Xiaomi の USB デバッグ(セキュリティ設定)と USB 経由でインストール
Xiaomi、Redmi、POCO で ADB がうまく動かないときの対処法です。USB デバッグ(セキュリティ設定)と USB 経由でインストールをオンにし、INSTALL_FAILED_USER_RESTRICTED や画面操作のエラーを解決します。
MIUI や HyperOS を搭載した Xiaomi、Redmi、POCO のスマホには、通常の USB デバッグに加えて 2 つの追加スイッチがあります。これらがオフのままだと、ADB は接続できても一部の操作が失敗します。アプリがインストールできない、パソコンから送ったタップや文字入力が反応しない、といった症状です。この記事では、スイッチの場所と各エラーの意味を説明します。
手順 1: 開発者向けオプションをオンにする
- 設定 › デバイス情報 を開きます。
- OS バージョン(HyperOS)または MIUI バージョン を、「開発者になりました」といったメッセージが出るまで 7 回タップします。
- 設定 › 追加設定 › 開発者向けオプション を開きます。
手順 2: 3 つのスイッチ
| スイッチ | できること | 必要な場面 |
|---|---|---|
| USB デバッグ | 基本的な ADB(シェル、logcat、ファイル転送) | すべて |
| USB 経由でインストール | adb install やパソコンからの APK インストール | アプリのインストール |
| USB デバッグ(セキュリティ設定) | タップ、スワイプ、キー入力の送信、権限の付与 | 画面操作、自動化、文字入力 |
下の 2 つは、オンにするときに Mi アカウントへのログイン を求められます。多くの機種では SIM カードが挿さっている ことも必要です。これは Xiaomi 独自のルールで、ADB の要件ではありません。一度オンにすれば、通常はオンのまま保たれます。
エラー: INSTALL_FAILED_USER_RESTRICTED
adb: failed to install app.apk: Failure [INSTALL_FAILED_USER_RESTRICTED: Install canceled by user]原因は 2 つあります。
- USB 経由でインストールがオフ。 上の手順でオンにしてください。
- スマホ側で確認していない。 USB 経由でインストールがオンだと、APK ごとにカウントダウン付きのインストール確認ダイアログが表示されます。時間切れになる前にロックを解除して インストール をタップしてください。
エラー: タップや文字入力が反応しない
USB デバッグだけがオンの状態では、画面のミラーリングはできても、パソコンからの入力は拒否されます。ツールによっては次のようなエラーが表示されます。
java.lang.SecurityException: Injecting to another application requires INJECT_EVENTS permissionUSB デバッグ(セキュリティ設定) をオンにして、接続し直してください。scrcpy、ADBKit、Appium など、入力を送るツールすべてに影響します。
エラー: スイッチがグレーアウトしている、SIM を求められる
- SIM カードを挿し、電波をつかむのを待ってから再度試します。
- 設定 › Mi アカウント でログインします。
- アカウントの確認が終わるよう、モバイルデータか Wi-Fi をオンにします。
エラー: スマホがまったく認識されない
これは Xiaomi の設定の問題ではありません。ケーブル、USB モード、ドライバーを adb devices にデバイスが表示されないときの対処法 で確認してください。Windows では Xiaomi の USB ドライバーか Google USB Driver をインストールします。
ADBKit で Xiaomi のスマホを使う
- 上の 3 つのスイッチをすべてオンにします。
- Chrome または Edge で ADBKit を開き、USB で接続するか、ADBKit エージェントを使って Wi-Fi で接続します。
- スマホのロックを解除し、「USB デバッグを許可しますか?」で 許可 をタップします。
ADBKit の接続ヘルプは、Xiaomi のスマホについて USB デバッグ(セキュリティ設定) に触れています。これがオフだと、ライブ画面は表示されてもクリックや文字入力に反応しないためです。ADBKit から APK をインストールすると、adb install と同じ確認がスマホに表示されるので、スマホのロックは解除したままにしてください。
使い終わったらオフにする
セキュリティ設定をオンにすると、パソコンからスマホを操作できるようになります。テストが終わったら USB デバッグ(セキュリティ設定) と USB 経由でインストール をオフに戻すか、開発者向けオプション自体をオフにしてください。
ほかのインストールエラーは adb install のエラー解説 を、ブートローダー画面については Xiaomi の fastboot モード をご覧ください。