設定 > デバイス情報 > タップ ビルド番号 7回 > 入力 PIN （またはパターン）。「開発者になりました」というメッセージが表示されます。開いて、 開発者向けオプション 次をオンにします USBデバッグ または ワイヤレスデバッグ 必要なときは adbAndroid Studio、または実機で Capacitor を実行する場合。手順は Android 14、15、16 で同じです。設定へのパスだけが ビルド番号 メーカーによって異なります（下の表を参照）。
開発者向けオプションでできること・できないこと
「開発者向けオプション」はアプリ開発者向けの隠し設定メニューです。オンにしただけでは何も起こりません。次のようなスイッチが表示されるだけです：
- USBデバッグ：信頼できるコンピュータに
adbコマンドの実行、build のインストール、logs の読み取りを許可します。 - ワイヤレスデバッグ：Wi-Fi経由でも同様です（Android 11以降）。
- スリープ状態にしない：充電中は画面が点灯したままになり、テスト中に便利です。
- アニメーションスケール：システムアニメーションを速めたりオフにしたりできます。UIテストに便利です。
- アクティビティを保持しない：アプリを離れるとアクティビティを破棄します。Capacitor アプリの状態復元テストに最適です。
- タップを表示 / ポインターの位置：デモの録画やタッチターゲットの確認に便利です。
次の場合には 決して ブラウザやファイルマネージャーからAPKをインストールしたり、ほとんどのアプリを使ったり、OTAアップデートを受け取ったりするには、デベロッパーオプションが必要です。
メーカー別のデベロッパーオプション有効化手順
| メーカー | 7回タップする場所 | その後メニューが表示される場所 |
|---|---|---|
| Google Pixel / 素の Android | 設定 > デバイス情報 > ビルド番号 | 設定 > システム > 開発者向けオプション |
| Samsung (One UI) | 設定 > デバイス情報 > ソフトウェア情報 > ビルド番号 | 設定 > 開発者向けオプション (リストの一番下) |
| Xiaomi、Redmi、POCO (HyperOS) | 設定 > デバイス情報 > OSバージョンまたは | 設定 > 追加設定 > 開発者向けオプション |
| Xiaomi (旧MIUI) | 設定 > デバイス情報 > MIUIバージョンを使用してください | 設定 > 追加設定 > 開発者向けオプション |
| OnePlus (OxygenOS) | 設定 > デバイス情報 > バージョン > ビルド番号 | 設定 > システム設定 > 開発者向けオプション |
| OPPO / realme（ColorOS / realme UI） | 設定 > デバイス情報 > バージョン > ビルド番号 | 設定 > 追加設定 > 開発者向けオプション |
| Motorola | 設定 > デバイス情報 > ビルド番号 | 設定 > システム > 開発者向けオプション |
| Huawei / Honor (EMUI / MagicOS) | 設定 > デバイス情報 > ビルド番号 | 設定 > システムとアップデート > 開発者向けオプション |
メニューの位置はOSバージョンによって変わります。Build numberが見つからない場合は、設定を開いて検索欄に「build number」と入力してください。ほとんどのAndroidデバイスでは、検索で直接見つかります。
Google Pixel（Android 14、15、16）
- 開く 設定 までスクロールして デバイス情報.
- 一番下までスクロールしてタップ ビルド番号 7回タップします。数回タップするとカウントダウンのトーストが表示されます。
- PIN、パターン、またはパスワードを入力してください。
- 戻る 設定 > システム > 開発者向けオプション.
Samsung Galaxy
- 開く 設定 > 端末情報 > ソフトウェア情報.
- タップ ビルド番号 7回タップし、PINで確定します。
- 開発者向けオプション 設定のメインリストの一番下、「デバイス情報」の下に表示されるようになりました。
Xiaomi、Redmi、POCO
- 開く 設定 > デバイス情報.
- タップ OSバージョンまたは (HyperOS) または MIUIバージョンを使用してください (旧デバイス) を7回タップします。
- 以下に移動します： 設定 > 追加設定 > 開発者向けオプション.
Xiaomiでは、開発に通常必要となる2つの追加スイッチが用意されています： USB経由のインストール と USBデバッグ (セキュリティ設定)「USB経由のインストール」が有効でないと、 adb install で失敗します INSTALL_FAILED_USER_RESTRICTEDこれらを有効にするには、XiaomiアカウントへのサインインやSIMカードの挿入が必要になる場合があります。
OnePlus、OPPO、realme
- 開く 設定 > デバイス情報 > バージョン.
- タップ ビルド番号 7回タップします。
- 開く 設定 > システム設定 > 開発者向けオプション (OnePlus) または 設定 > 追加設定 > 開発者向けオプション (OPPO, realme)。
Huawei、Honor
- 開く 設定 > デバイス情報.
- タップ ビルド番号 7回タップします。
- 以下に移動します： 設定 > システムとアップデート > 開発者向けオプション.
もし adb USB経由でHuaweiデバイスが認識されない場合は、USB接続モードを次に設定してください： ファイル転送 接続した際に。
ビルド番号がない、または「この操作は利用できません」と表示される
「デバイス情報」の項目が間違っています。 タップしても、 Androidバージョンや または セキュリティパッチレベル では開発者モードは有効になりません。Samsungの場合は ソフトウェア情報 > ビルド番号を使用してください。Xiaomiの場合は OSバージョンまたは または MIUIバージョンを使用してください上部にある一般的なモデル名ではなく
仕事用プロファイルまたは管理対象デバイス。 仕事用や学校用のポリシーが適用された端末では、開発者向けオプションがブロックされることがよくあります。次のようなメッセージが表示される場合があります： このユーザーは開発者向けオプションを利用できません または この操作は利用できません 「ビルド番号」をタップした際は、設定 > を開き、 アカウント そして、自分が 個人用 プロファイルにいること（「仕事用」ではない）を確認してください。ポリシーを回避するのではなく、IT部門にテスト専用端末を依頼してください。
ゲストユーザー メインユーザーに切り替えてください： 設定 > システム > 複数ユーザー (パスは端末により異なります)、以下からサインアウトしてください： ゲスト、その後オーナーアカウントで同じ7回タップを繰り返します。
ペアレンタルコントロールと制限付きプロファイル。 Family Linkや制限付きのセカンダリユーザーを使っていると、ビルド番号が非表示になったり、ロック解除のジェスチャーがブロックされたりすることがあります。制限のないオーナーアカウントを使用してください。
それでも解決しない場合： 再起動し、保留中のシステムアップデートをインストールしてから、設定で ビルド番号 をもう一度検索してください。中古端末で制限がかかったままの場合は、前の所有者やキャリアがエンタープライズ管理を残している可能性があります。
USBデバッグを有効にする
- 開く 開発者向けオプション をオンにして USBデバッグ.
- データ転送対応のUSBケーブルでスマートフォンを接続してください（安価なケーブルの多くは充電専用です）。
- スマートフォンで「 USBデバッグを許可しますか？ 」ダイアログが表示されたら許可し、「 このコンピュータからの操作を常に許可する 」にチェックを入れてください（自分のマシンで）。
- 次に、コンピュータ側で接続を確認します：
adb devices以下の表示が出ていれば成功です：
List of devices attached
R5CT1234ABC deviceunauthorized プロンプトを承認しなかったことを意味します。 offline 通常、ケーブルやポートの不良、または adb 古い SDK のサーバーが原因です。
adb Android SDK Platform-Tools に同梱されています。Android Studio がインストールされている場合は、 ~/Library/Android/sdk/platform-tools macOS では、 %LOCALAPPDATA%\Android\Sdk\platform-tools Windows では。そのフォルダを PATH に追加してください。 PATHAndroid ツールチェーンは初めてですか？ こちらの Capacitor アプリ向けの Android セットアップガイド で解説しています。
ワイヤレス デバッグをオンにする (Android 11 以降)
ワイヤレス デバッグならケーブルは不要です。PC とスマホが同じ Wi-Fi ネットワークに接続されている必要があります。なお、企業やホテルのネットワークではデバイス間の通信が制限されている場合があります。
- では 開発者向けオプションをオンにして、 ワイヤレスデバッグ ネットワークのプロンプトを許可してください。
- タップ ワイヤレスデバッグ を開いてから、 ペアリング用 code でデバイスをペアリング。この画面を開いたままにしてください。
- PC側では、ペアリングダイアログに表示されているIPアドレスとポートを使ってペアリングします：
adb pair 192.168.1.42:37145
# Enter pairing code: 482913- ワイヤレスデバッグのメイン画面に表示されているIPとポート（ペアリングポートとは別）を使って接続してください：
adb connect 192.168.1.42:41827
adb devicesAndroid Studioにも Wi-Fiでデバイスをペアリング デバイスマネージャーに表示されるQR code を、ワイヤレスデバッグ画面からスキャンします。
ワイヤレスデバッグが再起動するたびにポートが変わるため、再起動後は再度 adb connect 操作が必要です。ペアリング自体は保持されます。
Android 10以前の場合は、従来の方法を使用してください。一度USBで接続し、 adb tcpip 5555, 取り外してから、 adb connect <phone-ip>:5555.
デバイス上で Capacitor アプリを実行します
デバイスが adb devicesにリストされていれば、Capacitor CLI を使って直接ビルドとインストールが可能です：
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABC開発サイクルを高速化するには、ライブリロードを使用してネットワーク経由でアプリに開発サーバーを読み込ませます：
bunx cap run android -l --externalこれを機能させるには、スマートフォンからお使いのマシンのIPアドレスに到達できる必要があります。
アプリ実行中のネイティブログを確認するには：
adb logcat | grep -i -E "capacitor|chromium"WebViewをデバッグするには、次を開きます： chrome://inspect デバッグビルドの実行中に、デスクトップ版Chromeで開きます。Capacitor アプリのデバッグビルドでは、デフォルトでWebViewのデバッグが有効になっています。
トラブルシューティング
ビルド番号をタップしても何も起きません。 タップする場所が間違っている（例：ビルド番号ではなくAndroidバージョンをタップしている）か、デバイスが組織によって管理されている可能性があります。Xiaomiの一部のデバイスでは、ビルド番号ではなくOSバージョンをタップする必要があります。
デバイスが次に表示されません： adb devices.
adb kill-server
adb start-server
adb devices別のケーブルを試すか、ハブではなくコンピュータのポートに直接接続してください。USBモードの通知を次に切り替えます： ファイル転送.
Windowsがスマートフォンを認識しません。 OEMのUSBドライバー（SamsungやXiaomiなどが独自に提供）をインストールするか、Pixelデバイスの場合は SDK ManagerからGoogle USB Driverをインストールしてください。
INSTALL_FAILED_UPDATE_INCOMPATIBLE. インストール済みのアプリが異なるキーで署名されています（例：Play Store版とデバッグビルドの違い）。まずアンインストールしてください： adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED Xiaomiの場合： 有効にする USB経由のインストール 「開発者向けオプション」内にあります。
ワイヤレスデバッグが勝手にオフになる。 AndroidはWi-Fiネットワークを切り替えるとオフにします。バッテリーセーバーによっても停止することがあります。長時間のセッションでは、同じネットワークにつないだまま充電してください。
Android Studioのアップデート後にunauthorizedになる。 のadbキーが ~/.android/adbkey 変更されました。「開発者向けオプション」で USBデバッグの承認を取り消すをタップし、再接続して再度プロンプトを承認してください。
開発者向けオプションをオフにする方法
- 開く 開発者向けオプション.
- 切り替え 開発者向けオプションを使用 (または 開発者向けオプション Samsungの場合、上部のスイッチをオフにします。
端末によってはメニューが表示されたままになり、開発者向けオプションをオフにしても個別のトグルが最後の値のままになることがあります。メニューを完全に隠すには、 設定 > アプリ > 設定 > ストレージ へ進み、設定アプリのストレージを消去してください。他の設定項目もリセットされるので、ほとんどおすすめしません。
テスト端末を他人に渡す前に、次の項目もタップしてください。 USBデバッグの承認を取り消す これで、以前使ったPCからは接続できなくなります。
セキュリティに関する注意
- USBデバッグを有効にすると、許可したコンピュータがアプリをインストールしたり、デバッグ可能なビルドからアプリデータを読み取ったりできるようになります。公共の充電スタンドや信頼できないコンピュータでは、RSAのプロンプトを許可しないでください。
- 一部の銀行・決済アプリは、開発者向けオプションやUSBデバッグが有効なままだと起動を拒否します。作業が終わったら、個人の端末ではオフにしてください。
- 以下を含めたままリリースビルドを出荷しないでください：
android:debuggable="true". Capacitor のリリースビルドは、デフォルトではデバッグできません。
よくある質問
ビルド番号がない場合、どうやって開発者向けオプションを有効にしますか？
すべてのAndroid端末にビルド番号は存在しますが、メーカーによって名称や場所が異なる場合があります。Samsungの場合は、設定 > デバイス情報 > ソフトウェア情報から「ビルド番号」を7回タップします。Xiaomi HyperOSでは「OSバージョン」を、古いMIUIでは「MIUIバージョン」をタップしてください。見つからない場合は、設定の検索バーで「ビルド番号」と入力してください。詳細は ビルド番号が見つからない場合 ワークプロファイルや制限付きユーザー向けです。
Android 14または15で、ビルド番号を何回タップすればいいですか？
続けて7回、 ビルド番号 (または OSバージョンまたは / MIUIバージョンを使用してください （Xiaomiの場合など）。3回か4回タップすると、通常Androidではカウントダウンのトーストが表示されます。求められたらデバイスのPIN、パターン、パスワードを入力し、その後、次を開きます： 開発者向けオプション 設定から。
Samsungでビルド番号はどこ？
設定 > 端末情報 > ソフトウェア情報 > ビルド番号。それを7回タップし、PINを確認して、次を探します： 開発者向けオプション 設定のメインリストの一番下に。
ワイヤレスデバッグのペアリング方法は？
オンにする ワイヤレスデバッグ 開発者向けオプションでそれを開き、次を選択します： ペアリング用 code でデバイスをペアリング. PCで実行します adb pair <ip>:<pairing-port>, 6桁の code を入力し、 adb connect <ip>:<debug-port> ワイヤレスデバッグのメイン画面に表示されているアドレス（ペアリングポートではありません）を使用してください。
仕事用の端末でも開発者向けオプションを有効にできますか？
通常、IT部門の承認なしではできません。管理対象デバイスではビルド番号の連打操作がブロックされたり、 この操作は利用できません。テストには個人用または専用の端末を使用してください。 adb 使用してください。
