Risolvere i problemi relativi ai link per app

Questa guida descrive i problemi comuni e come risolverli. Puoi anche utilizzare gli strumenti di risoluzione dei problemi nella pagina Link diretti di Play Console o nell'assistente per gli app link di Android Studio. Per saperne di più, consulta Strumenti per sviluppatori di app link.

  • Problema: fai clic su un link che dovrebbe aprire la tua app, ma si apre in un browser web o viene visualizzata una finestra di dialogo di disambiguazione.
  • Soluzione:
    • Controlla assetlinks.json: assicurati che il file sia un file JSON valido, accessibile all'indirizzo https://<your-domain>/.well-known/assetlinks.json, e pubblicato tramite HTTPS senza reindirizzamenti. Utilizza un validatore online.
    • Verifica della fingerprint SHA-256: verifica che sha256_cert_fingerprints in assetlinks.json corrisponda esattamente alla fingerprint della chiave di firma per la release dell'app (utilizza quella di Play Console se utilizzi la firma dell'app di Google Play). La firma deve essere in maiuscolo.
    • Verifica autoVerify: assicurati che <intent-filter> in AndroidManifest.xml includa android:autoVerify="true".
    • Controlla la presenza di reindirizzamenti lato server: i reindirizzamenti da http a https o da un dominio non www a www possono causare il mancato completamento della verifica.
    • Forza la nuova verifica: esegui i comandi ADB nella guida Esegui test sugli app link per ottenere un nuovo risultato di verifica.

Le regole dinamiche su Android 15 e versioni successive non vengono aggiornate

  • Problema: hai aggiornato le regole nel file assetlinks.json, ma i nuovi link non vengono gestiti dall'app.
  • Soluzione:
    • Forza la nuova verifica: il modo più affidabile per testare le modifiche è forzare un nuovo recupero con adb shell pm verify-app-links --re-verify. <your-package-name>.
    • Controlla la presenza di errori di battitura: esamina attentamente i pattern matcher nelle regole per verificare la presenza di errori di sintassi.
    • Controlla le regole dei filtri per il file manifest: esamina le regole dei filtri per intent nel manifest dell'app per assicurarti che il percorso del link non venga filtrato. Se il link viene filtrato, rendi meno restrittivo il filtro per intent nel manifest dell'app.

Correggi gli errori di implementazione comuni

Se non riesci a verificare gli app link Android, controlla la presenza dei seguenti errori comuni. In questa sezione viene utilizzato example.com come nome di dominio segnaposto; quando esegui questi controlli, sostituisci example.com con il nome di dominio effettivo del server.

Configurazione errata del filtro per intent
Controlla se includi un URL di cui la tua app non è proprietaria in un <intent-filter> elemento.
Configurazione errata del server

Controlla la configurazione JSON del server e assicurati che il valore SHA sia corretto.

Inoltre, verifica che example.com. (con il punto finale) fornisca gli stessi contenuti di example.com.

Reindirizzamenti lato server

Il sistema non verifica alcun app link Android per la tua app se configuri un reindirizzamento come il seguente:

  • http://example.com a https://example.com
  • example.com a www.example.com

Questo comportamento protegge la sicurezza della tua app.

Robustezza del server

Controlla se le tue app client possono connettersi al server.

Link non verificabili

A scopo di test, potresti aggiungere intenzionalmente link non verificabili. Tieni presente che, su Android 11 e versioni precedenti, questi link impediscono al sistema di verificare tutti gli app link Android per la tua app.

Firma errata in assetlinks.json

Verifica che la firma sia corretta e corrisponda a quella utilizzata per firmare l'app. Gli errori comuni includono:

  • Firma dell'app con un certificato di debug e presenza solo della firma della release in assetlinks.json.
  • Presenza di una firma in minuscolo in assetlinks.json. La firma deve essere in maiuscolo.
  • Se utilizzi la firma dell'app di Google Play, assicurati di utilizzare la firma che Google utilizza per firmare ogni release. Puoi verificare questi dettagli, incluso uno snippet JSON completo, seguendo le istruzioni su come dichiarare le associazioni di siti web.

Acquisisci una segnalazione di bug

Per i problemi complessi difficili da riprodurre, acquisisci una segnalazione di bug e analizzala. In questo modo puoi ottenere informazioni preziose sulla procedura di verifica e su eventuali errori a livello di sistema.