expo-dev-client

Q: Como instalo o expo-dev-client no SDK 57?

Nunca fixe a versão manualmente - expo install resolve a versão compatível com SDK 57.

Q: Qual a diferença entre launchMode most-recent e launcher?

most-recent abre o último URL do Metro diretamente (volta para o launcher se inacessível). launcher sempre mostra o seletor de servidor - melhor para QA alternar branches.

Q: Como adiciono botões personalizados ao menu dev?

Registre uma vez no início do aplicativo em __DEV__ apenas.

Q: Como abro o menu dev sem agitar o telefone?

Pressione m no terminal do Metro, chame DevClient.openMenu() do JS, ou use o toque longo de três dedos nos simuladores iOS.

Q: Qual perfil do eas.json compila um cliente dev?

Defina "developmentClient": true em um perfil de build (comumente chamado development). Execute eas build --profile development.

Q: O expo-dev-client funciona em simuladores?

Sim. Use "ios": { "simulator": true } no perfil de desenvolvimento para IPAs de simulador, ou npx expo run:ios localmente.

expo-dev-client transforma seu binário de depuração em um ambiente de desenvolvimento completo: um launcher para alternar servidores Metro, um menu dev extensível e suporte para todos os módulos nativos que seu projeto instala - o caminho padrão além do Expo Go no SDK 57.

Receita

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

# Adiciona a biblioteca (fixa a versão compatível para SDK 57)
npx expo install expo-dev-client
 
# Compila e instala um cliente de desenvolvimento
npx expo run:ios          # simulador local / dispositivo USB
npx expo run:android --device
# - ou nuvem -
eas build --profile development --platform all
 
# Serve JavaScript para o cliente de desenvolvimento (não para Expo Go)
npx expo start --dev-client

// app.json - comportamento do launcher (reconstrução necessária após alterações)
{
  "expo": {
    "plugins": [
      [
        "expo-dev-client",
        {
          "launchMode": "most-recent",
          "ios": { "launchMode": "launcher" }
        }
      ]
    ]
  }
}

Quando usar isso:

Instalar qualquer módulo nativo não incluído no Expo Go (react-native-maps com configuração personalizada, Stripe, etc.).
QA precisa alternar entre URLs do Metro localhost, staging e pré-visualização de PR.
Adicionar entradas personalizadas ao menu dev de agitar (shake) / três dedos.
Testar links universais, push e ícones de aplicativos com seu identificador de bundle real.
Permanecer no fluxo gerenciado ao superar a superfície nativa fixa do Expo Go.

Exemplo de Trabalho

// App.tsx - itens personalizados do menu dev + banner em tempo de execução
import { useEffect } from "react";
import { Button, Platform, StyleSheet, Text, View } from "react-native";
import * as DevClient from "expo-dev-client";
import * as Expo from "expo";
 
async function registerDevTools() {
  if (!__DEV__) return;
 
  await DevClient.registerDevMenuItems([
    {
      name: "Logar configuração do app",
      callback: () => {
        console.log("Executando no Expo Go?", Expo.isRunningInExpoGo());
      },
      shouldCollapse: true,
    },
    {
      name: "Lançar erro de teste",
      callback: () => {
        throw new Error("Crash intencional do menu dev para QA");
      },
      shouldCollapse: true,
    },
  ]);
}
 
export default function App() {
  useEffect(() => {
    registerDevTools().catch(console.error);
  }, []);
 
  return (
    <View style={styles.container}>
      <Text style={styles.title}>Demo do expo-dev-client</Text>
      <Text style={styles.row}>Plataforma: {Platform.OS}</Text>
      <Text style={styles.row}>
        Executando no Expo Go: {Expo.isRunningInExpoGo() ? "sim" : "não"}
      </Text>
      <Text style={styles.hint}>
        Agite o dispositivo (ou pressione m no terminal) → abra o menu dev → experimente os itens personalizados.
      </Text>
      <Button title="Abrir menu dev" onPress={() => DevClient.openMenu()} />
    </View>
  );
}
 
