Não - use xcrun simctl e a janela de dispositivos do Xcode para plataformas Apple.

adb & Dispositivos Android

Q: Por que o emulador vê o Metro, mas o telefone USB não?

O emulador usa 10.0.2.2 para alcançar o localhost do host - dispositivos físicos não. Use adb reverse no USB ou --host lan com o IP correto do laptop no Wi-Fi.

Q: Como encontro o caminho do APK instalável após expo run:android?

android/app/build/outputs/apk/debug/app-debug.apk para builds de depuração padrão. Artefatos do EAS são baixados de eas build:list - veja jq, rg & Logs JSON.

adb (Android Debug Bridge) é a interface de terminal para emuladores e hardware USB - liste dispositivos, reverta portas do Metro, acompanhe logcat e instale builds de desenvolvimento sem abrir o Android Studio. O Expo SDK 57 encapsula compilações diárias em npx expo run:android; esta página é o guia para quando logcat, encaminhamento de porta ou instalações de APK precisam de controle explícito.

Receita

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

# Verifique a toolchain + dispositivo
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools"
adb devices -l
 
# Dev USB: Reversão da porta Metro (8081 padrão)
adb reverse tcp:8081 tcp:8081
npx expo start --dev-client
 
# logcat focado em RN
adb logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E
 
# Instale o APK de dev (interno do EAS ou debug local)
adb install -r ./build/app-debug.apk
adb shell am start -n com.example.app/.MainActivity

Quando usar isto:

npx expo run:android não consegue ver um dispositivo (nenhum dispositivo/emulador encontrado).
Hardware USB não consegue carregar o bundle JS - o Metro funciona no emulador, mas não no telefone.
Você precisa de traces de pilha de crash nativos além da caixa vermelha.
CI ou QA instala um APK pré-compilado sem Gradle no laptop.
Deep link ou inicialização a frio de notificação deve ser scriptada para preparação do Maestro.

Exemplo de Trabalho

Dispositivo físico USB: reverter Metro, instalar cliente de dev, acompanhar logs, abrir deep link.

#!/usr/bin/env bash
set -euo pipefail
 
PACKAGE="com.example.shopapp"
APK="./shopapp-debug.apk"   # de eas build --profile development --platform android
 
# 1. Guarda de dispositivo único
SERIAL=$(adb devices | awk 'NR>1 && $2=="device" {print $1; exit}')
if [[ -z "$SERIAL" ]]; then
  echo "Nenhum dispositivo adb no estado 'device'. Habilite a depuração USB." >&2
  exit 1
fi
echo "Usando dispositivo: $SERIAL"
 
# 2. Reversão de porta para Metro (USB)
adb -s "$SERIAL" reverse tcp:8081 tcp:8081
adb -s "$SERIAL" reverse --list
 
# 3. Instale / atualize o cliente de dev
adb -s "$SERIAL" install -r "$APK"
 
# 4. Inicialização a frio da atividade principal
adb -s "$SERIAL" shell am force-stop "$PACKAGE"
adb -s "$SERIAL" shell am start -n "$PACKAGE/.MainActivity"
 
# 5. Teste de deep link
adb -s "$SERIAL" shell am start -a android.intent.action.VIEW \
  -d "shopapp://orders/42" "$PACKAGE"
 
# 6. Logs em segundo terminal - crashes nativos + console JS
adb -s "$SERIAL" logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E

Inicie o Metro (terminal separado):

npx expo start --dev-client --clear

O que isso demonstra:

-s SERIAL - obrigatório quando emulador e telefone estão ambos conectados.
adb reverse - caminho USB para o Metro sem alinhamento de IP Wi-Fi.
install -r - substitui a build de depuração existente mantendo os dados do aplicativo (geralmente).
am start -a VIEW -d - filtro de intenção / verificação de deep link do bash.
logcat filtrado - expõe erros fatais ReactNativeJS e AndroidRuntime.

Mergulho Profundo

Como Funciona

adb fala com adbd no dispositivo/emulador via USB ou TCP (depuração sem fio).
Metro serve JS em localhost:8081 no seu laptop - o dispositivo precisa de um caminho para essa porta (reverse, IP LAN compartilhado ou túnel).
npx expo run:android invoca o Gradle installDebug e depois inicia o aplicativo - adb install pula a compilação quando você já tem um APK.
Clientes de dev construídos com expo-dev-client ainda precisam do Metro para JS - adb reverse é o atalho USB.

