Por que a leitura de tag NFC em segundo plano no iPhone exige um Universal Link
Se uma tag NFC abre o Safari em vez de um app no iPhone, o problema não é a tag: a URL não é um universal link que funcione. Veja o que a leitura NFC em segundo plano realmente verifica e os erros de configuração que a quebram sem avisar.
O que é
A leitura de tag NFC em segundo plano do iPhone só entrega o toque a um app quando o registro NDEF da tag contém um Universal Link da Apple válido: não uma URL comum, e não um esquema personalizado como myapp://. Se o link não resolver para um universal link configurado corretamente, o iOS o trata como qualquer outro endereço da web e o abre no Safari.
É por isso que a leitura NFC em segundo plano confunde tanta gente. Uma tag pode parecer totalmente correta (você encosta, o celular vibra, uma tela abre) e mesmo assim falhar, porque "uma tela abriu" não é o mesmo que "o app certo abriu". Veja o que o iOS realmente verifica antes de encaminhar um toque e os erros de configuração que fazem uma tag voltar silenciosamente para o navegador.
Como funciona na prática
Quando você encosta em uma tag com a tela bloqueada ou o app fechado, o iOS lê a mensagem NDEF e considera apenas o primeiro registro: um universal link em um segundo ou terceiro registro é ignorado. Esse registro precisa ser do tipo URI e apontar para um domínio que o app tenha reivindicado explicitamente. Além dos links https://, os únicos outros esquemas que o iOS aceita em segundo plano são mailto:, sms:, tel:, FaceTime, Apple Maps e o X-HM:// do HomeKit. Esquemas personalizados de apps nunca acionam o encaminhamento em segundo plano, mesmo funcionando em uma sessão Core NFC em primeiro plano. (Veja nossos conteúdos sobre registros NDEF de URI e tipos de tag NFC Forum para entender como as tags codificam isso.)
Para reivindicar um domínio, é preciso ter a entitlement Associated Domains no Xcode, além de um arquivo apple-app-site-association assinado e hospedado nesse domínio via HTTPS. Sem os dois, o iOS abre o link como um simples favorito.
Também é necessário um iPhone XS ou mais recente, desbloqueado pelo menos uma vez desde a reinicialização. E a leitura é pausada enquanto uma sessão NFC em primeiro plano ou uma transação do Apple Pay estiver ativa, a câmera estiver em uso ou o Modo Avião estiver ligado. Nada disso acontece de forma silenciosa: uma notificação do sistema aparece primeiro, e o usuário precisa tocar nela antes de o app abrir.
Onde você vai ver isso
Isso importa mais nos casos de toque para abrir: uma automação do Shortcuts a partir de uma tag na mesa, uma cena de casa inteligente, uma tag de cartão de visita que deve abrir uma tela de salvar contato em vez de uma página da web, ou uma pulseira de evento feita para levar os participantes a um app de check-in. Uma tag com https:// simples funciona em qualquer lugar, mas não consegue passar a ação para um app: um universal link só compensa quando o mapeamento entre domínio e app realmente existe.
É aqui também que as coisas ficam confusas. Desenvolvedores relataram casos em que tudo estava correto no papel (arquivo de associação assinado, entrada applinks:, validador passando) e a tag ainda assim abria o Safari. Os suspeitos de sempre: incompatibilidade do certificado de assinatura, cache de validação desatualizado no aparelho, incompatibilidade de Team ID ou o arquivo não ser servido como application/json. Nada disso gera um erro visível; a tag simplesmente continua abrindo o navegador.
Dicas, armadilhas e um guia rápido com o NFCore
Antes de concluir que uma tag está com defeito, verifique nesta ordem: o registro de URL é o primeiro da tag, o Associated Domains está ativado para o app, e o arquivo de associação hospedado usa HTTPS, está assinado corretamente e é servido como application/json.
Para conferir o que realmente está gravado em uma tag sua, o Tag Inspector do NFCore lê de volta o payload NDEF bruto, para você ver qual registro vem primeiro e qual é de fato a URL. Para codificar o link por conta própria, você pode gravar o registro NDEF de uma tag com o gravador do NFCore, definindo diretamente o registro de URI.
Vale ser transparente: o NFCore consegue confirmar o que está na tag, mas não consegue corrigir uma configuração de universal link quebrada. Esse é um problema de configuração do lado de quem desenvolve o app, e não algo que um app de leitura e gravação possa mudar.
Perguntas frequentes
Por que meu iPhone abre o Safari em vez do meu app quando encosto em uma tag NFC?
A URL da tag não é reconhecida como um universal link que funcione. Quando o iOS não consegue associar o domínio a um app instalado, ele abre a URL como qualquer endereço da web comum, sem nenhum erro, então por fora isso parece idêntico a uma tag que funciona.
Posso usar um esquema de URL personalizado como myapp:// em uma tag NFC para leitura em segundo plano?
Não. A leitura de tag em segundo plano só é encaminhada por Universal Links da Apple, além de uma pequena lista de esquemas do sistema como mailto:, tel: e links do Apple Maps. Esquemas personalizados de apps são ignorados silenciosamente em segundo plano, mesmo funcionando em uma sessão Core NFC em primeiro plano.
Quais iPhones oferecem suporte à leitura de tag NFC em segundo plano?
O iPhone XS e os mais recentes, desbloqueados pelo menos uma vez desde a última reinicialização. A leitura também é pausada enquanto uma sessão NFC em primeiro plano, uma transação do Apple Pay ou a câmera estiver ativa, ou enquanto o Modo Avião estiver ligado.
Por que a tag ainda abre o Safari mesmo com a configuração do universal link aparentemente correta?
Os universal links dependem de um arquivo de configuração assinado e hospedado no seu domínio, e essa validação pode falhar sem avisar: incompatibilidade de certificado, cache desatualizado no aparelho, incompatibilidade de Team ID ou tipo de conteúdo errado no arquivo. Não há mensagem de erro para nada disso; a tag simplesmente continua voltando para o navegador.
Conclusão
Se uma tag NFC encostada abre um app ou apenas uma aba do navegador, tudo se resume a uma coisa: um universal link configurado corretamente, e não a tag em si. Acerte a ordem dos registros, a entitlement Associated Domains e o arquivo de associação hospedado, e a transferência para o app é instantânea. Erre qualquer um deles, e a tag ainda vai "funcionar", mas não fará o que você planejou.