<?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>ReactNative on Last Stand</title><link>https://amatsuzero.github.io/LastStand/tags/reactnative/</link><description>Recent content in ReactNative on Last Stand</description><generator>Hugo</generator><language>zh-cn</language><lastBuildDate>Mon, 02 Nov 2026 18:12:04 +0800</lastBuildDate><atom:link href="https://amatsuzero.github.io/LastStand/tags/reactnative/index.xml" rel="self" type="application/rss+xml"/><item><title>UgreenHome RN iOS 组件化与调试能力重建（阶段总结）</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-rn-ios-modularization/</link><pubDate>Mon, 02 Nov 2026 18:12:04 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-rn-ios-modularization/</guid><description>&lt;h2 id="背景与目标"&gt;背景与目标&lt;/h2&gt;
&lt;p&gt;2026-10-29 至 11-02，我接手了 UgreenHome 主工程里一套陈旧的 RN（React Native）依赖栈，把目标定为三件事：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;清理重复的实现入口与本地临时代码，统一走内网 Specs / GitLab / Nexus；&lt;/li&gt;
&lt;li&gt;把可复用逻辑按单一职责拆成独立组件；&lt;/li&gt;
&lt;li&gt;恢复原生符号调试与 Metro JS 调试，同时不破坏默认的离线与发布链路。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;明确的不变量：不再为内部库新增「Debug/Release × 静态/动态」四套制品；不覆盖已发布 tag；所有产品变更走 MR；主工程保留业务组合，不追求机械地搬空目录。&lt;/p&gt;
&lt;p&gt;本文是阶段收口记录。这里先说明一个原则：&lt;strong&gt;已发布、已合入、测试通过、真实设备运行通过，这四件事要分别记录，不能互相替代&lt;/strong&gt;。下面凡是说到「已合入」「已发布」，都不代表所有真机业务场景已逐项通过。&lt;/p&gt;
&lt;h2 id="推进路线"&gt;推进路线&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;先清理、再合入&lt;/strong&gt;：移除重复的 Runtime/Kit 接线与过时实验内容，清理无用分支、worktree、临时文件与部分缓存，保留未提交的业务改动。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;建立远端组件边界&lt;/strong&gt;：从 LocalPods / 主工程抽取可复用逻辑与资源，迁到 &lt;code&gt;home/rn&lt;/code&gt;；测试随实现进入 &lt;code&gt;test_spec&lt;/code&gt;，宿主只保留跨组件与设备集成测试。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;治理依赖图&lt;/strong&gt;：从显式 binary 选择推导传递 redirect，处理 Lottie、MMKVCore、ZIPFoundation 等同模块双实现问题，再扩展为调试源码闭包。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;恢复 RN_DEBUG&lt;/strong&gt;：统一安装入口、源码/Debug 变体选择、Metro 编译隔离与调试工具组件化。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;继续下沉&lt;/strong&gt;：通用 Debug 编辑器已发布，宿主 MR !262 已合入；&lt;code&gt;UGreenRNComponents 0.1.0&lt;/code&gt; 已发布，WebView / Lottie 两个 subspec 已由宿主 MR !273 消费，原实现已从主工程删除。&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id="阶段成果与真实边界"&gt;阶段成果与真实边界&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;依赖单一真源&lt;/strong&gt;：移除 &lt;code&gt;LocalPods/UGreenRNRuntime&lt;/code&gt; 等重复清单，以 Podfile 的 &lt;code&gt;rn_dependencies&lt;/code&gt; 统一维护版本与来源。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;组件化切片&lt;/strong&gt;：Platform、Transport、DeviceSettings、E-Ink、Debug 等职责已有独立组件。Transport 先下沉 HTTP callback gate / 取消策略，DeviceSettings 先下沉启动校验 / 手势 / codec，E-Ink 先下沉图片身份 / 重试 / 调度——不宣称整套 HTTP / MQTT / 业务桥已搬完。&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><item><title>RN Runtime：Xcode 26 ↔ 27 二进制不兼容的原因</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/rn-runtime-xcode26-27-incompat/</link><pubDate>Tue, 15 Sep 2026 19:33:46 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/rn-runtime-xcode26-27-incompat/</guid><description>&lt;h2 id="现象"&gt;现象&lt;/h2&gt;
&lt;p&gt;用 Xcode 27 编译主工程时，若本地 RN Runtime 仍是 Xcode 26.6 打的预编译包，链接阶段失败：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Undefined symbols for architecture arm64:
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; method descriptor for Cxx.CxxPair.first.getter
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; method descriptor for Cxx.CxxPair.second.getter
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; 来源：NitroModules（AnyMap.o）
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;反向也成立：Xcode 27 的包拿到 Xcode 26.6 下去编，会缺另一组 &lt;code&gt;Iterable&lt;/code&gt; / &lt;code&gt;makeBorrowingIterator&lt;/code&gt; 相关符号。&lt;/p&gt;
&lt;h2 id="结论先看这个"&gt;结论（先看这个）&lt;/h2&gt;
&lt;p&gt;这不是某个编译参数（&lt;code&gt;-fxxx&lt;/code&gt; / &lt;code&gt;OTHER_SWIFT_FLAGS&lt;/code&gt; / &lt;code&gt;BUILD_LIBRARY_FOR_DISTRIBUTION&lt;/code&gt;）能补丁过去的问题。&lt;/p&gt;
&lt;p&gt;根因是：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Swift 6.3.3（Xcode 26.6） → Swift 6.4（Xcode 27）
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;系统自带的 Swift–C++ 互通层（Cxx overlay）里，&lt;code&gt;CxxPair&lt;/code&gt; 协议的 ABI 变了。预编译的 NitroModules 已经写死了对「旧 method descriptor」的引用；消费端换编译参数，补不出这些符号。&lt;/p&gt;
&lt;p&gt;因此：&lt;strong&gt;同一套预编译 RN Runtime，不能跨 Xcode 大版本混用&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;官方有痕迹，但没有面向 App 开发者的点名预警。官方提前说的是「C++ 互通还在变，用兼容模式保源码」，没有提前说「Xcode 26 的 Swift–Cxx 预编译包不能给 27 链接」。这是语言演进的必然结果，不是未公开的私有变更；发行说明漏了二进制兼容这一层。&lt;/p&gt;</description></item></channel></rss>