UgreenHome CocoaPods Specs / 镜像 tag 故障复盘

背景与现象 主工程使用内部 CocoaPods Specs 仓库。某些源码 pod 的 source.git 指向内部 GitLab 镜像;另一些第三方依赖由 *-bin spec 提供预编译 XCFramework。FCUUID-bin 的 spec 声明了对源码 pod UICKeyChainStore (~> 2.1.0) 的依赖,而主工程此前没有直接声明 UICKeyChainStore。 删除 iot/Podfile.lock 后运行 make -C iot pods,CocoaPods 重新解析传递依赖,选中了 Specs 中的 UICKeyChainStore 2.1.3。该 spec 指向镜像中不存在的 v2.1.1 tag,安装失败,典型报错是 fatal: Remote branch v2.1.1 not found in upstream origin。这发生在依赖解析、源码获取阶段,尚未进入 App 链接。 主工程 Podfile → FCUUID-bin 1.3.3.1 → UICKeyChainStore (~> 2.1.0) [传递源码依赖] → 无 lock 时选到 2.1.3 → source.tag = v2.1.1 [镜像不存在] → make pods 失败。 ...

October 21, 2026

rn-runtime-ios Runtime 发布与接入踩坑复盘

最终结果 Runtime 最终发布版本:0.1.9.17 Lottie 内网修订版本:4.6.0.1 Runtime 发布流水线:Pipeline 3740 真机产物验证 Job:9486 成功 Runtime MR !22 已合并并完成发布 ugreenhome MR !8 已合并,Runtime 与 Lottie 依赖已同步升级 下面按「问题 → 根因 → 处理」的方式复盘,避免把教训写成流水账。 1. 依赖地址与 Lottie Podspec 依赖地址必须统一使用内网 GitLab 新域名,不能把 Runner 内部 IP(形如 192.168.x.x)写进 Podspec。这会造成环境耦合、证书 / SNI 问题,也让开发机与 CI 行为不一致。 Lottie 原始 4.6.0 已经发布,不能移动或覆盖旧 Tag。保留源码不变,仅修复 Podspec URL 时,应发布新的修订版本 4.6.0.1。 Specs 仓库中的版本、s.version、Git Tag 与 Runtime 依赖版本必须完全一致——这是后面一系列问题的总根。 2. 版本号与 Tag 任何会影响发布产物或 Podspec 的修复都要递增版本号,不能复用已经发布的 Tag; Tag 应从已经合并且验证通过的 main 创建,不要从未合并提交直接打发布 Tag; 发布前确认「Tag 规则、流水线 rules、版本文件」三者一致。「打了 Tag」不等于「publish-runtime 一定会触发」。 3. publish-runtime 未随 Tag 触发 首先检查 .gitlab-ci.yml 中 job 的 rules/only 是否匹配当前 Tag; 检查 Tag 是否属于 Protected Tag,以及触发者是否有对应权限; 发布 job 与普通构建 job 是两条独立链路:普通 CI 绿色不能证明发布 job 已创建或已执行; 修复后必须用新的版本和新 Tag 验证,不能移动旧 Tag 来「补跑」。 4. Specs Token 鉴权 SPECS_GIT_PASSWORD 必须是对 Specs 仓库具备写权限的有效 Token,并正确配置到 Runtime 项目的 CI/CD Variables。变量还要检查 Protected / Masked / Environment scope——受保护 Tag 上运行时,未受保护变量可能不可见。 ...

October 7, 2026