Descoberta de Dispositivos

adb devices -l                    # serial, estado, modelo
adb kill-server && adb start-server # reinicia o daemon quando os dispositivos falham
adb -e <cmd>                        # apenas emulador
adb -d <cmd>                        # apenas dispositivo USB

Estado	Significado	Correção
`device`	Pronto	Prossiga
`unauthorized`	Chave RSA não aceita no telefone	Toque em "Permitir depuração USB"
`offline`	Falha no cabo/driver	Reconecte, `adb kill-server`
lista vazia	Nenhum emulador em execução	AVD do Android Studio ou `emulator -avd <nome>`

# Liste AVDs e inicie um (o binário do emulador está em ANDROID_HOME)
emulator -list-avds
emulator -avd Pixel_8_API_35 &
adb wait-for-device

Reversão e Encaminhamento de Porta

# Metro (8081 padrão)
adb reverse tcp:8081 tcp:8081
 
# DevTools ou porta de packager customizada
adb reverse tcp:8082 tcp:8082
 
# Mostre as reversões ativas
adb reverse --list
 
# Remova todas as reversões
adb reverse --remove-all
 
# Encaminhe a porta do dispositivo para o laptop (menos comum em RN)
adb forward tcp:9000 tcp:9000

Dev Wi-Fi - pule reverse; use npx expo start --dev-client --host lan e certifique-se de que o telefone e o laptop compartilhem a mesma sub-rede.
VPN Corporativa - frequentemente quebra a LAN; tente --tunnel no Metro ou reverse USB.

Receitas de logcat

# Diariamente para RN
adb logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E
 
# Limpe o buffer antes de reproduzir um crash
adb logcat -c && adb logcat '*:S' ReactNativeJS:V AndroidRuntime:E
 
# Salve em arquivo para artefato de CI
adb logcat -d > android-logcat.txt
 
# Filtre por PID após o lançamento (adb shell pidof)
PID=$(adb shell pidof -s com.example.app)
adb logcat --pid="$PID"
 
# Apenas stack trace de crash Kotlin/Java
adb logcat '*:S' AndroidRuntime:E

Instale e Lance

# APK de depuração de expo run:android
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
 
# APK de distribuição interna do EAS
adb install -r ./downloads/shopapp.apk
 
# Desinstale limpo
adb uninstall com.example.app
 
# Inicie a atividade do launcher
adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1
 
# Forçar parada
adb shell am force-stop com.example.app
 
# Limpe os dados do aplicativo (logout / armazenamento corrompido)
adb shell pm clear com.example.app

applicationId em app.config.ts (android.package) deve corresponder às strings de pacote do adb.
AAB assinado pelo Play do eas build de produção não é instalável via adb - use a trilha interna de APK/AAB ou bundletool.

Utilitários de Shell

# Captura de tela (PNG para stdout redirecionado)
adb exec-out screencap -p > screen.png
 
# Gravação de tela (máximo de 180s em muitos dispositivos)
adb shell screenrecord /sdcard/demo.mp4
adb pull /sdcard/demo.mp4
 
# Digite texto (apenas ASCII - sem espaços sem %s)
adb shell input text "hello"
 
# Abra o deep link de configurações do sistema
adb shell am start -a android.settings.APPLICATION_DETAILS_SETTINGS \
  -d package:com.example.app

Notas do Bash

# Caminho SDK padrão do macOS - alinhe com a instalação do Android Studio
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator"
 
# JDK 17 necessário para RN 0.86 / Expo SDK 57 Gradle
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
 
# Loop até o dispositivo estar pronto (inicialização do emulador CI)
adb wait-for-device shell 'while [[ -z $(getprop sys.boot_completed) ]]; do sleep 1; done'

Armadilhas

