跳转至

将SohaGame SDK添加到Xcode项目中

前提条件

  • 自 2026 年 4 月 26 日起，要求使用 Xcode 26。
  • 确保您的项目满足以下要求:
    • iOS 15
  • 设置一个物理的苹果设备或使用模拟器来运行您的应用

重要 — 添加隐私清单

安装 SDK 时，必须将 SohaGame 提供的 PrivacyInfo.xcprivacy 文件添加到您的 App Target。请按照下方步骤4：添加隐私清单完成操作。

下载并安装SDK

步骤1：下载

SDK以静态框架的形式分发，因此您需要手动下载SDK和第三方依赖框架，然后将它们添加到您的Xcode项目中.

SDK需要以下第三方依赖框架:

  • Firebase
  • Facebook
  • Google SignIn
  • Adjust
  • MobileId

Note

请通过 SohaGame 已发送的项目信息 Excel 文件获取 SDK 和示例应用（App Demo）的下载链接。

步骤2：解压缩

解压缩您刚刚下载的所有 .zip 文件.

步骤3：导入到项目中

Warning

不要嵌入这些 XCFrameworks。这些 XCFrameworks 必须设置为“不嵌入”。

  1. 将 SohaSDK.xcframework 以及所有依赖框架的文件夹拖放到您的Xcode项目中。在出现的对话框中，确保您要添加框架的目标旁边有一个复选标记，并且您已经选择了 "Copy items if needed".

  2. 在 Other Linker Settings -ObjC 标志:

    a. 在项目设置中，打开您的目标的 Settings 面板.

    b. 转至构建设置选项卡，找到 Linking 部分中的 Other Linker Flags 设置.

    c. 双击该设置，点击“+”按钮，然后添加 -ObjC. Add the -ObjC flag

步骤4：添加隐私清单

SohaGame 提供了一个 PrivacyInfo.xcprivacy 文件，您需要将其添加到 Xcode 项目中。背景信息请参见 Apple 的隐私清单文档。

  1. 下载 PrivacyInfo.xcprivacy 文件。
  2. 将 PrivacyInfo.xcprivacy 拖入 Xcode 项目。
  3. 在导入对话框中，选择 Copy items if needed，并确保勾选您的 App Target。

添加隐私清单文件