MacでADBを使う：Platform-Toolsのインストールとデバイス接続の確認

Macでadbを使うために、Android Studio全体をインストールする必要はありません。コマンドラインで使用するには、Mac向けの公式Android SDK Platform-Toolsパッケージで十分です。すでにStudioでAndroid SDKを管理している場合、Googleは、別の独立したコピーを用意するのではなく、SDK ManagerからPlatform-Toolsを取得することを推奨しています。

このガイドはGoogleのドキュメントに基づくものであり、実機テストの報告ではありません。記載の手順はMacとAndroidデバイスで検証していません。以下のコマンドは、ご自身のMacとデバイスで実行することを想定しています。実行結果やスクリーンショットは掲載していません。

1. インストール元を1つ選びます

Android Studioがすでにインストールされている場合

Tools > SDK Managerを開きます。SDK ToolsタブでAndroid SDK Platform-Toolsを選び、ApplyまたはOKをクリックして、ライセンス条件を確認してください。Android SDK Locationの値を控えてください。インストールされたadbは、そのSDKのplatform-toolsサブディレクトリにあります。

Googleのドキュメントにあるandroid_sdk/platform-tools/は、ご自身のSDKのディレクトリを表す表記であり、そのままターミナルに貼り付けるパスではありません。SDKが必ずデフォルトのディレクトリにあるとは考えず、SDK Managerの表示を確認してください。GoogleのSDK Managerの手順。

adbだけが必要な場合

Platform-Toolsの公式ページを開き、Download SDK Platform-Tools for Macを選択し、Android SDK License Agreementの条件を読んでZIPをダウンロードします。アーカイブを展開し、platform-toolsフォルダを、継続して使用する任意の場所に保存してください。Windows版やLinux版は実行しないでください。

ターミナルで末尾にスペースを付けてcd と入力し、展開したplatform-toolsフォルダをFinderからターミナルのウインドウにドラッグして、Returnキーを押します。これにより、他人のユーザー名や架空のパスを使わずに、実際のディレクトリへ移動できます。続いて、次のコマンドで確認します。

./adb version

接頭辞./は「現在のフォルダにあるadbを実行する」という意味です。そのフォルダにファイルがあるだけでは、接頭辞なしのadbコマンドがPATH経由で見つかるとは限りません。最初の確認のために、ディレクトリをグローバルのPATHへ追加する必要はありません。

Googleは、Studioなしでコマンドラインから利用できる個別のZIPを提供しています。公式パッケージはSDKの条件に基づいて配布されており、任意の「制限のない無料ライセンス」で提供されているわけではありません。ダウンロード元と条件。

OpenNavoのPlatform-Tools紹介ページには、パッケージに関する情報がまとめられています。この記事の作成時点では、同カタログでの推奨は一時停止されています。これはOpenNavo側の状態であり、Googleがツールの提供を終了したという意味ではありません。Googleのページには、引き続き公式のMac向けZIPが掲載されています。このガイドでは、紹介ページのステータスを変更することなく、公式の提供元を使用します。

2. どのadbを実行しているか確認します

任意のディレクトリからadbを実行する想定であれば、次を実行してください。

which -a adb
adb version

which -a adbは、PATH内で見つかったadbのコピーを確認するのに役立ちます。adb versionは、実行されるクライアントのバージョンを表示します。見つかったパスを、前の手順で選んだディレクトリと照合してください。この2つの確認は目的が異なります。バージョンが分かるだけでは、目的のインストール先のadbを使っている証拠にはなりません。

コマンドが見つからない場合は、選んだplatform-toolsフォルダに戻り、./adb versionを使ってください。その場合、この記事の以降のコマンドでも、先頭のadbを./adbに置き換えてください。たとえば、./adb devices -lです。この方法は、SDK Managerでインストールしたディレクトリでも使えます。

複数のインストールが見つかった場合は、まず、ご自身のSDKや作業手順でどれが必要かを判断してください。他のコピーを削除したり、シェル設定を手当たり次第に書き換えたりしないでください。adbクライアントは、ローカルのTCPポート5037で動作する共通のサーバーに接続します。そのため、クライアントファイルの選択と、すでに動作しているサーバーの状態は別の問題です。このガイドでは、選んだコピーを一貫して使用すれば十分です。adbの仕組み。

3. ご自身のAndroidデバイスをUSBで接続します

1. ご自身が所有するデバイスで開発者向けオプションを開き、USB debugging／USBデバッグを有効にします。この項目が表示されていない場合は、Googleの開発者向けオプションを有効にする手順に従ってください。項目名はメーカーによって異なる場合があります。
2. データ転送に対応したケーブルでデバイスをMacに接続し、画面のロックを解除します。
3. デバイス一覧を表示するコマンドを実行します。

adb devices -l

4. デバイス本体に表示される確認要求を確認します。Android 4.2.2以降では、デバッグ用にパソコンのRSA鍵の確認が求められます。アクセスを許可するのは、ご自身の信頼できるパソコンからの、意図した接続の場合だけにしてください。他人のパソコンでは、継続的に信頼する設定を保存しないでください。
5. 承認後、もう一度adb devices -lを実行します。

