KappS Base de conhecimento · Blog

Apple Privacy Manifests em 2026: o checklist das Required Reason APIs

Blog Checklist

O requisito de manifesto de privacidade da Apple está em vigor desde 1º de maio de 2024 e continua sendo uma das poucas falhas de submissão que não têm nada a ver com o comportamento do seu app — uma compilação que usa uma API de motivo obrigatório sem um motivo declarado simplesmente não é aceita pela App Store Connect. Duas obrigações distintas convivem no mesmo arquivo: as declarações de coleta de dados, que se aplicam em todas as plataformas, e as declarações de API de motivo obrigatório, que se aplicam no iOS, no iPadOS, no tvOS, no visionOS e no watchOS. Se o seu app faz link com um dos SDKs da lista de SDKs comumente usados da Apple, o manifesto de privacidade desse SDK também é obrigatório — e uma assinatura também é exigida quando o SDK é usado como dependência binária. Estas são as doze verificações que fazemos antes de um archive sair do Mac.

A versão em uma linha: o arquivo deve se chamar PrivacyInfo.xcprivacy, deve estar no bundle que contém o código que usa a API, e cada categoria de API deve ser declarada com um código de motivo que o Apple publica — não uma frase que você mesmo escreveu.

1. Um manifesto é realmente obrigatório para este app?

Duas obrigações definem isso, e seus escopos diferem. As declarações de coleta de dados são necessárias para seu app ou SDK de terceiros em todas as plataformas. As declarações de API de motivo obrigatório são necessárias no iOS, iPadOS, tvOS, visionOS e watchOS. Se o app usa uma API de motivo obrigatório, coleta dados sobre a pessoa que usa apps que a incluem, permite que o app colete dados sobre as pessoas que o usam ou contata domínios de rastreamento, ele precisa do arquivo. Se for um dos SDKs listados, precisa de um de qualquer forma.

2. O arquivo tem o nome exato e está no bundle?

PrivacyInfo.xcprivacy é o nome de arquivo obrigatório — o Apple rejeita qualquer outro. No Xcode: File > New File, role até a seção Resource, escolha o tipo App Privacy File, marque seu target e crie o arquivo. Depois, confirme que ele está listado em resources desse target, porque o Xcode só usa um manifesto que encontra ali quando gera o relatório de privacidade. Se você distribui um SDK de terceiros como biblioteca estática, use o suporte a framework estático adicionado no Xcode 15 e adicione o manifesto aos recursos do bundle do target do framework, junto com os demais recursos.

3. As quatro chaves de nível superior estão presentes?

  • NSPrivacyTracking — se o app ou o SDK de terceiros usa dados para rastreamento.
  • NSPrivacyTrackingDomains — os domínios contatados para rastreamento.
  • NSPrivacyCollectedDataTypes — um dicionário por tipo de dado coletado, cada um informando o tipo de dado, se está vinculado à identidade da pessoa, se é usado para rastreamento e as finalidades.
  • NSPrivacyAccessedAPITypes — um dicionário por categoria de API com motivo obrigatório, cada um informando a categoria e seus códigos de motivo.

Se o app não rastreia, diga isso explicitamente no arquivo em vez de omitir as chaves de rastreamento.

4. Você auditou todas as cinco categorias de API de motivo obrigatórias?

O Apple agrupa as APIs regulamentadas em cinco categorias. Audite o código que você escreveu e, separadamente, o código dentro de cada SDK que você vincula — uma única chamada já basta para tornar a declaração necessária:

  • Carimbo de data/hora do arquivo — getattrlist, getattrlistbulk, fgetattrlist, fstat, fstatat, lstat, getattrlistat.
  • Tempo de inicialização do sistema — mach_absolute_time().
  • Espaço em disco — statfs, statvfs, fstatfs, fstatvfs, além da família getattrlist.
  • Teclados ativos — as APIs que informam quais teclados estão ativos no dispositivo.
  • User defaults — leituras e gravações pelas APIs de user defaults.

5. Cada entrada usa um código de motivo aprovado?

Os códigos de motivo são strings fixas publicadas pelo Apple; você escolhe da lista, não escreve os seus. Os que declaramos com mais frequência: timestamps de arquivo — DDA9.1 (exibir timestamps para a pessoa que usa o dispositivo), C617.1 (arquivos dentro do app, do grupo de apps ou do contêiner CloudKit), 3B52.1 (arquivos ou diretórios que o usuário concedeu especificamente, como por meio de um seletor de documentos), 0A2A.1 (um SDK de terceiros que encapsula a API para o app). Hora de inicialização do sistema — 35F9.1 (medir o tempo decorrido entre eventos no app ou executar timers), 8FFB.1 (timestamps absolutos de eventos que ocorreram no seu app), 3D61.1 (hora de inicialização dentro de um relatório de bug opcional enviado pela pessoa). Espaço em disco — 85F4.1 (exibir espaço em disco para a pessoa que usa o dispositivo), E174.1 (verificar se há espaço suficiente para gravar ou liberar espaço quando ele estiver acabando), 7D9E.1 (espaço em disco dentro de um relatório de bug opcional), B728.1 (app de pesquisa em saúde). Preferências do usuário — CA92.1 (dados acessíveis apenas ao próprio app), 1C8F.1 (app, extensões de app e App Clips), C56D.1 (wrapper de SDK, apenas SDKs de terceiros), AC6B.1 (chaves de configuração gerenciadas por MDM). Teclados ativos — 3EC4.1 (app de teclado personalizado), 54BD.1 (apresentar a interface personalizada correta).

