Krótki przewodnik

Peter Conn
Peter Conn

Konfiguracja zaufanych działań w internecie może być nieco kłopotliwa, zwłaszcza jeśli chcesz tylko wyświetlić swoją witrynę. Ten przewodnik pomoże Ci utworzyć podstawowy projekt, który korzysta z zaufanych działań w internecie, uwzględniając wszystkie istotne kwestie.

Po zakończeniu tego przewodnika:

  • Użyj Bubblewrap do utworzenia aplikacji, która korzysta z zaufanej aktywności w internecie i przeszkadza weryfikację.
  • Dowiedz się, kiedy są używane klucze podpisywania.
  • Umożliwianie określenia podpisu, z którym budowana jest aplikacja na Androida.
  • Dowiedz się, jak utworzyć podstawowy plik linków do cyfrowych zasobów.

Aby wykonać te czynności, musisz mieć:

  • Node.js 10 lub nowsza wersja zainstalowana na komputerze programisty.
  • telefon z Androidem lub emulator połączony i skonfigurowany do celów programistycznych (włącz debugowanie USB, jeśli używasz fizycznego telefonu).
  • przeglądarka obsługująca zaufaną aktywność internetową na telefonie deweloperskim. Wystarczy Chrome w wersji 72 lub nowszej. Obsługa w innych przeglądarkach jest w drodze.
  • witrynę, którą chcesz wyświetlić w zaufanej aktywności w internecie.

Zaufane działanie internetowe umożliwia aplikacji na Androida uruchamianie karty przeglądarki w trybie pełnoekranowym bez żadnego interfejsu przeglądarki. Ta funkcja jest ograniczona do witryn, które są Twoją własnością. Musisz to potwierdzić, konfigurując połączenia z zasobami cyfrowymi. Więcej o nich dowiesz się później.

Gdy uruchomisz zaufane działanie w internecie, przeglądarka sprawdzi, czy protokół Digital Asset Links działa prawidłowo. Nazywamy to weryfikacją. Jeśli weryfikacja się nie powiedzie, przeglądarka wyświetli Twoją witrynę jako kartę niestandardową.

Instalowanie i konfigurowanie Bubblewrap

Bubblewrap to zestaw bibliotek i narzędzie wiersza poleceń (CLI) dla Node.js, które pomaga deweloperom generować, kompilować i uruchamiać progresywne aplikacje internetowe w aplikacji na Androida przy użyciu zaufanej aktywności w internecie.

Interfejs wiersza poleceń można zainstalować za pomocą tego polecenia:

npm i -g @bubblewrap/cli

Konfigurowanie środowiska

Gdy uruchomisz Bubblewrap po raz pierwszy, narzędzie zaproponuje automatyczne pobranie i zainstalowanie wymaganych zależności zewnętrznych. Zalecamy zezwolenie na to narzędziu, ponieważ gwarantuje to prawidłową konfigurację zależności. Aby używać istniejącego pakietu Java Development Kit (JDK) lub narzędzi wiersza poleceń Androida, zapoznaj się z dokumentacją Bubblewrap.

Inicjowanie i tworzenie projektu

Inicjalizowanie projektu na Androida, który zawiera PWA, odbywa się przez uruchomienie polecenia init:

bubblewrap init --manifest=https://my-twa.com/manifest.json

Bubblewrap odczyta plik manifestu internetowego, poprosi programistów o potwierdzenie wartości do użycia w projekcie na Androida i wygeneruje projekt na podstawie tych wartości. Po wygenerowaniu projektu wygeneruj plik APK, wykonując te czynności:

bubblewrap build

Uruchom

Etap kompilacji wygeneruje plik o nazwie app-release-signed.apk. Plik można zainstalować na urządzeniu deweloperskim na potrzeby testowania lub przesłać do Sklepu Play w celu opublikowania.

Bubblewrap udostępnia polecenie do zainstalowania i przetestowania aplikacji na urządzeniu lokalnym. Po podłączeniu urządzenia do komputera wykonaj te czynności:

bubblewrap install

Możesz też użyć narzędzia adb.

adb install app-release-signed.apk

Aplikacja powinna być teraz dostępna w wyszukiwarce urządzenia. Po otwarciu aplikacji zauważysz, że Twoja witryna jest otwierana jako karta niestandardowa, a nie zaufana aktywność w internecie. Dzieje się tak, ponieważ nie skonfigurowaliśmy jeszcze weryfikacji linków do zasobów cyfrowych, ale najpierw...

Alternatywy graficznego interfejsu użytkownika (GUI) dla Bubblewrap

PWA Builder udostępnia interfejs graficzny, który korzysta z biblioteki Bubblewrap do generowania projektów zaufanej aktywności internetowej. Więcej instrukcji dotyczących korzystania z twórcy aplikacji PWA do tworzenia aplikacji na Androida, która otwiera Twoją aplikację PWA, znajdziesz w tym wpisie na blogu.

Uwaga dotycząca kluczy podpisywania

Digital Asset Links biorą pod uwagę klucz, którym został podpisany plik APK. Typową przyczyną niepowodzenia weryfikacji jest użycie nieprawidłowego podpisu. (Pamiętaj, że jeśli nie przejdziesz weryfikacji, Twoja witryna będzie otwierać się jako karta niestandardowa z interfejsem przeglądarki u góry strony). Gdy Bubblewrap skompiluje aplikację, w kroku init zostanie utworzony plik APK z konfiguracją klucza. Jednak gdy opublikujesz aplikację w Google Play, może zostać utworzony inny klucz, w zależności od tego, jak chcesz zarządzać kluczami podpisywania. Dowiedz się więcej o kluczach podpisywania i o tym, jak się one łączą z Bubblewrap i Google Play.

Digital Asset Links to przede wszystkim plik w Twojej witrynie, który wskazuje na Twoją aplikację, oraz metadane w aplikacji, które wskazują na Twoją witrynę.

Po utworzeniu pliku assetlinks.json prześlij go do swojej witryny w folderze .well-known/assetlinks.json (względnie katalogu głównego), aby przeglądarka mogła prawidłowo zweryfikować aplikację. Aby dowiedzieć się więcej o tym, jak to się ma do Twojego klucza podpisywania, przeczytaj szczegółowe informacje o protokole Digital Asset Links.

Sprawdzanie przeglądarki

Zaufana aktywność internetowa będzie się starać stosować do domyślnej przeglądarki użytkownika. Jeśli domyślna przeglądarka użytkownika obsługuje zaufane działania w internecie, zostanie ona uruchomiona. Jeśli nie, zostanie wybrana przeglądarka, która obsługuje zaufane działania w internecie. W takim przypadku domyślnie używany jest tryb kart niestandardowych.

Oznacza to, że jeśli debugujesz coś związanego z Zaufanymi Aktywnościami w Sieci, sprawdź, czy używasz przeglądarki, której używasz. Aby sprawdzić, która przeglądarka jest używana, użyj tego polecenia:

> adb logcat -v brief | grep -e TWAProviderPicker
D/TWAProviderPicker(17168): Found TWA provider, finishing search: com.google.android.apps.chrome

Następne kroki

Jeśli postępujesz zgodnie z tym przewodnikiem, powinna działać zaufana aktywność w przeglądarce, a Ty powinieneś mieć wystarczającą wiedzę, aby debugować, co dzieje się, gdy weryfikacja się nie powiedzie. Jeśli nie, zapoznaj się z koncepcjami Androida dla programistów stron internetowych lub otwórz problem na GitHub w tych dokumentach.

Na początek utwórz ikonę aplikacji. Następnie możesz wdrożyć aplikację w Sklepie Play.