EOS SDK for iOS

如何使用Xcode在iOS项目中实现EOS SDK。

阅读时间3分钟

支持的iOS发布版本

下表列出了每个EOS SDK发布版本支持的iOS发布版本:

EOS SDK发布版本iOS发布版本
EOS SDK 1.10.2 - 1.11支持iOS 11或更高版本

下表列出了每个EOS SDK发布版本为Unity支持的最低iOS发布版本:

EOS SDK发布版本iOS发布版本
EOS SDK 1.10.2 - 1.15.5支持iOS 11或更高版本

为iOS设置EOS SDK

要在你的项目中使用Epic在线服务(EOS)SDK,必须使用iOS版EOS SDK框架(框架)。使用这些说明的前提是,你在Xcode中已有一个iOS项目。

在实现iOS版SDK之前,请回顾一般指南和参考中有关平台实现的内容。

Objective-C和Swift iOS项目

iOS版EOS SDK使用C语言编写。如果你的游戏代码是用Objective-C(ObjC)或Swift编写的,我们建议围绕EOS SDK编写一个ObjC包装器,因为EOS SDK不是Swift模块。iOS版EOS SDK下载包中包括的登录示例使用ObjC包装器。如需查看实现示例,请参阅登录示例的 /Login/EOS/EOSWrapper.h 文件。请参阅使用iOS示例文档,了解有关使用登录示例应用的更多信息。

1. 下载iOS版EOS SDK框架

按照以下步骤下载iOS版EOS SDK框架(框架):

  1. 登录开发人员门户https://dev.epicgames.com
  2. 点击 下载SDK(DOWNLOAD SDK)
  3. SDK类型(SDK type) 下拉菜单中,选择 iOS版SDK(SDK for iOS) 选项。
  4. 版本(Version) 下拉菜单中,选择最新版本,然后点击 下载(DOWNLOAD)

2. 将EOS SDK框架添加到你的项目

下载EOS SDK框架后,你必须将其添加到自己的项目。下方示例引用了一个名为EOSGame的示例游戏项目。如果你知道如何链接和嵌入iOS框架,可以跳到下面的框架依赖项小节。

按照以下步骤将EOS SDK框架添加到你的项目:

  1. 转到你下载的EOS SDK压缩包内的 ./SDK/Bin/IOS/EOSSDK.framework 文件夹。

  2. EOSSDK.framework 文件夹复制到你的项目的根文件夹中。

  3. 在Xcode中打开你的项目。

  4. 在Xcode中,在左列中选择你的项目以打开其属性。

  5. 在中间列 目标(TARGETS) 分段下选择你的目标。

  6. 选择 通用(General) 选项卡,然后滚动到末尾的 框架、库和嵌入式内容(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框架状态设置为必需
    • 选中 嵌入框架(Embed Frameworks) > 复制时进行代码签名(Code Sign On Copy)
    将EOS SDK框架的嵌入框架选项设置为复制时进行代码签名

3. 添加框架依赖项

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的更多信息。