adb y dispositivos Android

Q: ¿Por qué el emulador ve Metro pero el teléfono USB no?

El emulador usa 10.0.2.2 para alcanzar localhost del host - dispositivos físicos no. Usa adb reverse en USB o --host lan con IP correcta de laptop en Wi-Fi.

Q: ¿Cómo encuentro la ruta instalable de APK después de expo run:android?

android/app/build/outputs/apk/debug/app-debug.apk para compilaciones debug estándar. Los artefactos de EAS descargan desde eas build:list - ve jq, rg & JSON Logs.

Q: ¿Funciona adb en iOS?

No - usa xcrun simctl y ventana de dispositivos Xcode para plataformas Apple.

adb (Android Debug Bridge) es la interfaz de terminal para emuladores y hardware USB - lista dispositivos, invierte puertos de Metro, obtén logcat e instala compilaciones de desarrollo sin abrir Android Studio. Expo SDK 57 envuelve compilaciones diarias en npx expo run:android; esta página es el manual de referencia para cuando logcat, el reenvío de puertos o las instalaciones de APK necesiten control explícito.

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

# Verifica toolchain y dispositivo
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools"
adb devices -l
 
# USB dev: Metro port reverse (8081 por defecto)
adb reverse tcp:8081 tcp:8081
npx expo start --dev-client
 
# logcat enfocado en RN
adb logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E
 
# Instala APK de desarrollo (EAS interno o debug local)
adb install -r ./build/app-debug.apk
adb shell am start -n com.example.app/.MainActivity

Cuándo usarlo:

npx expo run:android no puede ver un dispositivo (no devices/emulators found).
El hardware USB no puede cargar el bundle de JS - Metro funciona en emulador pero no en teléfono.
Necesitas stack traces nativos de crash más allá de la redbox.
CI o QA instalan un APK pregenerado sin Gradle en la laptop.
Deep link o notificación de cold-start debe ser scripted para preparación de Maestro.

Ejemplo de Trabajo

Dispositivo físico USB: reverse Metro, instala cliente de desarrollo, obtén logs, abre deep link.

#!/usr/bin/env bash
set -euo pipefail
 
PACKAGE="com.example.shopapp"
APK="./shopapp-debug.apk"   # from eas build --profile development --platform android
 
# 1. Guarda single device
SERIAL=$(adb devices | awk 'NR>1 && $2=="device" {print $1; exit}')
if [[ -z "$SERIAL" ]]; then
  echo "No adb device en estado 'device'. Habilita USB debugging." >&2
  exit 1
fi
echo "Usando dispositivo: $SERIAL"
 
# 2. Port reverse para Metro (USB)
adb -s "$SERIAL" reverse tcp:8081 tcp:8081
adb -s "$SERIAL" reverse --list
 
# 3. Instala / upgrade cliente de desarrollo
adb -s "$SERIAL" install -r "$APK"
 
# 4. Inicia en frío la actividad principal
adb -s "$SERIAL" shell am force-stop "$PACKAGE"
adb -s "$SERIAL" shell am start -n "$PACKAGE/.MainActivity"
 
# 5. Deep link smoke
adb -s "$SERIAL" shell am start -a android.intent.action.VIEW \
  -d "shopapp://orders/42" "$PACKAGE"
 
# 6. Logs en segunda terminal - crashes nativos + consola JS
adb -s "$SERIAL" logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E

Inicia Metro (terminal separada):

npx expo start --dev-client --clear

Lo que esto demuestra:

-s SERIAL - obligatorio cuando el emulador y el teléfono están ambos conectados.
adb reverse - ruta USB a Metro sin alineación de IP Wi-Fi.
install -r - reemplaza la compilación debug existente manteniendo datos de app (usualmente).
am start -a VIEW -d - intent filter / verificación de deep link desde bash.
logcat filtrado - expone errores ReactNativeJS y AndroidRuntime fatales.

Análisis en Profundidad

Cómo Funciona

