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 app link di Android Studio. Per saperne di più, consulta Strumenti per sviluppatori di link per app.

  • 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 uno strumento di convalida 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> nel tuo AndroidManifest.xml includa android:autoVerify="true".
    • Controlla i 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 di filtro del file manifest: esamina le regole di filtro degli intent nel file manifest dell'app per assicurarti che il percorso del link non venga filtrato. Se il link viene filtrato, rendi il filtro per intent nel manifest dell'app meno restrittivo.

Correggere gli errori di implementazione comuni

Se non riesci a verificare i tuoi Android App Links, controlla i seguenti errori comuni. Questa sezione utilizza example.com come segnaposto per il nome di dominio; quando esegui questi controlli, sostituisci example.com con il nome di dominio effettivo del tuo server.

Configurazione del filtro per intent non corretta
Controlla se includi un URL non di proprietà della tua app in un elemento <intent-filter>.
Configurazione del server errata

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

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

Reindirizzamenti lato server

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

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

Questo comportamento protegge la sicurezza della tua app.

Robustezza del server

Controlla se le 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 i link app Android per la tua app.

Firma errata in assetlinks.json

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

  • Firma dell'app con un certificato di debug e presenza della sola firma di rilascio in assetlinks.json.
  • Avere 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 usa per firmare ogni release. Puoi verificare questi dettagli, incluso uno snippet JSON completo, seguendo le istruzioni per dichiarare le associazioni di siti web.