Noções Básicas do EAS Build

Dez exemplos para eas.json, perfis de build e seu primeiro build iOS/Android na nuvem - a base operacional para distribuir binários do Expo SDK 57 sem Xcode ou Android Studio local em cada máquina.

Pré-requisitos

Comece com um aplicativo Expo em branco com SDK 57 fixado e EAS CLI instalado globalmente ou via npx:

npx create-expo-app@latest EasBuildBasics --template blank-typescript@sdk-57 --yes
cd EasBuildBasics
npm install -g eas-cli@latest
eas login

Confirme o pin da stack antes de configurar os builds:

{
  "dependencies": {
    "expo": "~57.0.4",
    "react": "19.2.3",
    "react-native": "0.86.0"
  }
}

Ferramentas: Estes exemplos visam o Expo SDK 57 (expo ~57.0.4), React Native 0.86.0 e React 19.2.3. Leia Noções Básicas de Prebuild antes do seu primeiro build EAS sob Geração Nativa Contínua (CNG).

Exemplos Básicos

1. O que o EAS Build Faz

EAS Build é o serviço de compilação na nuvem do Expo. Para um aplicativo CNG típico, ele:

1. Envia seu JavaScript, app.config.ts, lockfile e modules/ (não ios/ / android/ ignorados pelo git)
2. Executa npx expo prebuild quando as pastas nativas estão ausentes
3. Instala dependências CocoaPods e Gradle em runners macOS / Linux
4. Assina o artefato com credenciais do EAS Credentials
5. Retorna um link de download de IPA, AAB/APK ou build de simulador

eas build:configure

• eas build:configure cria eas.json e vincula o projeto à sua conta Expo
• Xcode local é opcional - a compilação ocorre na infraestrutura do Expo
• Veja CNG em CI para quando as pastas nativas são geradas versus commitadas

2. Vincule o Projeto ao EAS

Todo build precisa de um ID de projeto Expo em app.config.ts:

eas init

// app.config.ts
import type { ExpoConfig } from "expo/config";
 
const config: ExpoConfig = {
  name: "EasBuildBasics",
  slug: "eas-build-basics",
  version: "1.0.0",
  ios: {
    bundleIdentifier: "com.example.easbuildbasics",
  },
  android: {
    package: "com.example.easbuildbasics",
  },
  extra: {
    eas: {
      projectId: "00000000-0000-0000-0000-000000000000", // de eas init
    },
  },
};
 
export default config;

npx expo config --type public | jq '.extra.eas.projectId'

• eas init escreve projectId - faça commit de app.config.ts após vincular
• Builds sem projectId falham cedo com um erro de configuração claro
• Aplicativos white-label precisam de um ID de projeto por listagem na loja - veja Perfis de Build e Flavors

3. eas.json Mínimo

eas.json é o contrato de build - os perfis nomeiam conjuntos de credenciais, canais de distribuição e variáveis de ambiente:

{
  "cli": {
    "version": ">= 16.0.0",
    "appVersionSource": "remote"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "production": {}
  }
}

eas build --profile preview --platform ios

• cli.version fixa o EAS CLI mínimo - o CI deve corresponder ou exceder isso
• appVersionSource: "remote" permite que o EAS incremente automaticamente buildNumber / versionCode em perfis de loja
• Três perfis cobrem a maioria das equipes: development, preview, production

4. Perfil de Desenvolvimento (Dev Client)

Engenheiros precisam de um binário nativo com expo-dev-client embutido - não o Expo Go:

npx expo install expo-dev-client

{
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "environment": "development",
      "ios": {
        "simulator": true
      },
      "android": {
        "buildType": "apk"
      }
    }
  }
}

# Binário para Simulador iOS (sem registro de dispositivo)
eas build --profile development --platform ios
 
# APK Android para sideload via USB
eas build --profile development --platform android

• developmentClient: true compila o menu de desenvolvimento e módulos nativos personalizados
• Recompile após atualizações de SDK ou alterações de dependência nativa - OTA não pode atualizar o cliente de desenvolvimento
• Emparelhe com Regras de Release & OTA para alinhamento de versão em tempo de execução

5. Perfil de Preview (Formato QA)

Builds de preview se parecem com os de produção, mas são instalados via distribuição interna - TestFlight interno, ad hoc ou links de APK:

{
  "build": {
    "preview": {
      "distribution": "internal",
      "environment": "preview",
      "channel": "preview",
      "ios": {
        "simulator": false
      },
      "android": {
        "buildType": "apk"
      }
    }
  }
}

eas build --profile preview --platform all

