1. Witamy
Z tego modułu dowiesz się, jak wdrożyć progresywną aplikację internetową, a potem pakujesz ją w aplikacji do dystrybucji w Sklepie Google Play.
Czego się nauczysz
- Jak za pomocą Bubblewrap umieścić progresywną aplikację internetową w Sklepie Google Play
- Co to jest klucz podpisywania i jak z niego korzystać
- Tworzenie nowej aplikacji w Konsoli Google Play i konfigurowanie wersji testowej do testowania aplikacji przed publikacją
- Co to są linki do zasobów cyfrowych i jak dodać je do aplikacji internetowej
Co warto wiedzieć
- Co to są progresywne aplikacje internetowe
- Jak używać narzędzi wiersza poleceń
- Podstawowe polecenia powłoki Bash lub jak przetłumaczyć je na wybraną powłokę.
Czego potrzebujesz
- Progresywna aplikacja internetowa opublikowana w internecie, w której możesz wprowadzać zmiany
- Interfejs Bubblewrap Command Line zainstalowany i gotowy do użycia
- konto dewelopera w Google Play,
- Jeśli masz już aplikacje w Google Play, swój dotychczasowy klucz podpisywania
- urządzenia z Androidem lub systemem operacyjnym Chrome, na którym będzie ono testowane;
Co nie zostanie uwzględnione
- Ograniczanie dostępu PWA tylko do urządzeń z Androidem lub Chrome OS
- Wdrażanie PWA w przypadku systemu operacyjnego Chrome i aplikacji na Androida na urządzenia mobilne w tej samej aplikacji.
- Przestrzegać zasad dotyczących płatności w Google Play.
2. Bąbelki
Bubblewrap to narzędzie, dzięki któremu dodasz progresywną aplikację internetową do pakietu aplikacji na Androida tak proste, jak uruchomienie kilku poleceń interfejsu wiersza poleceń. Aby to zrobić, trzeba wygenerować projekt na Androida, który uruchamia aplikację PWA jako zaufana aktywność internetowa.
Na początek utwórz katalog, w którym będzie znajdować się Twój projekt, i przejdź do niego:
$ mkdir my-pwa && cd my-pwa
Następnie uruchom narzędzie wiersza poleceń Bubblewrap, aby wygenerować konfigurację i projekt na Androida dla pakietu Android App Bundle, który prześlesz do Google Play:
$ bubblewrap init --manifest=https://my-pwa.com/manifest.json
Dymek Bubblewrap jest inicjowany przy użyciu lokalizacji pliku PWA&3 pliku manifestu aplikacji internetowej. Spowoduje to wygenerowanie konfiguracji domyślnej z manifestu aplikacji internetowej i uruchomienie w konsoli kreatora, który pozwoli na zmianę konfiguracji domyślnej. Użyj kreatora, aby zmienić dowolną wartość wygenerowaną przez narzędzie.
Klucz podpisywania
Podczas przesyłania pakiety aplikacji Google Play wymagają cyfrowego podpisania certyfikatu, który jest często nazywany kluczem podpisywania. Jest to certyfikat podpisany samodzielnie i różni się od tego, który służy do udostępniania aplikacji przez HTTPS.
Podczas tworzenia aplikacji Bubblewrap poprosi o podanie klucza. Jeśli używasz informacji o aplikacji w Sklepie Play, musisz dodać ścieżkę do tego samego klucza, którego używa aplikacja.
Jeśli nie masz jeszcze klucza podpisywania i tworzysz nową wizytówkę w Sklepie Play, możesz użyć wartości domyślnej dostarczonej przez Bubblewrap i poproś o utworzenie nowego klucza:
Wyjście Bubblewrap
Po zainicjowaniu projektu Bubblewrap i ukończeniu kreatora zostaną utworzone te elementy:
- twa-manifest.json – konfiguracja projektu odzwierciedlająca wartości wybrane w kreatorze Bubblewrap. Warto monitorować ten plik przy użyciu systemu kontroli wersji, ponieważ w razie potrzeby może on posłużyć do odtworzenia całego projektu Bubblewrap.
- Pliki projektu na Androida – pozostałe pliki w katalogu to wygenerowany projekt na Androida. Ten projekt jest źródłem używanym przez polecenie kompilacji Bubblewrap. Opcjonalnie możesz śledzić te pliki za pomocą systemu kontroli wersji.
- (Opcjonalnie) Klucz podpisywania – jeśli zdecydujesz się na utworzenie klucza podpisywania za pomocą Bubblewrap, klucz zostanie wysłany do lokalizacji opisanej w kreatorze. Klucz należy przechowywać w bezpiecznym miejscu i ograniczyć liczbę osób, które mają do niego dostęp. Na podstawie tych informacji możemy potwierdzić, że aplikacje pochodzą ze Sklepu Play.
Dzięki tym plikom mamy wszystko, czego potrzeba do utworzenia pakietu aplikacji na Androida.
Tworzenie pakietu aplikacji na Androida
W tym samym katalogu, w którym uruchomiono polecenie inicjowania Bubblewrap's, uruchom to polecenie (potrzebujesz haseł do klucza podpisywania):
$ bubblewrap build
Polecenie kompilacji wygeneruje 2 ważne pliki:
- app-release-bundle.aab – Twój pakiet PWA oraz pakiet Android App Bundle. Ten plik należy przesłać do Sklepu Google Play.
- app-release-signed.apk – format opakowania na Androida, który można wykorzystać do zainstalowania aplikacji bezpośrednio na urządzeniu programistycznym za pomocą polecenia
bubblewrap install
3. Wypróbuj! – Bubblewrap
Teraz Twoja kolej! Wykorzystaj wiedzę zdobytą w poprzednim kroku, aby wykonać te czynności:
- Utwórz katalog, w którym zapiszesz wygenerowany projekt na Androida.
- Zainicjuj ten katalog za pomocą Bubblewrap oraz PWA''s Web App Manifest.
- Wygeneruj nowy klucz podpisywania lub użyj istniejącego, jeśli już go masz.
- Utwórz pakiet Android App Bundle na podstawie wygenerowanego projektu Androida.
4. Dodaję Twoją aplikację do Sklepu Google Play
Masz już pakiet Android App Bundle i chcesz go przesłać do Sklepu Google Play. Po zarejestrowaniu konta dewelopera możesz otworzyć Konsolę Play i się zalogować.
Tworzenie aplikacji
Po zalogowaniu się zobaczysz ekran ze wszystkimi aplikacjami. U góry znajduje się przycisk Utwórz aplikację, którego kliknięcie powoduje wyświetlenie nowego ekranu z informacjami o nowej aplikacji na Androida.
Możesz wypełnić wiele pól, w tym nazwę aplikacji, język domyślny, aplikację lub grę, informację o tym, czy jest ona bezpłatna czy płatna, a także kilka deklaracji. Nie można utworzyć aplikacji bez wyrażenia zgody na deklaracje, dlatego ważne jest, aby zapoznać się z nimi przed wyrażeniem zgody.
Gdy wypełnisz wszystkie informacje i klikniesz przycisk Utwórz aplikację u dołu formularza, przekierujemy Cię do panelu nowej aplikacji. W panelu zobaczysz listy kontrolne zadań, które musisz wykonać, aby skonfigurować, rozpocząć testy i opublikować swoją aplikację.
Skonfiguruj testy wewnętrzne
Testy wewnętrzne to świetny sposób na szybkie udostępnienie aplikacji bez sprawdzania jej grupie wybranych testerów. Wyświetl zadania na liście kontrolnej Rozpocznij testowanie i wybierz Wybierz testerów.
Kliknij to zadanie, by wyświetlić stronę Test wewnętrzny. W tym miejscu możesz zarządzać konfiguracją testów aplikacji. Możesz to zrobić ponownie, otwierając sekcję Testowanie w menu Wersja na pasku bocznym. Najpierw utwórz listę e-mailową testerów na potrzeby przetestowania aplikacji. Aby to zrobić, kliknij link Utwórz listę e-mailową w sekcji Testerzy. Otworzy się wyskakujące okienko do utworzenia listy e-mailowej.
W wyskakującym okienku wpiszesz nazwę listy e-mailowej i możesz wpisać je ręcznie lub przesłać plik CSV z adresami e-mail do użycia. Po zakończeniu naciśnij przycisk Zapisz zmiany. W razie potrzeby możesz wrócić do list e-mailowych, które zostały już utworzone, aby dodać lub usunąć adresy e-mail. Gdy dodasz testerów, czas na utworzenie wersji testowej. Kliknij przycisk Utwórz nową wersję u góry strony.
Utwórz wersję testową
Po kliknięciu przycisku Utwórz nową wersję zobaczysz odpowiednią liczbę sekcji. Pierwszym z nich jest Integrity App – to miejsce, w którym wybierasz sposób zarządzania kluczem podpisywania aplikacji. Domyślnie możesz zezwolić Google na zarządzanie Twoim kluczem podpisywania, a zalecamy tę opcję, ponieważ jest ona bezpieczna i umożliwia odzyskanie aplikacji w przypadku utraty klucza przesyłania.
podpisywanie aplikacji przez Google Play
Przesyłanie i finalizowanie aplikacji
Gdy wybierzesz sposób zarządzania kluczem podpisywania, zobaczysz prośbę o przesłanie pakietu aplikacji do wersji. Aby to zrobić, przeciągnij i upuść plik app-release-bundle.aab wygenerowany w dymku do formularza. Aby zakończyć tworzenie wersji, podaj pozostałe informacje o wersji i kliknij przycisk Zapisz, a następnie kliknij Sprawdź wersję i Rozpocznij wdrażanie do testów wewnętrznych, aby rozpocząć tworzenie wersji. W ten sposób udostępnisz aplikację testerom wewnętrznym. Na karcie Testerzy na stronie Test wewnętrzny możesz skopiować link, który możesz udostępnić testerom, by umożliwić im dostęp do Twojej aplikacji.
5. Ćwicz umiejętności – utwórz aplikację
Teraz Twoja kolej! Wykorzystaj wiedzę zdobytą w poprzednim kroku, aby wykonać te czynności:
- Utwórz nową aplikację PWA w Konsoli Play.
- Skonfiguruj testy wewnętrzne aplikacji i dodaj siebie jako testera.
- Prześlij pakiet aplikacji i utwórz wersję testową aplikacji.
- Użyj linku testowego, aby zainstalować aplikację ze Sklepu Play na urządzeniu z Androidem lub Chrome OS.
6. Digital Asset Links
Jeśli aplikacja ma zostać przetestowana w Google Play, może się nie wyświetlać na pełnym ekranie. Wynika to z tego, że własność witryny nie została jeszcze zweryfikowana w pliku z zasobami cyfrowymi. Bubblewrap jest w stanie skonfigurować i utworzyć pakiet aplikacji na Androida, ale musisz dokończyć tworzenie połączenia, aktualizując aplikację internetową.
Pobierz odcisk cyfrowy SHA-256 aplikacji
Aby skonfigurować cyfrowe linki do zasobów PWA&, musisz mieć odcisk cyfrowy SHA-256 certyfikatu, który jest używany do podpisywania pakietu otrzymanego przez użytkownika na telefonie.
Z podpisywaniem aplikacji przez Google Play
Jeśli podczas tworzenia wersji skonfigurowano podpisywanie aplikacji przez Google Play (co wcześniej było zalecane), odcisk cyfrowy SHA-256 znajdziesz w Konsoli Play. Pamiętaj, że ten certyfikat jest inny niż certyfikat użyty do przesłania aplikacji. Aby uzyskać odcisk cyfrowy w aplikacji w Konsoli Play, kliknij Releases->Setup->App Integrity. W sekcji Certyfikat klucza podpisywania aplikacji znajdziesz wiele opcji. Skopiuj wartość odcisku cyfrowego SHA-256.
Bez podpisywania aplikacji przez Google Play
Jeśli zrezygnujesz z podpisywania aplikacji przez Google Play, klucz używany do podpisywania ostatecznej wersji aplikacji będzie taki sam jak ten, którego używasz do przesyłania aplikacji do Konsoli Play. Aby wyodrębnić odcisk palca, możesz użyć narzędzia keytool w Javie:
$ keytool -list -v \
-keystore <keystore-file-path> \
-alias <key-alias> \
-keypass <key-password> \
-storepass <store-password> | grep SHA256
$ SHA256: BD:92:64:B0:1A:B9:08:08:FC:FE:7F:94:B2...
Aby z niego skorzystać, musisz znać ścieżkę do klucza podpisywania i poznać odpowiednie hasła. Skopiuj wartości szesnastkowe klucza SHA256.
Tworzenie pliku Digital Asset Links
Bubblewrap może zarządzać odciskami cyfrowych podpisów, które zostały przez Ciebie pobrane i wygenerowane prawidłowo. Aby dodać odcisk palca za pomocą Bubblewrap, uruchom następujące polecenie z tego samego katalogu, który został utworzony w ramach Bubblewrapping Your PWA, zastępując fragment <fingerprint> odciskiem palca skopiowanym z poprzedniego kroku.
$ bubblewrap fingerprint add <fingerprint>
To polecenie spowoduje dodanie odcisku palca do listy odcisków palców aplikacji i wygenerowanie pliku assetlinks.json. Prześlij ten plik do katalogu .well-known o tym samym pochodzeniu co PWA.
7. Ćwicz umiejętności – cyfrowe linki do zasobów
Teraz Twoja kolej! Wykorzystaj wiedzę zdobytą w poprzednim kroku, aby wykonać te czynności:
- Znajdź odcisk cyfrowy SHA-256 aplikacji.
- Wygeneruj plik Digital Asset Links dla swojej aplikacji.
- Prześlij plik Digital Asset Links w PWA.
- Sprawdź, czy plik Digital Asset Links jest poprawnie skonfigurowany, korzystając z interfejsu API i aplikacji testowej.
8. Sprawdzian wiedzy
Zanim zakończysz test, sprawdź swoją wiedzę i sprawdź zdobytą wiedzę, odpowiadając na poniższe pytania. Nie zaglądaj do dziesiątek.
Po wygenerowaniu projektu na Androida za pomocą Bubblewrap Sally przekazuje wygenerowany plik ______ do swojego systemu kontroli wersji, aby mogła go utworzyć w dowolnym momencie.
Jacek chce, aby jego zespół ds. kontroli jakości przetestował swoją aplikację PWA na Androida. ______ jego pakiet Android App Bundle na ścieżkę testów wewnętrznych.
Oogie Boogie''s aplikacja PWA na Androida nie działa na pełnym ekranie. Aby to naprawić, muszą pobrać odcisk cyfrowy certyfikatu SHA-256 dla ______ i przesłać go do pliku Digital Asset Links w tym samym miejscu co PWA.
9. Sprawdź swoją wiedzę – odpowiedzi
Odpowiedzi na pytania do testu wiedzy
- Po wygenerowaniu projektu na Androida za pomocą Bubblewrap Sally przekazuje wygenerowany plik ______ do swojego systemu kontroli wersji, aby mogła go utworzyć w dowolnym momencie.
- Odpowiedź: twa-manifest.json
- Sekcja: Panowanie tagu PWA
- Jacek chce, aby jego zespół ds. kontroli jakości przetestował swoją aplikację PWA na Androida. ______ jego pakiet Android App Bundle na ścieżkę testów wewnętrznych.
- Odpowiedź: znaki i przesłane pliki
- Sekcja: Dodawanie aplikacji do Sklepu Google Play
- Oogie Boogie''s aplikacja PWA na Androida nie działa na pełnym ekranie. Aby to naprawić, muszą pobrać odcisk cyfrowy certyfikatu SHA-256 dla ______ i przesłać go do pliku Digital Asset Links w tym samym miejscu co PWA.
- Odpowiedź: klucz podpisywania, /.well-known/assetlinks.json
- Sekcja: Linki do zasobów cyfrowych
10. Gratulacje!
Gratulacje! Wiesz już, jak dodać progresywną aplikację internetową do Sklepu Google Play.
Jeśli uznasz, że jest to konieczne, wypróbuj te rozwiązania:
- Tworzenie wersji produkcyjnej aplikacji
- Dowiedz się więcej o dodatkowych opcjach publikowania aplikacji, w tym o wersjach przeznaczonych wyłącznie dla Chrome OS i aplikacjach na Androida na komórki oraz PWA na urządzenia z Chrome OS.
- Dowiedz się, jak skonfigurować płatności w Google Play za pomocą aplikacji i wdrożyć je w PWA oraz w interfejsie.
Miłego programowania.