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

> **注意**：本指南仅适用于未启用 Swift Package Manager 的旧版 Flutter 项目。
> 
> 如果你的 Flutter 版本 >= 3.24，强烈建议启用 SPM 支持：
> ```bash
> flutter config --enable-swift-package-manager
> ```
> 启用后，插件会自动处理所有依赖，无需手动配置。

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

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

## 步骤说明

### 1. 运行 pod install

首先在项目根目录运行：

```bash
cd ios
pod install
```

### 2. 打开 Xcode 项目

打开生成的 workspace 文件：

```bash
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`：
   ```bash
   rm -rf ~/Library/Developer/Xcode/DerivedData
   ```
4. 重新打开项目并构建

#### 问题：包依赖下载失败

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

## 注意事项

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

## 相关链接

- [MacPaw OpenAI Swift 库](https://github.com/MacPaw/OpenAI)
- [Swift Package Manager 文档](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app)