adb se comunica con adbd en el dispositivo/emulador sobre USB o TCP (wireless debugging).
Metro sirve JS en localhost:8081 en tu laptop - el dispositivo necesita una ruta a ese puerto (reverse, IP LAN compartida, o tunnel).
npx expo run:android invoca Gradle installDebug luego lanza la app - adb install omite compilación cuando ya tienes un APK.
Dev clients construidos con expo-dev-client aún necesitan Metro para JS - adb reverse es el atajo USB.

Descubrimiento de Dispositivos

adb devices -l                    # serial, estado, modelo
adb kill-server && adb start-server # reinicia daemon cuando dispositivos cambian
adb -e <cmd>                        # solo emulador
adb -d <cmd>                        # solo dispositivo USB

Estado	Significado	Solución
`device`	Listo	Procede
`unauthorized`	Clave RSA no aceptada en teléfono	Toca "Allow USB debugging"
`offline`	Cable/driver problema	Replug, `adb kill-server`
lista vacía	No hay emulador ejecutándose	Android Studio AVD o `emulator -avd <name>`

# Lista AVDs e inicia uno (binary de emulator está en ANDROID_HOME)
emulator -list-avds
emulator -avd Pixel_8_API_35 &
adb wait-for-device

Port Reverse & Forward

# Metro (8081 por defecto)
adb reverse tcp:8081 tcp:8081
 
# DevTools o puerto packager personalizado
adb reverse tcp:8082 tcp:8082
 
# Muestra reverses activos
adb reverse --list
 
# Elimina todos los reverses
adb reverse --remove-all
 
# Forward puerto del dispositivo a laptop (menos común en RN)
adb forward tcp:9000 tcp:9000

Wi-Fi dev - omite reverse; usa npx expo start --dev-client --host lan y asegúrate que el teléfono y laptop compartan subnet.
VPN corporativa - a menudo rompe LAN; prueba --tunnel en Metro o USB reverse.

Recetas de logcat

# RN daily driver
adb logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E
 
# Limpia buffer antes de reproducir un crash
adb logcat -c && adb logcat '*:S' ReactNativeJS:V AndroidRuntime:E
 
# Guarda en archivo para artefacto CI
adb logcat -d > android-logcat.txt
 
# Filtra por PID después del lanzamiento (adb shell pidof)
PID=$(adb shell pidof -s com.example.app)
adb logcat --pid="$PID"
 
# Kotlin/Java crash stack solo
adb logcat '*:S' AndroidRuntime:E

Instala & Lanza

# Debug APK desde expo run:android
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
 
# APK de distribución interna de EAS
adb install -r ./downloads/shopapp.apk
 
# Desinstala limpio
adb uninstall com.example.app
 
# Lanza launcher activity
adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1
 
# Fuerza stop
adb shell am force-stop com.example.app
 
# Limpia datos de app (logout / almacenamiento corrupto)
adb shell pm clear com.example.app

applicationId en app.config.ts (android.package) debe coincidir con strings de paquete de adb.
Play-signed AAB desde producción eas build no es instalable vía adb - usa track APK/AAB interno o bundletool.

Utilidades Shell

# Screenshot (PNG a stdout redirigido)
adb exec-out screencap -p > screen.png
 
# Screen record (máximo 180s en muchos dispositivos)
adb shell screenrecord /sdcard/demo.mp4
adb pull /sdcard/demo.mp4
 
# Texto de entrada (solo ASCII - sin espacios sin %s)
adb shell input text "hello"
 
# Abre deep link de configuración del sistema
adb shell am start -a android.settings.APPLICATION_DETAILS_SETTINGS \
  -d package:com.example.app

Notas de Bash

# Ruta SDK por defecto de macOS - alinea con instalación de Android Studio
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator"
 
# JDK 17 requerido para RN 0.86 / Expo SDK 57 Gradle
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
 
# Loop hasta que el dispositivo esté listo (CI emulator boot)
adb wait-for-device shell 'while [[ -z $(getprop sys.boot_completed) ]]; do sleep 1; done'

Errores Comunes