6. Os motivos correspondem à funcionalidade que os usuários conseguem ver?

Cada motivo tem suas próprias condições, e os revisores as leem. O E174.1 exige que o app se comporte de forma diferente conforme o espaço em disco, de maneira observável pelos usuários. O 3EC4.1 é reservado para apps cuja funcionalidade principal é um teclado personalizado para todo o sistema. O 3D61.1 exige que o tempo de inicialização seja exibido com destaque como parte de um relatório que a pessoa escolhe enviar. Escolha o motivo que descreve o que o código realmente faz; os motivos declarados também devem ser consistentes com a funcionalidade que você apresenta aos usuários.

7. Você interrompeu todas as transferências que o motivo proíbe?

Declarar um motivo licencia o uso da API e dos dados derivados dela apenas para esse motivo. A maioria dos motivos traz a frase de que as informações, e qualquer coisa derivada delas, não podem ser enviadas para fora do dispositivo. As exceções documentadas são restritas: o tempo decorrido entre eventos dentro do app pode sair do dispositivo (35F9.1); carimbos de data e hora absolutos dentro do app podem sair (8FFB.1), mas o horário de inicialização em si não pode; valores de relatório de bugs só podem sair depois que a pessoa envia afirmativamente aquele relatório específico; e o espaço em disco pode cruzar a rede local até outro dispositivo usado pela mesma pessoa para exibição, nunca pela internet. Os SDKs de análise são onde essa regra quebra primeiro, então verifique o que eles enviam antes de assinar a declaração.

8. A declaração de rastreamento está consistente?

O fingerprinting é proibido independentemente de a pessoa ter concedido permissão de rastreamento, e você não pode usar essas APIs nem os dados derivados delas para rastreamento. Se a resposta for que não há rastreamento, coloque isso no arquivo — um falso explícito é uma declaração, o silêncio não é.

9. De quem é o manifesto que cobre o SDK?

Do próprio SDK. Um SDK de terceiros não pode depender do manifesto do app que o integra, nem dos manifestos de outros SDKs que o app integra. Toda biblioteca executável ou dinâmica em um app que usa uma API de motivo obrigatório precisa de um bundle contendo um manifesto que a informe. A regra espelhada é mais amigável: o manifesto de privacidade do seu app não precisa cobrir os dados coletados pelos SDKs de terceiros que o seu app integra.

10. Você conferiu a lista de SDKs e as assinaturas deles?

O manifesto de privacidade é obrigatório para qualquer SDK da lista do Apple quando você envia um novo app que o inclua, ou uma atualização que adicione um dos SDKs listados — e assinaturas são exigidas adicionalmente quando esses SDKs são usados como dependências binárias, para que o Xcode possa validar que o SDK foi assinado pelo mesmo desenvolvedor. Todas as versões de um SDK listado estão no escopo, assim como qualquer SDK que reembale um dos listados. A lista atinge a maioria das stacks do mundo real: Flutter e seus plugins comuns, FirebaseCore, FirebaseMessaging, FirebaseCrashlytics, OneSignal, Alamofire, SDWebImage, Reachability, nanopb, GoogleUtilities, UnityFramework e hermes entre eles. Quando um deles coloca um envio em quarentena, a correção geralmente é atualizar para uma versão que traga seu próprio manifesto e assinatura.

11. Você consegue gerar o relatório de privacidade antes do envio?

Abra o projeto no Xcode, escolha Product > Archive e, no Organizer, clique com a tecla Control pressionada sobre o archive e escolha Generate Privacy Report. O Xcode agrega seu manifesto com os manifestos de todos os SDKs aos quais o app se vincula. Leia esse relatório antes de preencher os detalhes de privacidade no App Store Connect, não depois — é a mesma visão que o revisor tem.

12. O que acontece se você enviar sem ela?

Primeiro um e-mail: o Apple envia um lembrete para adicionar o motivo ausente ao manifesto de privacidade do app. Depois vem o bloqueio total — desde 1º de maio de 2024, apps que não descrevem o uso de API de motivo obrigatório não são aceitos pelo App Store Connect. Não há fila de revisão para uma compilação que falha nessa validação, e um portfólio grande sente isso na hora, porque o mesmo uso recorrente de API aparece em todos os pacotes.

Fontes

Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.

Clique para escolher um arquivo · clique com o botão direito → Colar, ou pressione Ctrl/⌘+V para colar uma captura de tela

Você também pode arrastar um arquivo para esta caixa.

Respondemos ao e-mail que você fornecer. Seus dados ficam com KappS.

✔ Enviado

Recebemos sua mensagem e responderemos em até 24 horas.


← Voltar para editar