Implantação

Quando Usar

Use esta habilidade quando precisar implantar aplicativos Expo em produção com o EAS — compilar e enviar para a App Store do iOS, Google Play Store e TestFlight, configurar perfis de compilação e envio do eas.json, gerenciar versões de aplicativos e números de compilação, publicar metadados da App Store e ASO, e implantar pacotes web e rotas de API via EAS...

Esta habilidade abrange a implantação de aplicativos Expo em todas as plataformas usando o EAS (Expo Application Services).

Referências

Consulte estes recursos conforme necessário:

• ./references/workflows.md -- Fluxos de trabalho de CI/CD para implantações automatizadas e prévias de PR
• ./references/testflight.md -- Envio de compilações do iOS para o TestFlight para testes beta
• ./references/app-store-metadata.md -- Gerenciamento de metadados da App Store e otimização de ASO
• ./references/play-store.md -- Envio de compilações Android para a Google Play Store
• ./references/ios-app-store.md -- Processo de envio e revisão da App Store do iOS

Início Rápido

Instalar EAS CLI

npm install -g eas-cli
eas login

Inicializar EAS

npx eas-cli@latest init

Isso cria eas.json com perfis de compilação.

Comandos de Compilação

Compilações de Produção

# iOS App Store build
npx eas-cli@latest build -p ios --profile production

# Android Play Store build
npx eas-cli@latest build -p android --profile production

# Both platforms
npx eas-cli@latest build --profile production

Enviar para Lojas

# iOS: Build and submit to App Store Connect
npx eas-cli@latest build -p ios --profile production --submit

# Android: Build and submit to Play Store
npx eas-cli@latest build -p android --profile production --submit

# Shortcut for iOS TestFlight
npx testflight

Implantação Web

Implante aplicativos web usando o EAS Hosting:

# Deploy to production
npx expo export -p web
npx eas-cli@latest deploy --prod

# Deploy PR preview
npx eas-cli@latest deploy

As rotas de API do Expo Router são implantadas junto com o pacote web no EAS Hosting — eas deploy envia ambos. Para criar ou configurar as próprias rotas de API, use a habilidade expo-api-routes.

Configuração do EAS

eas.json padrão para implantações de produção:

{
  "cli": {
    "version": ">= 16.0.1",
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true,
      "ios": {
        "resourceClass": "m-medium"
      }
    },
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    }
  },
  "submit": {
    "production": {
      "ios": {
        "appleId": "your@email.com",
        "ascAppId": "1234567890"
      },
      "android": {
        "serviceAccountKeyPath": "./google-service-account.json",
        "track": "internal"
      }
    }
  }
}

Guias Específicos da Plataforma

iOS

• Use npx testflight para envios rápidos para o TestFlight
• Configure credenciais da Apple via eas credentials
• Veja ./references/testflight.md para configuração de credenciais
• Veja ./references/ios-app-store.md para envio para a App Store

Android

• Configure a conta de serviço do Google Play Console
• Configure trilhas: interna → fechada → aberta → produção
• Veja ./references/play-store.md para configuração detalhada

Web

• O EAS Hosting fornece URLs de prévia para PRs
• Implantações de produção em seu domínio personalizado
• Veja ./references/workflows.md para automação de CI/CD

Implantações Automatizadas

Os Fluxos de Trabalho do EAS automatizam o pipeline de compilação → envio → atualização → implantação para CI/CD. Veja ./references/workflows.md para exemplos orientados à implantação. Para criar ou validar o YAML do fluxo de trabalho, use a habilidade expo-cicd-workflows — ela funciona a partir do esquema de fluxo de trabalho ativo.

Gerenciamento de Versão

O EAS gerencia números de versão automaticamente com appVersionSource: "remote":

# Check current versions
eas build:version:get

# Manually set version
eas build:version:set -p ios --build-number 42

Monitoramento

# List recent builds
eas build:list

# Check build status
eas build:view

# View submission status
eas submit:list

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo do produto ou API upstream.
• Verifique comandos, comportamento da API, preços, cotas, credenciais e efeitos de implantação em relação à documentação oficial atual antes de fazer alterações.
• Não trate exemplos gerados como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou caras.