Olvidó adb reverse en USB - dev client muestra "Unable to load script". Solución: adb reverse tcp:8081 tcp:8081 después de cada reconexión.
Múltiples dispositivos, sin -s SERIAL - adb: more than one device/emulator. Solución: adb devices luego sufija cada comando.
Instalando release AAB con adb install - falla; tipo de artefacto incorrecto. Solución: perfil APK interno o track interno de Play - Internal Testing Tracks.
Logcat inundado sin filtros - miles de líneas/sec ocultan errores RN. Solución: patrón '*:S' ReactNativeJS:V arriba.
npm install módulo nativo sin rebuild - actualizaciones JS pero código nativo obsoleto. Solución: npx expo run:android o instala nuevo APK de desarrollo de EAS.
Wireless debugging cae - adb disconnect luego re-pair. Solución: USB para reverse confiable durante native debugging.

Alternativas

Alternativa	Usar Cuando	No Usar Cuando
`npx expo run:android`	Compilación Gradle diaria + instala	APK ya construido en CI
Android Studio Logcat GUI	UI multi-filter, pinning de threads	CI headless - usa `adb logcat`
`npx expo start --tunnel`	Sin USB, LAN bloqueado	USB disponible - `reverse` es más rápido
Wireless `adb connect`	Escritorio sin cable	Necesitas Metro estable durante long debug

FAQs

¿Por qué el emulador ve Metro pero el teléfono USB no?

El emulador usa 10.0.2.2 para alcanzar localhost del host - dispositivos físicos no.
Usa adb reverse en USB o --host lan con IP correcta de laptop en Wi-Fi.

¿Cómo encuentro la ruta instalable de APK después de expo run:android?

android/app/build/outputs/apk/debug/app-debug.apk para compilaciones debug estándar.
Los artefactos de EAS descargan desde eas build:list - ve jq, rg & JSON Logs.

¿adb unauthorized después de actualizar macOS?

Revoca autorizaciones de USB debugging en el teléfono (Developer options).
Replug cable y acepta el diálogo de fingerprint RSA.

¿Puedo otorgar permisos desde adb?

adb shell pm grant com.example.app android.permission.CAMERA
Los permisos de runtime aún pueden necesitar prompts en-app en Android 13+ para notificaciones.

¿Funciona adb en iOS?

No - usa xcrun simctl y ventana de dispositivos Xcode para plataformas Apple.

Relacionado

CLI Basics for RN - expo run:android y comandos de EAS
xcrun simctl & iOS Simulators - contraparte iOS
jq, rg & JSON Logs - parse eas build:list --json para URLs de APK
Android Basics for RN Devs - Gradle, ANDROID_HOME, JDK 17
EAS Build Basics - perfiles APK de development vs preview
Internal Testing Tracks - distribución de Play cuando adb install no es la ruta

Stack versions: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

# Verifica toolchain y dispositivo
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools"
adb devices -l
 
# USB dev: Metro port reverse (8081 por defecto)
adb reverse tcp:8081 tcp:8081
npx expo start --dev-client
 
# logcat enfocado en RN
adb logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E
 
# Instala APK de desarrollo (EAS interno o debug local)
adb install -r ./build/app-debug.apk
adb shell am start -n com.example.app/.MainActivity

Cuándo usarlo:

npx expo run:android no puede ver un dispositivo (no devices/emulators found).
El hardware USB no puede cargar el bundle de JS - Metro funciona en emulador pero no en teléfono.
Necesitas stack traces nativos de crash más allá de la redbox.
CI o QA instalan un APK pregenerado sin Gradle en la laptop.
Deep link o notificación de cold-start debe ser scripted para preparación de Maestro.

Ejemplo de Trabajo

Dispositivo físico USB: reverse Metro, instala cliente de desarrollo, obtén logs, abre deep link.

#!/usr/bin/env bash
set -euo pipefail
 
PACKAGE="com.example.shopapp"
APK="./shopapp-debug.apk"   # from eas build --profile development --platform android
 
# 1. Guarda single device
SERIAL=$(adb devices | awk 'NR>1 && $2=="device" {print $1; exit}')
if [[ -z "$SERIAL" ]]; then
  echo "No adb device en estado 'device'. Habilita USB debugging." >&2
  exit 1
fi
echo "Usando dispositivo: $SERIAL"
 
# 2. Port reverse para Metro (USB)
adb -s "$SERIAL" reverse tcp:8081 tcp:8081
adb -s "$SERIAL" reverse --list
 
