用途:把 React Native 项目从「未集成」推进到「release 构建下热更新可用」,强调可直接复制的步骤、最小可行改动和明确的验证检查点。
服务路由:中国服务用 Pushy(pushy CLI、new Pushy(...)、Pushy 控制台);全球服务用 Cresc(cresc CLI、new Cresc(...)、Cresc 控制台)。CLI、控制台、应用记录、update.json 与 JS 客户端类必须保持同一服务,不可混用。服务未知时依据用户表述、现有导入、域名或文档语言推断;仍无法确定则实现中性结构并标出需用户选择 Pushy 还是 Cresc 的那一行。
主要流程:检测 app root、包管理器、RN/Expo/react-native-update 版本、全局 CLI 版本、服务与目标平台(ios、android、harmony;Apple TV 用 ios);先读 references/integration-playbook.md,tvOS、RN 0.87、元数据/source map、非交互发布与 Hermes-base 诊断再读 references/modern-integration.md;安装 react-native-update 与全局 react-native-update-cli,直接调用 pushy 或 cresc,不要改用项目本地 CLI 或 npx;按平台配置原生 bundle 加载(iOS/tvOS 的 RCTPushy.bundleURL() 或 Expo 自动集成,Android 通过 ReactHost、ReactNativeHost 或自定义实例管理器使用 UpdateContext.getBundleUrl(...),Harmony 的 package/provider/bundle-provider 接线,Brownfield 用运行时钩子);在根组件外创建唯一客户端并用 UpdateProvider 包裹应用树。
可用执行环境且有 Node.js 22+ 时,优先运行 node <skill-root>/scripts/integration_doctor.mjs <app-root>,自动化为 --strict --json(缺需求返回 2,诊断错误返回 1);不可执行时使用手动清单并注明诊断未运行。静态检查无法验证设备原生二进制。
限制与注意:改动保持最小且局部,保留向后兼容,使用带版本特性前先确认已安装 SDK 与原生二进制能力,新原生能力需新的原生发布与基线而非仅 OTA 包;debug 模式不保证应用补丁;Expo 项目需警示与 expo-updates 冲突;每进程仅一个客户端与一个 UpdateProvider;JS 与资源视为 OTA 安全,原生代码、原生配置、原生资源、pods、Gradle 设置、HAR/AAR/XCFramework 内容与 manifest 需新的原生发布并上传基线;本资料未提供具体收费、价格与效果数据,暂未提供。