Konfiguracja zaufanych działań w internecie może być nieco kłopotliwa, zwłaszcza jeśli chcesz tylko wyświetlić swoją witrynę. Z tego przewodnika dowiesz się, jak utworzyć podstawowy projekt wykorzystujący funkcję Trusted Web Activities, obejmujący wszystkie potrzebne funkcje.
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 Digital Asset Links.
Aby wykonać te czynności, musisz mieć:
- zainstalowane oprogramowanie Node.js w wersji 10 lub nowszej 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.
- witrynę, którą chcesz wyświetlić w zaufanej aktywności w internecie;
Zaufana aktywność w internecie pozwala aplikacji na Androida uruchomić kartę przeglądarki na pełnym ekranie bez żadnego interfejsu przeglądarki. Ta funkcja jest ograniczona do witryn należących do Ciebie, co potwierdzasz, konfigurując linki do zasobów cyfrowych. O nich powiemy więcej na ten temat później.
Gdy uruchomisz zaufaną aktywność w internecie, przeglądarka sprawdzi, czy link do zasobów cyfrowych jest nazywany 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ć aplikacje Progressive Web w aplikacji na Androida przy użyciu zaufanej aktywności w internecie.
Interfejs wiersza poleceń można zainstalować za pomocą tego polecenia:
Konfigurowanie środowiska
Przy pierwszym uruchomieniu Bubblewrap zaoferuje automatyczne pobranie i zainstalowanie wymaganych zależności zewnętrznych. Zalecamy, aby to narzędzie wykonało tę czynność, ponieważ gwarantuje to prawidłową konfigurację zależności. Aby używać istniejącej instalacji pakietu Java Development Kit (JDK) lub narzędzi wiersza poleceń Androida, zapoznaj się z dokumentacją Bubblewrap.
Zainicjuj i skompiluj projekt
Inicjalizowanie projektu na Androida, który zawiera PWA, odbywa się przez uruchomienie polecenia init:
Bubblewrap odczyta plik manifestu internetowego, poprosi deweloperó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:
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 pozwalające zainstalować i przetestować aplikację na urządzeniu lokalnym. Po podłączeniu urządzenia do komputera wykonaj te czynności:
Możesz też użyć narzędzia adb.
Uwaga: narzędzie wiersza poleceń **adb**
znajduje się w narzędziach wiersza poleceń Androida w **android_sdk/platform-tools/**
.
Aplikacja jest 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. Najpierw...
Alternatywy graficznego interfejsu użytkownika (GUI) dla Bubblewrap
Kreator aplikacji PWA udostępnia interfejs GUI, który wykorzystuje bibliotekę Bubblewrap do generowania projektów Trusted Web Activity. Więcej informacji o tym, jak za pomocą Kreatora aplikacji na Androida utworzyć aplikację na Androida, która otworzy aplikację PWA, znajdziesz w tym poście na blogu.
Uwaga na temat 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). Podczas kompilacji aplikacji Bubblewrap zostanie utworzony plik APK z konfiguracją klucza w kroku init
. Jednak gdy opublikujesz aplikację w Google Play, może zostać utworzony inny klucz, w zależności od tego, jaką metodę obsługi kluczy podpisywania wybierzesz. Dowiedz się więcej o kluczach podpisywania i o tym, jak są one powiązane z Bubblewrap i Google Play.
Konfigurowanie pliku linku do zasobu
Digital Asset Links to przede wszystkim plik w 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 na swoją stronę internetową na adreswell-known/assetlinks.json
w stosunku do katalogu głównego), aby przeglądarka mogła prawidłowo zweryfikować aplikację. Zapoznaj się ze szczegółowym omówieniem linków Digital Asset Links, aby dowiedzieć się, jaki mają one związek z Twoim kluczem podpisywania.
Sprawdzanie przeglądarki
Zaufana aktywność internetowa będzie próbowała stosować się do domyślnego wyboru 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 przeciwnym razie domyślnie używany jest tryb kart niestandardowych.
Oznacza to, że jeśli debugujesz coś związanego z Zaufanymi Aktywnościami w Sieci, musisz się upewnić, że używasz przeglądarki, której używasz. Aby sprawdzić, która przeglądarka jest używana, możesz użyć tego polecenia:
Dalsze kroki
Jeśli postępujesz zgodnie z tym przewodnikiem, powinna działać zaufana aktywność w internecie i powinieneś mieć wystarczającą wiedzę, aby debugować, co dzieje się, gdy weryfikacja się nie powiedzie. Jeśli nie, zapoznaj się z innymi pojęciami dotyczącymi Androida dla programistów stron internetowych lub zgłoś problem na GitHubie w tych dokumentach.
Następnie zalecam utworzenie ikony aplikacji. Gdy to zrobisz, możesz rozważyć wdrożenie aplikacji w Sklepie Play.