Android Application Records (AAR): Faça uma tag NFC abrir o seu app
Um Android Application Record (AAR) guarda o nome do pacote do seu app em um registro NDEF. Ao aproximar a tag, o Android abre esse app ou leva a pessoa ao Google Play se ele não estiver instalado.
O que é um Android Application Record
Um Android Application Record (AAR) é um registro NDEF que guarda o nome do pacote de um app. Coloque um na mensagem de uma tag e o Android abre esse app quando a tag é lida, ou leva a pessoa ao Google Play para instalá-lo.
Os AARs surgiram no Android 4.0 (API level 14). O guia de NFC do Android os descreve como uma forma de ter "a stronger certainty that your application is started when an NFC tag is scanned" (uma certeza maior de que o seu aplicativo será iniciado quando uma tag NFC for lida). Você cria um com NdefRecord.createApplicationRecord(packageName), e a referência da API diz que ele pode ser incluído em qualquer posição da mensagem.
val message = NdefMessage(
arrayOf(
NdefRecord.createUri("https://example.com/start"),
NdefRecord.createApplicationRecord("com.example.myapp")
)
)
O Android procura AARs em toda a mensagem NDEF, então o registro não precisa de um lugar especial. Ele só precisa do nome exato do pacote do app, o mesmo que aparece na página do app no Google Play.
Como o Android decide qual app abrir
Sem um AAR, qualquer app com um intent filter compatível pode assumir a tag. Com um AAR, o Android segue três passos, nesta ordem:
- Ele tenta uma activity com um intent filter compatível. Se essa activity pertencer ao app indicado no AAR, ela é iniciada.
- Se a activity compatível não pertencer ao app do AAR, se várias activities puderem tratar o intent ou se nenhuma puder, o Android inicia o app indicado no AAR.
- Se nenhum app puder ser iniciado a partir do AAR, o Android abre o Google Play para baixá-lo.
Um AAR não ignora os intent filters. Ele resolve quem vence quando os apps competem. O guia do Android diz que os AARs são úteis "to prevent other applications from filtering for the same intent and potentially handling specific tags that you have deployed" (para impedir que outros aplicativos filtrem o mesmo intent e possivelmente tratem tags específicas que você distribuiu). Isso importa se você entrega tags a clientes que podem ter outros apps NFC instalados.
Os AARs funcionam apenas no nível do app. Não dá para apontar um deles para uma tela específica. Para abrir uma activity específica, use intent filters no registro de URI ou MIME.
O que acontece quando o app não está instalado
O Android abre o Google Play na página do pacote indicado no AAR. A página de referência descreve isso como um link do market aberto para o primeiro app listado. É isso que transforma uma tag em um convite de instalação, útil para um adesivo de produto ou um pôster. Para tags que não precisam de app nenhum, veja o que lê uma tag quando nenhum app está envolvido.
Se uma mensagem tiver vários AARs, a referência diz que os apps são alvos preferenciais "in the order in which they appear in the message" (na ordem em que aparecem na mensagem).
Onde colocar o AAR na mensagem
Não coloque o AAR primeiro, a menos que ele seja o único registro. O guia explica o motivo: o Android lê o primeiro registro para descobrir o tipo MIME ou a URI a partir da qual monta o intent. Um AAR na primeira posição não deixa nada para os intent filters compararem.
Coloque o registro de URI ou MIME primeiro e o AAR por último, como no exemplo acima. O guia também recomenda combinar AARs com tipos MIME ou URIs para alcançar a maior variedade de aparelhos, porque os AARs são específicos do Android 4.0 e posterior. As páginas do Android não dizem como outras plataformas tratam um AAR, então não conte com ele para iPhones. Um registro de URL dá a eles algo para abrir; adicionar uma URL alternativa para iPhone mostra a ideia em uma tag de Wi-Fi.
Onde um AAR não ajuda
- O foreground dispatch tem prioridade. Um AAR não se sobrepõe a um app que chamou
enableForegroundDispatch. A página Advanced NFC diz que esse sistema permite que uma activity "claim priority over other activities that handle the same intent" (tenha prioridade sobre outras activities que tratam o mesmo intent). - Versões mais novas do Android adicionam controles ao usuário. A partir do Android 16, as pessoas são notificadas quando um app recebe seu primeiro intent NFC e podem bloqueá-lo em "Launch via NFC". O Android 17 adiciona a exigência da permissão
DISPATCH_NFC_MESSAGEpara apps que usam SDKs mais novos como alvo e deixa de enviar intents NFC para apps parados. O guia do Android não diz como isso afeta a abertura por AAR, então teste em celulares atuais. - Uma capinha ou uma gravação com erro podem ter o mesmo sintoma. Se aparecer No supported app for this NFC tag, confira o conteúdo da tag antes de culpar o AAR.
Para confirmar que uma tag realmente tem um AAR, leia os registros dela com um leitor de tags. O NFCore mostra o que está gravado em uma tag, e também há uma versão para Android.
Resumo rápido
Use um AAR quando uma tag precisar abrir um app Android específico, ou levar as pessoas a instalá-lo. Mantenha o nome do pacote exato, coloque o AAR depois de um registro de URI ou MIME e espere que apps em primeiro plano e os controles de privacidade das versões mais novas do Android tenham prioridade. Sempre teste a tag pronta em um celular de verdade.
Perguntas frequentes
O AAR funciona no iPhone?
A documentação do Android apresenta os AARs como um recurso do Android (4.0 e posterior) e não diz como outras plataformas os tratam. Combine o AAR com um registro de URL ou MIME para que a tag continue útil em outros aparelhos, e teste nos dispositivos que importam para você.
O que acontece se o app não estiver instalado?
O Android abre o Google Play para que a pessoa possa baixar o app indicado no AAR.
Um AAR pode abrir uma tela específica do meu app?
Não. Os AARs funcionam no nível do app, não no nível da activity. Para chegar a uma activity específica, use intent filters nos outros registros da mensagem.