Pour activer les liens universels sur iOS et les liens d'application sur Android, vous devez héberger deux fichiers JSON spécifiques sur votre serveur Web :

1. apple-app-site-association (AASA) pour iOS : Ce fichier indique à iOS quels chemins sur votre site Web doivent être gérés par votre application iOS.
2. assetlinks.json pour Android : Ce fichier indique à Android quels chemins sur votre site Web doivent être gérés par votre application Android.

Servir correctement ces fichiers est crucial pour que les liens profonds fonctionnent de manière transparente.

1. Hébergement du fichier apple-app-site-association (AASA) pour iOS

• Contenu du fichier : Le fichier AASA est un fichier JSON qui mappe les chemins de votre site Web à votre application. Une structure courante ressemble à ceci :

  json { "applinks": { "apps": [], "details": [ { "appID": "TEAM_ID.com.yourcompany.yourapp", "paths": [ "/app/*", "/links/to/content/*", "*" ] } ] } } * Remplacez TEAM_ID.com.yourcompany.yourapp par l'identifiant unique de votre application (ID d'équipe suivi de l'ID de bundle de votre application). * Le tableau paths spécifie quels chemins d'URL sur votre site Web doivent être gérés par l'application. "*" signifie tous les chemins.

• Exigences d'hébergement :

  • Emplacement : Le fichier doit être hébergé à la racine de votre domaine ou dans le répertoire .well-known. Par exemple :
    • https://yourdomain.com/.well-known/apple-app-site-association
    • https://yourdomain.com/apple-app-site-association (moins courant maintenant)
  • HTTPS : Le fichier doit être servi via HTTPS.
  • Type MIME : L'en-tête Content-Type doit être application/json ou application/json; charset=utf-8.
  • Pas de redirections : Le fichier AASA lui-même ne doit pas être redirigé.

• Vérification : Les appareils iOS téléchargent ce fichier lorsque votre application est installée. Vous pouvez tester son accessibilité à l'aide de l'outil de validation Apple ou simplement en essayant d'accéder à l'URL dans Safari.

2. Hébergement du fichier assetlinks.json pour Android

• Contenu du fichier : Le fichier assetlinks.json contient des informations sur votre application et le site Web auquel elle est associée.

  json [ { "relation": [ "delegate_permission/common.handle_all_urls" ], "target": { "namespace": "android.app", "package_name": "com.yourcompany.yourapp", "sha256_cert_fingerprints": [ "YOUR_APP_SHA256_FINGERPRINT" ] } } ] * Remplacez com.yourcompany.yourapp par le nom du package de votre application. * Remplacez YOUR_APP_SHA256_FINGERPRINT par l'empreinte SHA256 du certificat de signature de votre application (vous pouvez l'obtenir à partir de votre keystore ou de vos outils de build).

• Exigences d'hébergement :

  • Emplacement : Le fichier doit être hébergé à l'adresse https://yourdomain.com/.well-known/assetlinks.json. Le chemin .well-known est obligatoire.
  • HTTPS : Le fichier doit être servi via HTTPS.
  • Type MIME : L'en-tête Content-Type doit être application/json ou application/json; charset=utf-8.

• Vérification : Les appareils Android vérifient ce fichier pour valider l'association. Vous pouvez utiliser le validateur de l'API Google Asset Link pour vérifier votre fichier assetlinks.json.

3. Bonnes pratiques de configuration du serveur

• Service de fichiers statiques : Configurez votre serveur Web (par exemple, Nginx, Apache ou le service d'hébergement statique de votre fournisseur de cloud) pour servir ces fichiers JSON directement.
• Mise en cache : Soyez prudent lors de la mise en cache de ces fichiers. Bien que la mise en cache puisse améliorer les performances, elle peut également retarder la propagation des modifications si vous mettez à jour votre application ou l'association de votre site Web. Il est souvent recommandé de définir une durée de cache courte ou de désactiver la mise en cache pour ces fichiers spécifiques.
• Type de contenu : Assurez-vous que l'en-tête Content-Type correct est défini.
• Accessibilité : Assurez-vous que ces fichiers sont accessibles publiquement sans nécessiter d'authentification.

En hébergeant correctement ces fichiers d'association, vous activez les liens universels et les liens d'application, offrant une expérience plus fluide et plus intégrée à vos utilisateurs.