ガイド
Androidのワイヤレス デバッグをMacとペア設定する
Android 11からは、ケーブルなしでWi-Fi越しにadbを使えます。ペア設定に必要なのは6桁のコードと1分ほどの時間で、うまくいかないときの原因は、だいたい決まっています。
ワイヤレス デバッグは、Androidの開発者向けの接続であるadbを、USBケーブルではなくWi-Fiネットワークで使う機能です。Android 11以降で、開発者向けオプションがオンになっていて、スマホとMacが同じネットワークにある必要があります。スマホで開発者向けオプション > ワイヤレス デバッグを開いてオンにし、ペア設定コードによるデバイスのペア設定をタップします。スマホに6桁のコードが表示されるので、それを一度だけMacに伝えます。それ以降は、同じネットワークにいればいつでも接続できます。
Mac側の作業には2つの方法があります。ターミナルでGoogle自身のadbツールを使うか、ペア設定をしてくれるアプリを使うかです。以下で両方を説明し、そのあとで、スマホとMacがペア設定できないときに試すことを紹介します。
始める前に
- Android 11以降。設定 > デバイス情報で確かめます。それより古いバージョンでは、USBで接続したあとに
adb tcpip 5555を使う方法でしか、Wi-Fi経由のadbを使えません。 - 開発者向けオプションがオン。ビルド番号を7回タップします。メーカーごとのビルド番号の場所は、USB デバッグをオンにする方法にあります。Pixelでは、そのあと設定 > システムに開発者向けオプションが現れます。
- 同じネットワーク。スマホはWi-Fiに、Macは同じWi-Fiか、同じルーターに有線でつなぎます。ゲストネットワークは使えません。理由はあとで説明します。
ワイヤレス デバッグをオンにする
開発者向けオプションを開き、ワイヤレス デバッグを探します。スイッチではなく項目名をタップして専用のページを開き、そこでオンにします。スマホが、このネットワークでワイヤレス デバッグを許可するかどうかを尋ねます。自分のネットワークならこのネットワークで常に許可するにチェックを入れ、許可をタップします。
ページには、スマホのアドレスとポート、ペア設定済みのデバイスの一覧、そして2つのペア設定の方法、QR コードによるデバイスのペア設定とペア設定コードによるデバイスのペア設定が表示されます。QRコードは、Android Studioや、QRコードを表示するアプリ向けです。ペア設定コードは、どれとでも使えます。
頻繁にオンとオフを切り替えるなら、タイルを追加しましょう。開発者向けオプション > クイック設定開発者用タイル > ワイヤレス デバッグです。
ターミナルでadbを使ってペア設定する
adbが入っている、GoogleのSDK Platform-Toolsをインストールします。Homebrewなら1行で済みます。そうでなければ、GoogleのAndroidデベロッパーサイトからダウンロードします。
brew install --cask android-platform-tools
スマホでペア設定コードによるデバイスのペア設定をタップします。ダイアログに、6桁のコードと、192.168.1.23:37155のようなポート付きのアドレスが表示されます。開いたままにしておきます。Macで、そのアドレスを付けてadb pairを実行し、求められたらコードを入力します。
adb pair 192.168.1.23:37155
ターミナルにペア設定が完了したと表示され、スマホのペア設定済みのデバイスにMacが現れます。このポートはペア設定専用です。接続には、ワイヤレス デバッグのページの上部に表示されたアドレスとポートを使います。こちらは別のポートです。
adb connect 192.168.1.23:41689
adb devices
最近のバージョンのadbは、ネットワーク上のペア設定済みのスマホを見つけて自分で接続することが多いので、adb connectを入力する前にadb devicesに表示されることもあります。接続用のポートは、ワイヤレス デバッグをオフにしてからオンにし直すと変わることがあるので、毎回スマホで確かめてください。
ここからは、ケーブルのときと同じようにadbを使えます。adb pull /sdcard/DCIM/Camera ~/Desktop/Cameraでカメラのフォルダをコピーし、adb shellでシェルを開きます。ペア設定を解除するには、ペア設定済みのデバイスでMacをタップし、削除を選びます。
SideMountでペア設定する
SideMountは、ケーブル越しに、またはペア設定をすればWi-Fi越しに、スマホをFinderのボリュームとしてマウントします。自分でadbを話すので、Platform-Toolsは要りません。メニューバーからパネルを開き、スマホがつながっていないときに表示されるConnect over Wi-Fiを選ぶか、設定のPair a phone over Wi-Fiの横にあるPairを選びます。パネルには、QR コードによるデバイスのペア設定で読み取るQRコードが表示されます。Use a pairing code insteadを選んだ場合は、コードを表示しているスマホを待ちます。スマホでペア設定コードによるデバイスのペア設定をタップし、6桁の数字をパネルに入力します。
初回は、このアプリにローカルネットワーク上のデバイスを探すことを許可するかどうか、macOSが尋ねます。許可してください。許可しないと、何も表示されません。あとで変えるには、システム設定 > プライバシーとセキュリティ > ローカルネットワークを開きます。
それ以降は、ワイヤレス デバッグがオンのスマホが同じネットワークにあれば、いつでもFinderにマウントされます。ケーブルもつなげば、ケーブルに切り替わります。macOS 26以降が必要で、最初の接続のそのほかの手順はセットアップガイドで説明しています。
速度については、現実的に考えてください。私たちの測定では、自宅のWi-Fiでマウントしたスマホの速度は13から18 MB/sで、同じスマホをケーブルでつなぐと270から280 MB/sでした。書類や写真を数枚扱うには十分ですが、スマホ1台分の動画には遅すぎます。ほかの方法は、AndroidからMacへ、ワイヤレスで移すすべての方法で比べています。
| GoogleのPlatform-Toolsのadb | SideMount | |
|---|---|---|
| ペア設定 | 6桁のコード、またはAndroid Studio経由のQRコード | 6桁のコードかQRコード(パネルで) |
| ファイルをFinderに表示 | 不可(ターミナルでコマンド) | 可能(ボリュームとして) |
| 自動で再接続 | ネットワークが検出を通せば、多くの場合は可能 | 可能(ワイヤレス デバッグがオンのあいだ) |
| Android 10以前 | USB接続のあとでadb tcpipを使う場合のみ | 不可(Android 11以降) |
| 価格 | 無料 | 月額$1.99または買い切り$19、7日間のトライアルあり |
| ケーブルと比べた速度 | 遅い(Wi-Fiしだい) | 遅い(Wi-Fiしだい) |
ペア設定に失敗するとき
コードの期限が切れた、またはダイアログが閉じた
スマホがコードを受け付けるのは、ペア設定のダイアログが画面に開いているあいだだけです。画面がロックされたり、ほかのアプリに切り替えたりした場合は、もう一度ペア設定コードによるデバイスのペア設定をタップして、新しいコードを使ってください。打ち間違えたコードは理由の説明なしに失敗するので、その場合も、新しいコードで解決します。
ゲストネットワーク、または端末どうしを分けるネットワーク
多くのゲストネットワークや、ホテル、学校、職場のネットワークの多くは、クライアント分離を使っています。各端末はインターネットには出られても、ほかの端末には届きません。ワイヤレス デバッグでは、スマホとMacがお互いに直接届く必要があります。さらに、スマホを自動で見つける仕組みはどれも、スマホがネットワーク上で自分の存在を知らせることに頼っていて、こうしたネットワークはそれもよく遮断します。自宅のネットワークを使ってください。それでも失敗するなら、ルーターの設定でクライアント分離やAP分離を探し、使っているネットワークでオフになっているか確かめてください。
MacまたはスマホのVPN
VPNは、ローカルの通信をネットワークの外に送ってしまうことがあり、そうなると2台は出会えません。ペア設定のあいだはVPNをオフにするか、VPNの設定でローカルネットワークへのアクセスを許可してから、もう一度試してください。
ワイヤレス デバッグが勝手にオフになった
Android 16以前では、スマホが別のネットワークに切り替わったり再起動したりすると、ワイヤレス デバッグがよくオフになります。もう一度オンにして、ポートを確かめてください。変わっていることがあります。Android 17では、MacにPlatform-Tools 37.0.0以降があれば、GoogleのADB Wi-Fi 2.0により、許可したネットワークではスマホが自分でオンに戻します。
古いadb、または止まったadbサーバー
ペア設定には、新しいadbが必要です。Platform-Toolsをアップデートし、adb kill-serverを実行して、もう一度試してください。失敗しているのが検出なら、スマホに表示されたアドレスとポートを使ったadb connectは、検出なしで動きます。
よくある質問
ワイヤレス デバッグには、どのバージョンのAndroidが必要ですか?
スマホではAndroid 11以降です。それより古いスマホは、USB接続のあとでしかWi-Fi経由のadbを使えません。ケーブルをつないだ状態で「adb tcpip 5555」を実行し、そのあとスマホのアドレスを付けて「adb connect」を実行します。
ペア設定に成功したのに、adb connectが失敗するのはなぜですか?
たいていは、ペア設定用のポートを指定しているからです。ペア設定と接続では、ポートが違います。ペア設定のダイアログを閉じ、ワイヤレス デバッグのページの上部に表示されたアドレスとポートを使ってください。このポートは、ワイヤレス デバッグをオンにするたびに変わることがあります。
スマホとMacは同じWi-Fiにつながっている必要がありますか?
はい。同じネットワークにあり、お互いに直接届く必要があります。ゲストネットワークやクライアント分離のあるネットワークは端末どうしを分けるので、両方ともオンラインでも、ペア設定は失敗します。
ワイヤレス デバッグは、USBケーブルと同じくらい速いですか?
いいえ。ファイルを移すなら、Wi-FiはUSBケーブルよりはるかに遅く、速度はルーター、距離、あいだにある壁によって変わります。書類や数枚の写真に向いています。大きな動画やバックアップ全体なら、スマホをケーブルでつないでください。