const styles = StyleSheet.create({
  container: { flex: 1, justifyContent: "center", alignItems: "center", padding: 24 },
  title: { fontSize: 22, fontWeight: "700", marginBottom: 12 },
  row: { fontSize: 14, color: "#475569", marginBottom: 4 },
  hint: { marginTop: 16, fontSize: 12, color: "#64748b", textAlign: "center" },
});

// eas.json - perfil de desenvolvimento com cliente dev habilitado
{
  "cli": { "version": ">= 16.0.0" },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "ios": { "simulator": true },
      "android": { "gradleCommand": ":app:assembleDebug" }
    }
  }
}

# Fluxo inicial após adicionar expo-dev-client
npx expo prebuild   # pule se android/ e ios/ já existirem
eas build --profile development --platform ios
# Instale o build → depois diariamente:
npx expo start --dev-client

O que isso demonstra:

registerDevMenuItems para diagnósticos específicos da equipe sem editar código nativo.
DevClient.openMenu() como um fallback programático para gestos de agitar.
eas.json developmentClient: true para que o EAS produza um binário de depuração com o launcher integrado.
Flag --dev-client para que o Metro nunca assuma que o Expo Go é o host.

Mergulho Profundo

Como Funciona

expo-dev-client é um módulo nativo mais um plugin de configuração que integra uma UI de launcher, esquema de deep-link e menu dev aprimorado em builds de depuração.
Builds de desenvolvimento (binários de depuração com expo-dev-client) carregam JavaScript do Metro - a mesma história de Fast Refresh do Expo Go, mas o lado nativo é o ID do seu aplicativo, ícones e módulos instalados.
launchMode controla o cold start: most-recent entra no último URL do projeto; launcher mostra o seletor de servidor (útil para QA alternar ambientes).
defaultLaunchURL pula o seletor completamente quando definido - combine com substituições por plataforma para Android emulator (10.0.2.2) vs iOS simulator (localhost).
Alterações nativas (novo plugin de configuração, expo prebuild, edições de Gradle/Pod) exigem npx expo run:* ou eas build; alterações puras de JS/TS têm hot-reload via npx expo start --dev-client.

Opções do Plugin de Configuração do Launcher

Propriedade	Padrão	Efeito
`launchMode`	`"most-recent"`	`most-recent` abre automaticamente o último servidor; `launcher` mostra o seletor
`defaultLaunchURL`	-	URL de cold-start quando o Metro está em um host fixo
`addGeneratedScheme`	`true`	Registra o deep link `exp+<slug>://` para abrir projetos
`ios.launchMode` / `android.launchMode`	herda o nível superior	Comportamento de lançamento por plataforma
`ios.defaultLaunchURL` / `android.defaultLaunchURL`	-	URL do Metro por plataforma

{
  "expo": {
    "plugins": [
      [
        "expo-dev-client",
        {
          "launchMode": "most-recent",
          "defaultLaunchURL": "http://localhost:8081",
          "android": { "defaultLaunchURL": "http://10.0.2.2:8081" }
        }
      ]
    ]
  }
}

Recompile o nativo após alterações no plugin: npx expo run:ios ou eas build --profile development.

Método	Propósito
`DevClient.openMenu()`	Mostrar o menu dev programaticamente
`DevClient.closeMenu()`	Fechar o menu
`DevClient.hideMenu()`	Ocultar sem efeitos colaterais de animação
`DevClient.registerDevMenuItems(items)`	Adicionar linhas personalizadas com `name`, `callback`, `shouldCollapse` opcional

Itens personalizados rodam na thread JS - mantenha os callbacks rápidos; adie trabalhos pesados com queueMicrotask ou InteractionManager.

Loop de Iteração de Módulo Nativo

# 1. Adicionar uma dependência nativa
npx expo install expo-camera
 
# 2. Regenerar projetos nativos se estiver usando CNG
npx expo prebuild
 
# 3. Recompilar o cliente dev (mudança nativa)
npx expo run:android --device
 
