Credenciais e Provisionamento iOS

Certificados, perfis e credenciais gerenciadas pelo EAS - o guia para assinatura iOS no Expo SDK 57 sem que cada engenheiro precise manter pastas de assinatura do Xcode.

Receita

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

# Configuração interativa de credenciais
eas credentials --platform ios
 
# Primeiro build de produção (solicita login da Apple)
eas build --profile production --platform ios
 
# Build de CI não interativo após as credenciais existirem
eas build --profile production --platform ios --non-interactive

// app.config.ts - o bundle ID é a âncora de assinatura
import type { ExpoConfig } from "expo/config";
 
const config: ExpoConfig = {
  name: "ShopApp",
  slug: "shop-app",
  ios: {
    bundleIdentifier: "com.example.shopapp",
    buildNumber: "1",
  },
  extra: {
    eas: { projectId: "00000000-0000-0000-0000-000000000000" },
  },
};
 
export default config;

// eas.json - distribuição store vs internal afeta o tipo de perfil
{
  "build": {
    "production": {
      "distribution": "store",
      "ios": { "simulator": false }
    },
    "preview": {
      "distribution": "internal",
      "ios": { "simulator": false }
    }
  }
}

Quando usar isso:

• O primeiro eas build --platform ios pergunta sobre certificados e perfis de provisionamento.
• O Xcode reporta "No profiles for bundle identifier" na máquina de um colega de equipe.
• Rotacionando um engenheiro que era o único administrador do portal Apple Developer.
• Adicionando push, Sign in with Apple ou domínios associados antes do QA do TestFlight.

Exemplo de Trabalho

Passo 1 - Registrar o bundle ID

1. Apple Developer → Certificates, Identifiers & Profiles → Identifiers.
2. Crie um App ID correspondente ao ios.bundleIdentifier em app.config.ts.
3. Habilite as capacidades que você precisa (Push, Associated Domains, etc.) - veja Entitlements & Capabilities.

Passo 2 - Deixe o EAS gerenciar as credenciais de assinatura

eas credentials --platform ios

Escolha para um aplicativo novo:

? What do you want to do? › Set up credentials for a new bundle identifier
? Generate a new Apple Distribution Certificate? › Yes
? Generate a new Apple Provisioning Profile? › Yes

O EAS armazena:

• Apple Distribution Certificate (equivalente a .p12, criptografado nos servidores Expo)
• Provisioning Profile (App Store ou Ad Hoc dependendo de distribution)
• Opcional Push Notification Key (.p8) para APNs

Passo 3 - Registrar dispositivos para builds internos

# Criar um link de registro para testadores
eas device:create
 
# Listar dispositivos registrados
eas device:list

Perfis internos ("distribution": "internal") incorporam UDIDs registrados. Testadores devem se registrar antes de você reconstruir.

Passo 4 - Construir e verificar

eas build --profile production --platform ios
eas build --profile preview --platform ios   # ad hoc / testadores internos

Baixe o IPA e instale via TestFlight (eas submit) ou link ad hoc - Internal Distribution.

Tipos de Credenciais

Operações Comuns

Rotacionar um certificado de distribuição comprometido

eas credentials --platform ios
# Escolha: Remove distribution certificate → Generate new → Rebuild all profiles
eas build --profile production --platform ios --clear-cache

• A Apple permite dois certificados de distribuição ativos - planeje a rotação antes do vencimento
• Todos os IPAs assinados com o certificado antigo permanecem válidos até que os perfis expirem
• Notifique a equipe - builds de CI --non-interactive pegam as novas credenciais automaticamente

Carregar credenciais existentes (migração brownfield)

eas credentials --platform ios
# Escolha: Upload distribution certificate (.p12 + password)
# Escolha: Upload provisioning profile (.mobileprovision)

• Corresponda exatamente o bundle ID, team ID e capabilities ao seu aplicativo existente
• Revogue certificados duplicados no portal da Apple após confirmar que os builds do EAS foram bem-sucedidos
• Emparelhe com Migrating Manual Native Projects to CNG ao migrar de projetos Xcode editados manualmente

Sincronizar capabilities do app.config

O EAS pode habilitar capabilities no portal que correspondem aos seus plugins de configuração:

{
  "build": {
    "production": {
      "ios": {
        "autoIncrement": true
      }
    }
  }
}

// app.config.ts - domínios associados exigem alinhamento do portal + entitlements
ios: {
  associatedDomains: ["applinks:shop.example.com"],
},
plugins: [["expo-notifications", { icon: "./assets/notification-icon.png" }]],

• Incompatibilidades de capability aparecem como erros de provisioning profile doesn't include entitlement
• Corrija primeiro em app.config.ts / plugins - depois regenere os perfis via eas credentials

Solução de Problemas

FAQs

Relacionados

• EAS Build Basics - primeiro build iOS na nuvem
• Internal Distribution - caminhos ad hoc e TestFlight
• EAS Submit - upload para o App Store Connect
• ../ios-platform/entitlements-and-capabilities/entitlements-and-capabilities.md - push, domínios associados, modos de background
• ../ios-platform/testflight-distribution/testflight-distribution.md - grupos de testadores internos/externos
• ../ios-platform/ios-basics-for-rn-devs/ios-basics-for-rn-devs.md - vocabulário de assinatura do Xcode
• ../cng-prebuild/prebuild-basics/prebuild-basics.md - fluxo do bundle ID para o projeto Xcode gerado
• ../expo-rules/release-and-ota-rules/release-and-ota-rules.md - builds de store vs elegibilidade OTA

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).