Depuração USB Xiaomi: Configurações de segurança e Instalar via USB
Resolva problemas de ADB no Xiaomi, Redmi e POCO. Ative Depuração USB (Configurações de segurança) e Instalar via USB e corrija INSTALL_FAILED_USER_RESTRICTED.
Os celulares Xiaomi, Redmi e POCO com MIUI ou HyperOS têm duas chaves extras além da Depuração USB normal. Sem elas, o ADB conecta mas algumas coisas falham: os apps não instalam, ou os toques e a digitação enviados pelo computador não fazem nada. Este guia mostra onde ficam essas chaves e o que cada erro significa.
Passo 1: ative as Opções do desenvolvedor
- Abra Configurações › Sobre o telefone.
- Toque sete vezes em Versão do SO (HyperOS) ou Versão do MIUI, até aparecer "Você agora é um desenvolvedor".
- Vá em Configurações › Configurações adicionais › Opções do desenvolvedor.
Passo 2: as três chaves
| Chave | O que libera | Necessária para |
|---|---|---|
| Depuração USB | ADB básico: shell, logcat, transferência de arquivos | Tudo |
| Instalar via USB | adb install e instalação de APKs pelo computador | Instalar apps |
| Depuração USB (Configurações de segurança) | Enviar toques, deslizes e teclas, conceder permissões | Controle da tela, automação, digitação |
As duas últimas pedem que você entre numa conta Mi e, em muitos modelos, é preciso ter um chip (SIM) no celular na hora de ativar. Essa é uma regra da Xiaomi, não uma exigência do ADB. Depois de ativadas, elas costumam continuar ligadas.
Erro: INSTALL_FAILED_USER_RESTRICTED
adb: failed to install app.apk: Failure [INSTALL_FAILED_USER_RESTRICTED: Install canceled by user]Duas causas:
- Instalar via USB está desligado. Ative como mostrado acima.
- Você não confirmou no celular. Com Instalar via USB ligado, o celular mostra uma janela de instalação para cada APK, com contagem regressiva. Desbloqueie o celular e toque em Instalar antes de o tempo acabar.
Erro: toques e digitação não fazem nada
Só com a Depuração USB ligada, a tela pode ser espelhada, mas os comandos de entrada do computador são recusados. As ferramentas podem mostrar um erro como:
java.lang.SecurityException: Injecting to another application requires INJECT_EVENTS permissionAtive Depuração USB (Configurações de segurança), desconecte e conecte de novo. Isso afeta o scrcpy, o ADBKit, o Appium e qualquer outra ferramenta que envie toques ou teclas.
Erro: a chave está cinza ou pede um chip
- Coloque um chip, espere ter sinal e tente de novo.
- Entre numa conta Mi em Configurações › Conta Mi.
- Ligue os dados móveis ou o Wi-Fi para a verificação da conta terminar.
Erro: o celular não é reconhecido
Isso não é uma configuração da Xiaomi. Confira o cabo, o modo USB e os drivers em celular não aparece no adb devices. No Windows, instale o driver USB da Xiaomi ou o Google USB Driver.
Usando um Xiaomi com o ADBKit
- Ative as três chaves acima.
- Abra o ADBKit no Chrome ou no Edge e conecte por USB, ou pelo Wi-Fi com o agente do ADBKit.
- Desbloqueie o celular e toque em Permitir no aviso "Permitir a depuração USB?".
A ajuda de conexão do ADBKit cita Depuração USB (Configurações de segurança) para celulares Xiaomi, porque sem ela a tela ao vivo aparece mas não responde a cliques nem a digitação. Instalar um APK pelo ADBKit gera a mesma confirmação no celular que o adb install, então deixe o celular desbloqueado.
Desligue quando terminar
As Configurações de segurança deixam um computador controlar o seu celular. Quando terminar os testes, desligue de novo Depuração USB (Configurações de segurança) e Instalar via USB, ou desative as Opções do desenvolvedor de vez.
Para outros erros de instalação, veja erros do adb install explicados. Para a tela do bootloader, veja modo fastboot Xiaomi.