Android Application Records (AAR): haz que una etiqueta NFC abra tu app
Un Android Application Record (AAR) guarda el nombre de paquete de tu app en un registro NDEF. Al escanear la etiqueta, Android inicia esa app o lleva a la persona a Google Play si no está instalada.
Qué es un Android Application Record
Un Android Application Record (AAR) es un registro NDEF que contiene el nombre de paquete de una app. Si lo incluyes en el mensaje de una etiqueta, Android inicia esa app al escanearla, o lleva a la persona a Google Play para instalarla.
Los AAR llegaron con Android 4.0 (nivel de API 14). La guía de NFC de Android los describe como una forma de lograr "una mayor certeza de que tu aplicación se inicia cuando se escanea una etiqueta NFC". Se crean con NdefRecord.createApplicationRecord(packageName), y la referencia de la API indica que puedes incluirlo en cualquier posición del mensaje.
val message = NdefMessage(
arrayOf(
NdefRecord.createUri("https://example.com/start"),
NdefRecord.createApplicationRecord("com.example.myapp")
)
)
Android recorre todo el mensaje NDEF en busca de AAR, así que el registro no necesita un lugar especial. Solo necesita el nombre de paquete exacto de la app, el que aparece en su ficha de Google Play.
Cómo decide Android qué app se abre
Sin un AAR, cualquier app con un filtro de intents compatible puede quedarse con la etiqueta. Con uno, Android sigue tres pasos, en este orden:
- Intenta abrir una actividad con un filtro de intents que coincida. Si esa actividad pertenece a la app del AAR, se inicia.
- Si la actividad que coincide no pertenece a la app del AAR, si varias actividades pueden gestionar el intent o si ninguna puede, Android inicia la app indicada en el AAR.
- Si ninguna app puede iniciarse a partir del AAR, Android va a Google Play para descargarla.
Un AAR no se salta los filtros de intents: decide quién gana cuando varias apps compiten. La guía de Android dice que los AAR sirven "para evitar que otras aplicaciones filtren el mismo intent y gestionen posiblemente las etiquetas que has desplegado". Eso importa si entregas etiquetas a clientes que pueden tener otras apps NFC instaladas.
Los AAR funcionan solo a nivel de app. No puedes apuntar uno a una pantalla concreta. Para llegar a una actividad específica, usa filtros de intents sobre el registro URI o MIME.
Qué pasa si la app no está instalada
Android abre Google Play con el paquete del AAR. La página de referencia lo describe como un enlace de mercado que se abre para la primera app de la lista. Eso convierte una etiqueta en una invitación a instalar, útil en una pegatina de producto o en un cartel. Para etiquetas que no necesitan ninguna app, mira qué lee una etiqueta cuando no hay una app de por medio.
Si un mensaje contiene varios AAR, la referencia dice que las apps son los destinos preferidos "en el orden en que aparecen en el mensaje".
Dónde colocar el AAR en el mensaje
No lo pongas primero, salvo que sea el único registro. La guía explica el motivo: Android lee el primer registro para determinar el tipo MIME o el URI con el que construye el intent. Un AAR en la primera posición no deja nada que los filtros de intents puedan comparar.
Pon primero el registro URI o MIME y el AAR al final, como en el ejemplo anterior. La guía también recomienda combinar los AAR con tipos MIME o URI para llegar a la mayor variedad de dispositivos, porque los AAR son propios de Android 4.0 y posteriores. Las páginas de Android no dicen cómo tratan otras plataformas un AAR, así que no cuentes con él en iPhone. Un registro URL les da algo que abrir; añade una URL de respaldo para iPhone muestra la idea con una etiqueta Wi-Fi.
Dónde un AAR no ayuda
- Gana el foreground dispatch. Un AAR no se impone a una app que haya llamado a
enableForegroundDispatch. La página de NFC avanzado dice que ese sistema permite a una actividad "reclamar prioridad sobre otras actividades que gestionan el mismo intent". - Las versiones recientes de Android añaden controles al usuario. Desde Android 16, se avisa a la persona cuando una app recibe su primer intent NFC y puede bloquearlo en "Launch via NFC". Android 17 añade el requisito del permiso
DISPATCH_NFC_MESSAGEpara apps que apuntan a SDK más nuevos, y deja de enviar intents NFC a apps detenidas. La guía de Android no dice cómo afecta esto a los lanzamientos por AAR, así que prueba en teléfonos actuales. - Una funda o una mala escritura pueden verse igual. Si ves No supported app for this NFC tag, revisa el contenido de la etiqueta antes de culpar al AAR.
Para confirmar que una etiqueta lleva de verdad un AAR, vuelve a leer sus registros con un lector de etiquetas. NFCore muestra lo que hay guardado en una etiqueta, y también existe la versión para Android.
Resumen rápido
Usa un AAR cuando una etiqueta deba abrir una app concreta de Android o llevar a instalarla. Escribe el nombre de paquete exacto, coloca el AAR después de un registro URI o MIME, y espera que las apps en primer plano y los nuevos controles de privacidad de Android tengan prioridad. Prueba siempre la etiqueta terminada en un teléfono real.
Preguntas frecuentes
¿Funciona un AAR en iPhone?
La documentación de Android presenta los AAR como una función de Android (4.0 y posteriores) y no dice cómo los tratan otras plataformas. Combina el AAR con un registro URL o MIME para que la etiqueta siga siendo útil en otros dispositivos, y prueba en los equipos que te importen.
¿Qué pasa si la app no está instalada?
Android abre Google Play para que la persona pueda descargar la app indicada en el AAR.
¿Puede un AAR abrir una pantalla concreta de mi app?
No. Los AAR funcionan a nivel de app, no de actividad. Para llegar a una actividad determinada, usa filtros de intents sobre los otros registros del mensaje.