# 3. Instala / upgrade cliente de desarrollo
adb -s "$SERIAL" install -r "$APK"
 
# 4. Inicia en frío la actividad principal
adb -s "$SERIAL" shell am force-stop "$PACKAGE"
adb -s "$SERIAL" shell am start -n "$PACKAGE/.MainActivity"
 
# 5. Deep link smoke
adb -s "$SERIAL" shell am start -a android.intent.action.VIEW \
  -d "shopapp://orders/42" "$PACKAGE"
 
# 6. Logs en segunda terminal - crashes nativos + consola JS
adb -s "$SERIAL" logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E

Inicia Metro (terminal separada):

npx expo start --dev-client --clear

Lo que esto demuestra:

-s SERIAL - obligatorio cuando el emulador y el teléfono están ambos conectados.
adb reverse - ruta USB a Metro sin alineación de IP Wi-Fi.
install -r - reemplaza la compilación debug existente manteniendo datos de app (usualmente).
am start -a VIEW -d - intent filter / verificación de deep link desde bash.
logcat filtrado - expone errores ReactNativeJS y AndroidRuntime fatales.

Análisis en Profundidad

Cómo Funciona

adb se comunica con adbd en el dispositivo/emulador sobre USB o TCP (wireless debugging).
Metro sirve JS en localhost:8081 en tu laptop - el dispositivo necesita una ruta a ese puerto (reverse, IP LAN compartida, o tunnel).
npx expo run:android invoca Gradle installDebug luego lanza la app - adb install omite compilación cuando ya tienes un APK.
Dev clients construidos con expo-dev-client aún necesitan Metro para JS - adb reverse es el atajo USB.

Descubrimiento de Dispositivos

adb devices -l                    # serial, estado, modelo
adb kill-server && adb start-server # reinicia daemon cuando dispositivos cambian
adb -e <cmd>                        # solo emulador
adb -d <cmd>                        # solo dispositivo USB

Estado	Significado	Solución
`device`	Listo	Procede
`unauthorized`	Clave RSA no aceptada en teléfono	Toca "Allow USB debugging"
`offline`	Cable/driver problema	Replug, `adb kill-server`
lista vacía	No hay emulador ejecutándose	Android Studio AVD o `emulator -avd <name>`

# Lista AVDs e inicia uno (binary de emulator está en ANDROID_HOME)
emulator -list-avds
emulator -avd Pixel_8_API_35 &
adb wait-for-device

Port Reverse & Forward

# Metro (8081 por defecto)
adb reverse tcp:8081 tcp:8081
 
# DevTools o puerto packager personalizado
adb reverse tcp:8082 tcp:8082
 
# Muestra reverses activos
adb reverse --list
 
# Elimina todos los reverses
adb reverse --remove-all
 
# Forward puerto del dispositivo a laptop (menos común en RN)
adb forward tcp:9000 tcp:9000

Wi-Fi dev - omite reverse; usa npx expo start --dev-client --host lan y asegúrate que el teléfono y laptop compartan subnet.
VPN corporativa - a menudo rompe LAN; prueba --tunnel en Metro o USB reverse.

Recetas de logcat

# RN daily driver
adb logcat '*:S' ReactNative:V ReactNativeJS:V AndroidRuntime:E
 
# Limpia buffer antes de reproducir un crash
adb logcat -c && adb logcat '*:S' ReactNativeJS:V AndroidRuntime:E
 
# Guarda en archivo para artefacto CI
adb logcat -d > android-logcat.txt
 
# Filtra por PID después del lanzamiento (adb shell pidof)
PID=$(adb shell pidof -s com.example.app)
adb logcat --pid="$PID"
 
# Kotlin/Java crash stack solo
adb logcat '*:S' AndroidRuntime:E

Instala & Lanza

# Debug APK desde expo run:android
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
 
# APK de distribución interna de EAS
adb install -r ./downloads/shopapp.apk
 
# Desinstala limpio
adb uninstall com.example.app
 
# Lanza launcher activity
adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1
 
# Fuerza stop
adb shell am force-stop com.example.app
 
