Voltar aos guias

Como fazer uma tag NFC abrir um app em vez de um site

Um registro de URL simples abre o navegador. Para que o toque abra o seu app, Android e iOS usam dois mecanismos diferentes. Veja como usar os dois em uma única tag.

Publicado

Resposta rápida

Um registro de URL simples em uma tag NFC abre um navegador. Só isso. Para que o toque abra o seu app, Android e iOS precisam de mecanismos diferentes, aplicados sobre essa URL. O Android usa um Android Application Record (AAR), um registro NDEF dedicado, ligado ao nome do pacote do seu app. O iOS usa um App Clip, acionado por um App Clip Code com NFC. Já escreveu registros NDEF personalizados além de URL e texto? Este é o próximo tipo de registro que vale a pena aprender.

Passo a passo

Android: o Application Record

O método NdefRecord.createApplicationRecord("com.your.package") do Android incorpora um Application Record na mensagem NDEF da sua tag. Um AAR não carrega conteúdo como um registro de URL ou de texto: ele apenas indica o nome do seu app, para que o Android o abra diretamente, em vez de pedir ao usuário que escolha em uma lista.

A ordem dos registros importa. Um AAR não deve ser o primeiro registro, a menos que seja o único na tag. O Android lê esse primeiro registro para determinar o tipo MIME ou a URI usados na correspondência de intents, e um AAR nessa posição pode quebrar a correspondência. Padrão seguro: registro de URL ou de texto primeiro, AAR adicionado depois.

Se o app indicado não estiver instalado, o Android não desiste: ele abre a página do pacote na Google Play Store. Mais um toque e o app é instalado.

iOS: App Clips

O iOS não tem um equivalente direto ao Application Record. Não existe "gravar só um identificador de pacote e deixar o sistema resolver". O mecanismo da Apple é baseado em URL desde o início: o App Clip.

No App Store Connect, você gera um App Clip Code como NFC-enabled (com NFC) ou Scan-Only (somente leitura por câmera). Os códigos com NFC incorporam uma tag de verdade, então o usuário aproxima o celular em vez de escanear; o código visual também continua impresso, como alternativa. Ao aproximar, o cartão do App Clip aparece na tela e mais um toque o abre, muitas vezes dispensando o login ao ligar direto ao Apple Pay ou a uma conta existente.

Se o App Clip não estiver em cache, ele é baixado sob demanda em segundo plano. Se o app completo já estiver instalado, o iOS abre o app completo, o que é esperado e não é um bug. Para a leitura em segundo plano, e não um toque explícito em um App Clip, veja por que a leitura NFC em segundo plano no iPhone exige um Universal Link. É um assunto relacionado, mas é um mecanismo distinto.

Gravando uma tag que funciona nos dois

O iOS se baseia na própria URL; o Android pode se basear na URL ou no AAR. Por isso, a ordem que atende às duas plataformas é: registro de URL primeiro, Android Application Record adicionado depois. O iOS lê a URL e ignora o AAR, que ele não reconhece. O Android verifica o AAR e abre o seu app diretamente, com a URL ainda ali como alternativa.

Problemas comuns e soluções

  • AAR ignorado, abre o app errado: erro na ordem dos registros. Tire o AAR da primeira posição, a menos que seja o único registro da tag.
  • A tag abre o Safari em vez do App Clip: a experiência do App Clip não está registrada para essa URL exata, ou o código não foi gerado como NFC-enabled.
  • O app completo abre em vez do App Clip: esperado quando o app completo já está instalado.
  • Funciona em uma plataforma, mas não na outra: confirma que são mecanismos separados, e não um padrão compartilhado. Veja NFC no iOS vs Android: o que cada plataforma realmente consegue fazer para uma comparação mais ampla.
  • Testes: use celulares reais em cada plataforma. Simuladores não reproduzem de forma confiável o acionamento de AAR ou de App Clip.

Como fazer isso especificamente no NFCore

O editor de registros personalizados do NFCore oferece suporte a mensagens NDEF com vários registros. Adicione primeiro o registro de URL e, depois, um segundo registro com o Android Application Record contendo o nome do pacote do seu app. Depois, leia a tag de volta para confirmar a ordem antes de usá-la: reimprimir porque dois registros foram trocados é um erro simples de evitar. Baixe o NFCore na App Store ou no Google Play.

Perguntas frequentes

Uma única tag NFC abre um app tanto no iPhone quanto no Android?

Sim, se a ordem dos registros estiver certa: primeiro um registro de URL, de preferência também registrada como experiência de App Clip, e depois um Android Application Record adicionado. O iOS se baseia na URL; o Android verifica o AAR.

O que acontece se o app não estiver instalado?

O fallback do AAR no Android abre automaticamente a página do app na Google Play Store. No iOS, um App Clip Code com NFC baixa e abre o App Clip sob demanda, sem precisar de instalação prévia.

Por que meu Android Application Record às vezes é ignorado?

Geralmente por causa da ordem dos registros. O AAR está em primeiro lugar sem ser o único registro da tag, o que quebra a correspondência de intents por MIME/URI do Android. Mova-o para depois do registro de URL ou de texto.

Posso usar o NFCore para gravar uma tag que abre um app em vez de um site?

Sim. Crie uma mensagem NDEF personalizada com um registro de URL primeiro e um Android Application Record em segundo, usando o editor de registros personalizados do NFCore, e confira a ordem antes de entregar a tag.

Conclusão

Uma tag física, dois mecanismos diferentes de plataforma. É assim que funciona hoje abrir um app a partir de uma tag. O Application Record do Android e o App Clip do iOS não funcionam do mesmo jeito, mas convivem bem em uma única tag se a ordem dos registros estiver certa: URL primeiro, AAR depois. Acerte isso de primeira e você não precisará reimprimir tags depois.