Esqueceu adb reverse no USB - o cliente de dev mostra "Unable to load script". Correção: adb reverse tcp:8081 tcp:8081 após cada reconexão.
Múltiplos dispositivos, sem -s SERIAL - adb: more than one device/emulator. Correção: adb devices e depois adicione o sufixo a cada comando.
Instalando AAB de release com adb install - falha; tipo de artefato incorreto. Correção: perfil de APK interno ou trilha interna do Play - Trilhas de Teste Interno.
Inundação de Logcat sem filtros - milhares de linhas/segundo escondem erros de RN. Correção: padrão '*:S' ReactNativeJS:V acima.
npm install módulo nativo sem reconstrução - atualizações JS, mas código nativo obsoleto. Correção: npx expo run:android ou instale um APK de dev EAS novo.
Quedas de depuração sem fio - adb disconnect e depois reconecte. Correção: USB para reverse confiável durante a depuração nativa.

Alternativas

Alternativa	Use Quando	Não Use Quando
`npx expo run:android`	Compilação Gradle diária + instalação	APK já compilado em CI
GUI Logcat do Android Studio	UI com múltiplos filtros, fixando threads	CI sem cabeça - use `adb logcat`
`npx expo start --tunnel`	Sem USB, LAN bloqueada	USB disponível - `reverse` é mais rápido
`adb connect` sem fio	Mesa sem cabos	Precisa de Metro estável durante depuração longa

FAQs

Por que o emulador vê o Metro, mas o telefone USB não?

O emulador usa 10.0.2.2 para alcançar o localhost do host - dispositivos físicos não.
Use adb reverse no USB ou --host lan com o IP correto do laptop no Wi-Fi.

Como encontro o caminho do APK instalável após expo run:android?

android/app/build/outputs/apk/debug/app-debug.apk para builds de depuração padrão.
Artefatos do EAS são baixados de eas build:list - veja jq, rg & Logs JSON.

adb não autorizado após atualização do macOS?

Revogue as autorizações de depuração USB no telefone (Opções do desenvolvedor).
Reconecte o cabo e aceite o diálogo de impressão digital RSA.

Posso conceder permissões do adb?

adb shell pm grant com.example.app android.permission.CAMERA
Permissões de tempo de execução ainda podem precisar de prompts no aplicativo no Android 13+ para notificações.

adb funciona no iOS?

Não - use xcrun simctl e a janela de dispositivos do Xcode para plataformas Apple.

Relacionados

Noções Básicas de CLI para RN - expo run:android e comandos EAS
xcrun simctl & Simuladores iOS - contraparte iOS
jq, rg & Logs JSON - analise eas build:list --json para URLs de APK
Noções Básicas de Android para Desenvolvedores RN - Gradle, ANDROID_HOME, JDK 17
Noções Básicas de EAS Build - perfis de APK de desenvolvimento vs. preview
Trilhas de Teste Interno - distribuição do Play quando adb install não é o caminho

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.

# Verifique a toolchain + dispositivo
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools"
adb devices -l
 
# Dev USB: Reversão da porta Metro (8081 padrão)
adb reverse tcp:8081 tcp:8081
npx expo start --dev-client
 
# logcat focado em RN
adb logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E
 
# Instale o APK de dev (interno do EAS ou debug local)
adb install -r ./build/app-debug.apk
adb shell am start -n com.example.app/.MainActivity

Quando usar isto:

npx expo run:android não consegue ver um dispositivo (nenhum dispositivo/emulador encontrado).
Hardware USB não consegue carregar o bundle JS - o Metro funciona no emulador, mas não no telefone.
Você precisa de traces de pilha de crash nativos além da caixa vermelha.
CI ou QA instala um APK pré-compilado sem Gradle no laptop.
Deep link ou inicialização a frio de notificação deve ser scriptada para preparação do Maestro.

Exemplo de Trabalho

Dispositivo físico USB: reverter Metro, instalar cliente de dev, acompanhar logs, abrir deep link.

#!/usr/bin/env bash
set -euo pipefail
 
PACKAGE="com.example.shopapp"
APK="./shopapp-debug.apk"   # de eas build --profile development --platform android
 
# 1. Guarda de dispositivo único
SERIAL=$(adb devices | awk 'NR>1 && $2=="device" {print $1; exit}')
if [[ -z "$SERIAL" ]]; then
  echo "Nenhum dispositivo adb no estado 'device'. Habilite a depuração USB." >&2
  exit 1
fi
echo "Usando dispositivo: $SERIAL"
 
