Ouvrir les liens dans votre application (deep linking)

Nécessite des modifications de votre application

1. Étape 1

   Avant de commencer

   Il faut téléverser deux fichiers, ce que vous pouvez faire vous-même si vous avez les valeurs nécessaires, mais les modifications de l’application et les nouvelles versions demandent un développeur. Il vous faut un domaine personnalisé actif — voir Configurer un domaine personnalisé.
2. Étape 2

   Ajouter le fichier iOS

   Dans Settings > Custom Domains, ouvrez le domaine et son panneau Open in app, puis choisissez Build it for me à côté d’iOS. Saisissez deux valeurs de votre application :
   • App ID Prefix — dix caractères, sous « Membership » sur developer.apple.com (généralement votre Team ID)
   • Bundle ID — dans Xcode, comme com.example.app
   Vérifiez le fichier et enregistrez-le. Si vous avez déjà un fichier apple-app-site-association, téléversez-le à la place.

   

3. Étape 3

   Ajouter le fichier Android

   Google Play Console affiche le fichier de votre application : sur la page App integrity de l’application, sous App signing, copiez le Digital Asset Links JSON. Enregistrez-le sous le nom assetlinks.json et téléversez-le à côté d’Android dans le même panneau.

   

4. Étape 4

   Déclarer le domaine dans l’application iOS

   Dans Xcode, ouvrez Signing & Capabilities de votre cible, ajoutez Associated Domains, puis ajoutez une entrée pour votre domaine :

   applinks:get.example.com

   Gérez ensuite le lien entrant dans l’application — l’URL arrive sous forme de « user activity » — et affichez le contenu correspondant. Apple décrit les deux dans Supporting associated domains.
5. Étape 5

   Déclarer le domaine dans l’application Android

   Dans AndroidManifest.xml, ajoutez un intent filter à l’activité qui doit ouvrir les liens :

   <intent-filter android:autoVerify="true">
     <action android:name="android.intent.action.VIEW" />
     <category android:name="android.intent.category.DEFAULT" />
     <category android:name="android.intent.category.BROWSABLE" />
     <data android:scheme="https" android:host="get.example.com" />
   </intent-filter>

   Gérez ensuite le lien entrant dans cette activité et affichez le contenu correspondant. Google décrit les deux dans Verify Android App Links.
6. Étape 6

   Choisir quels liens ouvrent quelle application

   Avec la configuration ci-dessus, chaque lien du domaine ouvre votre application. Pour n’ouvrir que certains liens, ou pour partager le domaine entre plusieurs applications, associez des chemins précis à chaque application :
   • iOS : votre application déclare seulement le domaine. Le fichier téléversé définit quels chemins ouvrent quelle application.
   • Android : votre application déclare le domaine et ses chemins. Le fichier téléversé indique seulement quelles applications peuvent utiliser le domaine.
   Sur iOS, rédigez votre propre apple-app-site-association avec les chemins de chaque application, ou avec une règle d’exclusion pour retirer un seul lien, puis téléversez-le. Aucune mise à jour de l’application n’est nécessaire. Les nouvelles installations reçoivent la modification en un jour environ, et les applications déjà installées la reçoivent au cours des jours suivants.
   Sur Android, les chemins se trouvent dans l’intent filter de chaque application, par exemple android:pathPrefix="/webshop" ; une modification nécessite donc une mise à jour de l’application.
7. Étape 7

   Téléverser d’abord, publier ensuite

   Mettez les deux fichiers en place avant que les nouvelles versions de l’application n’arrivent dans les boutiques. Android vérifie le domaine une seule fois, lors de l’installation ou de la mise à jour de l’application, et Apple mémorise un fichier manquant pendant environ une journée — une application publiée avant que son fichier soit en ligne n’ouvrira pas les liens pour ses premiers utilisateurs.
8. Étape 8

   Tester sur un appareil

   Saisir le lien dans la barre d’adresse du navigateur n’ouvre pas les applications, sur aucune des deux plateformes. Installez plutôt la nouvelle version et touchez un lien vers votre domaine dans Notes, Messages ou un email.
   Un appui qui ouvre l’application va directement à l’application ; il n’apparaît donc pas dans les statistiques de votre Onelink.