Android Application Records (AAR): So öffnet ein NFC-Tag deine App
Ein Android Application Record (AAR) speichert den Paketnamen deiner App in einem NDEF-Record. Beim Scannen des Tags startet Android die App oder führt zu Google Play, falls sie nicht installiert ist.
Was ein Android Application Record ist
Ein Android Application Record (AAR) ist ein NDEF-Record, der den Paketnamen einer App enthält. Wenn du einen AAR in die Nachricht eines Tags schreibst, startet Android beim Scannen des Tags diese App oder leitet zu Google Play weiter, damit sie installiert werden kann.
AARs wurden mit Android 4.0 (API-Level 14) eingeführt. Der Android-NFC-Leitfaden beschreibt sie als Möglichkeit, "mit größerer Sicherheit" zu erreichen, dass deine Anwendung beim Scannen eines NFC-Tags gestartet wird. Du erstellst einen AAR mit NdefRecord.createApplicationRecord(packageName), und laut API-Referenz kannst du ihn an beliebiger Stelle in die Nachricht einbetten.
val message = NdefMessage(
arrayOf(
NdefRecord.createUri("https://example.com/start"),
NdefRecord.createApplicationRecord("com.example.myapp")
)
)
Android durchsucht die gesamte NDEF-Nachricht nach AARs, der Record braucht also keinen besonderen Platz. Er benötigt nur den exakten Paketnamen der App, so wie er in ihrem Google-Play-Eintrag steht.
Wie Android entscheidet, welche App sich öffnet
Ohne AAR kann jede App mit passendem Intent-Filter den Tag für sich beanspruchen. Mit AAR geht Android in drei Schritten vor, in dieser Reihenfolge:
- Android versucht, eine Activity mit passendem Intent-Filter zu starten. Gehört diese Activity zu der App aus dem AAR, wird sie gestartet.
- Gehört die passende Activity nicht zur App aus dem AAR, kommen mehrere Activities für den Intent infrage oder kann keine ihn verarbeiten, startet Android die im AAR genannte App.
- Kann keine App über den AAR gestartet werden, öffnet Android Google Play, damit sie heruntergeladen werden kann.
Ein AAR umgeht die Intent-Filter nicht. Er entscheidet, wer gewinnt, wenn mehrere Apps konkurrieren. Laut Android-Leitfaden sind AARs nützlich, um zu verhindern, dass andere Anwendungen nach demselben Intent filtern und womöglich bestimmte Tags verarbeiten, die du ausgebracht hast. Das ist wichtig, wenn du Tags an Kunden auslieferst, die vielleicht andere NFC-Apps installiert haben.
AARs arbeiten nur auf App-Ebene. Du kannst mit ihnen nicht auf einen bestimmten Bildschirm zielen. Um eine bestimmte Activity zu öffnen, nutzt du stattdessen Intent-Filter auf den URI- oder MIME-Record.
Was passiert, wenn die App nicht installiert ist
Android öffnet Google Play für das Paket aus dem AAR. Die Referenzseite beschreibt das als Market-Link, der für die erste aufgeführte App geöffnet wird. Dadurch wird aus einem Tag eine Installationsaufforderung, praktisch für einen Produktaufkleber oder ein Plakat. Für Tags, die gar keine App brauchen, siehe was einen Tag liest, wenn keine App beteiligt ist.
Enthält eine Nachricht mehrere AARs, sind laut Referenz die Apps "in der Reihenfolge, in der sie in der Nachricht erscheinen" die bevorzugten Ziele.
Wo der AAR in der Nachricht stehen sollte
Setze ihn nicht an die erste Stelle, es sei denn, er ist der einzige Record. Der Leitfaden erklärt den Grund: Android liest den ersten Record, um den MIME-Typ oder die URI zu ermitteln, aus der es den Intent baut. Steht der AAR an erster Stelle, gibt es nichts, was die Intent-Filter abgleichen könnten.
Setze den URI- oder MIME-Record an den Anfang und den AAR ans Ende, wie im Beispiel oben. Der Leitfaden empfiehlt außerdem, AARs mit MIME-Typen oder URIs zu kombinieren, um möglichst viele Geräte zu erreichen, da AARs nur für Android 4.0 und neuer gelten. Die Android-Seiten sagen nicht, wie andere Plattformen einen AAR behandeln, verlass dich also bei iPhones nicht darauf. Ein URL-Record gibt ihnen etwas zum Öffnen; eine URL-Alternative für das iPhone ergänzen zeigt die Idee an einem WLAN-Tag.
Wo ein AAR nicht helfen kann
- Foreground Dispatch hat Vorrang. Ein AAR setzt sich nicht über eine App hinweg, die
enableForegroundDispatchaufgerufen hat. Die Seite Advanced NFC sagt, dass dieses System einer Activity erlaubt, "Vorrang vor anderen Activities zu beanspruchen, die denselben Intent verarbeiten". - Neuere Android-Versionen bringen Nutzerkontrollen mit. Ab Android 16 werden Nutzer benachrichtigt, wenn eine App ihren ersten NFC-Intent erhält, und können ihn unter "Launch via NFC" blockieren. Android 17 verlangt für Apps, die neuere SDKs anvisieren, die Berechtigung
DISPATCH_NFC_MESSAGEund liefert keine NFC-Intents mehr an gestoppte Apps aus. Der Android-Leitfaden sagt nicht, wie sich das auf das Starten per AAR auswirkt, teste also auf aktuellen Smartphones. - Eine Handyhülle oder ein fehlerhaftes Schreiben kann gleich aussehen. Wenn du No supported app for this NFC tag siehst, prüfe den Inhalt des Tags, bevor du dem AAR die Schuld gibst.
Um zu bestätigen, dass ein Tag wirklich einen AAR enthält, lies seine Records mit einem Tag-Reader aus. NFCore zeigt, was auf einem Tag gespeichert ist, und es gibt auch eine Android-Version.
Kurz zusammengefasst
Nutze einen AAR, wenn ein Tag eine bestimmte Android-App öffnen oder Menschen zur Installation führen soll. Halte den Paketnamen exakt, setze den AAR hinter einen URI- oder MIME-Record und rechne damit, dass Apps im Vordergrund und neuere Datenschutzkontrollen von Android Vorrang haben. Teste den fertigen Tag immer auf einem echten Smartphone.
Häufig gestellte Fragen
Funktioniert ein AAR auf dem iPhone?
Die Android-Dokumentation stellt AARs als Android-Funktion dar (ab Android 4.0) und sagt nicht, wie andere Plattformen sie behandeln. Kombiniere den AAR mit einem URL- oder MIME-Record, damit der Tag auch anderswo etwas Sinnvolles tut, und teste auf den Geräten, die dir wichtig sind.
Was passiert, wenn die App nicht installiert ist?
Android öffnet Google Play, damit die Person die im AAR genannte App herunterladen kann.
Kann ein AAR einen bestimmten Bildschirm in meiner App öffnen?
Nein. AARs arbeiten auf App-Ebene, nicht auf Activity-Ebene. Um eine bestimmte Activity zu erreichen, nutze Intent-Filter auf den anderen Records der Nachricht.