EOS SDK for iOS

Xcode を使用して iOS プロジェクトに EOS SDK を実装する方法。

3 分で読めます

iOS のプロジェクトで Epic Online Services (EOS) SDK を使用するには、EOS SDK フレームワークを用いる必要があります。これらの手順は、Xcode に既存の iOS プロジェクトがあることを前提としています。

iOS で SDK を実装する前に、プラットフォーム実装のための「一般的なガイドラインと参考情報」を再度ご確認ください。

Objective-C および Swift iOS プロジェクト

iOS 用 EOS SDK は C で記述されています。ゲームのコードが Objective-C (ObjC) または Swift で記述されている場合、EOS SDK は Swift モジュールではないため、EOS SDK の周りに ObjC ラッパーを記述することをお勧めします。iOS 用 EOS SDK ダウンロード ファイルにある Login Sample では、ObjC ラッパーが使用されています。実装例については、Login Sample の「/Login/EOS/EOSWrapper.h」ファイルを参照してください。Login Sample アプリの使用方法の詳細については、「iOS サンプル ドキュメントを使用する」を参照してください。

iOS 用の EOS SDK フレームワークをダウンロードする

iOS 用の EOS SDK フレームワークをダウンロードするには、次の手順に従います。

  1. デベロッパー ポータル (dev.epicgames.com/portal) にサイン インします。
  2. [DOWNLOAD SDK (SDK をダウンロード)] をクリックします。
  3. [SDK type (SDK タイプ)] のドロップダウン メニューから、[SDK for iOS (iOS 用 SDK)] オプションを選択します。
  4. [Version (バージョン)] ドロップダウン メニューから最新バージョンを選択し、[DOWNLOAD (ダウンロード)] をクリックします。

プロジェクトに EOS SDK フレームワークを追加する

EOS SDK フレームワークをダウンロードしたら、それをプロジェクトに追加する必要があります。以下の例は、EOSGame というサンプル ゲーム プロジェクトを参照しています。iOS フレームワークをリンクして埋め込む方法を知っている場合は、以下の フレームワークの依存関係 セクションまでスキップできます。

次の手順に従って、EOS SDK フレームワークをプロジェクトに追加します。

  1. ダウンロードした EOS SDK zip 内の「./SDK/Bin/IOS/EOSSDK.framework」フォルダに移動します。

  2. 「EOSSDK.framework」フォルダをプロジェクトのルート フォルダにコピーします。

  3. Xcode でプロジェクトを開きます。

  4. Xcode で、左側の列でプロジェクトを選択して、そのプロパティを開きます。

  5. [TARGETS] セクションの下の中央の列でターゲットを選択します。

  6. [General] タブを選択し、一番下にある [Frameworks, Libraries and Embedded Content] セクションまでスクロールします。

    [Frameworks, Libraries and Embedded Content] セクションまでスクロールします

  7. Finder のプロジェクト フォルダから「EOSSDK.framework」フォルダをドラッグし、Xcode の [Frameworks, Libraries and Embedded Content] セクションにドロップします。

  8. [Build Phases] タブをクリックし、EOSSDK.framework のこれらの設定を次のように構成します。

    • [Link Binary With Libraries] > [Status] ドロップダウン メニューから [Required] を選択します。
    EOS SDK フレームワークのステータスを [Required] に設定します
    • [Embed Frameworks] > [Code Sign On Copy] を確認します。
    EOS SDK フレームワークの [Embed Frameworks] オプションを [Code Sign On Copy] に設定します

フレームワークの依存関係を追加する

EOS SDK では、AuthenticationServices.framework が iOS の次の機能をサポートしている必要があります。

  • iOS 12 以降：ログイン フロー。
  • iOS 13 以降：Apple ログインでのサイン イン。

注：ゲームが iOS 11 をサポートしている場合は、ログイン フローに SafariServices.framework も追加する必要があります。プロジェクトに SafariServices.framework を追加するには、以下の同じ手順に従います。この API は非推奨であり、Apple によって将来削除される可能性があることに注意してください。これは、限定的な後方互換性を得るためだけにサポートされています。

次の手順に従って、AuthenticationServices 依存関係をプロジェクトに追加します。

  1. [Frameworks, Libraries and Embedded Content] セクションの最後にある [+] (プラス アイコン) をクリックします。

  2. リストから AuthenticationServices.framework を選択し、[Add] をクリックしてプロジェクトに追加します。

  3. これで、[Frameworks, Libraries, and Embedded Content] セクションでリストされている依存関係と EOSSDK.framework が確認できるようになりました。AuthenticationServices フレームワークの [Embed] オプションを [Do Not Embed] に変更します。

次のステップ

デバイスでアプリをビルドして実行し、正しくビルドされることを確認します。Xcode におけるシミュレータのサポートは現在、EOS SDK のテストには利用できません。プロジェクトで EOS SDK フレームワークを実行するには、iOS 11 以降を搭載した物理的な接続済みデバイスが必要です。

注：インターフェースを使用する前に、EOS SDK を初期化する必要があります。EOS SDK の初期化の詳細については、「プラットフォーム インターフェース」ドキュメントを参照してください。