# 4. Iterar em JS - nenhuma reconstrução necessária até que o nativo mude novamente
npx expo start --dev-client

Notas TypeScript

const items = [
  {
    name: "Limpar async storage",
    shouldCollapse: true,
    callback: () => {
      console.log("Coloque Wire AsyncStorage.clear() aqui");
    },
  },
];
 
if (__DEV__) {
  void import("expo-dev-client").then((DevClient) =>
    DevClient.registerDevMenuItems(items)
  );
}

Proteja todas as APIs do dev-client com __DEV__ para que os builds de lançamento de produção façam tree-shake das chamadas (as APIs são no-ops em produção, mas a proteção mantém os bundles limpos).

Armadilhas

Iniciar o Metro sem --dev-client - O CLI pode esperar pelo Expo Go ou mostrar o QR code errado. Correção: Sempre use npx expo start --dev-client depois que o projeto depender de expo-dev-client.
Editar a configuração do plugin app.json sem reconstruir - As configurações do launcher são em tempo de compilação. Correção: Execute npx expo run:* ou eas build após alterações no plugin.
Emulador Android não consegue alcançar localhost:8081 - O emulador mapeia o loopback do host para 10.0.2.2. Correção: Defina android.defaultLaunchURL para http://10.0.2.2:8081 ou use --lan.
registerDevMenuItems após hot reload duplica entradas - Os itens são anexados a cada registro. Correção: Registre uma vez em um guarda if (__DEV__ && !globalThis.__DEV_MENU__) no nível do módulo.
Esperando o Expo Go carregar módulos nativos personalizados - O Expo Go envia um binário fixo. Correção: Instale seu build de desenvolvimento; Native module cannot be null significa que você precisa de uma reconstrução.
Usar builds de desenvolvimento para testes de desempenho da loja - Clientes de desenvolvimento de depuração incluem ferramentas extras. Correção: Perfilar em builds preview ou de lançamento para métricas de FPS e inicialização.
Confusão do Expo Go no simulador iOS - O simulador ainda pode ter o Expo Go instalado ao lado do seu cliente de desenvolvimento. Correção: Abra o ícone correto do aplicativo (o nome do seu aplicativo, não "Expo Go").

Alternativas

Alternativa	Use Quando	Não Use Quando
`expo-dev-client` + build de desenvolvimento	Módulos nativos personalizados, ID de bundle real, menu dev extensível	Spike puramente JS com apenas módulos do SDK Expo
Expo Go	Aprendizado mais rápido no primeiro dia, sem compilação nativa	Qualquer dependência nativa personalizada ou plugin de configuração
`expo run:ios/android` sem EAS	Compilação nativa local, dispositivo USB	Colegas no Windows que precisam de builds iOS
Perfil `development` do EAS	Toda a equipe instala o mesmo cliente dev a partir de um link	Você muda o código nativo a cada hora e tem toolchains locais completas
React Native Bare (`@react-native-community/cli`)	Controle total do repositório nativo sem Expo	Você quer EAS, módulos Expo e atualizações gerenciadas
Builds de lançamento de produção	Desempenho e envio para a loja	Iteração diária de JSX - o custo de reconstrução é muito alto

FAQs

O que é expo-dev-client?

Uma biblioteca e um plugin de configuração que adicionam um launcher de desenvolvimento, um menu dev aprimorado e ferramentas de depuração ao seu próprio binário de depuração de aplicativos - o nome do Expo para um "build de desenvolvimento".

Como instalo o expo-dev-client no SDK 57?

npx expo install expo-dev-client

Nunca fixe a versão manualmente - expo install resolve a versão compatível com SDK 57.

Por que devo executar expo start --dev-client?

A flag informa ao Expo CLI para gerar URLs e códigos QR para o seu binário personalizado. Sem ela, as ferramentas assumem que o Expo Go é o host de destino.

Qual a diferença entre launchMode most-recent e launcher?

most-recent abre o último URL do Metro diretamente (volta para o launcher se inacessível). launcher sempre mostra o seletor de servidor - melhor para QA alternar branches.

