Linki aplikacji na Androida to adresy URL HTTP, które kierują użytkowników bezpośrednio do określonych treści w aplikacji na Androida. Linki aplikacji na Androida mogą zwiększyć ruch w aplikacji, pomóc Ci odkryć, które treści w aplikacji są najczęściej używane, oraz ułatwić użytkownikom znajdowanie i udostępnianie treści w aplikacji instalowanej.
Aby dodać obsługę linków aplikacji na Androida:
- Utwórz filtry intencji w pliku manifestu.
- Dodaj do aktywności aplikacji kod do obsługi przychodzących linków.
- Powiąż aplikację i witrynę za pomocą Digital Asset Links.
Asystent linków do aplikacji w Android Studio upraszcza ten proces dzięki kreatorowi, który krok po kroku przeprowadzi Cię przez kolejne etapy, jak opisano poniżej.
Więcej informacji o tym, jak działają linki aplikacji i jakie korzyści oferują, znajdziesz w artykule Obsługa linków aplikacji na Androida.
Dodawanie filtrów intencji
Asystent linków do aplikacji w Android Studio może pomóc Ci utworzyć filtry intencji w pliku manifestu i zmapować istniejące adresy URL z Twojej witryny na działania w aplikacji. Asystent linków do aplikacji dodaje też kod szablonu w każdym odpowiednim działaniu, aby obsłużyć intencję.
Aby dodać filtry intencji i obsługę adresów URL, wykonaj te czynności:
- Kliknij Narzędzia > Asystent linków do aplikacji.
- Kliknij Otwórz edytor mapowania adresów URL, a następnie kliknij Dodaj
u dołu listy Mapowanie adresów URL, aby dodać nowe mapowanie adresu URL. Dodaj szczegóły nowego mapowania adresów URL:
Rysunek 1. Dodaj podstawowe informacje o strukturze linków w witrynie, aby zmapować adresy URL na aktywności w aplikacji.
- Wpisz adres URL swojej witryny w polu Host.
Dodaj
path,pathPrefixlubpathPatterndla adresów URL, które chcesz zmapować.Jeśli na przykład masz aplikację do udostępniania przepisów, w której wszystkie przepisy są dostępne w ramach tej samej aktywności, a na stronie internetowej wszystkie przepisy znajdują się w tym samym katalogu /recipe, użyj pathPrefix i wpisz /recipe. W ten sposób adres URL http://www.recipe-app.com/recipe/grilled-potato-salad zostanie zmapowany na aktywność wybraną w następnym kroku.
- Wybierz aktywność, do której adresy URL mają kierować użytkowników.
- Kliknij OK.
Pojawi się okno edytora mapowania adresów URL. Asystent linków do aplikacji dodaje do pliku
AndroidManifest.xmlfiltry intencji na podstawie mapowania adresów URL i wyróżnia zmiany w polu Podgląd. Jeśli chcesz wprowadzić zmiany, kliknij Otwórz AndroidManifest.xml, aby edytować filtr intencji. Więcej informacji znajdziesz w artykule o filtrach intencji dla linków przychodzących.W głównym oknie narzędzia Asystent linków do aplikacji wyświetlane są też wszystkie precyzyjne linki w pliku
AndroidManifest.xml. Możesz szybko rozwiązać problemy z konfiguracją, klikając Rozwiąż wszystkie problemy z plikiem manifestu.
Rysunek 2. Popraw błędy w konfiguracji pliku manifestu w Asystencie linków do aplikacji. Uwaga: aby obsługiwać przyszłe linki bez aktualizowania aplikacji, zdefiniuj mapę URL, która obsługuje adresy URL, które planujesz dodać. Podaj też adres URL ekranu głównego aplikacji, aby był on uwzględniany w wynikach wyszukiwania.
Aby sprawdzić, czy mapowanie adresów URL działa prawidłowo, wpisz adres URL w polu Sprawdź mapowanie adresów URL.
Jeśli wszystko działa prawidłowo, pojawi się komunikat o powodzeniu, który informuje, że wpisany adres URL jest mapowany na wybraną aktywność.
Obsługa linków przychodzących
Gdy sprawdzisz, czy mapowanie adresów URL działa prawidłowo, dodaj logikę do obsługi utworzonej intencji:
- W Asystencie linków do aplikacji kliknij Wybierz aktywność.
- Wybierz aktywność z listy i kliknij Wstaw kod.
Asystent linków do aplikacji dodaje do aktywności kod podobny do tego:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) ... // ATTENTION: This was auto-generated to handle app links. val appLinkIntent: Intent = intent val appLinkAction: String? = appLinkIntent.action val appLinkData: Uri? = appLinkIntent.data ... }
Java
@Override void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ... // ATTENTION: This was auto-generated to handle app links. Intent appLinkIntent = getIntent(); String appLinkAction = appLinkIntent.getAction(); Uri appLinkData = appLinkIntent.getData(); ... }
Ten kod nie jest kompletny. Teraz musisz podjąć działanie na podstawie identyfikatora URI w appLinkData, np. wyświetlić odpowiednie treści. Na przykład w przypadku aplikacji do udostępniania przepisów kod może wyglądać tak:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) ... handleIntent(intent) } override fun onNewIntent(intent: Intent) { super.onNewIntent(intent) handleIntent(intent) } private fun handleIntent(intent: Intent) { val appLinkAction = intent.action val appLinkData: Uri? = intent.data if (Intent.ACTION_VIEW == appLinkAction) { appLinkData?.lastPathSegment?.also { recipeId -> Uri.parse("content://com.recipe_app/recipe/") .buildUpon() .appendPath(recipeId) .build().also { appData -> showRecipe(appData) } } } }
Java
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ... handleIntent(getIntent()); } protected void onNewIntent(Intent intent) { super.onNewIntent(intent); handleIntent(intent); } private void handleIntent(Intent intent) { String appLinkAction = intent.getAction(); Uri appLinkData = intent.getData(); if (Intent.ACTION_VIEW.equals(appLinkAction) && appLinkData != null){ String recipeId = appLinkData.getLastPathSegment(); Uri appData = Uri.parse("content://com.recipe_app/recipe/").buildUpon() .appendPath(recipeId).build(); showRecipe(appData); } }
Powiąż aplikację ze swoją witryną
Po skonfigurowaniu obsługi adresów URL w aplikacji asystent linków do aplikacji wygeneruje plik Digital Asset Links, którego możesz użyć do powiązania witryny z aplikacją.
Zamiast pliku Digital Asset Links możesz powiązać witrynę i aplikację w Search Console.
Jeśli w przypadku swojej aplikacji korzystasz z podpisywania aplikacji przez Google Play, odcisk cyfrowy certyfikatu wygenerowany przez asystenta linków do aplikacji zwykle nie pasuje do odcisku cyfrowego na urządzeniach użytkowników. W takim przypadku prawidłowy fragment kodu JSON protokołu Digital Asset Links dla aplikacji znajdziesz na koncie dewelopera w Konsoli Play w sekcji Release > Setup > App signing.
Aby powiązać aplikację i witrynę za pomocą Asystenta linków do aplikacji, kliknij Otwórz generator plików Digital Asset Links w Asystencie linków do aplikacji i wykonaj te czynności:
Rysunek 3. Wpisz informacje o witrynie i aplikacji, aby wygenerować plik Digital Asset Links.
- Wpisz domenę witryny i identyfikator aplikacji.
Aby w pliku Digital Asset Links uwzględnić obsługę logowania jednym dotknięciem, wybierz Obsługuj udostępnianie danych logowania między aplikacją a witryną i wpisz adres URL logowania w witrynie.Spowoduje to dodanie do pliku Digital Asset Links tego ciągu znaków, który deklaruje, że aplikacja i witryna udostępniają dane logowania:
delegate_permission/common.get_login_creds.Określ konfigurację podpisywania lub wybierz plik magazynu kluczy.
Upewnij się, że wybierasz odpowiednią konfigurację wersji lub plik magazynu kluczy dla kompilacji do publikacji albo konfigurację debugowania lub plik magazynu kluczy dla kompilacji do debugowania aplikacji. Jeśli chcesz skonfigurować kompilację produkcyjną, użyj konfiguracji wersji. Jeśli chcesz przetestować kompilację, użyj konfiguracji debugowania.
- Kliknij Wygeneruj plik Digital Asset Links.
- Gdy Android Studio wygeneruje plik, kliknij Zapisz plik, aby go pobrać.
- Prześlij plik
assetlinks.jsondo swojej witryny, z uprawnieniami do odczytu dla wszystkich, nahttps://yoursite/.well-known/assetlinks.json.Ważne: system weryfikuje plik Digital Asset Links przy użyciu zaszyfrowanego protokołu HTTPS. Upewnij się, że plik
assetlinks.jsonjest dostępny przez połączenie HTTPS, niezależnie od tego, czy filtr intencji aplikacji zawierahttps. - Kliknij Połącz i zweryfikuj, aby potwierdzić, że plik Digital Asset Links został przesłany do właściwej lokalizacji.
Asystent linków do aplikacji może zweryfikować plik Digital Asset Links, który powinien zostać opublikowany w Twojej witrynie. W przypadku każdej domeny zadeklarowanej w pliku manifestu asystent analizuje plik w witrynie, przeprowadza testy weryfikacyjne i podaje szczegółowe wyjaśnienia, jak rozwiązać problem z błędami.
Więcej informacji o łączeniu witryny z aplikacją za pomocą pliku Digital Asset Links znajdziesz w artykule Deklarowanie powiązań z witryną.
Testowanie linków aplikacji na Androida
Aby sprawdzić, czy linki otwierają właściwą aktywność, wykonaj te czynności:
- W Asystencie linków do aplikacji kliknij Test App Links (Przetestuj linki do aplikacji).
- W polu URL wpisz adres URL, który chcesz przetestować, np. http://recipe-app.com/recipe/grilled-potato-salad.
- Kliknij Uruchom test.
Rysunek 4. Okno Testuj linki aplikacji z testowanym adresem URL i komunikatem o powodzeniu.
Jeśli mapowanie adresów URL nie jest prawidłowo skonfigurowane lub nie istnieje, pod adresem URL w oknie Testuj linki do aplikacji pojawi się komunikat o błędzie. W przeciwnym razie Android Studio uruchomi aplikację na urządzeniu lub emulatorze w określonej aktywności bez wyświetlania okna uściślania („wybór aplikacji”) i wyświetli komunikat o powodzeniu w oknie Testowanie linków do aplikacji, jak pokazano na rysunku 4.
Jeśli Android Studio nie może uruchomić aplikacji, w oknie Run (Uruchom) pojawi się komunikat o błędzie.
Aby przetestować linki aplikacji na Androida za pomocą Asystenta linków do aplikacji, musisz mieć połączone urządzenie lub dostępne urządzenie wirtualne z Androidem 6.0 (poziom interfejsu API 23) lub nowszym. Więcej informacji znajdziesz w artykułach o łączeniu urządzenia i tworzeniu urządzenia wirtualnego z Androidem.