Android Application Record (AAR) : faire ouvrir votre application par un tag NFC
Un Android Application Record (AAR) stocke le nom de package de votre application dans un enregistrement NDEF. Scannez le tag et Android lance cette application, ou envoie la personne sur Google Play si elle n'est pas installée.
Qu'est-ce qu'un Android Application Record
Un Android Application Record (AAR) est un enregistrement NDEF qui contient le nom de package d'une application. Si vous en placez un dans le message d'un tag, Android lance cette application lorsque le tag est scanné, ou envoie la personne sur Google Play pour l'installer.
Les AAR sont apparus avec Android 4.0 (API level 14). Le guide NFC d'Android les décrit comme un moyen d'obtenir « une plus grande certitude que votre application est lancée lorsqu'un tag NFC est scanné ». Vous en créez un avec NdefRecord.createApplicationRecord(packageName), et la référence de l'API indique que vous pouvez l'intégrer n'importe où dans le message.
val message = NdefMessage(
arrayOf(
NdefRecord.createUri("https://example.com/start"),
NdefRecord.createApplicationRecord("com.example.myapp")
)
)
Android parcourt l'ensemble du message NDEF à la recherche d'AAR, l'enregistrement n'a donc pas besoin d'un emplacement particulier. Il lui faut simplement le nom de package exact de l'application, celui qui apparaît dans sa fiche Google Play.
Comment Android choisit l'application à ouvrir
Sans AAR, n'importe quelle application dotée d'un intent filter correspondant peut s'approprier le tag. Avec un AAR, Android procède en trois étapes, dans cet ordre :
- Il essaie une activité dont l'intent filter correspond. Si cette activité appartient à l'application désignée dans l'AAR, elle est lancée.
- Si l'activité correspondante n'appartient pas à l'application de l'AAR, si plusieurs activités peuvent traiter l'intent, ou si aucune ne le peut, Android lance l'application désignée dans l'AAR.
- Si aucune application ne peut être lancée à partir de l'AAR, Android ouvre Google Play pour la télécharger.
Un AAR ne contourne pas les intent filters. Il tranche la question lorsque plusieurs applications se disputent le tag. Le guide Android précise que les AAR sont utiles « pour empêcher d'autres applications de filtrer le même intent et de traiter potentiellement les tags spécifiques que vous avez déployés ». C'est important si vous distribuez des tags à des clients qui ont peut-être d'autres applications NFC installées.
Les AAR fonctionnent uniquement au niveau de l'application. Vous ne pouvez pas en cibler un écran en particulier. Pour arriver sur une activité précise, utilisez plutôt des intent filters sur l'enregistrement URI ou MIME.
Que se passe-t-il si l'application n'est pas installée
Android ouvre Google Play sur le package indiqué dans l'AAR. La page de référence décrit cela comme un lien market ouvert pour la première application listée. C'est ce qui transforme un tag en invitation à installer l'appli, pratique pour un autocollant sur un produit ou une affiche. Pour les tags qui n'ont besoin d'aucune application, consultez ce qui lit un tag quand aucune application n'intervient.
Si un message contient plusieurs AAR, la référence indique que les applications sont les cibles privilégiées « dans l'ordre où elles apparaissent dans le message ».
Où placer l'AAR dans le message
Ne le placez pas en premier, sauf s'il est le seul enregistrement. Le guide l'explique : Android lit le premier enregistrement pour déterminer le type MIME ou l'URI à partir duquel il construit l'intent. Un AAR en première position ne laisse rien à faire correspondre aux intent filters.
Placez l'enregistrement URI ou MIME en premier et l'AAR en dernier, comme dans l'exemple ci-dessus. Le guide recommande aussi de combiner les AAR avec des types MIME ou des URI pour toucher le plus grand nombre d'appareils, car les AAR sont propres à Android 4.0 et versions ultérieures. Les pages Android n'indiquent pas comment les autres plateformes traitent un AAR, ne comptez donc pas dessus pour les iPhone. Un enregistrement URL leur donne quelque chose à ouvrir ; ajouter une URL de secours pour iPhone illustre l'idée sur un tag Wi-Fi.
Là où un AAR ne peut rien
- Le foreground dispatch est prioritaire. Un AAR ne prend pas le pas sur une application qui a appelé
enableForegroundDispatch. La page Advanced NFC indique que ce système permet à une activité de « prendre la priorité sur les autres activités qui traitent le même intent ». - Les versions récentes d'Android ajoutent des contrôles pour l'utilisateur. À partir d'Android 16, les utilisateurs sont notifiés lorsqu'une application reçoit son premier intent NFC et peuvent le bloquer sous « Launch via NFC ». Android 17 ajoute l'exigence de la permission
DISPATCH_NFC_MESSAGEpour les applications ciblant des SDK récents, et cesse de distribuer les intents NFC aux applications arrêtées. Le guide Android n'explique pas l'effet de ces changements sur les lancements par AAR, testez donc sur des téléphones récents. - Une coque de téléphone ou une mauvaise écriture peuvent donner le même résultat. Si vous voyez No supported app for this NFC tag, vérifiez le contenu du tag avant d'accuser l'AAR.
Pour vérifier qu'un tag contient bien un AAR, relisez ses enregistrements avec un lecteur de tags. NFCore affiche ce qui est stocké sur un tag, et il existe aussi une version Android.
En bref
Utilisez un AAR lorsqu'un tag doit ouvrir une application Android précise, ou inviter à l'installer. Veillez à ce que le nom de package soit exact, placez l'AAR après un enregistrement URI ou MIME, et attendez-vous à ce que les applications au premier plan et les contrôles de confidentialité des versions récentes d'Android soient prioritaires. Testez toujours le tag terminé sur un vrai téléphone.
Questions fréquentes
Un AAR fonctionne-t-il sur iPhone ?
La documentation Android présente les AAR comme une fonctionnalité d'Android (Android 4.0 et versions ultérieures) et n'indique pas comment les autres plateformes les traitent. Associez l'AAR à un enregistrement URL ou MIME pour que le tag serve à quelque chose ailleurs aussi, et testez sur les appareils qui comptent pour vous.
Que se passe-t-il si l'application n'est pas installée ?
Android ouvre Google Play pour que la personne puisse télécharger l'application désignée dans l'AAR.
Un AAR peut-il ouvrir un écran précis de mon application ?
Non. Les AAR fonctionnent au niveau de l'application, pas de l'activité. Pour atteindre une activité donnée, utilisez des intent filters sur les autres enregistrements du message.