deepvoice_client/local_plugins/chat_api/IOS_INTEGRATION_LEGACY.md

iOS 集成指南（旧版 CocoaPods 项目）- Chat API Plugin

注意：本指南仅适用于未启用 Swift Package Manager 的旧版 Flutter 项目。

如果你的 Flutter 版本 >= 3.24，强烈建议启用 SPM 支持：

flutter config --enable-swift-package-manager

启用后，插件会自动处理所有依赖，无需手动配置。

手动集成步骤（仅限 CocoaPods 项目）

由于 Flutter 插件中 CocoaPods 和 Swift Package Manager 的兼容性限制，需要手动在 Xcode 中添加 OpenAI 包依赖。

步骤说明

1. 运行 pod install

首先在项目根目录运行：

cd ios
pod install

2. 打开 Xcode 项目

打开生成的 workspace 文件：

open Runner.xcworkspace

3. 添加 Swift Package 依赖

1. 在 Xcode 中，选择左侧的 Runner 项目（蓝色图标）
2. 在主编辑区域，选择 Runner target
3. 点击顶部的 Package Dependencies 标签
4. 点击左下角的 + 按钮
5. 在弹出的窗口中输入：https://github.com/MacPaw/OpenAI.git
6. 点击 Add Package
7. 在版本选择界面：
   • 选择 Up to Next Major Version
   • 起始版本填写：0.4.0
8. 点击 Add Package
9. 在包产品选择界面，确保 OpenAI 被选中，并且目标是 Runner
10. 点击 Add Package

4. 验证集成

1. 在 Xcode 左侧导航栏中，展开 Package Dependencies
2. 确认能看到 OpenAI 包
3. 尝试构建项目（Cmd + B）确保没有错误

5. 可能的问题

问题：构建时提示找不到 OpenAI 模块

解决方案：

1. 清理构建缓存：Product > Clean Build Folder
2. 关闭 Xcode
3. 删除 DerivedData：

   rm -rf ~/Library/Developer/Xcode/DerivedData
   

4. 重新打开项目并构建

问题：包依赖下载失败

解决方案：

1. 检查网络连接
2. 在 Xcode 中：File > Packages > Reset Package Caches
3. 重新添加包依赖

注意事项

• 每次运行 pod install 后，包依赖配置会保留
• 如果切换了 Xcode 版本，可能需要重新解析包依赖
• 建议将 .xcworkspace 文件加入版本控制，但排除 xcuserdata 目录

相关链接

• MacPaw OpenAI Swift 库
• Swift Package Manager 文档