Googleのドキュメントによると、macOSでデバイスを検出するためにOS側の追加設定は必要ありません。WindowsのUSBドライバーやLinuxのudevに関する手順を、ここに適用しないでください。ただし、これはあらゆるケーブルやデバイスで動作することを保証するものではありません。USB接続とRSA認証。

devicesコマンドはデバイスを一覧表示し、-lを付けると詳細情報が表示されます。adb tcpip 5555はデバイスを一覧表示するコマンドではなく、デバイス上のサービスの待ち受けモードを変更します。このUSB接続の確認には不要なので、実行しないでください。adbコマンドリファレンス。

4. 行の有無だけでなく、結果の意味を確認します

以下は状態の説明であり、特定のデバイスをテストした結果ではありません。

表示内容	意味	次に確認すること
command not found	シェルがその名前のコマンドを見つけられませんでした	選んだフォルダへ移動して./adb versionを確認し、その後は./adb devices -lを使ってください
一覧の見出しだけでデバイスの行がない	今回の照会では接続済みデバイスが表示されませんでした	接続、データ転送対応ケーブル、デバイスのロック解除、USBデバッグが有効かを確認してください。別の正常なケーブルやUSBポートも試してください
unauthorizedを含む行	デバッグ用の接続がまだ承認されていません	スマートフォンのロックを解除した画面を確認し、意図したRSA確認要求を承認してください。要求が表示されない場合は、USBを接続し直して一覧を再確認してください
deviceを含む行	デバイスがadbサーバーに接続されています	シリアル番号とモデルを照合してください。この状態だけでは、Androidの起動完了や、今後のコマンドの成功は確認できません
offlineを含む行	デバイスがadbに接続されていないか、応答していません	接続とデバイスの状態を確認してください。認証成功とは判断しないでください
複数の行	複数のデバイスまたはエミュレーターが検出されています	次のコマンドを実行する前に、対象のデバイスを明示的に選んでください

ケーブルと設定の確認は、GoogleのUSB接続に関する推奨事項に沿ったものです。これらで解決しない場合は、デバイスメーカーのドキュメントを参照してください。macOSの保護機能を無効にしたり、スマートフォンの認証を回避しようとしたりしないでください。

Googleは、deviceという状態でも、Androidの起動が完全に終わり、すべての操作を実行できる状態になったことを意味するわけではないと、明確に注意しています。デバイス一覧の状態。

5. デバイスが複数ある場合は、1台を明示的に選びます

adb devices -lの対象行からシリアル番号をコピーします。特定のデバイスの状態を確認するには、次のコマンドを使えます。

adb -s SERIAL get-state

SERIALはプレースホルダーです。この文字列をそのまま入力せず、ご自身のデバイスの実際のシリアル番号に置き換えてください。現在のディレクトリからツールを実行する場合は、./adb -s SERIAL get-stateを使います。これは状態を照会するコマンドであり、アプリのインストールやファイルの変更は行いません。

-sオプションは、指定したシリアル番号のデバイスを選択します。特にエミュレーターも同時に動作している場合、行の並び順に頼らないでください。Google adbガイドのデバイス選択。

6. 不要な信頼設定を残さずにセッションを終了します

確認が終わったらケーブルを外し、USBデバッグが不要であれば無効にしてください。パソコンに今後のデバッグを許可していて、その信頼を取り消したい場合は、デバイスの開発者向けオプションにUSBデバッグの許可を取り消す項目があれば、それを使用してください。名称と場所はメーカーによって異なります。取り消しによって、以前に信頼した他のパソコンにも影響する場合があります。

ターミナルを閉じるだけでは、信頼が取り消されるわけではありません。この確認のために、鍵や内部管理用ファイルを手動で削除しないでください。スクリーンショットや報告には、シリアル番号、鍵のフィンガープリント、その他のデバイス識別情報を公開しないでください。

よくある質問

adbのためだけにAndroid Studioをインストールする必要はありますか？ いいえ。GoogleはMac向けのPlatform-Toolsを単独のパッケージとして提供しています。すでにStudioを使っている場合は、引き続きSDK Managerでツールを管理するほうが便利です。

./adb versionは動くのに、adb versionが動かないのはなぜですか？ 前者は現在のディレクトリにあるファイルを指定しますが、後者はシェルによるコマンド検索に依存します。このガイドでは、グローバル設定を変更せずに./adbを使い続けても構いません。

deviceは、すべての準備が整ったという意味ですか？ adbとの接続を示すものであり、システムの起動完了、アプリの正常動作、以降のあらゆるコマンドの安全性を保証するものではありません。

ワイヤレスデバッグは必要ですか？ いいえ。このUSB接続の手順では不要です。ネットワークポートを開いたり、ワイヤレス接続を行ったりする手順は含まれていません。

出典と検証範囲

• Google：SDK Platform-ToolsとMac向けダウンロード。
• Google：Android Debug Bridge — 認証、デバイスの一覧表示と選択。
• Google：SDK Manager。
• Google：実機の接続とUSBの確認。
• AOSP：adbリファレンス。

この記事はGoogleの公式ドキュメントに基づいて作成したものであり、MacとAndroidデバイスを使った実機検証は行っていません。確認済みの性能結果、特定のmacOSバージョンとの互換性テスト、実行したと称するコマンドのスクリーンショットは掲載していません。