Appy

Deep linking

Cos’è il file apple-app-site-association?

In breve

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.

Le regole da rispettare

Il file va servito in HTTPS, senza alcun redirect, e il nome non ha l’estensione .json. Ogni app compare con il suo identificativo completo, cioè il Team ID seguito dal bundle ID, per esempio ABCDE12345.com.esempio.app. Le regole paths o components stabiliscono poi quali URL aprono l’app e quali restano sul sito. Basta un firewall o una pagina di login davanti al file per impedire ad Apple di recuperarlo.

Perché una modifica non vale subito

Gli iPhone non scaricano il file dal tuo server. È la CDN di Apple a recuperarlo, a conservarne una copia e a consegnarla al dispositivo quando l’app viene installata o aggiornata. Una correzione pubblicata sul tuo server può quindi richiedere tempo prima di essere recepita. Nel dubbio, confronta la tua versione con quella servita dalla CDN.

EsempioDove si trova il file
https://esempio.com/.well-known/apple-app-site-association
Per approfondireGeneratore di AASA e assetlinks.jsonInserisci i dati della tua app e ottieni un file pronto da caricare sul dominio.
  • Universal Links

    Gli Universal Links (link universali) sono normali link https che iOS apre direttamente nella tua app se è installata, e sul tuo sito web se non lo è. Apple li ha introdotti con iOS 9. Si basano su un’associazione verificata tra app e dominio: l’entitlement Associated Domains da una parte, il file apple-app-site-association dall’altra.

  • assetlinks.json

    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.

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à.