为 iOS/iPadOS 构建

本指南将引导您完成在 iOS 和 iPadOS 设备上安装由 Convai 驱动的 Unity 应用的过程。

先决条件

在开始之前，请确保你已准备好以下内容：

• Unity 2022.3 或更高版本
• Xcode（建议使用最新版本）
• Apple Developer 账户
• 已集成并正常运行 Convai Unity SDK 的项目
• 用于构建并部署到 iOS/iPadOS 的 MacBook

步骤 1：准备你的 Unity 项目

1. 打开你的启用了 Convai 的 Unity 项目。
2. 确保你拥有最新版本的 Convai Unity SDK 已导入 并设置 到你的项目中。

已导入 Convai SDK 的 Unity 项目

步骤 2：配置构建设置

1. 在 Unity 中，前往 文件 → 构建设置.
2. 选择 iOS 作为目标平台。
3. 点击 切换平台 如果尚未选择。
4. 勾选 开发构建 用于测试的选项。

Unity 构建设置窗口，已选择 iOS 并勾选 Development Build

如果你想手动添加几个必需文件，请按照步骤 3 操作。如果你希望自动完成，请跳到步骤 4

步骤 3：手动添加必需文件

添加 link.xml

1. 创建一个名为 link.xml 的新文件，位于项目的 Assets 文件夹中。
2. 将以下内容添加到该文件中：

<linker>
  <assembly fullname="UnityEngine">
    <type fullname="UnityEngine.Application" preserve="fields">
      <property name="platform"/>
    </type>
  </assembly>
</linker>

Unity 项目视图，显示 Assets 文件夹中的 link.xml 文件

此文件可防止潜在的 FileNotFoundException 错误，相关于 libgrpc_csharp_ext.x64.dylib 文件。

添加 BuildIos.cs 脚本

1. 在 Assets/Convai/Scripts 中创建一个新的 C# 脚本， 命名为.
2. iOSBuild.cs

将以下内容添加到该脚本：
#if UNITY_EDITOR && UNITY_IOS
using System.IO;
using UnityEditor;
using UnityEditor.Callbacks;
using UnityEngine;

public class iOSBuild : MonoBehaviour
{
    [PostProcessBuild]
    public static void OnPostProcessBuild(BuildTarget target, string path)
    {
        string projectPath = PBXProject.GetPBXProjectPath(path);
        PBXProject project = new PBXProject();
        project.ReadFromString(File.ReadAllText(projectPath));
#if UNITY_2019_3_OR_NEWER
        string targetGuid = project.GetUnityFrameworkTargetGuid();
#else
        string targetGuid = project.TargetGuidByName(PBXProject.GetUnityTargetName());
#endif
        project.AddFrameworkToProject(targetGuid, "libz.tbd", false);
        project.SetBuildProperty(targetGuid, "ENABLE_BITCODE", "NO");
        File.WriteAllText(projectPath, project.WriteToString());
    }
}
#endif

步骤 4：为 iOS 安装所需的 gRPC DLL：

1. 前往 Convai -> Custom Package Installer
2. 点击 安装 iOS 构建包
3. 将脚本附加 命名为 到场景中的任意 GameObject 上。

步骤 5：构建 Xcode 项目

1. 在 Unity 中，前往 文件 → 构建设置.
2. 点击 构建 并选择一个位置来保存你的 Xcode 项目。
3. 等待 Unity 生成 Xcode 项目。

步骤 6：在 Xcode 中配置并构建

1. 打开生成的 Xcode 项目。
2. 在 Xcode 中，在导航器里选择你的项目。
3. 在 "TARGETS" 部分下选择你的目标。
4. 切换到 "Signing & Capabilities" 选项卡。
5. 确保已勾选 "Automatically manage signing"。
6. 从下拉菜单中选择你的 Team（这需要 Apple Developer 账户）。
7. 如有需要，将 Bundle Identifier 更改为唯一字符串。

Xcode 窗口显示 Signing & Capabilities 选项卡，Team 和 Bundle Identifier 字段被高亮

步骤 7：构建并运行

1. 将你的 iOS 设备连接到 Mac。
2. 在 Xcode 中，将已连接的设备选为构建目标。
3. 点击 "Play" 按钮或按 Cmd + R 即可在设备上构建并运行应用。

Xcode 工具栏显示已选择已连接设备，并高亮 "Play" 按钮

故障排除

• 如果你遇到任何构建错误，请确保以上所有步骤都已正确完成。
• 检查你的 Apple Developer 账户是否具备必要的描述文件和证书。
• 如果你遇到任何与 GRPC 相关的问题，请验证 libgrpc_csharp_ext.a 和 libgrpc.a 文件是否正确放置在 Assets/Convai/Plugins/gRPC/Grpc.Core/runtime/ios 文件夹中。