<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Specs on Last Stand</title><link>https://amatsuzero.github.io/LastStand/tags/specs/</link><description>Recent content in Specs on Last Stand</description><generator>Hugo</generator><language>zh-cn</language><lastBuildDate>Wed, 21 Oct 2026 14:06:24 +0800</lastBuildDate><atom:link href="https://amatsuzero.github.io/LastStand/tags/specs/index.xml" rel="self" type="application/rss+xml"/><item><title>UgreenHome CocoaPods Specs / 镜像 tag 故障复盘</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-cocoapods-spec-mirror/</link><pubDate>Wed, 21 Oct 2026 14:06:24 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-cocoapods-spec-mirror/</guid><description>&lt;h2 id="背景与现象"&gt;背景与现象&lt;/h2&gt;
&lt;p&gt;主工程使用内部 CocoaPods Specs 仓库。某些源码 pod 的 source.git 指向内部 GitLab 镜像；另一些第三方依赖由 &lt;code&gt;*-bin&lt;/code&gt; spec 提供预编译 XCFramework。FCUUID-bin 的 spec 声明了对源码 pod UICKeyChainStore (~&amp;gt; 2.1.0) 的依赖，而主工程此前没有直接声明 UICKeyChainStore。&lt;/p&gt;
&lt;p&gt;删除 iot/Podfile.lock 后运行 &lt;code&gt;make -C iot pods&lt;/code&gt;，CocoaPods 重新解析传递依赖，选中了 Specs 中的 UICKeyChainStore 2.1.3。该 spec 指向镜像中不存在的 v2.1.1 tag，安装失败，典型报错是 &lt;code&gt;fatal: Remote branch v2.1.1 not found in upstream origin&lt;/code&gt;。这发生在依赖解析、源码获取阶段，尚未进入 App 链接。&lt;/p&gt;
&lt;p&gt;主工程 Podfile → FCUUID-bin 1.3.3.1 → UICKeyChainStore (~&amp;gt; 2.1.0) [传递源码依赖] → 无 lock 时选到 2.1.3 → source.tag = v2.1.1 [镜像不存在] → make pods 失败。&lt;/p&gt;</description></item><item><title>rn-runtime-ios Runtime 发布与接入踩坑复盘</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/rn-runtime-ios-publish/</link><pubDate>Wed, 07 Oct 2026 23:28:30 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/rn-runtime-ios-publish/</guid><description>&lt;h2 id="最终结果"&gt;最终结果&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Runtime 最终发布版本：&lt;code&gt;0.1.9.17&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Lottie 内网修订版本：&lt;code&gt;4.6.0.1&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Runtime 发布流水线：Pipeline 3740&lt;/li&gt;
&lt;li&gt;真机产物验证 Job：9486 成功&lt;/li&gt;
&lt;li&gt;Runtime MR !22 已合并并完成发布&lt;/li&gt;
&lt;li&gt;ugreenhome MR !8 已合并，Runtime 与 Lottie 依赖已同步升级&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;下面按「问题 → 根因 → 处理」的方式复盘，避免把教训写成流水账。&lt;/p&gt;
&lt;h2 id="1-依赖地址与-lottie-podspec"&gt;1. 依赖地址与 Lottie Podspec&lt;/h2&gt;
&lt;p&gt;依赖地址必须统一使用内网 GitLab 新域名，&lt;strong&gt;不能把 Runner 内部 IP（形如 192.168.x.x）写进 Podspec&lt;/strong&gt;。这会造成环境耦合、证书 / SNI 问题，也让开发机与 CI 行为不一致。&lt;/p&gt;
&lt;p&gt;Lottie 原始 &lt;code&gt;4.6.0&lt;/code&gt; 已经发布，不能移动或覆盖旧 Tag。保留源码不变，仅修复 Podspec URL 时，应发布新的修订版本 &lt;code&gt;4.6.0.1&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;Specs 仓库中的版本、&lt;code&gt;s.version&lt;/code&gt;、Git Tag 与 Runtime 依赖版本必须完全一致——这是后面一系列问题的总根。&lt;/p&gt;
&lt;h2 id="2-版本号与-tag"&gt;2. 版本号与 Tag&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;任何会影响发布产物或 Podspec 的修复都要递增版本号，不能复用已经发布的 Tag；&lt;/li&gt;
&lt;li&gt;Tag 应从已经合并且验证通过的 main 创建，不要从未合并提交直接打发布 Tag；&lt;/li&gt;
&lt;li&gt;发布前确认「Tag 规则、流水线 rules、版本文件」三者一致。「打了 Tag」不等于「publish-runtime 一定会触发」。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="3-publish-runtime-未随-tag-触发"&gt;3. publish-runtime 未随 Tag 触发&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;首先检查 &lt;code&gt;.gitlab-ci.yml&lt;/code&gt; 中 job 的 &lt;code&gt;rules/only&lt;/code&gt; 是否匹配当前 Tag；&lt;/li&gt;
&lt;li&gt;检查 Tag 是否属于 Protected Tag，以及触发者是否有对应权限；&lt;/li&gt;
&lt;li&gt;发布 job 与普通构建 job 是两条独立链路：普通 CI 绿色不能证明发布 job 已创建或已执行；&lt;/li&gt;
&lt;li&gt;修复后必须用新的版本和新 Tag 验证，不能移动旧 Tag 来「补跑」。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="4-specs-token-鉴权"&gt;4. Specs Token 鉴权&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;SPECS_GIT_PASSWORD&lt;/code&gt; 必须是对 Specs 仓库具备写权限的有效 Token，并正确配置到 Runtime 项目的 CI/CD Variables。变量还要检查 Protected / Masked / Environment scope——受保护 Tag 上运行时，未受保护变量可能不可见。&lt;/p&gt;</description></item></channel></rss>