Busque em todas as páginas da documentação
Estruture contas do Expo, projetos EAS e controle de acesso baseado em papéis para que equipes possam lançar múltiplos aplicativos sob uma única organização - com propriedade clara, isolamento de credenciais e permissões de menor privilégio.
Cartão de receita de referência rápida - pronto para copiar e colar.
# Faça login e vincule um novo aplicativo a um projeto de organização
eas login
eas init// app.json - direcione o aplicativo para uma organização e fixe o projeto EAS
{
"expo": {
"name": "Aplicativo de Varejo",
"slug": "retail-app",
"owner": "acme-mobile",
"extra": {
"eas": {
"projectId": "bd2f7e21-1ee7-47f2-8357-d7c4b50622fb"
}
}
}
}# Verifique qual conta é proprietária do projeto vinculado
eas project:infoQuando usar isso:
// app.config.ts - organização multi-aplicativo: padrão de projectId compartilhado, slugs distintos por aplicativo
import type { ExpoConfig } from "expo/config";
const APP_SLUG = "retail-consumer";
const ORG_OWNER = "acme-mobile";
const config: ExpoConfig = {
name: "Acme Varejo",
slug: APP_SLUG,
owner: ORG_OWNER,
version: "3.1.0",
ios: {
bundleIdentifier: "com.acme.retail",
},
android: {
package: "com.acme.retail",
},
extra: {
eas: {
projectId: "bd2f7e21-1ee7-47f2-8357-d7c4b50622fb",
},
appFamily: "retail",
},
};
export default config;// eas.json - perfis herdam credenciais da organização através do projectId vinculado
{
"cli": {
"version": ">= 16.0.0",
"appVersionSource": "remote"
},
"build": {
"development": {
"developmentClient": true,
"distribution": "internal",
"environment": "development"
},
"preview": {
"distribution": "internal",
"environment": "preview"
},
"production": {
"distribution": "store",
"environment": "production",
"autoIncrement": true
}
},
"submit": {
"production": {
"ios": {
"appleTeamId": "ABCDE12345"
}
}
}
}# CI: use um token de robô com escopo mínimo - não uma senha pessoal
# Dashboard do Expo → Configurações da Conta → Tokens de Acesso → Criar token
export EXPO_TOKEN="xxxxxxxxxxxxxxxxxxxxxxxx"
eas build --profile production --platform ios --non-interactiveO que isso demonstra:
owner direciona o aplicativo para uma organização - builds, credenciais e variáveis de ambiente são escopados para acme-mobile.projectId é a chave durável que os serviços EAS usam em mudanças de slug ou identificador de bundle.| Tipo | Ideal para | Colaboração |
|---|---|---|
| Pessoal | Projetos solo, aprendizado, protótipos | Compartilhe credenciais manualmente (desencorajado) |
| Organização | Equipes, agências, empresas multi-aplicativo | RBAC, credenciais compartilhadas, logs de auditoria |
Cada cadastro em expo.dev cria uma conta pessoal. Crie uma Organização quando mais de uma pessoa precisar de acesso a builds, envios ou credenciais.
eas init → cria/vincula projeto sob a conta ativa
→ escreve extra.eas.projectId na configuração do app
→ EAS Build / Update / variáveis de ambiente usam projectId como chave
slug é legível por humanos e usado em URLs - pode mudar.projectId é um UUID - estável durante a vida útil do projeto.owner determina qual armazenamento de credenciais e faturamento da conta se aplicam.| Papel | Builds e atualizações | Credenciais | Faturamento e convites | Excluir conta/projetos |
|---|---|---|---|---|
| Proprietário | ✓ | ✓ | ✓ | ✓ |
| Administrador | ✓ | ✓ | ✓ (não concede Proprietário) | ✗ |
| Desenvolvedor | ✓ | ✓ | ✗ | ✗ |
| Visualizador | Visualiza apenas no Expo Go | ✗ | ✗ | ✗ |
Atribua Desenvolvedor para engenheiros que lançam diariamente. Reserve Proprietário para líderes e contatos de faturamento. Use Visualizador para stakeholders que só precisam abrir builds de pré-visualização no Expo Go.
| Padrão | Estrutura |
|---|---|
| Uma org, muitos projetos | Organização acme-mobile com retail-app, warehouse-app, driver-app - cada um com seu próprio projectId |
| Org por cliente (agência) | client-a-mobile org isola credenciais e faturamento por cliente |
| Variáveis de ambiente em toda a conta | NPM_TOKEN compartilhado ou token de organização Sentry no escopo da conta; URLs de API específicos do aplicativo no escopo do projeto |
| Transferência em custódia | Organização temporária detém um projeto durante aquisição - ambas as partes precisam de Proprietário na custódia |
// Lendo metadados do projeto vinculado em tempo de execução (apenas diagnósticos - não para autenticação)
import Constants from "expo-constants";
const projectId = Constants.expoConfig?.extra?.eas?.projectId;
const owner = Constants.expoConfig?.owner; // disponível na configuração estática
export function DiagnosticsBanner() {
if (!__DEV__) return null;
return (
<Text>
EAS {projectId ?? "não vinculado"} · proprietário: {owner ?? "pessoal"}
</Text>
);
}Nunca use projectId ou owner para autorização no aplicativo - eles são identificadores de tempo de compilação, não limites de segurança.
owner em projetos de organização - eas build pode ter como alvo sua conta pessoal em vez da equipe. Correção: Defina "owner": "slug-da-org" em app.json antes de eas init ou transfira o projeto.eas credentials para rotação.projectId por binário de aplicativo (identificador de bundle / pacote).| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
| Conta de Organização | Qualquer equipe ≥ 2 pessoas | Projeto de hobby solo sem CI |
| Conta Pessoal | Aprendizado, protótipos de desenvolvedor único | Aplicativos em produção com credenciais compartilhadas |
| Uma org por cliente | Isolamento e desligamento de agência | Empresa de produto único - sobrecarga desnecessária |
| Variáveis de ambiente em toda a conta | Tokens compartilhados entre todos os apps da org | URLs de API específicos do aplicativo - use escopo de projeto |
| Token de acesso pessoal (CI) | Configuração rápida de CI em uma equipe pequena | Pipelines de produção de longa duração - prefira tokens de robô |
| Converter pessoal → org | Desenvolvedor solo se tornando uma equipe | Você precisa de uma separação limpa de clientes - crie uma nova org em vez disso |
Quando qualquer pessoa além de você precisar executar builds, gerenciar credenciais, configurar variáveis de ambiente ou enviar para as lojas de aplicativos. Organizações fornecem RBAC, armazenamentos de credenciais compartilhados e gerenciamento de membros.
Define qual conta Expo (nome de usuário pessoal ou slug da organização) é proprietária do projeto. Builds, credenciais e URLs do painel são resolvidos sob essa conta. Obrigatório quando o projeto pertence a uma organização da qual você é membro.
Um UUID estável escrito por eas init que vincula seu repositório a um projeto EAS. EAS Build, Update, variáveis de ambiente e credenciais são escopados para este ID - não para o slug ou identificador de bundle.
eas login
eas initSiga as instruções para criar um novo projeto ou vincular a um existente. O comando escreve projectId na configuração do seu aplicativo.
A conta ativa eas whoami ou um campo owner ausente tem como padrão o escopo pessoal. Defina "owner": "slug-da-sua-org" na configuração do aplicativo e confirme se eas project:info mostra a organização.
Sim - Configurações do Usuário → "Converter sua conta em uma organização." Projetos, credenciais, assinaturas EAS e webhooks são transferidos. Planeje uma janela de manutenção e confirme se as integrações que usam seu token de acesso ainda funcionam.
Configurações do Projeto → Geral → Transferir projeto. Você deve ser Proprietário ou Administrador em ambas as contas de origem e destino. Para transferências para terceiros sem acesso compartilhado, use uma organização em custódia.
Proprietários e Administradores. Administradores podem atribuir qualquer papel, exceto Proprietário. Proprietários podem atribuir qualquer papel, incluindo Proprietário.
Crie um token de acesso (usuário robô para organizações). Defina EXPO_TOKEN nos segredos da CI. Use --non-interactive em eas build e eas submit. Não armazene senhas pessoais na CI.
Tecnicamente sim, mas não é recomendado. Credenciais, canais de atualização e variáveis de ambiente colidem. Use um projeto EAS por aplicativo distinto (identificador de bundle / pacote exclusivo).
O papel de Desenvolvedor cobre eas build, eas update, eas credentials e leitura de variáveis de ambiente (de acordo com a visibilidade). Desenvolvedores não podem gerenciar faturamento, convidar membros ou alterar configurações da organização.
Crie uma Organização separada para cada cliente (client-a-mobile, client-b-mobile). Cada organização detém seus próprios projetos, credenciais e faturamento. Desenvolvedores recebem convites apenas para as organizações que atendem.
Visão Geral da Conta → Configurações do Usuário → Atividade de Segurança. Mostra alterações de senha, e-mail e 2FA. Proprietários da Organização devem impor 2FA para todos os membros em contas de produção.
eas init e vinculação inicial de projetoowner, slug e extraVersõ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).
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026