Para habilitar el modo de desarrollador en Android, abra Configuración > Acerca de teléfono y toque número de compilación siete veces, luego ingresa tu PIN. A opciones de desarrollador se muestra un menú, donde puedes activar depuración USB o Depuración inalámbrica depuración inalámbrica adb o bunx cap run android Puede instalar y depurar su aplicación. El camino exacto a la Build number depende del fabricante, por lo que los pasos para cada marca se muestran a continuación.
¿Qué opciones de desarrollador están (y qué no están)
Opciones de desarrollador es un menú de ajustes oculto destinado a los desarrolladores de aplicaciones. Activarlo por sí solo no hace nada. Solo revela interruptores como:
- Depuración USB: permite que un ordenador de confianza ejecute
adbcomandos, instale builds y lea registros. - Depuración inalámbrica: lo mismo por Wi-Fi (Android 11+).
- Quédese despierto: la pantalla permanece encendida mientras se carga, útil durante la prueba.
- Escala de animación: acelere o desactive las animaciones del sistema, útil para pruebas de interfaz de usuario.
- No mantener actividades: destruye actividades cuando las dejas, una buena forma de probar la restauración de estado en una aplicación Capacitor.
- Mostrar toques / Ubicación del punteroútil para grabar demos y verificar los puntos de toque.
Tú debes No debes necesitan opciones de desarrollador para instalar una APK desde un navegador o administrador de archivos, para usar la mayoría de las aplicaciones o para recibir una actualización por aire.
Habilitar opciones de desarrollador por marca
| Marca | Dónde tocar 7 veces | Dónde aparece el menú después |
|---|---|---|
| Google Pixel / Android de fábrica | Ajustes > Acerca de la teléfono > Versión del constructor | Ajustes > Sistema > Opciones de desarrollador |
| Samsung (One UI) | Configuración > Acerca del teléfono > Información del software > Versión de compilación | Opciones de desarrollador (en la parte inferior de la lista) |
| Xiaomi, Redmi, POCO (HyperOS) | Configuración > Acerca del teléfono > OS version | Configuración > Configuración adicional > Opciones de desarrollador |
| Xiaomi (MIUI antiguo) | Configuración > Acerca del teléfono > Versión de MIUI | Configuración > Configuración adicional > Opciones de desarrollador |
| OnePlus (OxygenOS) | Configuración > Acerca del dispositivo > Versión > Número de compilación | Configuración > Opciones del sistema > Opciones del desarrollador |
| OPPO / realme (ColorOS / realme UI) | Configuración > Acerca del dispositivo > Versión > Número de compilación | Configuración > Configuración adicional > Opciones del desarrollador |
| Motorola | Configuración > Acerca del teléfono > Número de compilación | Configuración > Sistema > Opciones del desarrollador |
| Huawei / Honor (EMUI / MagicOS) | Configuración > Acerca de teléfono > Número de compilación | Configuración > Sistema y actualizaciones > Opciones de desarrollador |
Los menús se mueven entre versiones del sistema operativo. Si no encuentra el Número de compilación, abra Configuración y utilice el campo de búsqueda: escriba ‘Número de compilación’. En casi todos los dispositivos Android, la búsqueda lo encuentra directamente.
Google Pixel (Android 14, 15, 16)
- Abrir Configuración y desplácese hacia abajo hasta Acerca de teléfono.
- Desplácese hacia abajo hasta el final y toque Número de compilación siete veces. Después de unos toques ves un toast de conteo.
- Introduce tu PIN, patrón o contraseña.
- Vuelve a Ajustes > Sistema > Opciones de desarrollador.
Samsung Galaxy
- Abre Ajustes > Acerca de teléfono > Información del software.
- Toca Versión de compilación seis veces y confirma con tu PIN.
- Las opciones de desarrollador ahora aparecen en la parte inferior de la lista principal de Ajustes, debajo de Acerca de teléfono.
Xiaomi, Redmi y POCO
- Abrir Configuración > Acerca de la teléfono.
- Tocar OS version (HyperOS) o Versión de MIUI (dispositivos más antiguos) siete veces.
- Ir a Configuración > Configuración adicional > Opciones de desarrollador.
Xiaomi agrega dos interruptores adicionales que normalmente necesitas para el desarrollo: Instalar mediante USB y depuración USB (Configuración de seguridad). Sin "Instalar mediante USB" adb install falla con INSTALL_FAILED_USER_RESTRICTED. Es posible que debas iniciar sesión en una cuenta de Xiaomi y tener un tarjeta SIM insertada.
OnePlus, OPPO y realme
- Abrir Configuración > Acerca del dispositivo > Versión.
- Tocar número de compilación seis veces.
- Abrir Configuración > Opciones del sistema > Opciones del desarrollador (OnePlus) o Configuración > Configuración adicional > Opciones del desarrollador (OPPO, realme).
Huawei y Honor
- Abrir Configuración > Acerca de teléfono.
- Pulsa Número de compilación seis veces.
- Vaya a Configuración > Sistema y actualizaciones > Opciones del desarrollador.
On los dispositivos Huawei, también establezca el modo de conexión USB a Transferencia de archivos cuando se conecta, de lo contrario adb no verá el dispositivo. Si planea enviar a estos teléfonos, lea cómo publicar una Capacitor aplicación en Huawei AppGalleryporque muchos de ellos no tienen servicios de Google Play.
Perfiles de trabajo y dispositivos administrados
Si su empresa gestiona el teléfono, el administrador puede bloquear las opciones de desarrollador. Verá ‘Las opciones de desarrollador no están disponibles para este usuario’. Pida a IT un dispositivo de prueba en lugar de intentar trabajar alrededor de la política.
Habilitar depuración de USB
- Abrir Opciones de desarrollador y enciéndalo USB depuración.
- Conecta el teléfono con un cable USB que admita datos (muchos cables baratos solo cargan).
- En el teléfono, acepta el ¿Permitir la depuración USB? diálogo. Marca Siempre permitir desde este equipo en tu propia máquina.
- En el ordenador, verifica la conexión:
adb devicesDeberías ver:
List of devices attached
R5CT1234ABC deviceunauthorized indica que no aceptaste la solicitud. offline generalmente indica un cable o puerto defectuoso, o un adb servidor de un antiguo SDK.
adb viene con la plataforma de herramientas de Android SDK. Si se ha instalado Android Studio, se encuentra en ~/Library/Android/sdk/platform-tools en macOS o %LOCALAPPDATA%\Android\Sdk\platform-tools en Windows. Agregue esa carpeta a su PATHNuevos a la cadena de herramientas de Android? configuración de Android para aplicaciones Capacitor cubre eso.
Activa la depuración inalámbrica (Android 11 y posteriores)
La depuración inalámbrica elimina el cable. Su computadora y teléfono deben estar conectados a la misma red Wi-Fi, y algunos redes corporativas o de hotel bloquean el tráfico dispositivo a dispositivo.
- En opciones del desarrolladoractiva depuración inalámbrica y aceptar la solicitud de red.
- Toca Depuración inalámbrica para abrirlo, luego Pair dispositivo con code de pairing.. Mantén esta pantalla abierta.
- En el ordenador, pair utilizando la dirección IP y el puerto mostrados en el diálogo de pairing:
adb pair 192.168.1.42:37145
# Enter pairing code: 482913- Conecta utilizando la IP y el puerto mostrados en la pantalla principal de Depuración inalámbrica (un puerto diferente del puerto de pairing):
adb connect 192.168.1.42:41827
adb devicesAndroid Studio también tiene Pair dispositivos utilizando Wi-Fi en el administrador de dispositivos, que muestra un código QR code que escaneas desde la pantalla de Depuración inalámbrica.
El puerto cambia cada vez que se reinicia la depuración inalámbrica, por lo que repetirás adb connect después de reiniciar. La pareja se recuerda.
En Android 10 y versiones anteriores, utilice el método más antiguo: conecte una vez mediante USB, ejecute adb tcpip 5555, desconecte, y adb connect <phone-ip>:5555.
Ejecute su aplicación Capacitor en el dispositivo
Con el dispositivo listado en adb devices, la aplicación Capacitor CLI puede construir e instalar directamente:
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABCFor a faster loop, use live reload so the app loads your dev server over the network:
bunx cap run android -l --externalEl teléfono necesita llegar a la IP de su máquina para que esto funcione. Cuando quieras que los probadores fuera de tu red vean cambios sin reinstalar, mira Capgo actualizaciones en vivo en lugar de un servidor de desarrollo.
To read native logs while the app runs:
adb logcat | grep -i -E "capacitor|chromium"Y para depurar el WebView, abra chrome://inspect in desktop Chrome while the debug build is running. Debug builds of Capacitor apps enable WebView debugging by default.
Solución de problemas
El número de compilación no hace nada. Es posible que esté pulsando el campo incorrecto (por ejemplo, la versión de Android en lugar del número de compilación), o el dispositivo está gestionado por una organización. Algunos dispositivos Xiaomi necesitan que pulses la versión del sistema en lugar del número de compilación.
Falta el dispositivo de adb devices.
adb kill-server
adb start-server
adb devicesIntenta luego con un cable diferente y un puerto directamente en el ordenador en lugar de un hub. Cambia la notificación de modo USB a Transferencia de archivos.
No se ve el teléfono en Windows. Instala el controlador USB OEM (Samsung, Xiaomi y otros publican sus propios) o el controlador USB de Google desde el SDK Manager para dispositivos Pixel.
INSTALL_FAILED_UPDATE_INCOMPATIBLE. La aplicación instalada fue firmada con una clave diferente (por ejemplo, una versión de la tienda Play versus su versión de depuración). Desinstálela primero. adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED en Xiaomi. Habilita Instalar mediante USB en Opciones de desarrollador.
El depurado inalámbrico se apaga constantemente. Android lo apaga cuando cambias la red Wi-Fi. Algunos ahorros de batería también lo detienen. Mantén el teléfono en la misma red y conectado durante las sesiones largas.
No autorizado después de actualizar Android Studio. La clave de adb en ~/.android/adbkey se ha cambiado. En Opciones de desarrollador toca Revocar autorizaciones de depurado USB, reconecta y acepta la solicitud nuevamente.
Cómo desactivar las opciones de desarrollador
- Abre Opciones de desarrollador.
- Activar Usar opciones de desarrollador (o Opciones de desarrollador en Samsung) para desactivar.
The menu stays visible on some devices but every switch inside resets to default. To hide the menu completely, go to Configuración > Aplicaciones > Configuración > Almacenamiento y eliminar el almacenamiento para la aplicación de Configuración. Esto reinstala otras preferencias de ajustes también, por lo que es raramente valioso.
Antes de entregar un teléfono de prueba a alguien más, también toca Revocar autorizaciones de depuración USB Revocar autorizaciones de depuración USB
Notas de seguridad
- La depuración por USB permite a un ordenador autorizado instalar aplicaciones y leer datos de aplicaciones de compilaciones depurables. No acepte la solicitud RSA en estaciones de carga públicas o computadoras que no confíe.
- Algunas aplicaciones bancarias y de pago se niegan a ejecutarse mientras las opciones de desarrollador o la depuración por USB están activas. Apáguelas en su teléfono personal cuando esté listo.
- No envíe una compilación de lanzamiento con
android:debuggable="true". Las compilaciones de lanzamiento Capacitor no son depurables por defecto.
El equivalente de iOS
Los iPhones tienen su propia Modo de Desarrollador botón que necesita antes de ejecutar compilaciones de desarrollo o de ad hoc. Consulte ¿Cómo habilitar el Modo de Desarrollador en iOS?Para obtener compilaciones en los teléfonos de los probadores sin cables, consulte ¿Cómo distribuir aplicaciones de iOS y Android a los probadores?.
