Files

T

wangjia aa7099ba94 feat(devops): 发版拆分为 client/site/server 三条独立流水线

将单一 CI/CD 流水线拆成三条互不影响的发布流水线，各有 tag 前缀、独立版本
序列与独立 CHANGELOG：

- client（client-v*）：Flutter 全平台 + version.yaml 自更新清单
- site（site-v*）：web/ Eleventy 营销站，不含 web 版 app
- server（server-v*）：backend Go 服务 + 共享基建 nginx/systemd

新增 3 个 workflow（deploy-client/site/server.yml）替换 deploy.yml；CI 脚本
按 part 拆分为 compile-/release-/deploy-{client,site,server}.sh，抽出公共函数
lib-forgejo.sh；compile-{macos,android,ios,windows}.sh 改去 client-v 前缀；
manual.yml 按前缀路由回滚。

跨流水线解耦：version.yaml 归 client，后端每请求实时读取（不重启、不触发
server 流水线）；官网下载页的版本徽章/下载链接/更新日志时间线运行时经
/api/v1/public/release 动态拉取（API 不可达回退构建时静态内容）。为此一次性
扩展后端 changelog 字段（version.go/public.go）与 download.njk 动态渲染。

CHANGELOG.md 重命名为 CHANGELOG-client.md，新增 CHANGELOG-site/server.md；
重写 /release 命令为 /release <part> [version]；同步更新 CLAUDE.md 与部署文档。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-17 08:21:28 +08:00

3.1 KiB

Raw Blame History

iOS 分发（TestFlight）— 一次性配置

iOS 不能像安卓那样把安装包挂网页直接侧载。本项目通过 TestFlight 分发：CI 自动构建签名 IPA 并上传 App Store Connect，用户装 TestFlight app 后用公开链接安装。

所有凭证通过 Forgejo Secrets 注入，不入库。配置完成前 build-ios job 会自动跳过（exit 0），不阻塞发版。

前置：Apple Developer 账号

注册 Apple Developer Program（$99/年）。
在 App Store Connect 新建 App，Bundle ID = com.yanmei.jiu（与工程一致）。

1. 发行证书（Apple Distribution）

在钥匙串/开发者后台创建 Apple Distribution 证书，导出为 .p12（设一个导出密码）：

# 已在 Xcode/钥匙串里有 Distribution 证书时，从「钥匙串访问」导出 .p12
base64 -i dist.p12 | pbcopy        # → ANDROID 同理，复制到剪贴板

2. Provisioning Profile（App Store 类型）

开发者后台 → Profiles → 新建 App Store 类型，关联 App ID com.yanmei.jiu 与上面的发行证书，下载 .mobileprovision：

base64 -i jiu_appstore.mobileprovision | pbcopy

3. App Store Connect API Key

App Store Connect → Users and Access → Integrations → App Store Connect API → 新建密钥（角色 App Manager 即可），下载 AuthKey_XXXX.p8，记下 Key ID 与 Issuer ID：

base64 -i AuthKey_XXXX.p8 | pbcopy

4. 在 Forgejo 仓库配置 Secrets

仓库 → Settings → Actions → Secrets，新增 7 项：

Secret 名	值
`IOS_DIST_CERT_P12_BASE64`	第 1 步 .p12 的 base64
`IOS_DIST_CERT_PASSWORD`	.p12 导出密码
`IOS_PROVISIONING_PROFILE_BASE64`	第 2 步 .mobileprovision 的 base64
`IOS_TEAM_ID`	Apple Developer Team ID（10 位）
`APPSTORE_API_KEY_ID`	第 3 步 Key ID
`APPSTORE_API_ISSUER_ID`	第 3 步 Issuer ID
`APPSTORE_API_KEY_P8_BASE64`	第 3 步 .p8 的 base64

5. 配置 TestFlight 公开链接（下载页）

TestFlight 设置「公开链接」后，把链接填到 backend/config/version.yaml：

download_urls:
  ios: "https://testflight.apple.com/join/XXXXXXXX"

填上后下载页的 iOS 卡片自动激活为「通过 TestFlight 安装」；客户端「立即更新」在 iOS 上也会跳到该链接。release.sh 不会覆盖此行（仅改 macos/windows/android）。

6. 验证

打 tag 触发流水线，确认 build-ios job：

日志非 SKIP，出现 uploading to TestFlight；
App Store Connect → TestFlight 出现新 build（处理需几分钟）；
在 TestFlight 里设置测试组/公开链接后即可分发。

工作原理

scripts/ci/compile-ios.sh：建临时 keychain 导入证书、安装 profile、生成 ExportOptions（manual / app-store）、flutter build ipa、xcrun altool --upload-app 上传；CFBundleVersion 由版本号推导单调递增；缺 secrets 时跳过。
.gitea/workflows/deploy-client.yml 的 build-ios job：mac runner，串行于 build-android。
工程：client/ios（bundle id com.yanmei.jiu，应用名「岩美酒库」）。

3.1 KiB Raw Blame History Unescape Escape