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

UDC 镜像仓库迁移踩坑记录

背景 一次把 UDC 相关仓库从外部 GitLab 源迁到内网 GitLab + Nexus 的迁移,踩了十来个坑。本文把每个坑的「现象 → 根因 → 修复」记下来,方便后续再做类似镜像同步时直接对照。迁移目标是:把外部源(记为 gitlab-cloud)的仓库改写成指向内网 GitLab 的 podspec,并同步 Maven 产物到内网 Nexus。 名词解释 Pull Mirror(GitLab 原生镜像):GitLab 自带的仓库镜像功能,让镜像仓库与上游完全一致。 Nexus:内网私有仓库(Maven / raw 等),用来托管同步过来的二进制与 Maven 产物。 Protected 变量:GitLab CI 变量标记为 Protected 后,只在保护分支 / 标签上注入。 members/all:GitLab 查组成员接口,带 /all 才会包含从父组继承的成员。 一、GitLab 原生镜像根本没法用 一开始想直接用 GitLab 自带的 Repository Mirroring(pull mirror),结果它和「改写 podspec URL」的需求天然冲突:原生 pull mirror 会让镜像仓库与上游完全一致,等于把我们在内网侧做的 podspec URL 改写每次同步都覆盖回去。而且源仓库里的 podspec 仍带外部域名,我们用的同步 bot 是源项目的只读成员,push 回源会 403 “not allowed to upload code”——源仓库修不了。 ...

October 21, 2026