UgreenHome RN iOS 组件化与调试能力重建(阶段总结)

背景与目标 2026-10-29 至 11-02,我接手了 UgreenHome 主工程里一套陈旧的 RN(React Native)依赖栈,把目标定为三件事: 清理重复的实现入口与本地临时代码,统一走内网 Specs / GitLab / Nexus; 把可复用逻辑按单一职责拆成独立组件; 恢复原生符号调试与 Metro JS 调试,同时不破坏默认的离线与发布链路。 明确的不变量:不再为内部库新增「Debug/Release × 静态/动态」四套制品;不覆盖已发布 tag;所有产品变更走 MR;主工程保留业务组合,不追求机械地搬空目录。 本文是阶段收口记录。这里先说明一个原则:已发布、已合入、测试通过、真实设备运行通过,这四件事要分别记录,不能互相替代。下面凡是说到「已合入」「已发布」,都不代表所有真机业务场景已逐项通过。 推进路线 先清理、再合入:移除重复的 Runtime/Kit 接线与过时实验内容,清理无用分支、worktree、临时文件与部分缓存,保留未提交的业务改动。 建立远端组件边界:从 LocalPods / 主工程抽取可复用逻辑与资源,迁到 home/rn;测试随实现进入 test_spec,宿主只保留跨组件与设备集成测试。 治理依赖图:从显式 binary 选择推导传递 redirect,处理 Lottie、MMKVCore、ZIPFoundation 等同模块双实现问题,再扩展为调试源码闭包。 恢复 RN_DEBUG:统一安装入口、源码/Debug 变体选择、Metro 编译隔离与调试工具组件化。 继续下沉:通用 Debug 编辑器已发布,宿主 MR !262 已合入;UGreenRNComponents 0.1.0 已发布,WebView / Lottie 两个 subspec 已由宿主 MR !273 消费,原实现已从主工程删除。 阶段成果与真实边界 依赖单一真源:移除 LocalPods/UGreenRNRuntime 等重复清单,以 Podfile 的 rn_dependencies 统一维护版本与来源。 组件化切片:Platform、Transport、DeviceSettings、E-Ink、Debug 等职责已有独立组件。Transport 先下沉 HTTP callback gate / 取消策略,DeviceSettings 先下沉启动校验 / 手势 / codec,E-Ink 先下沉图片身份 / 重试 / 调度——不宣称整套 HTTP / MQTT / 业务桥已搬完。 ...

November 2, 2026