Android プロジェクトのデバッグ作業

Android プロジェクトを Android Studio を使用してデバッグする方法について説明します。

Choose your operating system:

Windows

macOS

Linux

コンテンツ

Unreal Engine 4 (UE4) と Android Studio により、UE4 プロジェクトで使用する C++ および Java コードをデバッグできます。以下の操作ガイドでは、UE4 Android プロジェクトをデバッグするために使用できる、Android Studio のセットアップを説明します。

ステップ

次のセクションでは、Android Studio をダウンロードおよびセットアップして、UE4 プロジェクトで使用するための方法を説明します。

  1. まだ行っていない場合は、現在の Unreal Engine のビルドと互換性のあるバージョンの AndroidStudio をダウンロードしてインストールします。使用するバージョンについては、「

    [開発要件](sharing-and-releasing-projects/android/getting-started/AndroidSDKRequirements)
    」ページを参照してください。環境のセットアップ方法については、「Android SDK と NDK セットアップガイド」を参照してください。 デバッグするapkをビルドしてから、デバッグに使用するAndroidデバイスにデプロイします。

  2. デバッグ対象の apk をビルドしてから、デバッグに使用する Android デバイスにデプロイします。 package_menu.png

  3. Android Studio Launcher を開き、表示されたオプションから [Open an existing Android Studio Project] を選択します。
    AndroidDebugging_01.png

  4. [Open File or Project] メニューで、C:\YourProjectName\Intermediate\Android\APK\Gradle に移動し、「Gradle」 ディレクトリを選択してから [OK] ボタンをクリックします。
    AndroidDebugging_02.png

  5. Android Studio が開いたら、[Run Menu] から [Edit Configurations] オプションを選択します。
    AndroidDebugging_03.png

  6. [Debugger] タブをクリックし、デバッグ タイプを [Dual] に設定します。
    AndroidDebugging_04.png

  7. 次に [LLDB Startup Command] タブで [plus] アイコン (+) をクリックして、以下の行を入力したら [OK] ボタンを押して処理を完了します。

    command script import "C:\PathToYourUE4EngineInstall\Engine\Extras/LLDBDataFormatters\UE4DataFormatters_2ByteChars.py"

    C++ コードでは TEXT("string") を使用し、L("string") を使用しないように注意してください。

    AndroidDebugging_05.png

    Enter キーを必ず押してください。そうしないとコマンドが有効になりません。

  8. この時点で、プロジェクトの .cpp ファイルを開き、デバッグ対象のアイテムにブレークポイントを追加します。 AndroidDebugging_10.png

  9. メイン メニューで、[Run] > [Debug 'app-app'] を選択します。 AndroidDebugging_06.png

  10. [Select Deployment Type] ウィンドウが表示されたら、リストから使用するデバイスを選択し、[OK] ボタンを押します。 AndroidDebugging_07.png

最終結果

これらの手順をすべて完了したら、デバッガがユーザーの使用する Android デバイスにアタッチするのを待ちます。 AndroidDebugging_08.png

プロジェクトのサイズにより、デバッガがアタッチするのに時間が掛かる場合があります。また、 [Package data inside APK] オプションを使用しない場合、デバイスにデータはインストール されません 。これを実行する場合、APK のサイズが大きくなることから、デバッグの再デプロイは遅くなります。別のオプションとして、エディタで 起動 してから、デバッグ用 Android Studio を使用してデバイスに現在のレベルをインストールする方法があります。現在のレベルのデータ以外が必要な場合、OBB をパッケージ化してデバイスにインストールすることもできます。

This page was written for a previous version of Unreal Engine and has not been updated for the current Unreal Engine 5.0 release.