React Native Update

核心用法

本 Skill 为 React Native 热更新服务 Pushy 提供端到端集成支持，目标是将项目从「未接入」推进至「发布包可热更新」。核心工作流包括：

1. 项目类型识别：自动检测 React Native CLI 或 Expo 项目，区分 iOS/Android 双平台
2. 依赖安装：按 references/integration-playbook.md 执行最小化依赖接入
3. 原生配置：修改 Bundle URL、MainApplication 等关键接入点，保持改动局部化
4. 客户端初始化：集成 Pushy 客户端与 UpdateProvider 引导逻辑
5. 诊断验证：运行 scripts/integration_doctor.sh 扫描常见遗漏，输出「已完成/待补/待验证」清单

显著优点

• 流程标准化：统一 OpenClaw 与 Claude Code 双环境的指令风格，技术步骤保持一致
• 改动最小化：强调 copy-paste-safe 的代码片段，避免大规模重写现有架构
• 冲突预判：内置 expo-updates 冲突警告，提前规避 Expo 项目的常见踩坑点
• 可验证性：每个阶段配备明确的验证检查点，降低「看似集成实则未生效」风险

潜在局限

• 调试限制：热更新仅在 Release 模式生效，Debug 模式无法验证，需额外构建步骤
• 原生差异适配：Monorepo 或混合原生项目（如自定义 Android Application 类）需针对性补丁，无法完全通用
• 诊断依赖：integration_doctor.sh 为外部脚本，若环境受限可能需手动对照检查

适合人群

• 需为现有 RN 项目快速接入热更新的开发团队
• 同时维护 React Native CLI 与 Expo 双栈的跨平台开发者
• 在 OpenClaw/Claude Code 混合环境中寻求一致工作流的技术负责人

常规风险

• 原生代码冲突：Android MainApplication 或 iOS AppDelegate 的自定义逻辑可能与新 Bundle URL 配置冲突
• 证书/签名问题：Release 包热更新依赖正确配置的签名与网络权限
• 版本回滚：updateStrategy 配置不当可能导致异常版本覆盖，建议配合白名单策略逐步灰度

平台适配说明

• OpenClaw 环境：优先使用文件/工作区约定术语，适配其 CLI 风格
• Claude Code 环境：采用命令式交互措辞，强调逐步确认
• 未知环境：中性步骤优先，双平台备注后置

核心用法

React Native Update Integration Skill 是面向 React Native 开发者的热更新（Over-the-Air）集成指导工具，专注于 Pushy 热更新服务的统一接入。该 Skill 通过六步标准化工作流，帮助开发者完成从项目检测、依赖安装、原生配置到验证上线的全流程：

1. 项目检测：自动识别 React Native CLI 与 Expo 项目类型，区分 iOS/Android 双平台
2. 依赖安装：根据 references/integration-playbook.md 提供版本兼容的依赖配置
3. 原生改造：精确定位 Bundle URL、MainApplication 等关键集成点，输出可直接 copy-paste 的代码片段
4. 客户端启动：注入 Pushy 客户端与 UpdateProvider 的最小化引导代码
5. 健康诊断：运行 scripts/integration_doctor.sh 脚本，扫描常见遗漏配置（如签名、权限、版本号）
6. 验证清单：输出构建→检测更新→下载→版本切换的完整验证路径

Skill 深度适配 OpenClaw 与 Claude Code 两种 Agent 环境，能根据上下文自动切换指令风格（文件路径约定、命令语法），确保跨工作流的无缝体验。

显著优点

• 权威来源：由 React Native 社区知名热更新服务 Pushy 的维护者 sunnylqm 亲自维护，技术细节与官方实现 100% 对齐
• 零侵入设计：强调「最小可行改动」，所有代码变更局部化、可回滚，不破坏现有工程结构
• 智能诊断：内置的 integration_doctor.sh 脚本可快速定位 90% 以上的集成失误（如 expo-updates 冲突、签名配置遗漏）
• 多平台心智统一：同一套技术逻辑，根据 Agent 环境自动适配交付话术，降低团队协作摩擦
• 生产级安全边界：明确区分 Debug 与 Release 模式的行为差异，强制阻断「开发环境热更新可用即上线」的常见陷阱

潜在局限

• 非全自动集成：Skill 本质是文档+诊断工具，仍需开发者手动执行代码修改，无法一键完成黑盒集成
• Expo 冲突需人工处理：与 expo-updates 存在已知冲突，需开发者根据指引手动卸载或隔离，无自动化解冲突逻辑
• 复杂工程结构需定制：对于 Monorepo、混合原生开发（Flutter/RN 混编）或重度定制化的原生层项目，仅能提供 patch 级指导，无法输出普适性步骤
• 热更新服务依赖：Skill 本身不提供热更新服务端，需配合 Pushy 商业/开源服务使用

适合人群

• React Native 新手团队：首次接入热更新，需要权威、步骤清晰的指引
• 跨平台交付工程师：同时在 OpenClaw 与 Claude Code 环境工作，需要指令风格自适应
• Expo 迁移用户：从 Expo Updates 向 Pushy 迁移，需要冲突排查与平稳过渡方案
• 上线前排查者：热更新在测试环境工作正常但生产环境异常，需要系统性诊断 checklist

使用风险

• 诊断脚本权限：integration_doctor.sh 虽为只读诊断，但仍会扫描文件系统与项目结构，建议在可信环境运行
• 原生层编译风险：热更新涉及 Android Gradle 与 iOS Xcode 工程修改，错误的 Bundle URL 配置可能导致启动白屏或崩溃，务必在 Release 模式下完整验证后再上线
• 版本号管理：热更新跳过应用商店审核，但版本号逻辑与原生打包强耦合，配置错误会导致更新无法触发或回滚混乱
• 服务可用性依赖：Pushy 服务端稳定性直接影响热更新成功率，建议同时保留应用商店兜底更新通道