XuqmGroup-iOSSDK/PUBLISH.md

# iOS SDK 发版流程

## 方式一：CocoaPods + 私有 Spec 仓库（推荐）

### 1. 创建私有 Spec Repo（只需一次）

```bash
# 在 GitLab/GitHub 创建一个空仓库，例如 xuqm-specs
pod repo add xuqm-specs https://xuqinmin.com/xuqinmin12/xuqm-specs.git
```

### 2. 发版步骤

```bash
# 1. 更新 XuqmSDK.podspec 中的 version 字段
# 2. 提交代码并打 tag
git tag 0.1.0
git push origin 0.1.0

# 3. 验证 podspec
pod spec lint XuqmSDK.podspec --allow-warnings

# 4. 推送到私有 spec repo
pod repo push xuqm-specs XuqmSDK.podspec --allow-warnings
```

### 3. 客户端集成

```ruby
# Podfile
source 'https://xuqinmin.com/xuqinmin12/xuqm-specs.git'
source 'https://cdn.cocoapods.org/'

pod 'XuqmSDK', '~> 0.1.0'
```

---

## 方式二：Swift Package Manager（更现代，适合 Xcode 原生集成）

SPM 基于 Git 标签发版，无需额外基础设施：

```bash
# 打 tag 即可发版
git tag 0.1.0
git push origin 0.1.0
```

客户端在 Xcode → File → Add Package Dependencies 中填写 Git 仓库地址和版本号。

---

## 推荐选择

| 场景 | 推荐方式 |
|------|---------|
| 纯 Swift/SwiftUI 项目，Xcode 15+ | **SPM**（已有 Package.swift） |
| 需要支持 ObjC 混编 / 已有 Cocoapods 体系 | **CocoaPods 私有 Spec** |
| 两种都要支持 | 同时维护 Package.swift + XuqmSDK.podspec |

当前项目已同时提供 `Package.swift`（SPM）和 `XuqmSDK.podspec`（CocoaPods），两种方式均可使用。