# Limpia datos de app (logout / almacenamiento corrupto)
adb shell pm clear com.example.app

applicationId en app.config.ts (android.package) debe coincidir con strings de paquete de adb.
Play-signed AAB desde producción eas build no es instalable vía adb - usa track APK/AAB interno o bundletool.

Utilidades Shell

# Screenshot (PNG a stdout redirigido)
adb exec-out screencap -p > screen.png
 
# Screen record (máximo 180s en muchos dispositivos)
adb shell screenrecord /sdcard/demo.mp4
adb pull /sdcard/demo.mp4
 
# Texto de entrada (solo ASCII - sin espacios sin %s)
adb shell input text "hello"
 
# Abre deep link de configuración del sistema
adb shell am start -a android.settings.APPLICATION_DETAILS_SETTINGS \
  -d package:com.example.app

Notas de Bash

# Ruta SDK por defecto de macOS - alinea con instalación de Android Studio
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator"
 
# JDK 17 requerido para RN 0.86 / Expo SDK 57 Gradle
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
 
# Loop hasta que el dispositivo esté listo (CI emulator boot)
adb wait-for-device shell 'while [[ -z $(getprop sys.boot_completed) ]]; do sleep 1; done'

Errores Comunes

Olvidó adb reverse en USB - dev client muestra "Unable to load script". Solución: adb reverse tcp:8081 tcp:8081 después de cada reconexión.
Múltiples dispositivos, sin -s SERIAL - adb: more than one device/emulator. Solución: adb devices luego sufija cada comando.
Instalando release AAB con adb install - falla; tipo de artefacto incorrecto. Solución: perfil APK interno o track interno de Play - Internal Testing Tracks.
Logcat inundado sin filtros - miles de líneas/sec ocultan errores RN. Solución: patrón '*:S' ReactNativeJS:V arriba.
npm install módulo nativo sin rebuild - actualizaciones JS pero código nativo obsoleto. Solución: npx expo run:android o instala nuevo APK de desarrollo de EAS.
Wireless debugging cae - adb disconnect luego re-pair. Solución: USB para reverse confiable durante native debugging.

Alternativas

Alternativa	Usar Cuando	No Usar Cuando
`npx expo run:android`	Compilación Gradle diaria + instala	APK ya construido en CI
Android Studio Logcat GUI	UI multi-filter, pinning de threads	CI headless - usa `adb logcat`
`npx expo start --tunnel`	Sin USB, LAN bloqueado	USB disponible - `reverse` es más rápido
Wireless `adb connect`	Escritorio sin cable	Necesitas Metro estable durante long debug

FAQs

¿Por qué el emulador ve Metro pero el teléfono USB no?

El emulador usa 10.0.2.2 para alcanzar localhost del host - dispositivos físicos no.
Usa adb reverse en USB o --host lan con IP correcta de laptop en Wi-Fi.

¿Cómo encuentro la ruta instalable de APK después de expo run:android?

android/app/build/outputs/apk/debug/app-debug.apk para compilaciones debug estándar.
Los artefactos de EAS descargan desde eas build:list - ve jq, rg & JSON Logs.

¿adb unauthorized después de actualizar macOS?

Revoca autorizaciones de USB debugging en el teléfono (Developer options).
Replug cable y acepta el diálogo de fingerprint RSA.

¿Puedo otorgar permisos desde adb?

adb shell pm grant com.example.app android.permission.CAMERA
Los permisos de runtime aún pueden necesitar prompts en-app en Android 13+ para notificaciones.

¿Funciona adb en iOS?

No - usa xcrun simctl y ventana de dispositivos Xcode para plataformas Apple.

Relacionado

CLI Basics for RN - expo run:android y comandos de EAS
xcrun simctl & iOS Simulators - contraparte iOS
jq, rg & JSON Logs - parse eas build:list --json para URLs de APK
Android Basics for RN Devs - Gradle, ANDROID_HOME, JDK 17
EAS Build Basics - perfiles APK de development vs preview
Internal Testing Tracks - distribución de Play cuando adb install no es la ruta

Stack versions: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).

adb y dispositivos Android

Buscar en la documentación

adb y dispositivos Android