Linki do aplikacji to precyzyjne linki, które używają schematu HTTP lub HTTPS i są zweryfikowane przez Androida jako powiązane z Twoją witryną. Aby zarejestrować się do obsługi linków aplikacji, wykonaj te czynności:
- Dodaj do pliku manifestu aplikacji co najmniej 1 filtr intencji, który określa domenę lub adresy URL Twojej witryny.
- Dodaj
autoVerify="true"attributedo elementów filtra intencji. Sygnalizuje to systemowi, że powinien spróbować zweryfikować schemat i domeny hosta pod kątem konfiguracjiassetlinks.jsonwitryny. - Zadeklaruj powiązania witryn.
Oto przykład deklaracji linku do aplikacji ze schematami i hostami oraz autoVerify="true":
<activity
android:name=".MainActivity"
android:exported="true"
...>
<!-- Make sure you explicitly set android:autoVerify to "true". -->
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<!-- If a user clicks on a link that uses the "http" scheme, your
app should be able to delegate that traffic to "https". -->
<!-- Do not include other schemes, as this will prevent verification. -->
<data android:scheme="http" />
<data android:scheme="https" />
<!-- Include one or more domains that should be verified. -->
<data android:host="www.example.com" />
<data android:host="*.example.com" />
</intent-filter>
</activity>
Najważniejsze informacje o kodzie
- AutoVerify: atrybut
android:autoVerify="true"jest wymagany w przypadku linków do aplikacji. Sygnalizuje systemowi, że powinien spróbować zweryfikować powiązanie między aplikacją a schematami i domenami określonymi w tagach<data>. Zalecamy dodanie elementuautoVerify="truedo każdego filtra intencji, który ma być weryfikowalny. - Elementy danych: każdy filtr intencji App Links musi zawierać co najmniej 1 element
<data>, który określa schematy i formaty hosta pasujące do domeny witryny, którą można zweryfikować. - Schematy: filtr intencji musi zawierać elementy
<data>dla schematówhttpihttps. Hosts: możesz opcjonalnie dodać elementy
<data>, aby dopasować co najmniej 1 hosta. Użyj symbolu wieloznacznego (*), aby dopasować wiele subdomen (np.*.example.com). System spróbuje zweryfikować każdego hosta na podstawie pliku assetlinks.json w Twojej witrynie. Pamiętaj, że routing na poziomie ścieżki powinien być obsługiwany przez plik assetlinks.json (patrz sekcja ze sprawdzonymi metodami poniżej).Wiele domen hostowanych: jeśli zadeklarujesz wiele domen hostowanych, system (na Androidzie 12 lub nowszym) spróbuje zweryfikować każdą z nich. Jeśli którykolwiek host zostanie zweryfikowany, aplikacja stanie się domyślnym modułem obsługi linków z tego zweryfikowanego hosta. Na Androidzie 11 i starszych weryfikacja nie powiedzie się, jeśli nie uda się zweryfikować nawet jednego hosta.
Wiele filtrów intencji: ważne jest, aby utworzyć osobne filtry, gdy chcesz zadeklarować unikalne adresy URL (np. konkretną kombinację schematu i hosta), ponieważ wiele elementów
<data>w tym samym filtrze intencji jest scalanych, aby uwzględnić wszystkie odmiany ich połączonych atrybutów.
Uwagi dotyczące reguł filtrowania plików manifestu
Jeśli konfigurujesz filtry do użycia z dynamicznymi linkami aplikacji na Androidzie 15 lub nowszym, pamiętaj, że reguły dynamiczne zadeklarowane w pliku assetlinks.json po stronie serwera nie mogą rozszerzać zakresu reguł adresów URL zadeklarowanych statycznie w pliku manifestu aplikacji.
Z tego powodu zalecamy takie podejście:
- W manifeście aplikacji ustaw najszerszy możliwy zakres, np. deklarując tylko schemat i domenę.
- Możesz polegać na regułach pliku assetlinks.json po stronie serwera, aby wprowadzać dalsze ulepszenia, takie jak routing na poziomie ścieżki.
Dzięki tej idealnej konfiguracji możesz w razie potrzeby dynamicznie dodawać nowe ścieżki linków do aplikacji w pliku assetlinks.json, wiedząc, że będą one pasować do szerokiego zakresu ustawionego w manifeście aplikacji.
Obsługa linków aplikacji w przypadku wielu hostów
System musi mieć możliwość zweryfikowania hosta określonego w elementach danych filtrów intencji adresu URL aplikacji pod kątem plików Digital Asset Links hostowanych w odpowiednich domenach internetowych w tym filtrze intencji. Jeśli weryfikacja się nie powiedzie, system domyślnie przejdzie do standardowego działania, aby rozwiązać intencję, zgodnie z opisem w artykule Tworzenie precyzyjnych linków do treści w aplikacji. Aplikacja może jednak nadal zostać zweryfikowana jako domyślny moduł obsługi dowolnego wzorca adresu URL zdefiniowanego w innych filtrach intencji aplikacji.
Na przykład aplikacja z tymi filtrami intencji przejdzie weryfikację tylko w przypadku https://www.example.com, jeśli plik assetlinks.json zostanie znaleziony w https://www.example.com/.well-known/assetlinks.json, ale nie w https://www.example.net/.well-known/assetlinks.json:
<application>
<activity android:name="MainActivity">
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="http" />
<data android:scheme="https" />
<data android:host="www.example.com" />
</intent-filter>
</activity>
<activity android:name="SecondActivity">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:host="www.example.net" />
</intent-filter>
</activity>
</application>
Obsługa linkowania aplikacji w przypadku wielu subdomen
Protokół Digital Asset Links traktuje subdomeny w filtrach intencji jako unikalne, oddzielne hosty. Jeśli więc filtr intencji zawiera kilka hostów z różnymi subdomenami, musisz opublikować prawidłowy plik assetlinks.json w każdej domenie.
Na przykład ten filtr intencji zawiera www.example.com i mobile.example.com jako akceptowane hosty adresów URL intencji. Dlatego prawidłowy plik assetlinks.json musi być opublikowany zarówno w https://www.example.com/.well-known/assetlinks.json, jak i https://mobile.example.com/.well-known/assetlinks.json.
<application>
<activity android:name="MainActivity">
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:scheme="https" />
<data android:host="www.example.com" />
<data android:host="mobile.example.com" />
</intent-filter>
</activity>
</application>
Jeśli natomiast zadeklarujesz nazwę hosta z symbolem wieloznacznym (np. *.example.com), musisz opublikować plik assetlinks.json w głównej nazwie hosta (example.com). Na przykład aplikacja z tym filtrem intencji przejdzie weryfikację w przypadku dowolnej podnazwy example.com (np. foo.example.com), o ile plik assetlinks.json zostanie opublikowany w https://example.com/.well-known/assetlinks.json:
<application>
<activity android:name="MainActivity">
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:host="*.example.com" />
</intent-filter>
</activity>
</application>
Sprawdzanie, czy z tą samą domeną jest powiązanych wiele aplikacji
Jeśli opublikujesz kilka aplikacji powiązanych z tą samą domeną, każda z nich może zostać zweryfikowana. Jeśli jednak aplikacje mogą rozpoznawać dokładnie tę samą domenę, hosta i ścieżkę, jak może to mieć miejsce w przypadku wersji uproszczonej i pełnej, tylko ostatnio zainstalowana aplikacja może rozpoznawać intencje internetowe dla tej domeny.
W takim przypadku sprawdź, czy na urządzeniu użytkownika nie ma aplikacji, które mogą powodować konflikt, pod warunkiem że masz niezbędną widoczność pakietu. Następnie w aplikacji wyświetl niestandardowe okno wyboru zawierające wyniki wywołania queryIntentActivities. Użytkownik może wybrać preferowaną aplikację z listy pasujących aplikacji, które pojawiają się w oknie.
Zgodność wsteczna dynamicznych linków aplikacji na Androidzie 14 i starszych wersjach
Funkcje dynamicznych linków do aplikacji, w tym zaawansowane reguły dopasowywania w pliku assetlinks.json i używanie <uri-relative-filter-group>, są w pełni obsługiwane tylko na Androidzie 15 (poziom interfejsu API 35) i nowszych wersjach.
Na Androidzie 14 (API na poziomie 34) i starszych system uwzględnia tylko elementy scheme i host zadeklarowane w elementach <data> pliku manifestu na potrzeby weryfikacji linków aplikacji. Reguły dotyczące ścieżek, wykluczenia i dynamiczne aktualizacje z pliku assetlinks.json nie są stosowane.
Oznacza to, że jeśli w pliku manifestu podasz tylko scheme i host, aplikacja może nieoczekiwanie przechwytywać wszystkie ścieżki w zweryfikowanej domenie na Androidzie 14 i starszych wersjach, niezależnie od reguł dotyczących ścieżek zdefiniowanych w pliku assetlinks.json na Androidzie 15 i nowszych wersjach.
Strategia zastępcza dla starszych wersji Androida, które mają być skonfigurowane bez precyzyjnych linków
Aby zapobiec obsługiwaniu przez aplikację wszystkich linków do domeny na Androidzie 14 i starszych wersjach, gdy chcesz używać dynamicznych linków aplikacji do bardziej szczegółowych ścieżek na Androidzie 15 i nowszych wersjach, dodaj w filtrze intencji w pliku manifestu ścieżkę, która nie pasuje do wzorca.
Dodaj element <data> z atrybutem android:path, który prawdopodobnie nigdy nie będzie prawidłową ścieżką dla Twoich linków. Dzięki temu filtr intencji nie będzie pasować do wszystkich ścieżek w niższych wersjach.
Przykład:
<activity
android:name=".MainActivity"
android:exported="true"
...>
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="http" />
<data android:scheme="https" />
<data android:host="www.example.com" />
<!-- Add a non-matching path for backward compatibility -->
<data android:path="/no_match_for_older_android_versions" />
<uri-relative-filter-group android:allow="true">
<data android:pathPattern="/.*"/>
</uri-relative-filter-group>
</intent-filter>
</activity>
Dodanie elementu <data android:path="/no_match_for_older_android_versions" /> sprawia, że na Androidzie 14 i starszych ten filtr intencji nie pasuje do żadnych linków przychodzących, ale nadal umożliwia weryfikację domeny do użycia z dynamicznymi linkami aplikacji na Androidzie 15 i nowszych na podstawie zaawansowanych reguł dopasowywania w regułach assetlinks.json.
Migracja istniejących linków do aplikacji
Jeśli w pliku manifestu masz już linki aplikacji z określonymi regułami ścieżki (np. android:pathPrefix) i chcesz zacząć używać dynamicznych linków aplikacji na Androidzie 15 lub nowszym, możesz bezpiecznie dodać element <uri-relative-filter-group> bezpośrednio do istniejących filtrów intencji.
Android 14 i starsze wersje ignorują element <uri-relative-filter-group>, więc dotychczasowe linki aplikacji będą nadal działać dokładnie tak samo jak obecnie na urządzeniach ze starszymi wersjami Androida.
Musisz jednak dokładnie rozważyć, jak Android 15 i nowsze wersje oceniają konfigurację „mieszaną”:
- Filtrowanie dwuwarstwowe: na Androidzie 15 i nowszych system ocenia filtry intencji jako sumę. Adres URL przechodzi sprawdzanie pliku manifestu, jeśli spełnia wymagania starszych statycznych tagów
<data>lub ogólnych reguł w pliku<uri-relative-filter-group>. Gdy adres URL przejdzie tę wstępną weryfikację pliku manifestu, system zastosuje reguły dynamiczne zdefiniowane w plikuassetlinks.jsonjako drugą warstwę szczegółowego filtrowania. Oznacza to, że reguły JSON po stronie serwera ostatecznie decydują o tym, które z tych dopasowanych adresów URL faktycznie otwierają aplikację.
Przykład konfiguracji hybrydowej:
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:host="www.example.com" />
<!-- Legacy rule: Android 14 and lower use this. Android 15 and higher
also use this. -->
<data android:pathPrefix="/store" />
<!--
Dynamic rule: Android 14 and lower ignore this. Android 15 and higher
evaluate this as a union between all paths and the configuration
specified in the assetlinks.json file. Make sure to apply further
refinements in the assetlinks.json file to prevent all URL paths from
opening in the app.
-->
<uri-relative-filter-group android:allow="true">
<data android:pathPrefix="/" />
</uri-relative-filter-group>
</intent-filter>