Using EOS SDK on iOS

如何通过Xcode在iOS项目中使用EOS SDK

阅读时间2分钟

Epic在线服务(Epic Online Services(EOS)) SDK可作为框架集成到iOS项目中。本文将演示如何将该框架添加到项目中。作为前提,你需要使用 Xcode 10.3.1

在为iOS平台接入SDK前,请务必阅读常用指南及参考一文,了解平台接入的注意事项。

1. 项目设置

本指南假设你已经在Xcode中创建了一个可供集成SDK的iOS项目。若你尚未创建iOS项目,请参阅为App创建Xcode项目,该指南将手把手教你如何新建一个项目。

在开发中使用EOS SDK需要满足两点要求:

  • 你必须在项目中禁用 中间代码(bitcode)
  • 你需要连接一台设备来运行链接了SDK的项目。

本指南将使用Xcode 10.3.1中的 单视图App(Single View App) 项目中的原始文件结构。

SDK框架

当你从 开发者门户(Developer Portal) 下载SDK后, 你会在下载的压缩包中看到以下框架文件和文件结构:

EOSSDK.framework
- EOSSDK
- Headers
-eos_achievements_types.h
-info.plist
-Payload
-EOSSDK

2. 在文件结构中添加框架

下载完框架后,我们需要将它添加到项目中。在这个示例中,我们已经将项目命名成了“Test。”

  1. 打开 访达(Finder),在你的项目根目录中创建 框架(Frameworks) 目录。
框架的文件夹

点击查看大图

  1. EOSSDK.framework 文件复制进 框架(Frameworks) 目录。
将EOS SDK框架添加到文件夹中

点击查看大图

这将确保框架能够链接到你的项目。

3. 将框架链接到你的项目

  1. 在Xcode中,将框架从“框架”(Frameworks)目录拖入 目标(Target) > 通用(General) > 框架、库和嵌入内容(Frameworks, Libraries and Embedded Content)
将框架添加到框架、库和嵌入的内容

点击查看大图

  1. 验证刚添加的框架的 目标成员(Target membership) 就是你的应用。
验证框架的目标成员

点击查看大图

4. 嵌入二进制文件

  1. 打开 嵌入二进制目标(Embed Binary Target) > 通用(General) > 嵌入的二进制文件(Embedded Binaries) 下拉菜单,然后选择 "+"。

  2. 然后选择新添加的 EOSSDK 框架。

框架文件夹

点击查看大图

项目现在应该已经嵌入并链接了 EOSSDK.framework 文件。

框架文件夹

点击查看大图

5. 嵌入依赖项

  1. 打开 嵌入二进制目标(Embed Binary Target) > 通用(General) > 嵌入二进制文件(Embedded Binaries) 下拉菜单,然后选择 “+”。

  2. 找到并添加 AuthenticationServices.framework

框架文件夹