62 行
1.4 KiB
Markdown
62 行
1.4 KiB
Markdown
|
# iOS SDK 发版流程
|
|||
|
|
|
|||
|
|
## 方式一：CocoaPods + 私有 Spec 仓库（推荐）
|
|||
|
|
|
|||
|
|
### 1. 创建私有 Spec Repo（只需一次）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 在 GitLab/GitHub 创建一个空仓库，例如 xuqm-specs
|
|||
|
|
pod repo add xuqm-specs https://your-git-host.com/xuqm/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://your-git-host.com/xuqm/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），两种方式均可使用。
|