Quando preciso reconstruir o aplicativo nativo?

Após adicionar/remover módulos nativos, alterar plugins de configuração, editar ícones/splash/ID de bundle em app.json, ou atualizar o SDK Expo. Edições puras de JS têm hot-reload sem reconstrução.

Como adiciono botões personalizados ao menu dev?

import * as DevClient from "expo-dev-client";
 
await DevClient.registerDevMenuItems([
  { name: "Minha ação", callback: () => console.log("executar"), shouldCollapse: true },
]);

Registre uma vez no início do aplicativo em __DEV__ apenas.

Como abro o menu dev sem agitar o telefone?

Pressione m no terminal do Metro, chame DevClient.openMenu() do JS, ou use o toque longo de três dedos nos simuladores iOS.

Posso usar expo-dev-client com Expo Router?

Sim - o template padrão do SDK 57 inclui o Router. O cliente dev carrega sua entrada do roteador (app/_layout.tsx) como qualquer outro aplicativo.

Qual perfil do eas.json compila um cliente dev?

Defina "developmentClient": true em um perfil de build (comumente chamado development). Execute eas build --profile development.

O expo-dev-client funciona em simuladores?

Sim. Use "ios": { "simulator": true } no perfil de desenvolvimento para IPAs de simulador, ou npx expo run:ios localmente.

Qual URL os emuladores Android devem usar para o Metro?

http://10.0.2.2:8081 - o alias do emulador para o localhost da máquina host. Defina android.defaultLaunchURL na configuração do plugin.

O expo-dev-client está incluído em builds de produção?

O shell nativo é o mesmo projeto, mas a UI do dev-client é removida dos builds de lançamento. Envie eas build --profile production para os binários da loja.

Como isso é diferente do Expo Go?

Expo Go é um aplicativo compartilhado com um conjunto fixo de módulos nativos. Um cliente de desenvolvimento é o binário do seu aplicativo com suas dependências nativas e identificador de bundle.

Armadilha: Native module cannot be null - e agora?

Instale expo-dev-client, reconstrua com npx expo run:android ou eas build --profile development, instale o novo binário e, em seguida, inicie o Metro com --dev-client.

Relacionados

Expo Go vs. Builds de Desenvolvimento - guia de decisão antes de adicionar expo-dev-client
Testes em Dispositivos Físicos - USB, sem fio e builds internos para clientes dev
Simulador iOS e Emulador Android - execute clientes dev em dispositivos virtuais
React Native DevTools - inspetor e ferramentas de desempenho dentro de builds dev
Hot Reload vs Fast Refresh - limites de iteração JS dentro de clientes dev
app.json & app.config.js - array de plugins e integração de plugin de configuração

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

Receita

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

# Adiciona a biblioteca (fixa a versão compatível para SDK 57)
npx expo install expo-dev-client
 
# Compila e instala um cliente de desenvolvimento
npx expo run:ios          # simulador local / dispositivo USB
npx expo run:android --device
# - ou nuvem -
eas build --profile development --platform all
 
# Serve JavaScript para o cliente de desenvolvimento (não para Expo Go)
npx expo start --dev-client

// app.json - comportamento do launcher (reconstrução necessária após alterações)
{
  "expo": {
    "plugins": [
      [
        "expo-dev-client",
        {
          "launchMode": "most-recent",
          "ios": { "launchMode": "launcher" }
        }
      ]
    ]
  }
}

Quando usar isso:

Instalar qualquer módulo nativo não incluído no Expo Go (react-native-maps com configuração personalizada, Stripe, etc.).
QA precisa alternar entre URLs do Metro localhost, staging e pré-visualização de PR.
Adicionar entradas personalizadas ao menu dev de agitar (shake) / três dedos.
Testar links universais, push e ícones de aplicativos com seu identificador de bundle real.
Permanecer no fluxo gerenciado ao superar a superfície nativa fixa do Expo Go.

Exemplo de Trabalho

