Porta de região do Analytics no iOS quando o país do chip não pode ser lido
Por Nesim Razon, desenvolvedor mobile independente · 2026-11-17
Dois dos nossos apps coletam estatísticas de uso apenas em dispositivos fora do Espaço Econômico Europeu, do Reino Unido e da Suíça, para não precisar de formulário de consentimento. No Android é fácil verificar. No iPhone o país do chip e da rede não pode ser lido, então a mesma regra precisou de outros sinais. Aqui se conta como a regra é escrita uma vez em Kotlin Multiplatform e o que ela faz quando há dúvida. Descreve uma decisão de design própria, não é aconselhamento jurídico.
A regra em uma frase
A análise só fica ativada quando temos certeza de que o dispositivo está fora das regiões restritas. Se qualquer sinal aponta para um país restrito, fica desativada. Se nenhum sinal é conhecido, fica desativada. Na dúvida, sempre desativada.
A regra vive no código comum, então Android e iPhone não podem divergir. É uma função que recebe qualquer número de códigos de país, alguns dos quais podem faltar, e devolve se a coleta é permitida.
A função compartilhada
A função apara cada valor, converte em maiúsculas e mantém só os códigos de duas letras. Se não sobra nada, devolve false. Caso contrário, devolve true somente quando nenhum dos códigos está no conjunto restrito: os Estados-membros da UE, Islândia, Liechtenstein e Noruega, o Reino Unido e a Suíça.
Converter em maiúsculas importa, porque as plataformas informam os códigos de formas diferentes, e um valor vazio ou malformado deve contar como desconhecido, não como permitido. Os testes unitários cobrem exatamente esses casos: a Turquia passa, um único código restrito em qualquer lugar falha (um telefone turco com chip alemão é tratado como restrito), códigos em minúsculas são normalizados e sem dados nenhum fica desativado.
Android: três sinais
No Android o app pode ler a região do dispositivo, o país do chip e o país da rede. Os três são passados juntos à função. Um viajante na Alemanha com chip turco, ou um residente alemão com chip turco, terminam com a coleta desativada, porque qualquer valor restrito vence.
O indicador de coleta vem desativado por padrão no manifesto e o app decide de novo a cada abertura. Uma compilação de depuração ou de teste nunca coleta, porque a coleta exige também o indicador da versão de loja.
iPhone: menos sinais
No iPhone, o país do chip e da rede não está disponível para um app comum. Restam a região do dispositivo nas configurações regionais, que reflete uma escolha do usuário, e o fuso horário, que reflete onde o telefone realmente está.
Por isso o lado do iOS passa o código de país das configurações regionais à mesma função e acrescenta uma segunda verificação sobre o nome do fuso horário. Todo fuso que começa com Europe/ conta como restrito, assim como alguns fusos atlânticos e africanos de países restritos, como Madeira, Canárias, Açores, Ilhas Faroé e Ceuta.
A exceção de Istambul
Europe/Istanbul começa com Europe/, mas a Turquia não está no conjunto restrito e estes são apps de notícias turcos. A verificação de fuso horário tem uma exceção explícita para ele. Sem essa linha, quase todo iPhone turco teria ficado desativado.
A verificação de fuso horário é deliberadamente grosseira. Às vezes desativará a análise de alguém fora das regiões restritas, por exemplo um viajante em Paris com configuração turca, e esse é o lado seguro de errar.
O que o código não faz
O projeto iOS também é entregue com a coleta automática desativada na lista de propriedades, e o app a ativa no código apenas quando a regra permite. Não há identificador de publicidade e os apps não têm anúncios. Os eventos levam uma categoria ou um tipo, nunca dados pessoais.
As peças para copiar são pequenas: um conjunto restrito, uma função que trata o desconhecido como desativado, um auxiliar de fuso horário com exceção explícita para o seu fuso e testes unitários que fixam o comportamento. Decidir quais regiões excluir é com você e seu consultor, não com o código.
Perguntas frequentes
Por que não pedir consentimento em todo lugar?
Porque estes dois apps são pequenos e sem anúncios, e preferimos não mostrar formulário de consentimento algum. Desativar a coleta nas regiões restritas era o design mais simples para nós.
Por que o iOS não pode usar o país do chip?
Um app comum de iPhone não consegue ler o país do chip nem da rede, então o lado do iOS usa a região das configurações regionais e o fuso horário.
O que acontece quando os sinais faltam ou se contradizem?
A coleta fica desativada. O desconhecido conta como desativado e um único valor restrito basta para desativar.
Isto é aconselhamento jurídico?
Não. É a descrição de como construímos nossa própria regra. Decida para os seus apps com a orientação adequada.
Mais do blog
- O número de build do iOS que ficou em 1: três correções que falharam e uma que funcionou
- Por que meu link da App Store deu 404 e a página mostrava capturas de 2018
- Diretriz 2.1 da App Store "Information Needed": o que enviei
- Capturas de tela da App Store sem celular: Robolectric, um carregador de imagens falso e um navegador sem interface
- Um código QR para duas lojas de apps: uma pequena página de redirecionamento
- Reescrever para Kotlin Multiplatform sem mudar o comportamento: o código antigo como oráculo de testes