Appy

Deep linking

Cos’è il file assetlinks.json?

In breve

assetlinks.json è il file Digital Asset Links che Android consulta per verificare i tuoi App Links. Pubblicato all’indirizzo /.well-known/assetlinks.json del tuo dominio, dichiara che un’app, identificata dal package name e dall’impronta SHA-256 del certificato di firma, può aprire i link di quel dominio.

Cosa contiene

Un elenco di dichiarazioni. Ognuna collega la relazione delegate_permission/common.handle_all_urls a un target: il package_name dell’app e un array sha256_cert_fingerprints. Puoi inserire più impronte, per esempio quella della chiave di Play App Signing e quella di una build di test firmata con un’altra chiave. Android lo richiede su ogni host dichiarato nell’app: esempio.com e www.esempio.com contano come due host, ognuno con il suo file.

Cosa fa fallire la verifica

Il file va servito in HTTPS, senza redirect, con un content type JSON. Basta un redirect da esempio.com a www.esempio.com per bloccare tutto. L’altro classico è un’impronta che non corrisponde al certificato che ha davvero firmato l’app installata sul telefono. L’utente non vede alcun errore: i link si aprono semplicemente nel browser, oppure Android chiede quale app usare.

EsempioDove si trova il file
https://esempio.com/.well-known/assetlinks.json
Per approfondireValidatore di link universaliControlla il tuo assetlinks.json e il file AASA, compresa la copia servita dalla CDN di Apple.
  • Android App Links

    Gli Android App Links sono link https verificati che Android, dalla versione 6.0 e sui dispositivi con i servizi Google, apre direttamente nella tua app, senza chiedere all’utente quale app usare. La verifica si basa su due elementi: un intent filter con android:autoVerify="true" nell’app e un file assetlinks.json pubblicato sul dominio.

  • apple-app-site-association (AASA)

    Il file apple-app-site-association, o AASA, è un file JSON pubblicato sul tuo dominio all’indirizzo /.well-known/apple-app-site-association. Dice a iOS quali app possono aprire i link di quel dominio, ognuna identificata da Team ID e bundle ID, e per quali percorsi. Senza questo file gli Universal Links non funzionano.

Tutto il glossario

Un solo link per App Store, Google Play e web

Crea uno smart link con il suo QR code: ogni telefono arriva allo store giusto, ogni computer al tuo sito. Gratis fino a 4 link, senza pubblicità.