// App.tsx - itens personalizados do menu dev + banner em tempo de execução
import { useEffect } from "react";
import { Button, Platform, StyleSheet, Text, View } from "react-native";
import * as DevClient from "expo-dev-client";
import * as Expo from "expo";
 
async function registerDevTools() {
  if (!__DEV__) return;
 
  await DevClient.registerDevMenuItems([
    {
      name: "Logar configuração do app",
      callback: () => {
        console.log("Executando no Expo Go?", Expo.isRunningInExpoGo());
      },
      shouldCollapse: true,
    },
    {
      name: "Lançar erro de teste",
      callback: () => {
        throw new Error("Crash intencional do menu dev para QA");
      },
      shouldCollapse: true,
    },
  ]);
}
 
export default function App() {
  useEffect(() => {
    registerDevTools().catch(console.error);
  }, []);
 
  return (
    <View style={styles.container}>
      <Text style={styles.title}>Demo do expo-dev-client</Text>
      <Text style={styles.row}>Plataforma: {Platform.OS}</Text>
      <Text style={styles.row}>
        Executando no Expo Go: {Expo.isRunningInExpoGo() ? "sim" : "não"}
      </Text>
      <Text style={styles.hint}>
        Agite o dispositivo (ou pressione m no terminal) → abra o menu dev → experimente os itens personalizados.
      </Text>
      <Button title="Abrir menu dev" onPress={() => DevClient.openMenu()} />
    </View>
  );
}
 
const styles = StyleSheet.create({
  container: { flex: 1, justifyContent: "center", alignItems: "center", padding: 24 },
  title: { fontSize: 22, fontWeight: "700", marginBottom: 12 },
  row: { fontSize: 14, color: "#475569", marginBottom: 4 },
  hint: { marginTop: 16, fontSize: 12, color: "#64748b", textAlign: "center" },
});

// eas.json - perfil de desenvolvimento com cliente dev habilitado
{
  "cli": { "version": ">= 16.0.0" },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "ios": { "simulator": true },
      "android": { "gradleCommand": ":app:assembleDebug" }
    }
  }
}

# Fluxo inicial após adicionar expo-dev-client
npx expo prebuild   # pule se android/ e ios/ já existirem
eas build --profile development --platform ios
# Instale o build → depois diariamente:
npx expo start --dev-client

O que isso demonstra:

registerDevMenuItems para diagnósticos específicos da equipe sem editar código nativo.
DevClient.openMenu() como um fallback programático para gestos de agitar.
eas.json developmentClient: true para que o EAS produza um binário de depuração com o launcher integrado.
Flag --dev-client para que o Metro nunca assuma que o Expo Go é o host.

Mergulho Profundo

Como Funciona

expo-dev-client é um módulo nativo mais um plugin de configuração que integra uma UI de launcher, esquema de deep-link e menu dev aprimorado em builds de depuração.
Builds de desenvolvimento (binários de depuração com expo-dev-client) carregam JavaScript do Metro - a mesma história de Fast Refresh do Expo Go, mas o lado nativo é o ID do seu aplicativo, ícones e módulos instalados.
launchMode controla o cold start: most-recent entra no último URL do projeto; launcher mostra o seletor de servidor (útil para QA alternar ambientes).
defaultLaunchURL pula o seletor completamente quando definido - combine com substituições por plataforma para Android emulator (10.0.2.2) vs iOS simulator (localhost).
Alterações nativas (novo plugin de configuração, expo prebuild, edições de Gradle/Pod) exigem npx expo run:* ou eas build; alterações puras de JS/TS têm hot-reload via npx expo start --dev-client.

Opções do Plugin de Configuração do Launcher

Propriedade	Padrão	Efeito
`launchMode`	`"most-recent"`	`most-recent` abre automaticamente o último servidor; `launcher` mostra o seletor
`defaultLaunchURL`	-	URL de cold-start quando o Metro está em um host fixo
`addGeneratedScheme`	`true`	Registra o deep link `exp+<slug>://` para abrir projetos
`ios.launchMode` / `android.launchMode`	herda o nível superior	Comportamento de lançamento por plataforma
`ios.defaultLaunchURL` / `android.defaultLaunchURL`	-	URL do Metro por plataforma

