Konfiguracja zaufanej aktywności internetowej może być nieco trudna, zwłaszcza jeśli zależy Ci tylko na wyświetlaniu witryny. Ten przewodnik pomoże Ci utworzyć podstawowy projekt wykorzystujący zaufane aktywności internetowe, który obejmuje wszystkie zadania.
Po zakończeniu tego przewodnika:
- zostały użyte Bubblewrap do utworzenia aplikacji, która korzysta z zaufanej aktywności w internecie i przechodzi weryfikację.
- Dowiedz się, kiedy używane są Twoje klucze podpisywania.
- Rozpoznaj podpis, za pomocą którego tworzysz aplikację na Androida.
- Dowiedz się, jak utworzyć podstawowy plik Digital Asset Links.
Aby skorzystać z tego przewodnika, musisz mieć:
- Na komputerze programistycznym musisz mieć zainstalowany pakiet Node.js w wersji 10 lub nowszej.
- Telefon z Androidem lub emulator podłączony i skonfigurowany do programowania (włącz debugowanie USB, jeśli korzystasz z telefonu fizycznego).
- Przeglądarka, która obsługuje zaufaną aktywność w internecie na telefonie programisty. Chrome w wersji 72 lub nowszej będzie działać. Wkrótce udostępnimy ją w innych przeglądarkach.
- Witryna, którą chcesz wyświetlić w zaufanej aktywności internetowej.
Zaufana aktywność internetowa umożliwia aplikacji na Androida uruchamianie pełnoekranowej karty przeglądarki bez interfejsu użytkownika. Ta funkcja jest dostępna tylko w przypadku należących do Ciebie witryn. Aby to sprawdzić, skonfiguruj linki do zasobów cyfrowych. Więcej o nich dowiesz się później.
Gdy uruchomisz zaufaną aktywność w internecie, przeglądarka sprawdzi, czy doszło do wymeldowania z linku do zasobów cyfrowych, co jest nazywane weryfikacją. Jeśli weryfikacja się nie powiedzie, przeglądarka przełączy się na wyświetlanie witryny jako karty niestandardowej.
Instalowanie i konfigurowanie folii dymnej
Bubblewrap to zestaw bibliotek i narzędzie wiersza poleceń dla Node.js, które pomaga programistom generować, tworzyć i uruchamiać progresywne aplikacje internetowe w aplikacjach na Androida przy użyciu zaufanej aktywności internetowej.
Interfejs wiersza poleceń można zainstalować za pomocą tego polecenia:
npm i -g @bubblewrap/cli
Konfigurowanie środowiska
Przy pierwszym uruchomieniu Bubblefolii zaoferuje ona automatyczne pobranie i zainstalowanie wymaganych zależności zewnętrznych. Zalecamy, aby narzędzie to zrobiło, ponieważ gwarantuje to prawidłowe skonfigurowanie zależności. Sprawdź dokumentację okładek z bąbelkami, aby zobaczyć, czy zainstalowano pakiet Java Development Kit (JDK) lub narzędzia wiersza poleceń Androida.
Zainicjuj i skompiluj projekt
Projekt Androida, który pakuje PWA, wykonuje się przy użyciu polecenia init:
bubblewrap init --manifest=https://my-twa.com/manifest.json
Bubblewrap odczyta plik manifestu internetowego, poprosi deweloperów o potwierdzenie wartości do użycia w projekcie Androida i wygeneruje projekt na ich podstawie. Po wygenerowaniu projektu wygeneruj pakiet APK, uruchamiając polecenie:
bubblewrap build
Uruchom
W ramach tego kroku kompilacji zostanie wygenerowany plik o nazwie app-release-signed.apk. Plik ten możesz zainstalować na urządzeniu programistycznym do testów lub przesłać go do Sklepu Play, żeby opublikować wersję.
Bubblewrap to polecenie do zainstalowania i przetestowania aplikacji na urządzeniu lokalnym. Po podłączeniu urządzenia do programowania:
bubblewrap install
Możesz też użyć narzędzia adb.
adb install app-release-signed.apk
Aplikacja powinna być teraz dostępna w programie uruchamiającym na urządzeniu. Po otwarciu aplikacji zauważysz, że witryna działa jako karta niestandardowa, a nie zaufana aktywność internetowa. Wynika to z faktu, że nie skonfigurowano jeszcze weryfikacji funkcji Digital Asset Links, ale najpierw...
Alternatywny interfejs graficzny (GUI) do folii bąbelkowej
Kreator PWA udostępnia interfejs GUI, który używa biblioteki Bubblewrap do generowania projektów zaufanej aktywności internetowej. Więcej informacji o tym, jak za pomocą narzędzia PWA Builder do tworzenia aplikacji na Androida, która otwiera taką aplikację, znajdziesz w tym poście na blogu.
Uwaga na temat kluczy podpisywania
Linki do zasobów cyfrowych uwzględniają klucz, którym został podpisany plik APK. Częstą przyczyną niepowodzenia weryfikacji jest użycie nieprawidłowego podpisu. (Pamiętaj, że niepowodzenie weryfikacji oznacza, że uruchomisz witrynę jako kartę niestandardową z interfejsem przeglądarki na górze strony). Gdy Bubblewrap kompiluje aplikację, w kroku init zostanie utworzony plik APK z konfiguracją klucza. Jeśli jednak opublikujesz aplikację w Google Play, w zależności od tego, jak postępujesz z kluczami podpisywania, może zostać utworzony inny klucz. Dowiedz się więcej o kluczach podpisywania i ich związku z Bubblewrap i Google Play.
Konfiguruję plik asset link
Linki do zasobów cyfrowych to zasadniczo plik w witrynie, który wskazuje Twoją aplikację, i metadane w aplikacji, które kierują do Twojej witryny.
Po utworzeniu pliku assetlinks.json prześlij go do swojej witryny pod adresem .well-known/assetlinks.json (względem katalogu głównego), aby przeglądarka mogła prawidłowo zweryfikować aplikację. Aby dowiedzieć się więcej o tym, jaki ma związek z Twoim kluczem podpisywania, zapoznaj się ze szczegółowym omówieniem linków do zasobów cyfrowych.
Sprawdzam przeglądarkę
Zaufana aktywność internetowa jest wykonywana zgodnie z domyślną przeglądarką wybraną przez użytkownika. Jeśli domyślna przeglądarka użytkownika obsługuje zaufane aktywności internetowe, zostanie ona uruchomiona. W przeciwnym razie zostanie wybrana przeglądarka, która obsługuje zaufane aktywności internetowe. Domyślnym działaniem jest też powrót do trybu kart niestandardowych.
Oznacza to, że jeśli debugujesz działanie związane z zaufaną aktywnością internetową, musisz używać przeglądarki, o którą Ci chodziło. Aby sprawdzić, która przeglądarka jest używana, możesz użyć tego polecenia:
> adb logcat -v brief | grep -e TWAProviderPicker
D/TWAProviderPicker(17168): Found TWA provider, finishing search: com.google.android.apps.chrome
Dalsze kroki
Mamy nadzieję, że jeśli zastosujesz się do tego przewodnika, Twoja aktywność w internecie jest zaufana i masz wystarczającą wiedzę, by debugować, co się dzieje, gdy weryfikacja się nie powiedzie. Jeśli nie, zapoznaj się z innymi pomysłami na Androida dla programistów stron internetowych lub zgłoś problem na GitHubie za pomocą tych dokumentów.
Na początek zalecam utworzenie ikony aplikacji. Gdy to zrobisz, możesz wdrożyć aplikację w Sklepie Play.