Quando Usar

• Use quando o fluxo de trabalho upstream corresponder ao objetivo declarado do usuário.
• Use quando a tarefa exigir os procedimentos documentados nesta habilidade.

Implantação na App Store

Serviço EAS - custos aplicáveis. Builds na nuvem usam recursos do plano EAS, e os serviços EAS têm limites de nível gratuito e planos pagos. Assinaturas Apple Developer e Google Play são separadas. Verifique https://expo.dev/pricing para o serviço solicitado.

Esta habilidade abrange a criação e o lançamento de aplicativos iOS e Android com EAS: Expo e outros projetos React Native, além de aplicativos nativos existentes. O EAS é um serviço de entrega; aplicativos nativos podem usá-lo sem adicionar Expo ou React Native ao seu runtime. O guia de configuração nativa atualmente abrange SwiftUI/UIKit no iOS.

Escolha o caminho do projeto

• Aplicativo SwiftUI/UIKit sem runtime React Native: leia [references/native-ios.md] antes de alterar sua configuração de build. Mantenha o projeto Xcode e o código Swift como a fonte da verdade do aplicativo. Os exemplos de quick-start e development-client do Expo/React Native abaixo não se aplicam a este caminho.
• Aplicativo Android nativo sem runtime React Native: preserve sua configuração de build nativa existente. Veja [references/play-store.md] para submissão; as instruções de configuração Swift/iOS não se aplicam. Um guia de configuração nativa dedicado para Android ainda não está incluído.
• Aplicativo Expo/React Native: use o quick-start abaixo, depois a referência da loja relevante.
• Adicionando telas React Native a um aplicativo nativo existente: use expo-brownfield para essa integração; retorne aqui para distribuição.

Use as verificações de arquivo e ícone em [references/native-ios.md] durante a configuração inicial do iOS nativo, após alterar versionamento, IDs de bundle ou ícones, ou ao diagnosticar um upload rejeitado. Lançamentos rotineiros seguem o fluxo EAS build/submit e as verificações de processamento e disponibilidade em [references/testflight.md]. Um build EAS bem-sucedido ou uma submissão em fila não estabelecem a aceitação da Apple, o acesso do testador ou um lançamento na App Store.

Referências

Consulte estes recursos conforme necessário:

• ./references/workflows.md -- Fluxos de trabalho CI/CD para lançamentos automatizados na loja e prévias de PR
• ./references/testflight.md -- Submetendo builds iOS para TestFlight para testes beta
• ./references/app-store-metadata.md -- Gerenciando metadados da App Store e otimização ASO
• ./references/play-store.md -- Submetendo builds Android para Google Play Store
• ./references/ios-app-store.md -- Processo de submissão e revisão da App Store iOS
• ./references/native-ios.md -- Configuração nativa Swift/SwiftUI/UIKit, versionamento e verificação de arquivo sem um runtime Expo

Quick Start Expo / React Native

Instalar EAS CLI

npm install -g eas-cli
eas login

Inicializar EAS

npx eas-cli@latest init

eas init vincula ou cria o projeto EAS. Execute eas build:configure para criar perfis de build em eas.json; preserve os identificadores de projeto e loja existentes quando uma configuração de lançamento já existir.

Comandos de Build

Builds 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

Submeter para Lojas

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

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

# Expo / React Native shortcut for iOS TestFlight
npx testflight

Hospedagem de Rotas Web e API

A implantação de um site Expo ou rotas de API Expo Router no EAS Hosting (npx expo export -p web então eas deploy) é coberta pela habilidade eas-hosting. Esta habilidade foca em lançamentos de aplicativos nativos na loja.

Configuração EAS

Exemplo para um projeto Expo / React Native (perfis nativos Swift estão em references/native-ios.md):

{
  "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

…