A aparência escura é uma configuração que seus usuários ligam sem pedir a você. Se você nunca rodou o app nela, alguma tela vai mostrar texto preto sobre fundo escuro. Esta checklist percorre os lugares onde isso acontece. Reserve de 20 a 30 minutos para uma primeira passada.
Prepare o teste
- Troque a aparência em "Settings > Appearance" (Ajustes > Aparência), ou em "Settings > Display & Brightness" (Ajustes > Tela e Brilho) no iOS 26 e versões anteriores, conforme a Apple. Também dá para usar a Central de Controle: mantenha o controle de brilho pressionado e toque no ícone de "Dark Mode" (Modo Escuro), para alternar no meio da sessão.
- Teste em um aparelho real, não só no simulador. Brilho e contraste parecem diferentes na mão.
- Faça cada passada duas vezes: inicie o app no modo claro e troque para o escuro com ele aberto; depois abra o app a frio já no modo escuro.
A checklist
- Contraste do texto. Leia cada tela. Procure texto cinza-escuro sobre superfícies escuras e textos de placeholder ou desabilitados que somem. Por quê: cores fixas não se adaptam. Como checar: teste semicerrando os olhos e depois amplie a captura de tela e compare o texto com o fundo.
- Cores fixas. Procure cartões brancos, folhas brancas ou uma barra de navegação branca em uma tela escura. Por quê: uma cor fixa ignora a aparência. Como checar: qualquer elemento que continue claro depois da troca é suspeito.
- Imagens e ícones. Confira PNGs transparentes e ícones desenhados em preto. Por quê: um glifo preto sobre fundo escuro fica invisível. Como checar: abra cada tela com ícones, barras de abas e estados vazios.
- Tela de abertura. Inicie o app a frio no modo escuro. Um flash claro antes da primeira tela parece bug. Como checar: observe o primeiro segundo em um aparelho real.
- Troca com o app aberto. Mude a aparência com o app rodando. Por quê: algumas views só leem as cores uma vez. Como checar: cada tela visitada antes da troca deve atualizar sem reiniciar.
- Teclados e interface do sistema. Abra campos de texto. O teclado, alertas, folhas de ação e seletores de data devem combinar com a aparência. Por quê: um teclado claro em um formulário escuro parece inacabado.
- Web views. Se você mostra conteúdo web (termos, ajuda, login), confira. Por quê: páginas web não seguem as cores nativas do seu app. Como checar: abra cada web view no modo escuro; uma página branca e ofuscante é o achado mais comum.
- Gráficos, mapas e desenho personalizado. Tudo que é desenhado pelo seu código ou por uma view de terceiros precisa de checagem própria. Por quê: desenhos personalizados costumam usar cores fixas.
- Sombras e separadores. Sombras quase não aparecem em superfícies escuras; separadores finos podem sumir. Confira se os cartões ainda se destacam como camadas separadas.
- Capturas de tela na página da loja. Não é um bug, mas decida se vai mostrar a versão clara, a escura ou ambas, e garanta que combinem com o app.
Registre o que encontrar
Escreva cada achado assim: tela, aparência, o que você esperava, o que viu e uma captura de tela. Uma lista curta nesse formato é fácil de corrigir.
Também útil: as passadas de Dynamic Type e VoiceOver pegam outra classe de problemas de layout e acessibilidade.
Peça um segundo par de olhos
Você conhece seu app bem demais para enxergar seus cantos escuros. Na AppReviewX, outros desenvolvedores dão a você feedback privado e estruturado, em aparelhos deles; cada feedback que você escreve vale um crédito para receber feedback do seu app. Contas novas começam com 0 créditos.
Mais no hub: guia de testes de apps iOS. Relacionados: teste de Dynamic Type, roteiro do VoiceOver.