Permissões & Política do Play

Permissões em tempo de execução, o seletor de fotos do sistema e Segurança de dados do Google Play - o guia de conformidade do Android para aplicativos Expo SDK 57. As entradas do manifesto informam ao sistema operacional o que você pode solicitar; prompts em tempo de execução e formulários do Play Console devem refletir o que você realmente faz.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

npx expo install expo-image-picker expo-camera

// features/media/pickAvatar.ts - seletor de fotos sem acesso amplo ao armazenamento
import * as ImagePicker from "expo-image-picker";
import { Alert, Linking, Platform } from "react-native";
 
export async function pickAvatar(): Promise<ImagePicker.ImagePickerAsset | null> {
  const { status } = await ImagePicker.requestMediaLibraryPermissionsAsync();
  if (status !== "granted") {
    Alert.alert(
      "Acesso às fotos necessário",
      "Habilite o acesso às fotos nas Configurações para escolher uma foto de perfil.",
      [
        { text: "Cancelar", style: "cancel" },
        { text: "Abrir Configurações", onPress: () => Linking.openSettings() },
      ],
    );
    return null;
  }
 
  const result = await ImagePicker.launchImageLibraryAsync({
    mediaTypes: ["images"],
    allowsEditing: true,
    aspect: [1, 1],
    quality: 0.8,
    // Android 13+ usa o seletor de fotos do sistema quando disponível - sem READ_MEDIA_IMAGES para seleção única
  });
 
  if (result.canceled) return null;
  return result.assets[0] ?? null;
}

// app.config.ts - declare apenas o que os módulos precisam; bloqueie permissões acidentais
export default {
  expo: {
    android: {
      package: "com.example.shopapp",
      permissions: [
        "CAMERA", // expo-camera
        // Evite WRITE_EXTERNAL_STORAGE legado - não necessário para fluxos de seleção
      ],
      blockedPermissions: [
        "READ_MEDIA_VIDEO", // exemplo: o aplicativo nunca lê a biblioteca de vídeos
      ],
    },
    plugins: [
      [
        "expo-image-picker",
        {
          photosPermission:
            "Permita que o ShopApp acesse suas fotos para uploads de perfil e recibos.",
          cameraPermission: "Permita que o ShopApp tire fotos para tickets de suporte.",
        },
      ],
    ],
  },
};

Quando usar isto:

• O Play Console rejeita a compilação por permissões não declaradas ou excessivamente amplas.
• Os usuários veem prompts de permissão ao iniciar em vez de em contexto.
• Você está preenchendo o questionário de Segurança de dados e precisa mapear SDKs para tipos de dados coletados.
• Dispositivos Android 14+ negam READ_MEDIA_IMAGES - fluxos iniciados pelo seletor ainda funcionam.

Exemplo de Trabalho

Etapa 1 - Permissão contextual da câmera

import { CameraView, useCameraPermissions } from "expo-camera";
import { Button, Text, View } from "react-native";
 
export function ScanReceiptScreen() {
  const [permission, requestPermission] = useCameraPermissions();
 
  if (!permission) return <View />; // hook carregando
 
  if (!permission.granted) {
    return (
      <View style={{ flex: 1, justifyContent: "center", padding: 24 }}>
        <Text>Precisamos de acesso à câmera para escanear seu recibo.</Text>
        <Button title="Continuar" onPress={requestPermission} />
      </View>
    );
  }
 
  return <CameraView style={{ flex: 1 }} facing="back" />;
}

Etapa 2 - Notificações (Android 13+)

import * as Notifications from "expo-notifications";
import { Platform } from "react-native";
 
export async function ensureNotificationPermission(): Promise<boolean> {
  if (Platform.OS !== "android" || Platform.Version < 33) return true;
 
  const { status: existing } = await Notifications.getPermissionsAsync();
  if (existing === "granted") return true;
 
  const { status } = await Notifications.requestPermissionsAsync();
  return status === "granted";
}

Etapa 3 - Auditar o manifesto mesclado após o prebuild

npx expo prebuild --platform android
rg "uses-permission" android/app/src/main/AndroidManifest.xml

Etapa 4 - Checklist de alinhamento de segurança de dados

O que isso demonstra:

• Prompts just-in-time - explique por que antes de requestPermission.
• Strings de permissão de plugin - justificativa visível para o usuário no diálogo do sistema.
• blockedPermissions - remova permissões transitivas de dependências.
• Segurança de dados - mapeie cada módulo Expo para categorias do Play Console.

