支持的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框架(框架):
- 登录开发人员门户https://dev.epicgames.com。
- 点击 下载SDK(DOWNLOAD SDK) 。
- 在 SDK类型(SDK type) 下拉菜单中,选择 iOS版SDK(SDK for iOS) 选项。
- 在 版本(Version) 下拉菜单中,选择最新版本,然后点击 下载(DOWNLOAD) 。
2. 将EOS SDK框架添加到你的项目
下载EOS SDK框架后,你必须将其添加到自己的项目。下方示例引用了一个名为EOSGame的示例游戏项目。如果你知道如何链接和嵌入iOS框架,可以跳到下面的框架依赖项小节。
按照以下步骤将EOS SDK框架添加到你的项目:
-
转到你下载的EOS SDK压缩包内的
./SDK/Bin/IOS/EOSSDK.framework
文件夹。 -
将
EOSSDK.framework
文件夹复制到你的项目的根文件夹中。 -
在Xcode中打开你的项目。
-
在Xcode中,在左列中选择你的项目以打开其属性。
-
在中间列 目标(TARGETS) 分段下选择你的目标。
-
选择 通用(General) 选项卡,然后滚动到末尾的 框架、库和嵌入式内容(Frameworks, Libraries and Embedded Content) 分段。
-
在访达(Finder)中,从你的项目文件夹拖动
EOSSDK.framework
文件夹,并将其放入Xcode中的 框架、库和嵌入式内容(Frameworks, Libraries and Embedded Content) 分段。 -
点击 构建阶段(Build Phases) 选项卡,然后为
EOSSDK.framework
配置以下设置:- 在 将二进制文件与库链接(Link Binary With Libraries) > 状态(Status) 下拉菜单中,选择 必需(Required) 。
- 选中 嵌入框架(Embed Frameworks) > 复制时进行代码签名(Code Sign On Copy) 。
3. 添加框架依赖项
EOS SDK需要 AuthenticationServices.framework
以便支持面向iOS的以下功能:
- iOS 12以上版本:登录流程。
- iOS 13以上版本:使用Apple登录信息登录。
注意 :如果你的游戏支持iOS 11,还必须包括用于登录流程的 SafariServices.framework
。按照下方相同步骤将 SafariServices.framework
添加到你的项目。请注意,此API已弃用,Apple将来可能会把它删除。支持它只是为了实现有限的向后兼容性。
按照以下步骤将 AuthenticationServices
依赖项添加到你的项目:
-
点击 框架、库和嵌入式内容(Frameworks, Libraries and Embedded Content) 分段末尾的 + (加号图标)。
-
从列表中选择 AuthenticationServices.framework ,然后点击 添加(Add) 将其添加到你的项目。
-
现在,你可以看到 框架、库和嵌入式内容(Frameworks, Libraries and Embedded Content) 分段中列出了该依赖项,以及 EOSSDK.framework 。将 AuthenticationServices 框架的 嵌入(Embed) 选项更改为 不嵌入(Do Not Embed) 。
后续步骤
在你的设备上编译并运行应用,以确保其正确编译。Xcode中的模拟器支持目前不可用于测试EOS SDK。要在你的项目中运行EOS SDK框架,必须拥有安装了iOS 11或更高版本的物理连接设备。
注意 :你必须先初始化EOS SDK,然后才能使用这些接口。请参阅平台接口文档,了解有关初始化EOS SDK的更多信息。