【Flutter】Android実機でワイヤレスデバッグする方法

FlutterとAndroid実機でワイヤレスデバッグする方法を詳しく解説します。

スマートフォン側の設定手順

スマートフォン側では、開発者向けオプションの開放とUSBデバッグの有効化が必要です。

設定完了後、端末とPCをデータ通信対応のUSBケーブルで接続します。接続時に端末画面へ「USBデバッグを許可しますか？」と表示されます。「このパソコンからのUSBデバッグを常に許可する」にチェックを入れて許可を選択します。

端末の通知領域にUSB接続の通知が表示されている場合は、接続モードを「充電のみ」から「ファイル転送（MTP）」へ変更します。

Android 11以降の端末では、同一のWi-Fiネットワークを介したワイヤレスデバッグが利用できます。

ワイヤレスデバッグは、初回のペア設定と、接続ごとの接続確立という2段階の処理で構成されます。

操作段階	スマートフォン側の操作	PC側の実行コマンド
1. ペア設定	「ペア設定コードでデバイスをペア設定」を開き、6桁コードとペア用ポートを確認	adb pair :
2. 接続確立	ワイヤレスデバッグ画面に戻り、接続用ポートを確認	adb connect :
3. 認識確認	操作なし	flutter devices

スマートフォンとPCを同一のローカルWi-Fiネットワークへ接続します。ルーターのプライバシーセパレーター機能が有効な場合、端末間の通信が遮断されるため注意が必要です。

画面上に6桁の「Wi-Fiペア設定コード」と、「IPアドレスとポート」（例: 192.168.0.10:37123）が表示されます。この画面を表示したままPCの操作へ移行します。

PCのターミナルで adb pair コマンドを実行します。端末画面のダイアログに表示されたIPアドレスとペア用ポート番号を入力します。

adb pair 192.168.0.10:37123

コマンドを実行すると、ペア設定コードの入力を求められます。端末画面に表示されている6桁のコードを入力して実行します。認証が成功すると、ペアリング完了メッセージが出力されます。

次に、端末側でペア設定ダイアログを閉じ、ワイヤレスデバッグ詳細画面の「IPアドレスとポート」欄を確認します。ペア設定時のポート番号と接続用ポート番号は異なります。

画面に表示された新しいポート番号を指定し、adb connect コマンドを実行します。

adb connect 192.168.0.10:41235

接続が確立されたら、以下のコマンドで実機が認識されているかを確認します。

flutter devices

一覧に対象端末が表示されたら、実機へのインストールや実行コマンドを実行できます。

ワイヤレスデバッグの再設定が必要な項目等は以下のとおりです。

操作項目	実行頻度	仕様と理由
開発者向けオプション有効化	初回のみ	端末の設定情報として永続化されます
ペア設定（adb pair）	初回のみ	PCがペア設定済みデバイスとして登録されるため次回以降は不要です
接続（adb connect）	接続切断ごとに必要	セキュリティ仕様により、接続ごとのポート番号が動的に再割り当てされるためです