Testes em Dispositivos Físicos

Simuladores são rápidos; dispositivos físicos são verdadeiros. A depuração USB e sem fio conecta seu aplicativo SDK 57 a hardware real, e a distribuição interna envia builds instaláveis para QA sem revisão da App Store - o ciclo que toda equipe móvel precisa antes da produção.

Receita

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

# Android USB - verify the device is visible
adb devices
# Expect: <serial>    device
 
# Run a development build directly on the plugged-in phone
npx expo install expo-dev-client
npx expo run:android --device
 
# iOS USB - pick the connected iPhone in Xcode or:
npx expo run:ios --device
 
# Start Metro for an installed dev client (same Wi‑Fi or USB)
npx expo start --dev-client --lan
 
# Android wireless (Android 11+) after initial USB pairing
adb pair <ip>:<pairing-port>    # one-time, from Developer options
adb connect <ip>:5555
adb devices
 
# Internal QA build (installable .ipa / .apk)
eas build --profile preview --platform all

Quando usar isto:

• Validar câmera, biometria, notificações push ou haptics que simuladores fingem ou pulam.
• Medir o desempenho de rolagem e o uso de memória em SoCs reais.
• QA precisa de um build instalável sem lançamento público na loja.
• Depurar problemas de LAN - USB (--localhost / adb reverse) contorna Wi‑Fi instável.
• Testar um candidato a lançamento nos telefones dos colegas de equipe via TestFlight ou teste interno do Play.

Exemplo de Trabalho

#!/usr/bin/env bash
# scripts/qa-device-session.sh - USB check, dev build, internal preview build
set -euo pipefail
 
PLATFORM="${1:-android}"   # android | ios
 
echo "▶ Checking expo-dev-client…"
npx expo install expo-dev-client
 
if [[ "$PLATFORM" == "android" ]]; then
  echo "▶ Android devices:"
  adb devices
  if ! adb devices | grep -w device | grep -v "List of devices" >/dev/null; then
    echo "❌ No Android device in 'device' state. Enable USB debugging and accept the RSA prompt."
    exit 1
  fi
  npx expo run:android --device
  npx expo start --dev-client --lan
else
  echo "▶ iOS devices (requires Xcode):"
  xcrun xctrace list devices 2>/dev/null || instruments -s devices
  npx expo run:ios --device
  npx expo start --dev-client --lan
fi

// eas.json - development (daily) + preview (internal QA distribution)
{
  "cli": { "version": ">= 16.0.0" },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "android": { "gradleCommand": ":app:assembleDebug" },
      "ios": { "simulator": false }
    },
    "preview": {
      "distribution": "internal",
      "channel": "preview",
      "android": { "buildType": "apk" },
      "ios": { "simulator": false }
    }
  }
}

# After eas.json exists:
eas login
eas build:configure   # if not already done
 
# Daily dev on your phone
eas build --profile development --platform android
# Install from the QR/link, then:
npx expo start --dev-client
 
# Hand to QA - internal distribution (no store review)
eas build --profile preview --platform ios
eas build --profile preview --platform android
# iOS → TestFlight internal group; Android → direct APK or Play internal track

// App.tsx - show connection mode so QA can report environment accurately
import { useEffect, useState } from "react";
import { StyleSheet, Text, View } from "react-native";
import * as Device from "expo-device";
import Constants from "expo-constants";
 
export default function App() {
  const [info, setInfo] = useState("Loading…");
 
  useEffect(() => {
    const model = Device.modelName ?? "unknown";
    const os = `${Device.osName} ${Device.osVersion}`;
    const build = Constants.expoConfig?.version ?? "0.0.0";
    const channel = Constants.expoConfig?.extra?.eas?.channel ?? "local";
    setInfo(`${model} · ${os} · v${build} · channel:${channel}`);
  }, []);
 
  return (
    <View style={styles.container}>
      <Text style={styles.title}>QA device probe</Text>
      <Text style={styles.body}>{info}</Text>
      <Text style={styles.hint}>Shake device → dev menu → Reload after Metro reconnects.</Text>
    </View>
  );
}
 
const styles = StyleSheet.create({
  container: { flex: 1, justifyContent: "center", alignItems: "center", padding: 24 },
  title: { fontSize: 20, fontWeight: "700", marginBottom: 8 },
  body: { fontSize: 14, textAlign: "center", color: "#334155" },
  hint: { marginTop: 16, fontSize: 12, color: "#64748b" },
});

O que isso demonstra:

• adb devices como o portão antes das implantações USB do Android.
• npx expo run:android --device / npx expo run:ios --device para compilações nativas locais em hardware.
• Perfis eas.json separando desenvolvimento (cliente de desenvolvimento + depuração) de prévia (QA interno).
• Metadados expo-device na tela para que relatórios de bugs incluam modelo e sistema operacional.

Mergulho Profundo

Como Funciona

• Depuração USB expõe o dispositivo ao adb (Android) ou devicectl/ios-deploy do Xcode (iOS). O Expo CLI e npx expo run:* encaminham o bundle do Metro pela conexão.
• npx expo start --dev-client serve JavaScript para um build de desenvolvimento instalado - o shell nativo permanece no telefone; o JS recarrega rapidamente via LAN, túnel ou encaminhamento de porta USB.
• Depuração sem fio mantém o mesmo URL do Metro após o emparelhamento inicial - o Android usa adb pair + adb connect; o iOS usa a janela Window > Devices and Simulators do Xcode para emparelhamento sem fio (fluxo de trabalho do iOS 17+ no Xcode 15+).
• Distribuição interna (distribution: "internal" em eas.json) produz IPAs iOS ad-hoc (dispositivos registrados) ou APKs Android / uploads da trilha interna do Play - não listagens públicas na loja.
• Builds do canal de prévia combinam bem com o EAS Update para que o QA possa receber bundles JS OTA após a instalação do shell nativo.

Configuração USB do Android

# USB port reverse - device hits laptop localhost (works when LAN is blocked)
adb reverse tcp:8081 tcp:8081
npx expo start --dev-client --localhost

Configuração USB do iOS

IDs Apple gratuitos podem implantar em seu próprio dispositivo para testes limitados; a distribuição em equipe requer uma assinatura do Apple Developer Program.

Depuração Sem Fio

Após adb connect sem fio, execute npx expo start --dev-client --lan e certifique-se de que o telefone e o laptop compartilham uma sub-rede (Wi‑Fi de convidado geralmente bloqueia tráfego entre pares).

Perfis de Distribuição Interna

# Register iOS test devices before ad-hoc/internal iOS builds
eas device:create
 
# Submit preview iOS build to TestFlight internal testers
eas build --profile preview --platform ios
eas submit --platform ios --latest

Modos de Conexão para Metro

Notas TypeScript

import * as Device from "expo-device";
 
if (__DEV__ && Device.isDevice) {
  console.log(`Physical device: ${Device.modelName}, OS ${Device.osVersion}`);
}

Instale com npx expo install expo-device - as versões se alinham automaticamente com o SDK 57.

Armadilhas

• adb devices mostra unauthorized - O prompt RSA foi dispensado. Correção: Revogue as autorizações de depuração USB no telefone, reconecte o USB, aceite o prompt.
• Build iOS falha com erros de provisionamento - UDID do dispositivo não está no perfil. Correção: Execute eas device:create e reconstrua, ou registre o dispositivo no portal Apple Developer.
• Metro inacessível na LAN - Redes de convidados bloqueiam o tráfego do dispositivo para o laptop. Correção: Use adb reverse + --localhost no Android, ou --tunnel em ambas as plataformas.
• Expo Go no dispositivo não corresponde ao SDK 57 - O Expo Go da App Store pode estar atrasado em relação ao SDK do seu projeto. Correção: Use um build de desenvolvimento; o Expo Go não pode carregar módulos nativos arbitrários de qualquer maneira.
• adb sem fio cai silenciosamente - O telefone dormiu ou mudou de IP. Correção: execute adb connect novamente; mantenha a depuração sem fio das opções do desenvolvedor habilitada.
• Build iOS interno não instala - Dispositivo do testador não registrado. Correção: Colete os UDIDs através do link eas device:create antes dos builds preview.
• QA testa o desempenho de depuração - Builds de depuração incluem sobrecarga de ferramentas de desenvolvimento. Correção: Envie builds preview ou de lançamento para aprovação de desempenho.

Alternativas

FAQs

adb devices

eas device:create

Relacionados

• Simulador iOS e Emulador Android - dispositivos virtuais rápidos para trabalho diário de layout
• expo-dev-client - menu de desenvolvimento, launcher e iteração de módulos nativos no dispositivo
• Noções Básicas de Desenvolvimento Local - túnel vs LAN quando o dispositivo não consegue alcançar o Metro
• Expo Go vs. Builds de Desenvolvimento - quando o Expo Go em um telefone ainda é suficiente
• Ambientes e Variáveis de Ambiente EAS - URLs de API de staging em builds de prévia
• Distribuição Interna - trilhas internas ad hoc, empresariais e da loja

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