• distribution": "internal" pula a liberação pública na loja - veja Distribuição Interna
• channel vincula o binário aos pacotes EAS Update publicados com eas update --channel preview
• Use preview para push, links universais e QA de câmera em dispositivos físicos

6. Perfil de Produção (Formato de Loja)

Compilações de produção geram binários de release assinados para App Store Connect e Google Play:

{
  "build": {
    "production": {
      "distribution": "store",
      "environment": "production",
      "channel": "production",
      "autoIncrement": true,
      "android": {
        "buildType": "app-bundle"
      }
    }
  }
}

eas build --profile production --platform all --non-interactive

• distribution": "store" produz artefatos prontos para App Store / Play
• buildType": "app-bundle" é necessário para produção no Play - AAB, não APK
• autoIncrement": true incrementa buildNumber do iOS e versionCode do Android remotamente

7. Primeiro Build iOS na Nuvem

A configuração interativa do primeiro build orienta a configuração de credenciais - aceite credenciais gerenciadas pelo EAS, a menos que você tenha uma cadeia de certificados existente:

eas build --profile production --platform ios

Fluxo de prompts (primeira vez):

? Gerar um novo Certificado de Distribuição Apple? › Sim
? Gerar um novo Perfil de Provisionamento Apple? › Sim
? Fazer login na sua conta de Desenvolvedor Apple › ...

Após o sucesso:

eas build:list --platform ios --limit 3

• O EAS armazena certificados e perfis criptografados - os colegas de equipe executam builds --non-interactive
• Mergulho profundo: Credenciais e Provisionamento iOS
• Contexto da plataforma iOS: Noções Básicas de iOS para Desenvolvedores RN

8. Primeiro Build Android na Nuvem

O primeiro build Android gera ou carrega um keystore - deixe o EAS criar um para aplicativos greenfield:

eas build --profile production --platform android

? Gerar um novo Keystore Android? › Sim

Inspecione as credenciais armazenadas:

eas credentials --platform android

• O Google Play espera um AAB assinado com sua chave de upload - o Play App Signing detém a chave de assinatura do aplicativo
• Mergulho profundo: Keystores e Assinatura Android
• Contexto da plataforma: Assinatura e Play App Signing

9. Monitore Builds e Baixe Artefatos

Acompanhe as compilações em andamento e recupere links de instalação:

# Assista ao último build
eas build --profile preview --platform ios --wait
 
# Liste builds recentes
eas build:list --status finished --limit 5
 
# Abra a página do build no navegador
eas build:view

// Metadados de exemplo de build concluído (abreviado)
{
  "status": "FINISHED",
  "platform": "IOS",
  "artifacts": {
    "buildUrl": "https://expo.dev/artifacts/eas/....ipa"
  }
}

• Compartilhe buildUrl com QA para sideload de APK/IPA ou instalações ad hoc
• Builds falhados registram erros de prebuild, pod install e Gradle - corrija plugins de configuração antes de tentar novamente
• CI usa --non-interactive e consulta eas build:list ou webhooks do EAS

10. CNG: Deixe o EAS Executar o Prebuild

Aplicativos CNG padrão ignoram pastas nativas - o EAS as regenera em cada build:

# .gitignore
ios/
android/

{
  "build": {
    "production": {
      "env": {
        "EXPO_NO_CAPABILITY_SYNC": "0"
      }
    }
  }
}

# Verificação local antes de gastar minutos do EAS
npx expo-doctor
npx expo prebuild --no-install
eas build --profile production --platform all

• Envie configuração + JS, não Info.plist editado manualmente - expresse alterações nativas em plugins
• Noções Básicas de Prebuild - o que o prebuild escreve antes da compilação
• Detecção de Impressão Digital e Alterações Nativas - quando recompilar versus OTA

FAQs

Relacionados

• Credenciais e Provisionamento iOS - certificados, perfis e credenciais gerenciadas pelo EAS
• Keystores e Assinatura Android - chaves de upload e Play App Signing
• Perfis de Build e Flavors - dev, preview, production, white-label
• EAS Submit - uploads para App Store Connect e Play Console
• ../cng-prebuild/prebuild-basics/prebuild-basics.md - gerando projetos nativos a partir da configuração
• ../cng-prebuild/cng-in-ci/cng-in-ci.md - quando o EAS gera versus faz commit de pastas nativas
• ../ios-platform/ios-basics-for-rn-devs/ios-basics-for-rn-devs.md - conceitos do Xcode para equipes RN
• ../android-platform/android-basics-for-rn-devs/android-basics-for-rn-devs.md - Gradle e identidade do pacote
• ../expo-rules/release-and-ota-rules/release-and-ota-rules.md - versão em tempo de execução e higiene de canais

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