{
  "expo": {
    "plugins": [
      [
        "expo-dev-client",
        {
          "launchMode": "most-recent",
          "defaultLaunchURL": "http://localhost:8081",
          "android": { "defaultLaunchURL": "http://10.0.2.2:8081" }
        }
      ]
    ]
  }
}

Recompile o nativo após alterações no plugin: npx expo run:ios ou eas build --profile development.

Método	Propósito
`DevClient.openMenu()`	Mostrar o menu dev programaticamente
`DevClient.closeMenu()`	Fechar o menu
`DevClient.hideMenu()`	Ocultar sem efeitos colaterais de animação
`DevClient.registerDevMenuItems(items)`	Adicionar linhas personalizadas com `name`, `callback`, `shouldCollapse` opcional

Itens personalizados rodam na thread JS - mantenha os callbacks rápidos; adie trabalhos pesados com queueMicrotask ou InteractionManager.

Loop de Iteração de Módulo Nativo

# 1. Adicionar uma dependência nativa
npx expo install expo-camera
 
# 2. Regenerar projetos nativos se estiver usando CNG
npx expo prebuild
 
# 3. Recompilar o cliente dev (mudança nativa)
npx expo run:android --device
 
# 4. Iterar em JS - nenhuma reconstrução necessária até que o nativo mude novamente
npx expo start --dev-client

Notas TypeScript

const items = [
  {
    name: "Limpar async storage",
    shouldCollapse: true,
    callback: () => {
      console.log("Coloque Wire AsyncStorage.clear() aqui");
    },
  },
];
 
if (__DEV__) {
  void import("expo-dev-client").then((DevClient) =>
    DevClient.registerDevMenuItems(items)
  );
}

Armadilhas

Iniciar o Metro sem --dev-client - O CLI pode esperar pelo Expo Go ou mostrar o QR code errado. Correção: Sempre use npx expo start --dev-client depois que o projeto depender de expo-dev-client.
Editar a configuração do plugin app.json sem reconstruir - As configurações do launcher são em tempo de compilação. Correção: Execute npx expo run:* ou eas build após alterações no plugin.
Emulador Android não consegue alcançar localhost:8081 - O emulador mapeia o loopback do host para 10.0.2.2. Correção: Defina android.defaultLaunchURL para http://10.0.2.2:8081 ou use --lan.
registerDevMenuItems após hot reload duplica entradas - Os itens são anexados a cada registro. Correção: Registre uma vez em um guarda if (__DEV__ && !globalThis.__DEV_MENU__) no nível do módulo.
Esperando o Expo Go carregar módulos nativos personalizados - O Expo Go envia um binário fixo. Correção: Instale seu build de desenvolvimento; Native module cannot be null significa que você precisa de uma reconstrução.
Usar builds de desenvolvimento para testes de desempenho da loja - Clientes de desenvolvimento de depuração incluem ferramentas extras. Correção: Perfilar em builds preview ou de lançamento para métricas de FPS e inicialização.
Confusão do Expo Go no simulador iOS - O simulador ainda pode ter o Expo Go instalado ao lado do seu cliente de desenvolvimento. Correção: Abra o ícone correto do aplicativo (o nome do seu aplicativo, não "Expo Go").

Alternativas

Alternativa	Use Quando	Não Use Quando
`expo-dev-client` + build de desenvolvimento	Módulos nativos personalizados, ID de bundle real, menu dev extensível	Spike puramente JS com apenas módulos do SDK Expo
Expo Go	Aprendizado mais rápido no primeiro dia, sem compilação nativa	Qualquer dependência nativa personalizada ou plugin de configuração
`expo run:ios/android` sem EAS	Compilação nativa local, dispositivo USB	Colegas no Windows que precisam de builds iOS
Perfil `development` do EAS	Toda a equipe instala o mesmo cliente dev a partir de um link	Você muda o código nativo a cada hora e tem toolchains locais completas
React Native Bare (`@react-native-community/cli`)	Controle total do repositório nativo sem Expo	Você quer EAS, módulos Expo e atualizações gerenciadas
Builds de lançamento de produção	Desempenho e envio para a loja	Iteração diária de JSX - o custo de reconstrução é muito alto

