React Native 中的 强制更新 (Manup) 与热更新（Hot Updates）尽管都与应用更新相关，但用途截然不同。以下是详细解析：
1. 强制更新 (Manup)
定位：专注于版本管理与强制更新的工具库。
核心功能：
- 检测应用是否过时、废弃或需执行强制更新
- 通过对比应用当前版本与远程配置文件（如 JSON）实现版本校验
- 支持阻断应用使用或直接跳转至应用商店（如 Apple App Store / Google Play）
功能扩展：【可与后端服务（如 Firebase Remote Config）集成，动态配置不同地区/用户群体的版本策略】
典型场景：
- 强制用户升级以修复严重安全漏洞（如支付模块缺陷）
金融类应用常通过 Manup 确保所有用户使用合规版本，避免因版本碎片化引发监管风险
- 终止对老旧系统版本的支持（如不再兼容 iOS 12）
2. 热更新（以 CodePush 为例）
定位：实现 JavaScript 代码、资源文件（Assets）等轻量级内容的空中下载技术（over-the-air OTA）更新。
核心优势：
- 无需经过应用商店审核流程，最快分钟级完成更新推送
- 支持动态更新非原生代码（如 React 组件、样式文件、图片资源）
- 提供灰度发布机制（如先推送给 10% 用户测试稳定性）
局限性扩展：【无法修改原生模块（如自定义的 Android Native Module），且苹果 App Store 明确要求热更新不得修改核心功能逻辑（参考 App Store 指南）】
适用场景：
-
修复线上 JS 逻辑 Bug（如列表渲染异常）
-
快速调整 UI 布局（如节日主题临时改版）
-
动态加载 A/B 测试配置
关键差异对比表
| 维度 | Manup | 热更新（CodePush 等） |
|---|---|---|
| 更新本质 | 版本强制升级（依赖应用商店） | 动态内容推送（无需重新打包 APK/IPA） |
| 用户体验 | 可能中断当前使用（需重启应用） | 无感更新（支持后台下载+下次启动生效） |
| 合规风险 | 符合各大应用商店政策 | 需注意平台限制（如 Google Play 对热更新的宽松度高于苹果） |
| 更新频率 | 低频（重大版本迭代） | 高频（每日多次紧急修复） |
协同使用策略
推荐组合方案：
- 版本门禁层：通过 Manup 校验基础版本号，确保用户至少使用支持热更新的最低版本（如要求 iOS 版本 ≥ v1.5.0）
- 快速修复层：利用 CodePush 推送 JS 代码修复，覆盖 80% 以上的非原生问题
- 原生升级触发：当热更新无法解决问题时（如需要新增 Android 权限），通过 Manup 强制跳转应用商店升级
时间序列总览（从应用启动到所有更新完成）
graph LR
A[应用启动] --> B{检查强制原生更新（Manup）}
B -->|是| C[阻断应用，跳转应用商店]
B -->|否| D{检查CodePush更新可用性}
D -->|无更新| E[进入应用主流程]
D -->|有更新| F{是否为强制热更新？}
F -->|是| G[立即下载并安装更新]
F -->|否| H[根据配置选择：后台下载/下次启动更新]
G --> I[重启应用生效]
H --> J[进入应用，提示用户有可选更新]
二、关键节点的条件判断与执行逻辑
1. 强制原生更新检查（启动阶段优先执行）
触发条件：
-
后端配置标记当前版本已废弃（如
isDeprecated: true） -
版本号低于最低支持版本（如要求
minVersion: "2.1.0"，当前版本为2.0.5） -
存在必须通过原生代码修复的安全漏洞（如需要新增系统权限）
执行逻辑：
// 伪代码示例（结合Manup库）
import Manup from 'manup-library';
const checkMandatoryNativeUpdate = async () => {
const { isMandatoryUpdate, storeUrl } = await Manup.fetchVersionConfig();
if (isMandatoryUpdate) {
// 阻断应用初始化流程
Alert.alert(
'必须更新',
'当前版本已不再支持，请升级到最新版本',
[{ text: '前往更新', onPress: () => Linking.openURL(storeUrl) }]
);
return false; // 阻止应用继续启动
}
return true; // 允许进入下一步
};
优先级原因：
-
原生更新涉及二进制代码变更，热更新无法覆盖，必须通过应用商店解决
-
确保用户处于支持热更新的最低版本环境（如热更新依赖
React Native 0.72+，需先校验原生版本）
2. CodePush 更新检查（仅在通过原生版本校验后执行）
触发条件：
-
应用处于非强制原生更新状态
-
网络连接可用（建议添加离线模式处理）
-
后端配置存在与当前原生版本兼容的热更新包（如
compatibleNativeVersion: ">=2.1.0"）
执行逻辑：
// 伪代码示例（结合CodePush SDK）
import codePush from 'react-native-code-push';
const checkCodePushUpdate = async (isAppActive) => {
try {
const update = await codePush.checkForUpdate();
if (update) {
if (update.isMandatory) {
// 强制热更新：立即下载并重启（需处理用户未保存的进度）
await codePush.sync({
updateDialog: {
title: '重要更新',
message: '检测到必须安装的更新，将在下载完成后重启应用',
},
mandatoryInstallMode: codePush.InstallMode.IMMEDIATE,
});
} else {
// 可选热更新：根据场景选择更新时机
if (isAppActive) { // 应用处于前台时
Alert.alert(
'可选更新',
'发现新功能优化，是否现在下载？',
[
{ text: '稍后再说', onPress: () => null },
{ text: '立即下载', onPress: () => codePush.sync() },
]
);
} else { // 应用在后台时自动下载
await codePush.sync({ installMode: codePush.InstallMode.ON_NEXT_RESUME });
}
}
}
} catch (error) {
// 处理更新失败（如回滚到上次成功版本）
console.error('CodePush更新检查失败:', error);
}
};
场景化策略：
| 更新类型 | 用户场景 | 执行方式 |
|---|---|---|
| 强制热更新 | 修复支付流程逻辑错误 | 前台弹窗阻断操作，下载完成后立即重启 |
| 可选热更新（功能） | 新增节日活动入口 UI | 后台静默下载，下次启动时提示更新 |
| 可选热更新（优化） | 提升列表加载性能 | 应用退到后台时自动下载，无打扰更新 |
三、版本兼容性与冲突处理
1. 热更新与原生版本的依赖关系
- 强依赖场景： 热更新包引入新的原生模块（如新增
react-native-image-picker@5.0），需确保原生工程已升级到对应版本。 解决方案： - 在 CodePush 元数据中声明依赖（如
requiredNativeVersion: "2.2.0"） - 前端检查逻辑：
const currentNativeVersion = NativeModules.Settings.getVersion();
if (update.metadata.requiredNativeVersion &&
currentNativeVersion < update.metadata.requiredNativeVersion) {
// 提示用户需先升级原生应用
Alert.alert('请先升级应用', '当前热更新需搭配原生版本2.2.0+使用');
return;
}
2. 同时存在强制原生更新与热更新的情况
- 执行顺序： 强制原生更新 > 强制热更新 > 可选热更新 原因：原生更新是热更新运行的基础环境，若环境不兼容，热更新无法生效
四、用户体验优化建议
-
避免连续弹窗干扰： - 先处理强制原生更新，完成后再触发热更新流程 - 同一时间段内仅展示一种类型的更新提示
-
离线场景处理： - 强制原生更新需联网校验，但可缓存最近一次的配置（如本地存储
lastCheckTime和isMandatory） - 热更新支持离线下载（CodePush 会自动缓存更新包） -
灰度发布控制： - 通过 CodePush 的
deploymentKey区分生产环境（Production）与灰度群体（Staging） - 强制更新仅对全量用户生效，避免灰度用户被误触达
五、典型故障排查流程
-
用户未收到热更新： - 检查 CodePush 后台部署状态（是否发布到对应环境） - 确认原生版本是否满足热更新兼容性要求 - 调试网络请求（如 Charles 抓包查看
codePush.checkForUpdate返回） -
强制更新未生效： - 验证 Manup 配置是否正确（如
minVersion是否匹配用户实际版本） - 检查应用商店链接是否正确（避免跳转到错误的平台或地区）
通过以上分层校验机制，可实现 "原生版本安全兜底 + 热更新敏捷修复" 的双轨更新体系，在保障应用稳定性的同时最大化迭代效率。实际落地时需结合业务特性调整策略（如金融类应用倾向更严格的强制更新，工具类应用侧重无感热修复）。
案例举例：
若电商 App 在大促期间发现商品详情页 JS 逻辑错误，首先通过 CodePush 在 15 分钟内推送修复代码；随后针对 5% 未安装热更新的用户，通过 Manup 在下一次启动时提示“需升级至 v2.3.1 以正常使用”，确保全量用户使用一致版本。
总结：两者并非替代关系，而是构建“分层更新体系”的核心组件——Manup 保障版本基线安全，热更新解决敏捷迭代需求，共同提升 React Native 应用的稳定性与运维效率。
