ドキュメント

Unity Engine

Unity Engine

Android デバイスでのデバッグ

USB またはワイヤレス接続を介して Android デバイスでアプリケーションをデバッグ。
読み終わるまでの所要時間 9 分最終更新 5日前

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

USB デバッグ

Unity は Android デバイスの USB デバッグをサポートします。USB デバッグを使用するには、デバイスで開発者オプションを有効にします。これを行うには、Android の設定開発者オプションのドキュメントを参照してください。
USB ケーブルを使用してデバイスをコンピュータに接続します。Windows コンピュータで開発する場合は、デバイス固有の USB ドライバーのインストールが必要な場合があります。詳細については、デバイスの製造元のウェブウェブサイトを参照してください。
設定プロセスは Windows と macOS で異なります。SDK に Android デバイスを接続する方法の詳細については、Android 開発者ドキュメントの アプリの実行 のセクションを参照してください。

Android デバッグブリッジ

Unityは、USB経由のADB(Androidデバッグ ブリッジ)とAndroidデバイスのワイヤレス接続をサポートしています。ワイヤレス接続は、USBデバッグを実行できない場合、コントローラーがAndroidデバイスに接続されている場合、またはVRアプリケーションをデバッグし、AndroidデバイスをVRキットに挿入する場合に便利です。

USB での接続

USB を使用して ADB 経由で Android デバイスを Unity に接続するには:
  1. デバイスで ADB を有効にします。この方法については、「 開発用デバイスの設定 」を参照してください。
  2. USB ケーブルを使用して、Android デバイスを Unity を実行しているマシンに接続します。
  3. ファイル>ビルドプロファイルを操作する。
  4. Android ビルドプロファイルを選択または追加します。
  5. 「Run device build(デバイスのビルドを実行)」設定で、使用可能なオプションからデバイスを選択します。デバイスが表示されない場合は、[Refresh] をクリックします。
  6. ビルドおよび実行を選択してアプリケーションをビルドし、デバイスで実行します。

ワイヤレス接続

ADB を介して Android デバイスを Unity にワイヤレス接続するには、以下を行います。
  1. デバイスでワイヤレス ADB をイネーブルにします。この方法については、「 Connect to your device using Wi-Fi 」を参照してください。
  2. デバイスの IP アドレスを確認します。これを行うプロセスは、デバイスの製造元によって異なります。
  3. ファイル>ビルドプロファイルを操作する。
  4. Android ビルドプロファイルを選択または作成します。
  5. Runデバイスのビルド設定から、**<Enter IP>**オプションを選択します。
  6. 開いたウィンドウで、デバイスの IP アドレスとポート番号を入力します。デバイスのポート番号が
    5555
    の場合は、入力する必要はありません。
  7. Add (追加) を選択します。Unity がデバイスに接続すると、デバイス名が Run デバイス リストに表示され、選択されます。
  8. ビルドおよび実行を選択してアプリケーションをビルドし、デバイスで実行します。

Android ログの表示

Android デバイスでアプリケーションのビルドを実行すると、Android はスタックトレースやログなどのメッセージをスクリプトから収集します。これらのメッセージを確認するために、Android には logcat コマンドライン ツールが用意されています。Unity アプリケーションでこのツールを使用するには、以下のいずれかを行います。
  • logcat
    パラメーターを指定してADBを起動します。
    $ adb logcat
  • Android Logcat パッケージを使用します。このパッケージは logcat コマンドライン ツールを実装し、アプリケーションからのメッセージを Unity の専用ウィンドウに表示します。

Android アプリケーションへの IDE のアタッチ、設定、添付

統合開発環境 (IDE) をアタッチ、設定、添付して、デバイス上で実行されている Unity Android アプリケーションのマネージ C# コードをデバッグできます。Visual Studio を使用してこれを行うには、以下のステップに従います。
  1. Android デバイスで Unity アプリケーションを実行します。
  2. Visual Studio で、デバッグ、Unity デバッガーアタッチ、設定、添付の順に移動します。
  3. Select Unity Instance ウィンドウで、デバイス上で実行中の Unity インスタンスを見つけます。[Machine] 列には、インスタンスがアクティブなデバイスが表示されます。
  4. 正しいインスタンスを選択し、OK を選択します。
Visual Studio コードや JetBrains Rider など、デバッグ用にほかの IDE を接続する方法については、次の関連ドキュメントを参照してください。VS コードを使用した Unity 開発と Unity アプリケーションのデバッグ。
ヒント
デバイスでデバッガを実行する前に、Wait for マネージデバッガ Android ビルド設定 を使用してアプリケーションにデバッガをアタッチ、設定、添付します。アプリケーションの初期化コードをデバッグできます。

追加リソース