Version: 2023.1
言語: 日本語
テストとデバッグ
Android のシンボル

Android デバイスでのデバッグ

Unity は、Android デバイスでアプリケーションをデバッグする方法として、以下をサポートしています。

USB デバッグ

Unity は Android デバイスの USB デバッグをサポートしています。USB デバッグを使用するにはデバイスの開発者向けオプションを有効にしてください。これを行うには、Android ドキュメントの デバイスの開発者向けオプションを設定する を参照してください。

USB ケーブルでデバイスをコンピューターに接続します。Windows コンピューターで開発している場合は、デバイス固有の USB ドライバーのインストールが必要な場合があります。詳しくは、使用しているデバイスのメーカーのウェブサイトを参照してください。

設定手順は Windows と macOS で異なります。Android デバイスと SDK との接続に関する詳細は、Android デベロッパードキュメントの ハードウェアデバイス上でアプリを実行する を参照してください。

ノート: Unity は ChromeOS デバイスでの USB デバッグをサポートしていません。代わりに、ワイヤレス接続で Android Debug Bridge を使用してください。

Android Debug Bridge

Unity は、Android Debug Bridge (ADB) の、USB 接続による使用 (Android デバイス用) と、ワイヤレス接続による使用 (Android および ChromeOS デバイス用) をサポートしています。ワイヤレス接続は、ChromeOS デバイスを使用する場合や、Android デバイスにコントローラーが接続されている場合、あるいは VR アプリケーションのデバッグ中で Android デバイスを VR キットに挿入する場合など、USB デバッグを実行できない場合に便利です。ChromeOS デバイスを ADB 経由で Unity に接続する方法については、ChromeOS デバイスでのデバッグ を参照してください。

USB での接続

USB を使用して ADB 経由で Android デバイスを Unity に接続するには、以下の手順に従ってください。

  1. デバイスの ADB を有効にします。この方法については 開発用デバイスのセットアップ を参照してください。
  2. USB ケーブルを使用して、Unity を実行しているマシンに Android デバイスを接続します。
  3. Unity で Android のビルド設定 を開きます。
  4. Build Settings ウィンドウで Run Device ドロップダウンを選択し、オプションからデバイスを選択します。デバイスが表示されない場合は Refresh をクリックしてください。

ワイヤレスでの接続

ワイヤレス接続を使用して ADB 経由で Android デバイスを Unity に接続するには、以下の手順に従ってください。

  1. デバイスの ADB を有効にします。この方法については 開発用デバイスのセットアップ を参照してください。
  2. 使用デバイスの IP アドレスを確認してください。この手順は使用デバイスのメーカーによって異なります。
  3. Unity で Android のビルド設定 を開きます。
  4. Build Settings ウィンドウで Run Device ドロップダウンを選択し、<Enter IP> オプションを選択します。
  5. 開かれたウィンドウで、デバイスの IP アドレスとポート番号を入力して Add を選択します。デバイスのポート番号が 5555 の場合は入力の必要はありません。Unity がデバイスへの接続に成功すると、そのデバイスが Run Device として選択されます。

Android のログの閲覧

Android デバイス上でアプリケーションのビルドを実行すると、Android はスクリプトからスタックトレースや ログ などのメッセージを収集します。Android は、これらのメッセージを表示するための Logcat コマンドラインツール を提供しています。このツールを Unity アプリケーションで使用するには、次のいずれかを行ってください。

  • ADB を logcat パラメーターで起動します。
    $ adb logcat
  • Android Logcat パッケージを使用します。これは、Logcat コマンドラインツールを実装し、Unity の専用ウィンドウにアプリケーションからのメッセージを表示します。

詳細は Android Logcat を参照してください。

テストとデバッグ
Android のシンボル