Xiaomi: Depuración USB (Configuración de seguridad) e Instalar vía USB
Soluciona problemas de ADB en Xiaomi, Redmi y POCO. Activa Depuración USB (Configuración de seguridad) e Instalar vía USB, y corrige INSTALL_FAILED_USER_RESTRICTED.
Los celulares Xiaomi, Redmi y POCO con MIUI o HyperOS agregan dos interruptores extra además de la Depuración USB normal. Sin ellos, ADB se conecta pero algunas cosas fallan: las apps no se instalan, o los toques y lo que escribes desde la computadora no hacen nada. Esta guía te muestra dónde están esos interruptores y qué significa cada error.
Paso 1: activa las Opciones de desarrollador
- Abre Ajustes › Acerca del teléfono.
- Toca Versión del SO (HyperOS) o Versión de MIUI siete veces, hasta que veas "Ahora eres un desarrollador".
- Ve a Ajustes › Ajustes adicionales › Opciones de desarrollador.
Paso 2: los tres interruptores
| Interruptor | Qué permite | Necesario para |
|---|---|---|
| Depuración USB (USB debugging) | ADB básico: shell, logcat, transferencia de archivos | Todo |
| Instalar vía USB (Install via USB) | adb install e instalar APK desde una computadora | Instalar apps |
| Depuración USB (Configuración de seguridad) (USB debugging (Security settings)) | Enviar toques, deslizamientos y teclas, otorgar permisos | Control de pantalla, automatización, escribir |
Los dos últimos te piden iniciar sesión con una cuenta Xiaomi (Mi), y en muchos modelos tiene que haber una tarjeta SIM en el celular al activarlos. Es una regla de Xiaomi, no un requisito de ADB. Una vez activados, normalmente se quedan así.
Error: INSTALL_FAILED_USER_RESTRICTED
adb: failed to install app.apk: Failure [INSTALL_FAILED_USER_RESTRICTED: Install canceled by user]Dos causas:
- Instalar vía USB está desactivado. Actívalo como se indica arriba.
- No confirmaste en el celular. Con Instalar vía USB activado, el celular muestra un diálogo de instalación para cada APK, con una cuenta regresiva. Desbloquea el celular y toca Instalar antes de que se acabe el tiempo.
Error: los toques y la escritura no hacen nada
Con solo la Depuración USB activada, se puede ver la pantalla pero el celular rechaza lo que envía la computadora. Las herramientas pueden mostrar un error como este:
java.lang.SecurityException: Injecting to another application requires INJECT_EVENTS permissionActiva Depuración USB (Configuración de seguridad) y luego desconecta y vuelve a conectar. Esto afecta a scrcpy, ADBKit, Appium y cualquier herramienta que envíe toques o teclas.
Error: el interruptor está en gris o pide una SIM
- Inserta una tarjeta SIM, espera a que tenga señal y vuelve a intentar.
- Inicia sesión con tu cuenta en Ajustes › Cuenta Xiaomi (Mi Account).
- Activa los datos móviles o el Wi-Fi para que se pueda completar la verificación de la cuenta.
Error: no detecta el celular
Eso no es una opción de Xiaomi. Revisa el cable, el modo USB y los drivers en adb devices no detecta el celular. En Windows, instala el driver USB de Xiaomi o el Google USB Driver.
Usar un Xiaomi con ADBKit
- Activa los tres interruptores de arriba.
- Abre ADBKit en Chrome o Edge y conéctate por USB, o por Wi-Fi con el agente de ADBKit.
- Desbloquea el celular y toca Permitir en el aviso "¿Permitir la depuración por USB?".
La ayuda de conexión de ADBKit menciona Depuración USB (Configuración de seguridad) para los celulares Xiaomi, porque sin ella la pantalla en vivo se ve pero no responde a clics ni a lo que escribes. Instalar un APK desde ADBKit muestra la misma confirmación en el celular que adb install, así que mantén el celular desbloqueado.
Desactívalo cuando termines
La Configuración de seguridad permite que una computadora controle tu celular. Cuando termines tus pruebas, vuelve a desactivar Depuración USB (Configuración de seguridad) e Instalar vía USB, o apaga por completo las Opciones de desarrollador.
Para otros errores de instalación, consulta errores de adb install explicados. Para la pantalla del bootloader, consulta modo fastboot en Xiaomi.