バグレポートの取得方法

Androidデバイスにおけるバグレポートの取得方法を説明します。

なお、バグレポートの取得にはAndroidデバイスの他にPCが必要です。

1. SDKプラットフォームツールをダウンロード

PCでSDKプラットフォームツールをダウンロードし、適当な場所に解凍します。

SDKプラットフォームツール

SDKプラットフォームツールは、以降の操作でadbコマンドを使用するために用います。

2. 開発者向けオプションとデバッグ機能を有効化

Androidデバイスでビルド番号（OSビルド番号）を7回連続でクリックし、開発者向けオプションを有効にします。

ビルド番号は設定の中のデバイス情報、タブレット情報、あるいはソフトウェア情報などにありますが、デバイスによって名称や階層構造が異なります。

開発者向けオプションに移動し、「USBデバッグ」を有効にします。

「ワイヤレスデバッグ」という設定項目があるデバイスでは、あわせて「ワイヤレスデバッグ」も有効にしてください。

開発者向けオプションを有効にする

デバイスでデバッグを有効にする

3. Androidデバイスにデバッグ接続

PCをAndroidデバイスと同じネットワークに接続し、コマンドプロンプト（Windowsの場合）またはターミナル（Macの場合）を開きます。

その後、1で解凍したSDKプラットフォームツールのディレクトリに移動します。

cd [platform-toolsがあるディレクトリ]/platform-tools

デバイスによって接続方法が異なります。まず、従来の5555番ポートを使用する方法を試してください。接続できない場合は、後述のペア設定を使用する方法を試してください。

3-1. 5555番ポートに直接接続できる場合

AndroidデバイスのIPアドレスを指定して接続します。

(Windowsの場合)
adb.exe connect 192.168.X.X:5555

(Macの場合)
./adb connect 192.168.X.X:5555

初めてそのPCから接続する場合、Androidデバイス側にUSBデバッグを許可するための確認画面が表示されますので、接続を許可してください。

成功すると、「connected to 192.168.X.X:5555」のように表示されます。

adb-command-1

Androidデバイスの現在のIPアドレス（通常「192.168.X.X」の形式で、Xは255以下の数字）は、「ネットワークとインターネット」から現在接続しているネットワークを選択することで確認できます。

5555番ポートに接続できない場合は、次の手順でワイヤレスデバッグのペア設定を行ってください。

3-2. ワイヤレスデバッグのペア設定が必要な場合

比較的新しいAndroidデバイスでは、5555番ポートに直接接続できず、PCとAndroidデバイスを事前にペア設定する必要があります。

Wi-Fi 経由でデバイスに接続する

まず、Androidデバイスの開発者向けオプションから「ワイヤレスデバッグ」を開き、「ペア設定コードによるデバイスのペア設定」を選択します。

画面に次の情報が表示されます。

  • ペア設定用のIPアドレスとポート番号
  • ペア設定コード

表示されたペア設定用のIPアドレスとポート番号を指定して、PCで次のコマンドを実行します。

(Windowsの場合)
adb.exe pair 192.168.X.X:YYYYY

(Macの場合)
./adb pair 192.168.X.X:YYYYY

「192.168.X.X:YYYYY」の部分は、Androidデバイスのペア設定画面に表示されているIPアドレスとポート番号に置き換えてください。

コマンドを実行するとペア設定コードの入力を求められるため、Androidデバイスに表示されているペア設定コードを入力します。

Enter pairing code: 123456

ペア設定に成功すると、「Successfully paired」のように表示されます。

次に、「ペア設定コードによるデバイスのペア設定」の画面を閉じ、ワイヤレスデバッグのメイン画面に戻ります。

ワイヤレスデバッグのメイン画面に表示されている「IPアドレスとポート」を確認し、その値を指定して接続します。

(Windowsの場合)
adb.exe connect 192.168.X.X:ZZZZZ

(Macの場合)
./adb connect 192.168.X.X:ZZZZZ

ペア設定に使用するポート番号「YYYYY」と接続に使用するポート番号「ZZZZZ」は通常異なりますのでご注意ください。

成功すると、「connected to 192.168.X.X:ZZZZZ」のように表示されます。

接続状態は次のコマンドで確認できます。

(Windowsの場合)
adb.exe devices

(Macの場合)
./adb devices

接続先のIPアドレスとポート番号の横に「device」と表示されていれば、デバッグ接続は完了です。

一度ペア設定したPCでは、通常は次回以降のペア設定は不要です。ただし、デバイスの再起動やネットワークの変更後には、ワイヤレスデバッグ画面に表示されている現在のIPアドレスとポート番号を使用して、再度 adb connect を実行する必要がある場合があります。

4. バグレポートを取得

下記のadbコマンドを用いてバグレポートを取得・保存します。

(Windowsの場合)
adb.exe bugreport MyBugReport

(Macの場合)
./adb bugreport MyBugReport

adb-command-2

コマンドを実行すると1分〜数分程度でバグレポート「MyBugReport.zip」が同じディレクトリに保存されます。

adb-command-3