Xcode を使用して iOS プロジェクトをデバッグする

Xcode を使用してデバイス上でプロジェクトを起動し、ブレーク ポイントと LLDB コマンドを利用してデバッグする方法を説明します。

Windows
MacOS
Linux

iOS で Unreal Engine ゲームをデバッグするには、プロジェクトをクック処理してパッケージ化した後、Xcode でコードを再ビルドしてデバッグ サポートを利用する必要があります。このページでは、新しいビルドのデバッグ時に必要な手順を説明します。

1. 必要なセットアップ

iOS や tvOS デバイス用のビルドを作成するには、アプリケーションのコード署名証明書とプロビジョニング プロファイルをセットアップする必要があります。これらがない場合、後の手順で行うビルドと iOS デバイスへのデプロイに失敗します。このプロセスの詳細については、「iOS のプロビジョニング」を参照してください。

C++ プロジェクトを作成している場合は、アプリケーションの XCode プロジェクトを用意する必要があります。Xcode プロジェクトがまだない場合は、プロジェクトの .uproject ファイルを探して、Ctrl キーを押しながらファイルをクリックし、[Generate Xcode Project (Xcode プロジェクトの生成)] をクリックしてプロジェクトを作成します。

2. iPhone 用コンテンツをクック処理する

iPhone でデバッグできるようにするには、Unreal Editor** を使用してゲームのコンテンツをクック処理してパッケージ化する必要があります。この処理が必要な理由は、Xcode でゲームのソース コードのコンパイルはできますが、コンテンツのクック処理はできないからです。そのため、ゲームのコンテンツに大きな変更をした場合は、XCode でのデバッグに進む前に必ず全てを再パッケージ化してください。

ゲームのパッケージ化を行うには、Unreal Editor で [File (ファイル)] > [Package Project (プロジェクトをパッケージ化)] > [iOS] の順にクリックします。iOS プロジェクトのパッケージ化に必要な前提条件についての詳細は、「iOS プロジェクトのパッケージ化」を参照してください。

3. Xcode でプロジェクトをコンパイルして起動する

ゲームをパッケージ化したら、デバッグ サポートを有効にした Xcode で再ビルドします。これで、Unreal Engine のパッケージ化プロセスで生成されたバイナリと実行可能ファイルが置き替えられます。

  1. アプリケーションの Xcode プロジェクトを開きます。Xcode のメイン メニューで [Product (プロダクト)] > [Scheme (スキーム)] > [Edit Scheme (スキーム編集)] の順に選択します。

    The Edit Scheme button is located under Product/Scheme

  2. .[Run (実行)] カテゴリをクリックし、 [Build Configuration (ビルド コンフィギュレーション)][DebugGame] に変更します。

    Set the Build Configuration to DebugGame in the Product/Scheme/Edit Scheme menu

Unreal Engine のソース コード ビルドを使用している場合は、[Debug configuration] を使用してエンジン コードをデバッグできます。

  1. ターゲット デバイスを [My Mac] から接続している [iPhone] に変更します。

    Use the button in the upper-right corner of the Xcode window to change your target device to the iPhone

  2. [Build and Run (ビルドして実行)] ボタンをクリックして Xcode でプロジェクトのビルドを開始し、デバイスで起動します。

    Click the Play button in the upper-left to build and run your project.

上記の手順を完了したら、プロジェクトがビルドされ、デバイスで起動されます。これで、ブレークポイント、ログ、LLDB コマンドを使用してプロジェクトをデバッグし、ランタイム時に情報を調査できます。

4.追加情報

Xcode のデバッグ機能の使用方法の詳細については、Xcode を使用したデバッグ に関する Apple のデベロッパー ドキュメントを参照してください。

LLDB の詳細については、Apple のドキュメント アーカイブにある『Getting Started with LLDB』ページを参照してください。

Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
閉じる