Qu’est-ce que le fichier apple-app-site-association ?

Les règles à respecter

Le fichier doit être servi en HTTPS, sans aucune redirection, et son nom ne prend pas d’extension .json. Chaque app y apparaît avec son identifiant complet, le Team ID suivi du bundle ID, par exemple ABCDE12345.com.exemple.app. Les règles paths ou components précisent ensuite quelles URL ouvrent l’app et lesquelles restent sur le site. Un pare-feu ou une page de connexion placés devant le fichier suffisent à empêcher Apple de le récupérer.

Pourquoi une modification ne s’applique pas tout de suite

Les iPhone ne téléchargent pas le fichier chez vous. C’est le CDN d’Apple qui le récupère, en garde une copie et la transmet à l’appareil quand l’app est installée ou mise à jour. Une correction publiée sur votre serveur peut donc mettre du temps à être prise en compte. En cas de doute, comparez votre version avec celle que sert le CDN.

Termes associés

• Universal Links

  Les Universal Links (liens universels) sont des liens https classiques qu’iOS ouvre directement dans votre app quand elle est installée, et sur votre site web sinon. Apple les a introduits avec iOS 9. Ils reposent sur une association vérifiée entre l’app et le domaine : l’entitlement Associated Domains d’un côté, le fichier apple-app-site-association de l’autre.

• assetlinks.json

  assetlinks.json est le fichier Digital Asset Links qu’Android consulte pour vérifier vos App Links. Publié à l’adresse /.well-known/assetlinks.json de votre domaine, il déclare qu’une app, désignée par son nom de package et par l’empreinte SHA-256 de son certificat de signature, a le droit d’ouvrir les liens de ce domaine.