FAQs

O que é expo-dev-client?

Como instalo o expo-dev-client no SDK 57?

npx expo install expo-dev-client

Nunca fixe a versão manualmente - expo install resolve a versão compatível com SDK 57.

Por que devo executar expo start --dev-client?

A flag informa ao Expo CLI para gerar URLs e códigos QR para o seu binário personalizado. Sem ela, as ferramentas assumem que o Expo Go é o host de destino.

Qual a diferença entre launchMode most-recent e launcher?

most-recent abre o último URL do Metro diretamente (volta para o launcher se inacessível). launcher sempre mostra o seletor de servidor - melhor para QA alternar branches.

Quando preciso reconstruir o aplicativo nativo?

Como adiciono botões personalizados ao menu dev?

import * as DevClient from "expo-dev-client";
 
await DevClient.registerDevMenuItems([
  { name: "Minha ação", callback: () => console.log("executar"), shouldCollapse: true },
]);

Registre uma vez no início do aplicativo em __DEV__ apenas.

Como abro o menu dev sem agitar o telefone?

Pressione m no terminal do Metro, chame DevClient.openMenu() do JS, ou use o toque longo de três dedos nos simuladores iOS.

Posso usar expo-dev-client com Expo Router?

Sim - o template padrão do SDK 57 inclui o Router. O cliente dev carrega sua entrada do roteador (app/_layout.tsx) como qualquer outro aplicativo.

Qual perfil do eas.json compila um cliente dev?

Defina "developmentClient": true em um perfil de build (comumente chamado development). Execute eas build --profile development.

O expo-dev-client funciona em simuladores?

Sim. Use "ios": { "simulator": true } no perfil de desenvolvimento para IPAs de simulador, ou npx expo run:ios localmente.

Qual URL os emuladores Android devem usar para o Metro?

http://10.0.2.2:8081 - o alias do emulador para o localhost da máquina host. Defina android.defaultLaunchURL na configuração do plugin.

O expo-dev-client está incluído em builds de produção?

O shell nativo é o mesmo projeto, mas a UI do dev-client é removida dos builds de lançamento. Envie eas build --profile production para os binários da loja.

Como isso é diferente do Expo Go?

Armadilha: Native module cannot be null - e agora?

Instale expo-dev-client, reconstrua com npx expo run:android ou eas build --profile development, instale o novo binário e, em seguida, inicie o Metro com --dev-client.

Relacionados

Expo Go vs. Builds de Desenvolvimento - guia de decisão antes de adicionar expo-dev-client
Testes em Dispositivos Físicos - USB, sem fio e builds internos para clientes dev
Simulador iOS e Emulador Android - execute clientes dev em dispositivos virtuais
React Native DevTools - inspetor e ferramentas de desempenho dentro de builds dev
Hot Reload vs Fast Refresh - limites de iteração JS dentro de clientes dev
app.json & app.config.js - array de plugins e integração de plugin de configuração

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

expo-dev-client

Receita

Exemplo de Trabalho

Mergulho Profundo

Como Funciona

Opções do Plugin de Configuração do Launcher

API do Menu Dev

Loop de Iteração de Módulo Nativo

Notas TypeScript

Armadilhas

Alternativas

FAQs

Relacionados

expo-dev-client

Receita

Exemplo de Trabalho

Mergulho Profundo

Como Funciona

Opções do Plugin de Configuração do Launcher

API do Menu Dev

Loop de Iteração de Módulo Nativo

Notas TypeScript

Armadilhas

Alternativas

FAQs

Relacionados

expo-dev-client

Buscar na documentação

expo-dev-client