XuqmGroup-iOSSDK/PUBLISH.md

iOS SDK 发版流程

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

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

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

2. 发版步骤

# 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. 客户端集成

# Podfile
source 'https://your-git-host.com/xuqm/xuqm-specs.git'
source 'https://cdn.cocoapods.org/'

pod 'XuqmSDK', '~> 0.1.0'

---

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

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

# 打 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），两种方式均可使用。