Permissões

O kit pede três permissões, cada uma no momento que faz sentido. Nunca todas de uma vez na Home.

---

PushCopiar link da âncora

• Quem completa o onboarding: vê a tela OnboardingNotificationsStep com explicação. Ao continuar, abre o diálogo nativo do sistema.
• Quem pula o onboarding: nenhum prompt automático. O usuário toca na aba Notificações e, se a lista estiver vazia, vê o botão "Permitir notificações" → toca → abre o nativo. O clique já é a confirmação de intenção, então não tem soft prompt.

Quando o usuário nega e tenta reativar, o botão muda para "Abrir configurações" (ícone de engrenagem) e chama openAppSettings().

---

Face ID / Touch ID / BiometriaCopiar link da âncora

• Só é pedido quando o usuário liga o switch em Configurações.
• Ligar dispara autenticação nativa na hora.
• Se autenticar, o BiometricGuard passa a exigir autenticação ao abrir o app.
• Sem soft prompt: o switch já é a confirmação.

A preferência biometric_enabled é por conta (limpa no logout). Assim o próximo usuário no mesmo device começa com a trava desligada.

---

ATT: App Tracking Transparency (iOS)Copiar link da âncora

ATT é o prompt "Permitir que o app rastreie sua atividade" do iOS. A Apple permite mostrar o nativo apenas uma vez por instalação. Por isso usamos um soft prompt nosso antes.

• Quem completa o onboarding: vê OnboardingAttSetup com explicação. Ao continuar → abre o nativo do iOS.
• Quem pula o onboarding: ao chegar na Home (após 1,5s) → KasyDialog explicando o rastreamento. Se aceitar o nosso → chamamos o nativo. Se recusar → NÃO chamamos o nativo (preservamos a única chance).

Retry do soft promptCopiar link da âncora

Quem recusar o soft prompt é perguntado de novo após 7 dias, por até 3 tentativas. Depois disso paramos. As flags ficam em SharedPreferences (att_soft_dismiss_count e att_soft_last_asked_at).

AndroidCopiar link da âncora

ATT não existe no Android.

---

O que persiste no logoutCopiar link da âncora

Atualizado em 03/11/2026