# 2. Reversão de porta para Metro (USB)
adb -s "$SERIAL" reverse tcp:8081 tcp:8081
adb -s "$SERIAL" reverse --list
 
# 3. Instale / atualize o cliente de dev
adb -s "$SERIAL" install -r "$APK"
 
# 4. Inicialização a frio da atividade principal
adb -s "$SERIAL" shell am force-stop "$PACKAGE"
adb -s "$SERIAL" shell am start -n "$PACKAGE/.MainActivity"
 
# 5. Teste de deep link
adb -s "$SERIAL" shell am start -a android.intent.action.VIEW \
  -d "shopapp://orders/42" "$PACKAGE"
 
# 6. Logs em segundo terminal - crashes nativos + console JS
adb -s "$SERIAL" logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E

Inicie o Metro (terminal separado):

npx expo start --dev-client --clear

O que isso demonstra:

-s SERIAL - obrigatório quando emulador e telefone estão ambos conectados.
adb reverse - caminho USB para o Metro sem alinhamento de IP Wi-Fi.
install -r - substitui a build de depuração existente mantendo os dados do aplicativo (geralmente).
am start -a VIEW -d - filtro de intenção / verificação de deep link do bash.
logcat filtrado - expõe erros fatais ReactNativeJS e AndroidRuntime.

Mergulho Profundo

Como Funciona

adb fala com adbd no dispositivo/emulador via USB ou TCP (depuração sem fio).
Metro serve JS em localhost:8081 no seu laptop - o dispositivo precisa de um caminho para essa porta (reverse, IP LAN compartilhado ou túnel).
npx expo run:android invoca o Gradle installDebug e depois inicia o aplicativo - adb install pula a compilação quando você já tem um APK.
Clientes de dev construídos com expo-dev-client ainda precisam do Metro para JS - adb reverse é o atalho USB.

Descoberta de Dispositivos

adb devices -l                    # serial, estado, modelo
adb kill-server && adb start-server # reinicia o daemon quando os dispositivos falham
adb -e <cmd>                        # apenas emulador
adb -d <cmd>                        # apenas dispositivo USB

Estado	Significado	Correção
`device`	Pronto	Prossiga
`unauthorized`	Chave RSA não aceita no telefone	Toque em "Permitir depuração USB"
`offline`	Falha no cabo/driver	Reconecte, `adb kill-server`
lista vazia	Nenhum emulador em execução	AVD do Android Studio ou `emulator -avd <nome>`

# Liste AVDs e inicie um (o binário do emulador está em ANDROID_HOME)
emulator -list-avds
emulator -avd Pixel_8_API_35 &
adb wait-for-device

Reversão e Encaminhamento de Porta

# Metro (8081 padrão)
adb reverse tcp:8081 tcp:8081
 
# DevTools ou porta de packager customizada
adb reverse tcp:8082 tcp:8082
 
# Mostre as reversões ativas
adb reverse --list
 
# Remova todas as reversões
adb reverse --remove-all
 
# Encaminhe a porta do dispositivo para o laptop (menos comum em RN)
adb forward tcp:9000 tcp:9000

Dev Wi-Fi - pule reverse; use npx expo start --dev-client --host lan e certifique-se de que o telefone e o laptop compartilhem a mesma sub-rede.
VPN Corporativa - frequentemente quebra a LAN; tente --tunnel no Metro ou reverse USB.

Receitas de logcat

# Diariamente para RN
adb logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E
 
# Limpe o buffer antes de reproduzir um crash
adb logcat -c && adb logcat '*:S' ReactNativeJS:V AndroidRuntime:E
 
# Salve em arquivo para artefato de CI
adb logcat -d > android-logcat.txt
 
# Filtre por PID após o lançamento (adb shell pidof)
PID=$(adb shell pidof -s com.example.app)
adb logcat --pid="$PID"
 
# Apenas stack trace de crash Kotlin/Java
adb logcat '*:S' AndroidRuntime:E

Instale e Lance

# APK de depuração de expo run:android
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
 
# APK de distribuição interna do EAS
adb install -r ./downloads/shopapp.apk
 
# Desinstale limpo
adb uninstall com.example.app
 
# Inicie a atividade do launcher
adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1
 
# Forçar parada
adb shell am force-stop com.example.app
 
# Limpe os dados do aplicativo (logout / armazenamento corrompido)
adb shell pm clear com.example.app

