Comandos adb básicos para testers de apps

adb (Android Debug Bridge) es una herramienta de línea de comandos que se comunica con un teléfono o un emulador por USB o Wi-Fi. No necesitas aprender todo. Una docena de comandos cubre lo que un tester o desarrollador hace a diario: instalar una build, reiniciar la app, asignar un permiso y guardar un log para un informe de bug.

Configuración en dos minutos

1. Instala Android SDK Platform-Tools (incluye adb).
2. En el teléfono, activa las Opciones de desarrollador (toca el número de compilación en Ajustes > Acerca del teléfono varias veces) y luego activa la depuración USB.
3. Conecta el teléfono y acepta el mensaje "¿Permitir la depuración USB?".
4. Ejecuta adb devices. Tu dispositivo debe aparecer como device. Si dice unauthorized, acepta de nuevo el mensaje en el teléfono.

Si hay más de un dispositivo conectado, añade -s <serial> a cada comando, usando el serial de adb devices.

Instalar y eliminar builds

Sustituye com.example.app por el nombre de tu paquete. Si una instalación falla, el texto del error (por ejemplo, una falta de coincidencia de firma o un problema de código de versión) suele indicar la causa. Un bundle (.aab) no se instala directamente; para probar, instala los APK generados a partir de él, o usa una pista de pruebas de la tienda.

Reiniciar el estado

• adb shell pm clear com.example.app borra los datos y la caché de la app, como una instalación nueva sin reinstalar. Úsalo antes de cada prueba de primer inicio.
• adb shell am force-stop com.example.app mata la app. Útil para probar arranques en frío.
• adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1 abre la app sin conocer el nombre de la actividad.

Permisos

• Conceder: adb shell pm grant com.example.app android.permission.CAMERA
• Revocar: adb shell pm revoke com.example.app android.permission.CAMERA

Conceder y revocar es la forma rápida de probar los caminos de "permitido" y "denegado". Solo se pueden cambiar así los permisos en tiempo de ejecución que declara tu app.

Logs

• adb logcat muestra en directo el log del sistema. Es ruidoso; filtra por tu paquete o una etiqueta.
• adb logcat -c limpia el búfer primero, para que tu captura empiece limpia.
• adb logcat -d > log.txt vuelca el búfer actual a un archivo y termina.

Una rutina fiable para reproducir un bug: limpia el log, reproduce el problema una vez, vuelca el log y adjúntalo. Mira también cómo leer informes de fallos.

Archivos, capturas y grabaciones de pantalla

• adb pull /sdcard/file.png . copia un archivo del teléfono.
• adb exec-out screencap -p > screen.png guarda una captura de pantalla.
• adb shell screenrecord /sdcard/demo.mp4 graba la pantalla (detén con Ctrl+C y luego copia el archivo). Se detiene tras un límite de tiempo que depende del dispositivo.

Límites

adb te dice lo que hizo el dispositivo, no lo que sintió una persona. No puede sustituir las pruebas con personas reales en teléfonos reales, pero mejora mucho sus informes: un log y una build exacta valen más que "se cerró".

Parte de la guía de pruebas de apps Android. Relacionado: informe previo al lanzamiento de Play Console y nociones básicas de Android vitals.

¿Quieres feedback sobre una build de personas reales? Empieza gratis y recibe feedback privado y estructurado sobre tu app.