Android Debug Bridge (ADB)は、Android SDK⁠に付属するコマンドラインツールです。これは、開発のあらゆる段階でMeta Questヘッドセットとやり取りをするために使うメインツールです。ADBは、アプリをインストールしたり、コンピューターからヘッドセットに他の重要なコマンドを発行したりするために必要となる、非常に多機能なツールです。

一般的によく使われるアクションについてはこのガイドで説明されていますが、Androidの公式ドキュメント⁠もご覧になることをおすすめします。

利用可能なコマンドとオプションのリストを見るには、ADBがインストールされていることを確認して、次を入力してください。

adb help

ADBを使ってデバイスに接続する

OSシェルから、USBで直接、またはWi-Fi接続を介してTCP/IPにより、Androidデバイスに接続して通信することが可能です。

デバイスをUSB経由で接続するには、互換性のあるUSBケーブルを使用してデバイスをPCにつなぎます。接続後、OSシェルを開き、次を入力します。

adb devices

デバイスが正しく接続されている場合、ADBにデバイスのIDリストが次のように表示されます。

List of devices attached
    ce0551e7                device

デバイスが検出されない場合、ADBは使用できません。ご使用のデバイスがリストにない場合、適切なUSBドライバーがインストールされていないことが考えられます(Oculus ADBドライバーを参照)。Meta Horizonモバイルアプリで開発者モードがデバイスに対して有効になっていることもチェックします。USBケーブルやポートを変えることで接続の問題が解決されることもあります。

Wi-Fiを介してADBに接続する

一般にはUSBでデバイスを接続するほうがTCP/IP接続よりも高速ですが、TCP/IP接続が必須の場合もあります。

TCP/IPを介して接続するには、まずデバイスがすでにUSBで接続されていることを確認してから、次のコマンドを使ってそのIPアドレスを調べます。

adb shell ip route

出力は次のようになります。

10.0.30.0/19 dev wlan0  proto kernel  scope link  src 10.0.32.101

srcの後にあるのがデバイスのIPアドレスです。このIPアドレスとポート(普通は5555)を使用して、次のコマンドを発行します。

adb tcpip <port>
adb connect <ipaddress>:<port>

以下はその例です。

> adb tcpip 5555
    restarting in TCP mode port: 5555
> adb connect 10.0.32.101:5555
    connected to 10.0.32.101:5555

ここで、デバイスをUSBポートから外すことができます。adb devicesに表示されるのが単一のデバイスである限り、すべてのADBコマンドはWi-Fi経由でそのデバイスに対して発行されます。

Wi-Fi接続の使用を停止するには、OSシェルから次のADBコマンドを発行します。

adb disconnect

ADBを使用してアプリをインストールする

次のコマンドを実行して、ヘッドセットにAPKをインストールします。

adb install <APK_PATH>

例えば、Windowsの場合:

adb install C:\Dev\Android\MyProject\VrApp.apk

macOSの場合:

adb install ~/Dev/Android/MyProject/VrApp.apk

ターゲットデバイスにすでにインストールされている同じ名前の既存のAPKを上書きするには、-rオプションを使用します。

adb install -r <APK_PATH>

注: アプリをadb installでインストールすると、通常のQuestのインストール経路を迂回します。クラウドバックアップは、この方法でインストールされたアプリを登録せず、それらのアプリのバックアップを実行しません。

詳しくは、AndroidのAndroid Debug Bridgeガイドのアプリをインストールする⁠のセクションをご覧ください。

接続のトラブルシューティング

以下のセクションでは、ADBの一般的な接続の問題に対する解決策を示します。

コンピューターがデバイスを検出できない

コンピューターがヘッドセットを検出できない場合、さまざまな理由が考えられます。次のようにすることをおすすめします。

モバイル機器のMeta Questコンパニオンアプリで、開発者モードがオンになっていることを確認します。

USBケーブルに問題がないかチェックします。別のUSBケーブルを使用してデバイスを接続してください。別のUSBケーブルがない場合は、他のAndroidデバイスを接続して、問題がUSBケーブルにあるかどうかを確認してください。

コンピューター側に、ヘッドセットにアクセスするために必要なアクセス許可がすべて付与されていることを確認します。通常、USBケーブルでデバイスをコンピューターに接続すると、コンピューターからそのデバイスにアクセスする許可を求めるプロンプトが表示されます。誤ってアクセス許可を拒否してしまった場合は、いったんUSBケーブルを抜き、デバイスを再起動した後、ケーブルをもう一度接続してください。アクセス許可を求められたら、[許可する]を選択します。

一部のデバイスでは、VRアプリの実行中やADBがデバイスを待機している状態で接続すると、デバイスが検出されないことがあります。その場合は、Ctrl+Cでアプリを終了しADBを停止してから、デバイスを接続し直してみてください。あるいは、以下のコマンドを使用してADBサービスを停止することもできます。停止後に次のコマンドが実行されると、ADBサービスが自動的に再開されます。

adb kill-server

`adb`コマンドが見つからないというエラーがターミナルから返される

まず、adbが正しくインストールされているかどうか確認します。/Android/SDK/platform-tools/フォルダに移動し、adbツールがあるかどうか確認します。ツールがない場合はスタンドアローンのAndroid SDKプラットフォームツールパッケージ⁠をダウンロードしてください。

環境変数が正しく設定されているかどうか確認します。

adbを実行するには、/Android/SDK/platform-tools/フォルダから、./を先頭に付加してadbコマンドを実行します。例えば、adb devicesではなく、./adb devicesを使います。

複数のデバイスが同時に接続されている

一度に複数のデバイスを接続することもできます。これは、主にクライアント/サーバー型のアプリをデバッグする場合に有用です。同じデバイスがWi-FiとUSBで同時に接続されていると、ADBではそのデバイスが2つのデバイスとして表示されることに注意してください。デバイスが複数リストされている場合、-sスイッチを使用して、ADBに対しどのデバイスがターゲットなのかを指定しなければなりません。例えば、adb devicesで次のように表示されたとします。

List of devices attached
    ce0551e7                device
    10.0.32.101:5555        device

リストされたデバイスは2つの別個のデバイスである可能性もありますが、1つのデバイスがWi-Fi経由とUSB差し込み(充電のためなど)の両方で接続されている可能性もあります。そのような場合、すべてのADBコマンドは次の形で指定する必要があります(<device id>はadb devicesで報告される識別情報)。