Para habilitar el modo de desarrollador en Android, abre Configuración > Acerca de teléfono y toca Número de compilación siete veces, luego introduce tu PIN. Un Opciones de desarrollador menú aparece, donde puedes activar Depuración USB o Depuración inalámbrica así Android Studio, adb o bunx cap run android Puede instalar y depurar su aplicación. El número de compilación exacto depende del fabricante, por lo que los pasos para cada marca se muestran a continuación.
comandos, instale versiones y lea registros.
Opciones de desarrollador es un menú de ajustes oculto destinado a desarrolladores de aplicaciones. Activarlo por sí solo no hace nada. Solo revela interruptores como:
- Depuración USBEntonces Android Studio,
adbcomandos, instalar compilaciones y leer registros. - Depuración inalámbricaLo mismo por Wi-Fi (Android 11+).
- Quédese despiertoLa pantalla permanece encendida mientras se carga, útil durante la prueba.
- Tamaño de animaciónAcelere o desactive las animaciones del sistema, útil para pruebas de interfaz de usuario.
- No mantener actividadesDestruir actividades cuando las dejes, 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 objetivos de toque.
Hacer No 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.
Activar opciones de desarrollador por marca
| Marca | Dónde tocar 7 veces | Dónde aparece el menú después |
|---|---|---|
| Google Pixel / Android de fábrica | Configuración > Acerca de teléfono > Número de compilación | Configuración > Sistema > Opciones de desarrollador |
| Samsung (One UI) | Configuración > Acerca de teléfono > Información del software > Número de compilación | Settings > Developer options (bottom of list) |
| Xiaomi, Redmi, POCO (HyperOS) | Configuración > Acerca del teléfono > OS version | Configuración > Opciones adicionales > Opciones de desarrollador |
| Xiaomi (MIUI más antiguo) | Configuración > Acerca del teléfono > Versión de MIUI | Configuración > Opciones adicionales > Opciones de desarrollador |
| OnePlus (OxygenOS) | Configuración > Acerca del dispositivo > Versión > Número de compilación | Configuración > Configuración del sistema > Opciones de desarrollador |
| OPPO / realme (ColorOS / realme UI) | Configuración > Acerca del dispositivo > Versión > Número de compilación | Configuración > Opciones adicionales > Opciones de desarrollador |
| Motorola | Configuración > Acerca del teléfono > Número de compilación | Configuración > Sistema > Opciones de desarrollador |
| Huawei / Honor (EMUI / MagicOS) | Configuración > Acerca del 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 puedes encontrar el número de compilación, abre Configuración y utiliza el campo de búsqueda: escribe “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ázate hacia abajo hasta Acerca de teléfono.
- Desplázate hacia abajo hasta el final y toca Número de compilación siete veces. Después de unos toques, verás un mensaje de toast de conteo.
- Introduce tu PIN, patrón o contraseña.
- Vuelve a la Configuración > Sistema > Opciones de desarrollador.
Samsung Galaxy
- Abrir Configuración > Acerca de teléfono > Información del software.
- Pulsar Versión de compilación seis veces y confirmar con su PIN.
- Opciones de desarrollador ahora aparece en la parte inferior de la lista de Configuración principal, debajo de Acerca de teléfono.
Xiaomi, Redmi y POCO
- Abrir Configuración > Acerca de teléfono.
- Pulsar OS version (HyperOS) o Versión de MIUI (dispositivos más antiguos) siete veces.
- Vaya a Configuración > Opciones adicionales > Opciones de desarrollador.
Xiaomi agrega dos interruptores adicionales que normalmente necesitas para el desarrollo: Instalar mediante USB y depuración de 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 siete veces.
- Abrir Configuración > Configuración del sistema > Opciones de desarrollador (OnePlus) o Configuración > Configuración adicional > Opciones de desarrollador (OPPO, realme).
Huawei y Honor
- Abre Ajustes > Acerca de teléfono.
- Toca Número de compilación seis veces.
- Ve a Ajustes > Sistema y actualizaciones > Opciones de desarrollador.
En dispositivos Huawei, también establece el modo de conexión USB a Transferencia de archivos cuando se conecta, de lo contrario adb no verá el dispositivo. Si planea enviar estos teléfonos, lea How to publish a Capacitor app on 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 USB
- Abre Opciones de desarrollador y enciéndelo Depuración USB.
- Conecta el teléfono con un cable USB que admita datos (muchos cables baratos solo admiten carga).
- 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 equipo, verifica la conexión:
adb devicesDeberías ver:
List of devices attached
R5CT1234ABC deviceunauthorized significa que no aceptaste la solicitud. offline generalmente significa un cable o puerto dañado adb servidor de un viejo SDK.
adb ships with the Android SDK Platform-Tools. If Android Studio is installed it lives in ~/Library/Android/sdk/platform-tools en macOS o %LOCALAPPDATA%\Android\Sdk\platform-tools en Windows. Agrega ese directorio a tu PATH. New to the Android toolchain? Our Configuración de Android para aplicaciones Capacitor lo cubre.
Activar depuración inalámbrica (Android 11 y posterior)
La depuración inalámbrica elimina la necesidad de un cable. Su computadora y teléfono deben estar conectados a la misma red Wi-Fi, y algunas redes corporativas o de hotel bloquean el tráfico de dispositivo a dispositivo.
- In opciones de desarrollador, activar depuración inalámbrica y aceptar la solicitud de red.
- Presione depuración inalámbrica para abrirlo, luego Pairia el dispositivo con la pareja code. Mantén esta pantalla abierta.
- En el ordenador, paira utilizando la dirección IP y el puerto mostrados en el diálogo de pareja:
adb pair 192.168.1.42:37145
# Enter pairing code: 482913- Conecta utilizando la IP y el puerto mostrados en la pantalla de depuración inalámbrica principal (un puerto diferente del puerto de pareja):
adb connect 192.168.1.42:41827
adb devicesAndroid Studio también tiene Pairar dispositivos mediante 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 en sí 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.
Ejecuta tu Capacitor aplicación en el dispositivo
With el dispositivo listado en adb devices, el Capacitor CLI puede construir y 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 desee que los probadores fuera de su red vean cambios sin reinstalar, mire en 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
Ningún número de compilación hace clic. You may be tapping the wrong field (for example Android version instead of Build number), or the device is managed by an organization. Some Xiaomi devices need you to tap OS version, not Build number.
Dispositivo faltante de adb devices.
adb kill-server
adb start-server
adb devicesIntenta con un cable diferente y un puerto directamente en el ordenador en lugar de un conector. Cambia la notificación de modo USB a Transferencia de archivos.
Windows no ve el teléfono. 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 compilación de la Tienda de aplicaciones versus tu compilación de depuración). Desinstálala primero: adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED en Xiaomi. Habilitar Instalar mediante USB en opciones de desarrollador.
La depuración inalámbrica se apaga constantemente. Android la apaga cuando cambias la red Wi-Fi. Algunos ahorros de batería también la detienen. Mantén el teléfono en la misma red y conectado durante las sesiones largas.
Después de actualizar Android Studio, no autorizado. La clave de adb en ~/.android/adbkey Cambiado. En opciones de desarrollador toca Revoque las autorizaciones de depuración USB, reconéctate y acepta la solicitud de nuevo.
Cómo desactivar las opciones de desarrollador
- Abrir Opciones de desarrollador.
- Toggle Usar opciones de desarrollador (o Opciones de desarrollador en Samsung) en la parte superior para apagar.
El menú permanece visible en algunos dispositivos, pero cada interruptor dentro se reinicia a su valor predeterminado. Para ocultar completamente el menú, vaya a Configuración > Aplicaciones > Configuración > Almacenamiento y elimine el almacenamiento para la aplicación Configuración. Esto también reinicia otras preferencias de configuración, por lo que es raramente útil.
Antes de entregar un teléfono de prueba a alguien más, también toque Revoque las autorizaciones de depuración USB para que los ordenadores antiguos ya no puedan conectarse.
Notas de seguridad
- La depuración USB permite a un ordenador autorizado instalar aplicaciones y leer datos de aplicaciones de compilaciones de depuración. No acepte la solicitud RSA en estaciones de carga públicas o en ordenadores que no confíe.
- Algunas aplicaciones bancarias y de pago se niegan a ejecutarse mientras las opciones de desarrollador o la depuración USB están activas. Apáguelas en su teléfono personal cuando esté listo.
- Nunca envíe una compilación de lanzamiento con
android:debuggable="true".Capacitor Las compilaciones de lanzamiento no son depurables por defecto.
The equivalent de iOS
Los iPhones tienen su propio Modo de Desarrollador botón que necesitas antes de ejecutar compilaciones de desarrollo o de ad hoc. Consulta cómo habilitar el Modo de Desarrollador en iOS. Para obtener compilaciones en los teléfonos de los probadores sin cables, lee cómo distribuir aplicaciones de iOS y Android a los probadores.
