W tym przewodniku opisujemy typowe problemy i sposoby ich rozwiązywania. Możesz też użyć narzędzi do rozwiązywania problemów na stronie Precyzyjne linki w Konsoli Play lub asystenta linków do aplikacji w Android Studio. Więcej informacji znajdziesz w artykule o narzędziach dla programistów do obsługi linków aplikacji.
Link aplikacji otwiera się w przeglądarce zamiast w aplikacji
- Problem: klikasz link, który powinien otworzyć aplikację, ale otwiera się on w przeglądarce lub wyświetla się okno uściślania.
- Rozwiązanie:
- Sprawdź
assetlinks.json: upewnij się, że plik jest prawidłowym plikiem JSON, jest dostępny pod adresemhttps://<your-domain>/.well-known/assetlinks.jsoni jest udostępniany przez HTTPS bez przekierowań. Użyj walidatora online. - Sprawdź odcisk cyfrowy SHA-256: upewnij się, że
sha256_cert_fingerprintswassetlinks.jsondokładnie odpowiada odciskowi cyfrowemu klucza podpisywania wersji aplikacji (jeśli używasz podpisywania aplikacji przez Google Play, użyj klucza z Konsoli Play). Podpis powinien być zapisany wielkimi literami. - Sprawdź funkcję
autoVerify: upewnij się, że element<intent-filter>w plikuAndroidManifest.xmlzawiera atrybutandroid:autoVerify="true. - Sprawdź, czy nie ma przekierowań po stronie serwera: przekierowania z
httpdohttpslub z domeny bez www dowwwmogą spowodować niepowodzenie weryfikacji. - Wymuś ponowną weryfikację: uruchom polecenia narzędzia ADB w przewodniku Testowanie linków aplikacji, aby uzyskać nowy wynik weryfikacji.
- Diagnozowanie rozpoznawania linków (Android 17 lub nowszy): uruchom polecenie
adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>", aby sprawdzić, które aplikacje kandydujące, filtry intencji w pliku manifestu i reguły dynamicznych linków aplikacji pasują do adresu URL. Szczegółowe informacje znajdziesz w artykule Diagnozowanie rozwiązywania linków za pomocą flagi debug-link.
- Sprawdź
Reguły dynamiczne na urządzeniach z Androidem w wersji 15 lub nowszej nie są aktualizowane
- Problem: reguły w pliku
assetlinks.jsonzostały zaktualizowane, ale aplikacja nie obsługuje nowych linków. - Rozwiązanie:
- Wymuś ponowną weryfikację: najbardziej niezawodnym sposobem testowania zmian jest wymuszenie ponownego pobrania za pomocą polecenia
adb shell pm verify-app-links --re-verify <your-package-name>. - Sprawdź, czy nie ma literówek: dokładnie sprawdź dopasowania wzorców w regułach pod kątem błędów składniowych.
- Sprawdź reguły filtrowania w pliku manifestu: przejrzyj reguły filtrów intencji w pliku manifestu aplikacji, aby upewnić się, że ścieżka linku nie jest odfiltrowywana. Jeśli link jest odfiltrowywany, zmniejsz restrykcyjność filtra intencji w manifeście aplikacji.
- Diagnozowanie reguł dopasowania (Android 17 lub nowszy): uruchom
adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>", aby sprawdzić, które reguły zostały ocenione, i ustalić, czy reguła wykluczająca (allow = 1) uniemożliwiła otwarcie aplikacji. Zapoznaj się z sekcją Diagnozowanie rozpoznawania linków za pomocą flagi debug-link.
- Wymuś ponowną weryfikację: najbardziej niezawodnym sposobem testowania zmian jest wymuszenie ponownego pobrania za pomocą polecenia
Naprawianie typowych błędów implementacji
Jeśli nie możesz zweryfikować linków do aplikacji na Androida, sprawdź, czy nie występują te typowe błędy. W tej sekcji używamy nazwy domeny example.com jako obiektu zastępczego. Podczas przeprowadzania tych testów zastąp example.com rzeczywistą nazwą domeny serwera.
- Nieprawidłowa konfiguracja filtra intencji
- Sprawdź, czy w elemencie
<intent-filter>nie ma adresu URL, który nie należy do Twojej aplikacji. - Nieprawidłowa konfiguracja serwera
Sprawdź konfigurację JSON serwera i upewnij się, że wartość SHA jest prawidłowa.
Sprawdź też, czy
example.com.(z kropką na końcu) wyświetla te same treści coexample.com.- Przekierowania po stronie serwera
System nie weryfikuje żadnych linków aplikacji na Androida, jeśli skonfigurujesz przekierowanie takie jak to:
- Od
http://example.comdohttps://example.com - Od
example.comdowww.example.com
Takie działanie chroni bezpieczeństwo aplikacji.
- Od
- Niezawodność serwera
Sprawdź, czy aplikacje klienckie mogą połączyć się z serwerem.
- Linki, których nie można zweryfikować
W celach testowych możesz celowo dodać linki, których nie można zweryfikować. Pamiętaj, że na Androidzie 11 i starszych wersjach te linki powodują, że system nie weryfikuje żadnych linków aplikacji na Androida w Twojej aplikacji.
- Nieprawidłowy podpis w pliku assetlinks.json
Sprawdź, czy podpis jest prawidłowy i zgodny z podpisem użytym do podpisania aplikacji. Typowe błędy:
- Podpisanie aplikacji certyfikatem debugowania i umieszczenie w
assetlinks.jsontylko podpisu wersji. - Podpis w
assetlinks.jsonmusi być zapisany małymi literami. Podpis powinien być zapisany wielkimi literami. - Jeśli używasz podpisywania aplikacji przez Google Play, upewnij się, że używasz podpisu, którego Google używa do podpisywania każdej wersji. Możesz sprawdzić te informacje, w tym pełny fragment kodu JSON, postępując zgodnie z instrukcjami dotyczącymi deklarowania powiązań witryn.
- Podpisanie aplikacji certyfikatem debugowania i umieszczenie w
Przechwytywanie raportu o błędzie
W przypadku złożonych problemów, które trudno odtworzyć, wygeneruj raport o błędzie i przeanalizuj go. Może to dostarczyć cennych informacji o procesie weryfikacji i błędach na poziomie systemu.