Mergulho Profundo

Como Funciona

• Permissões em tempo de instalação (INTERNET, VIBRATE) são concedidas na instalação - sem diálogo em tempo de execução.
• Permissões perigosas (CAMERA, ACCESS_FINE_LOCATION, RECORD_AUDIO, POST_NOTIFICATIONS) exigem solicitação em tempo de execução no Android 6+.
• Mesclagem de manifesto - Módulos Expo e plugins de configuração adicionam entradas <uses-permission>; npx expo prebuild produz o manifesto mesclado.
• Seletor de fotos (Android 13+) - ACTION_PICK_IMAGES / o seletor do sistema retorna URIs sem acesso persistente amplo ao armazenamento - preferível para fotos de perfil e fluxos de anexos.
• Política do Play - O Google revisa o uso de permissões em relação aos recursos declarados; "recurso não central para o propósito do aplicativo" é uma rejeição comum para localização e SMS.

Classes de Permissão que Aplicativos RN Atingem

Seletor de Fotos vs Permissões de Armazenamento

// Prefira o seletor - não solicite armazenamento amplo para um único upload
const result = await ImagePicker.launchImageLibraryAsync({
  mediaTypes: ["images"],
  selectionLimit: 1,
});

Modelo Mental do Formulário de Segurança de Dados

1. Tipos de dados - localização, fotos, contatos, informações financeiras, etc.
2. Coletado vs compartilhado - seus servidores vs SDKs de terceiros.
3. Propósito - funcionalidade do aplicativo, análise, publicidade (publicidade aciona revisão adicional).
4. Práticas de segurança - criptografia em trânsito (HTTPS) no mínimo.
5. Exclusão - configurações de conta ou e-mail de suporte para solicitações de exclusão.

Verifique em relação a:

• O URL da sua política de privacidade (obrigatório no Play Console).
• Manifestos de privacidade de SDK / documentação de coleta de dados (Sentry, Firebase, Stripe, etc.).
• Tráfego de rede real - análises não declaradas são uma violação de política.

Concessões Parciais do Android 14+

• Os usuários podem conceder fotos selecionadas em vez de acesso completo à biblioteca.
• Lide com permission.granted === false e canAskAgain === false - direcione para Configurações.
• Solicite novamente apenas depois que o usuário tocar em uma ação que precise de acesso - não ao iniciar o aplicativo.

import { Linking } from "react-native";
 
if (!permission.canAskAgain) {
  await Linking.openSettings();
}

Armadilhas

• Solicitar todas as permissões na tela de splash - A política do Play e a UX punem isso. Correção: Just-in-time, com UI de justificativa antes do diálogo do sistema.
• Permissões transitivas de SDKs não utilizados - SDK de análise adiciona localização. Correção: blockedPermissions + remova dependências não utilizadas; verifique o manifesto mesclado.
• Segurança de dados diz "nenhum dado coletado" mas Sentry envia - Risco de rejeição automática. Correção: Declare diagnósticos; vincule a documentação do SDK na planilha de conformidade interna.
• POST_NOTIFICATIONS ausente na API 33+ - O push falha silenciosamente. Correção: Solicite antes de getExpoPushTokenAsync.
• WRITE_EXTERNAL_STORAGE legado - Desnecessário para uploads do seletor em APIs modernas. Correção: Remova das permissões do app.config; use URIs de conteúdo.
• Paridade com iOS assumida - A redação da biblioteca de fotos do iOS difere; o Android tem seletor + concessões parciais. Correção: Copie específico da plataforma em telas pré-permissão.

Alternativas

FAQs

Relacionados

• Noções básicas do Android para Desenvolvedores RN - inspeção de manifesto mesclado
• Assinatura e Assinatura de App do Play - identidade de lançamento (separada das permissões)
• Trilhas de Teste Interno - correções de política são enviadas primeiro para a trilha interna
• ../deep-linking/android-app-links/android-app-links.md - links verificados sem permissões extras
• ../store-operations/google-play-console-workflow/google-play-console-workflow.md - checklist completo do Play Console
• ../native-modules/config-plugins/config-plugins.md - permissões de manifesto personalizadas via plugins

Versões da Stack: Esta página foi escrita para React 19.2.3, React Native 0.86.0 e Expo SDK 57 (expo ~57.0.4).