expo-dev-client

Use o EAS Build para criar clientes de desenvolvimento para testar alterações de código nativo em dispositivos físicos. Use isso para criar clientes Expo Go personalizados para testar branches do seu aplicativo.

Importante: Quando Clientes de Desenvolvimento São Necessários

Clientes de desenvolvimento são a configuração recomendada para qualquer aplicativo real ou de produção. O Expo Go é um playground para aprender e fazer experimentos rápidos com as bibliotecas nativas que ele inclui; a maioria dos aplicativos o supera e migra para um cliente de desenvolvimento. Veja Expo Go vs. builds de desenvolvimento para o raciocínio completo.

Você precisa de um cliente de desenvolvimento SOMENTE ao usar:

• Módulos Expo locais (código nativo personalizado)
• Alvos da Apple (widgets, app clips, extensões)
• Módulos nativos de terceiros que não estão no Expo Go
• Plugins de configuração, ou ao testar notificações push remotas e links App/Universal

Configuração do EAS

Certifique-se de que eas.json tenha um perfil de desenvolvimento:

{
  "cli": {
    "version": ">= 16.0.1",
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true
    },
    "development": {
      "autoIncrement": true,
      "developmentClient": true
    }
  },
  "submit": {
    "production": {},
    "development": {}
  }
}

Configurações principais:

• developmentClient: true - Empacota o expo-dev-client para builds de desenvolvimento
• autoIncrement: true - Incrementa automaticamente os números de build
• appVersionSource: "remote" - Usa o EAS como fonte da verdade para números de versão

Compilando para TestFlight

Compile o cliente de desenvolvimento iOS e envie para o TestFlight em um único comando:

eas build -p ios --profile development --submit

Isso irá:

1. Compilar o cliente de desenvolvimento na nuvem
2. Enviar automaticamente para o App Store Connect
3. Enviar um e-mail quando o build estiver pronto no TestFlight

Após receber o e-mail do TestFlight:

1. Baixe o build do TestFlight no seu dispositivo
2. Inicie o aplicativo para ver a interface do expo-dev-client
3. Conecte-se ao seu bundler Metro local ou escaneie um código QR

Compilando Localmente

Compile um cliente de desenvolvimento na sua máquina:

# iOS (requires Xcode)
## When to Use

Use this skill when you need build Expo app for development.

eas build -p ios --profile development --local

# Android
eas build -p android --profile development --local

Saída dos builds locais:

• iOS: arquivo .ipa
• Android: arquivo .apk ou .aab

Instalando Builds Locais

Instale o build iOS no simulador:

# Find the .app in the .tar.gz output
tar -xzf build-*.tar.gz
xcrun simctl install booted ./path/to/App.app

Instale o build iOS no dispositivo (requer assinatura):

# Use Xcode Devices window or ideviceinstaller
ideviceinstaller -i build.ipa

Instale o build Android:

adb install build.apk

Compilando para Plataforma Específica

# iOS only
eas build -p ios --profile development

# Android only
eas build -p android --profile development

# Both platforms
eas build --profile development

Verificando o Status do Build

# List recent builds
eas build:list

# View build details
eas build:view

Usando o Cliente de Desenvolvimento

Uma vez instalado, o cliente de desenvolvimento oferece:

• Conexão com o servidor de desenvolvimento - Insira a URL do seu bundler Metro ou escaneie o QR code
• Informações do build - Visualize detalhes do build nativo
• Interface do lançador - Alterne entre servidores de desenvolvimento

Conecte-se ao desenvolvimento local:

# Start Metro bundler
npx expo start --dev-client

# Scan QR code with dev client or enter URL manually

Solução de Problemas

Build falha com erros de assinatura:

eas credentials

Limpar cache de build:

eas build -p ios --profile development --clear-cache

Verificar versão do EAS CLI:

eas --version
eas update

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo do produto ou API de origem.
• Verifique comandos, comportamento da API, preços, cotas, credenciais e efeitos de implantação contra a 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 custosas.