Rozwiązywanie problemów z linkami do aplikacji

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.

  • 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 adresem https://<your-domain>/.well-known/assetlinks.json i jest udostępniany przez HTTPS bez przekierowań. Użyj walidatora online.
    • Sprawdź odcisk cyfrowy SHA-256: upewnij się, że sha256_cert_fingerprints w assetlinks.json dokł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 pliku AndroidManifest.xml zawiera atrybut android:autoVerify="true.
    • Sprawdź, czy nie ma przekierowań po stronie serwera: przekierowania z http do https lub z domeny bez www do www mogą 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.

Reguły dynamiczne na urządzeniach z Androidem w wersji 15 lub nowszej nie są aktualizowane

  • Problem: reguły w pliku assetlinks.json został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.

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 co example.com.

Przekierowania po stronie serwera

System nie weryfikuje żadnych linków aplikacji na Androida, jeśli skonfigurujesz przekierowanie takie jak to:

  • Od http://example.com do https://example.com
  • Od example.com do www.example.com

Takie działanie chroni bezpieczeństwo aplikacji.

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.json tylko podpisu wersji.
  • Podpis w assetlinks.json musi 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.

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.