Enrutamiento de AID en Android HCE: cómo elige tu teléfono qué app responde
Cuando un lector envía SELECT AID, Android elige un servicio HCE que responda. Así deciden la tabla de enrutamiento, los grupos y categorías de AID y las reglas de conflicto.
Introducción
Cuando acercas un teléfono Android a un lector, responde exactamente una app, aunque varias puedan emular una tarjeta. Android decide con el identificador de aplicación (AID) que pide el lector, una tabla de enrutamiento en el controlador NFC y una breve lista de reglas de conflicto. Esta guía recorre ese camino para la emulación de tarjeta en el host (HCE), que Android admite desde la versión 4.4.
Qué envía realmente el lector
Lo primero que suele enviar un lector es un comando SELECT AID. Es una APDU transportada sobre ISO-DEP que contiene un AID de hasta 16 bytes con el nombre de la aplicación que quiere el lector. Según la guía de HCE de Android, Android extrae ese AID, lo resuelve a un servicio HCE y le reenvía la APDU.
A partir de ahí, el servicio recibe todas las APDU del lector, hasta que este envíe otro SELECT AID que se resuelva a un servicio distinto o hasta que se corte el enlace NFC. En ambos casos se ejecuta la devolución de llamada onDeactivated() del servicio.
Dos capas: la tabla del controlador y luego Android
El enrutamiento ocurre dos veces. Primero, el controlador NFC mantiene una tabla de reglas, cada una con un AID y un destino: la CPU del host o un elemento seguro. Cuando llega SELECT AID, el controlador consulta su tabla. Si hay coincidencia, esa APDU y todas las siguientes van al destino correspondiente.
Si el AID no está en la tabla, el controlador usa su ruta predeterminada. Los dispositivos Android deben asegurarse de que los AID que registra tu app lleguen al host. Tú nunca construyes esta tabla: Android la configura a partir de los servicios instalados y las preferencias del usuario. Además, Android no admite en los dispositivos HCE la idea de coincidencias parciales de AID de ISO 7816-4.
Segundo, cuando la APDU llega al host, Android resuelve el AID a un servicio. Las apps que guardan su tarjeta en un elemento seguro declaran en su lugar un servicio fuera del host. Android nunca inicia ni se vincula a esos servicios, porque la transacción la gestiona el elemento seguro.
Grupos y categorías de AID
Un servicio registra los AID en grupos. Para todos los AID de un grupo, Android garantiza uno de dos resultados: todos se enrutan a tu servicio o ninguno lo hace. Nunca va la mitad de un grupo a otra app.
Cada grupo tiene además una categoría, payment u other. Solo puede estar habilitado un grupo de la categoría de pago a la vez. Las tarjetas de circuito cerrado, como una tarjeta de saldo que funciona en un único comercio, van en other, donde los grupos pueden estar activos todo el tiempo. Una app de la categoría de pago solo puede atender un toque si el usuario la configuró como app de pago predeterminada (el rol Wallet en Android 15 y posteriores) o si está en primer plano y ha llamado a setPreferredService.
Quién gana un conflicto
Varios servicios pueden registrar el mismo AID. Android lo resuelve en este orden:
- Si la app de billetera predeterminada del usuario registró el AID, se invoca esa app.
- Si no, se invoca el servicio que registró el AID.
- Si más de un servicio lo registró, Android pregunta al usuario.
Una app en primer plano puede anular todo eso. La referencia de CardEmulation describe setPreferredService: llámalo en onResume() y llama a unsetPreferredService en onPause(), porque el sistema no conserva la preferencia. La llamada puede fallar si el usuario ha impedido que las apps en primer plano anulen el servicio de pago predeterminado.
Los AID suelen venir de apduservice.xml en el manifiesto, escritos en hexadecimal con un número par de caracteres. Las apps también pueden llamar a registerAidsForService, que sustituye la lista anterior de esa categoría. Algunos dispositivos aceptan un prefijo de AID como A000000004*, y supportsAidPrefixRegistration() te dice si el tuyo lo permite.
Cuando responde la app equivocada
Si un toque llega a la app equivocada, repasa esta lista:
- ¿Está dividido el grupo de AID? Reúne en un solo grupo los AID que van juntos.
- ¿Es otra app la billetera predeterminada? Gana a tu servicio en cualquier AID que haya registrado.
- ¿Está tu grupo en
paymentcuando debería estar enother? - ¿Dependes de la coincidencia por prefijo en un dispositivo que no la ofrece?
- ¿Olvidaste volver a llamar a
setPreferredServicedespués de que la actividad se reanudara?
NFCore lee, escribe e inspecciona etiquetas NFC en iOS y Android. No sirve para rastrear el enrutamiento HCE, así que para estas comprobaciones usa un segundo lector y observa qué servicio registra el SELECT AID.
Conclusión
Android responde a un toque en dos pasos: la tabla de enrutamiento del controlador NFC envía el AID al host o a un elemento seguro, y luego Android elige un servicio según la billetera predeterminada, el único registrante o la decisión del usuario, con una app en primer plano capaz de anularlo. Mantén los AID relacionados en un solo grupo, elige la categoría correcta y fija el servicio preferido en cada reanudación.
Preguntas frecuentes
¿Cómo decide Android qué app HCE responde a un toque?
El lector envía SELECT AID. Android resuelve ese AID a un servicio: la app de billetera predeterminada si registró el AID y, si no, el único servicio que lo registró. Si lo registraron varios, pregunta al usuario. Una app en primer plano que use setPreferredService anula este orden.
¿Pueden dos apps registrar el mismo AID?
Sí. Android lo permite y resuelve el conflicto en el momento del toque con el orden anterior. Si más de un servicio registró el AID y ninguno es el preferido, se pregunta al usuario.
¿Admite Android la coincidencia por prefijo de AID?
Las coincidencias parciales de ISO 7816-4 no se admiten en los dispositivos Android con HCE, pero algunos dispositivos permiten a una app registrar un prefijo de AID. Llama a supportsAidPrefixRegistration() para comprobarlo.
¿Se puede dividir un grupo de AID entre dos apps?
No. O todos los AID del grupo se enrutan al servicio o ninguno lo hace.