applicationId em app.config.ts (android.package) deve corresponder às strings de pacote do adb.
AAB assinado pelo Play do eas build de produção não é instalável via adb - use a trilha interna de APK/AAB ou bundletool.

Utilitários de Shell

# Captura de tela (PNG para stdout redirecionado)
adb exec-out screencap -p > screen.png
 
# Gravação de tela (máximo de 180s em muitos dispositivos)
adb shell screenrecord /sdcard/demo.mp4
adb pull /sdcard/demo.mp4
 
# Digite texto (apenas ASCII - sem espaços sem %s)
adb shell input text "hello"
 
# Abra o deep link de configurações do sistema
adb shell am start -a android.settings.APPLICATION_DETAILS_SETTINGS \
  -d package:com.example.app

Notas do Bash

# Caminho SDK padrão do macOS - alinhe com a instalação do Android Studio
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator"
 
# JDK 17 necessário para RN 0.86 / Expo SDK 57 Gradle
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
 
# Loop até o dispositivo estar pronto (inicialização do emulador CI)
adb wait-for-device shell 'while [[ -z $(getprop sys.boot_completed) ]]; do sleep 1; done'

Armadilhas

Esqueceu adb reverse no USB - o cliente de dev mostra "Unable to load script". Correção: adb reverse tcp:8081 tcp:8081 após cada reconexão.
Múltiplos dispositivos, sem -s SERIAL - adb: more than one device/emulator. Correção: adb devices e depois adicione o sufixo a cada comando.
Instalando AAB de release com adb install - falha; tipo de artefato incorreto. Correção: perfil de APK interno ou trilha interna do Play - Trilhas de Teste Interno.
Inundação de Logcat sem filtros - milhares de linhas/segundo escondem erros de RN. Correção: padrão '*:S' ReactNativeJS:V acima.
npm install módulo nativo sem reconstrução - atualizações JS, mas código nativo obsoleto. Correção: npx expo run:android ou instale um APK de dev EAS novo.
Quedas de depuração sem fio - adb disconnect e depois reconecte. Correção: USB para reverse confiável durante a depuração nativa.

Alternativas

Alternativa	Use Quando	Não Use Quando
`npx expo run:android`	Compilação Gradle diária + instalação	APK já compilado em CI
GUI Logcat do Android Studio	UI com múltiplos filtros, fixando threads	CI sem cabeça - use `adb logcat`
`npx expo start --tunnel`	Sem USB, LAN bloqueada	USB disponível - `reverse` é mais rápido
`adb connect` sem fio	Mesa sem cabos	Precisa de Metro estável durante depuração longa

FAQs

Por que o emulador vê o Metro, mas o telefone USB não?

O emulador usa 10.0.2.2 para alcançar o localhost do host - dispositivos físicos não.
Use adb reverse no USB ou --host lan com o IP correto do laptop no Wi-Fi.

Como encontro o caminho do APK instalável após expo run:android?

android/app/build/outputs/apk/debug/app-debug.apk para builds de depuração padrão.
Artefatos do EAS são baixados de eas build:list - veja jq, rg & Logs JSON.

adb não autorizado após atualização do macOS?

Revogue as autorizações de depuração USB no telefone (Opções do desenvolvedor).
Reconecte o cabo e aceite o diálogo de impressão digital RSA.

Posso conceder permissões do adb?

adb shell pm grant com.example.app android.permission.CAMERA
Permissões de tempo de execução ainda podem precisar de prompts no aplicativo no Android 13+ para notificações.

adb funciona no iOS?

Não - use xcrun simctl e a janela de dispositivos do Xcode para plataformas Apple.

Relacionados

Noções Básicas de CLI para RN - expo run:android e comandos EAS
xcrun simctl & Simuladores iOS - contraparte iOS
jq, rg & Logs JSON - analise eas build:list --json para URLs de APK
Noções Básicas de Android para Desenvolvedores RN - Gradle, ANDROID_HOME, JDK 17
Noções Básicas de EAS Build - perfis de APK de desenvolvimento vs. preview
Trilhas de Teste Interno - distribuição do Play quando adb install não é o caminho

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

adb & Dispositivos Android

Buscar na documentação

adb & Dispositivos Android