从 CodePush 迁移到 Pushy#

#移除 react-native-code-push

在项目根目录卸载依赖：

npm uninstall react-native-code-push

然后清理原生侧的 CodePush 配置。CodePush 的接入方式随 RN 版本和项目历史有所不同，请以你项目里实际存在的内容为准，逐项检查：

iOS

• AppDelegate（或你的 bundleURL 所在文件）中的 #import <CodePush/CodePush.h>，以及 return [CodePush bundleURL];（Swift 项目中为对应的 CodePush.bundleURL() 调用）。下一步会把它替换为 Pushy 的写法。
• Info.plist 中的 CodePushDeploymentKey，以及可能存在的 CodePushServerURL（自建 code-push-server 时使用）、CodePushPublicKey（代码签名时使用）。
• 如果是 RN 0.60 以下手动在 Podfile 中添加过 pod 'CodePush', ...，一并删除。修改后在 ios 目录重新执行 pod install。

Android

• android/app/build.gradle 中的 apply from: "../../node_modules/react-native-code-push/android/codepush.gradle"。
• android/settings.gradle 中手动添加过的 include ':react-native-code-push' 和对应的 projectDir 配置（RN 0.60 以上的自动链接项目一般没有）。
• MainApplication 中的 import com.microsoft.codepush.react.CodePush 和返回 CodePush.getJSBundleFile() 的 getJSBundleFile 覆盖。
• res/values/strings.xml 中的 CodePushDeploymentKey，以及可能存在的 CodePushServerUrl、CodePushPublicKey。

JS

• 删除所有 import codePush from "react-native-code-push"，以及根组件外的 codePush(...)(App) 包裹和 codePush.sync() 调用。下文会用 Pushy 的写法替换。

#安装 react-native-update 并完成原生配置

按安装配置安装命令行工具和 react-native-update，并完成各平台的原生配置。对于 CodePush 迁移来说，关键是把上一步删掉的 bundle 入口换成 Pushy 的：

npm i -g react-native-update-cli
npm i react-native-update
cd ios && pod install

iOS（Objective-C 示例；Swift、RN 0.88 起的 SceneDelegate 写法见配置 Bundle URL）：

-#import <CodePush/CodePush.h>
+#import "RCTPushy.h"

 - (NSURL *)bundleURL
 {
 #if DEBUG
   return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index"];
 #else
-  return [CodePush bundleURL];
+  return [RCTPushy bundleURL];
 #endif
 }

Android（Kotlin，RN 0.81 或以下的 DefaultReactNativeHost 写法；RN 0.82 起改为给 getDefaultReactHost 传入 jsBundleFilePath = UpdateContext.getBundleUrl(this)，见配置 Bundle URL）：

-import com.microsoft.codepush.react.CodePush
+import cn.reactnative.modules.update.UpdateContext

 // DefaultReactNativeHost 内部
-override fun getJSBundleFile(): String {
-    return CodePush.getJSBundleFile()
-}
+override fun getJSBundleFile(): String? {
+    return UpdateContext.getBundleUrl(this@MainApplication)
+}

同时请按安装配置页完成这几项 CodePush 没有要求、但 Pushy 需要的设置：

• Android 在 android/app/build.gradle 的 release 配置中关闭 crunchPngs，否则会影响增量补丁生成；
• 使用 react-native-screens 时，按文档覆盖 Android MainActivity 的 onCreate，避免热更后重启白屏；
• 建议添加测试用的 Deep Link，用来替代 CodePush 的 Staging deployment 做发布前测试（见下文）；
• 鸿蒙项目按文档完成 Harmony 部分的配置。

Expo 项目要求 Expo 50 或以上并通过 npx expo prebuild 预构建，且不要同时安装 expo-updates。

#登录并创建应用

在 Pushy 管理后台注册账号后，在项目根目录登录并按平台分别创建应用：

pushy login
pushy createApp --platform ios
pushy createApp --platform android

完成后项目根目录会生成 update.json，其中包含各平台的 appId 和 appKey，可以提交到 Git；登录生成的 .update 文件则不要提交。详见安装配置中的「登录与创建应用」。

#替换 JS 代码

以一个典型的 CodePush 接入为例：

// 迁移前（CodePush）
import codePush from "react-native-code-push";

const codePushOptions = {
  checkFrequency: codePush.CheckFrequency.ON_APP_RESUME,
  installMode: codePush.InstallMode.ON_NEXT_RESTART,
};

export default codePush(codePushOptions)(App);

对应的 Pushy 写法：

// 迁移后（Pushy）
import { Platform } from "react-native";
import { Pushy, UpdateProvider } from "react-native-update";
import _updateConfig from "./update.json";

const { appKey } = _updateConfig[Platform.OS];

const pushyClient = new Pushy({
  appKey,
  checkStrategy: "onAppResume", // 对应 CheckFrequency.ON_APP_RESUME
  updateStrategy: "silentAndLater", // 静默下载，下次启动生效，对应 InstallMode.ON_NEXT_RESTART
});

export default function Root() {
  return (
    <UpdateProvider client={pushyClient}>
      <App />
    </UpdateProvider>
  );
}

如果原来是用 codePush.sync() 手动控制流程、自己画更新界面，可以设置 updateStrategy: null，在 UpdateProvider 的子组件中通过 useUpdate() 取得 checkUpdate、downloadUpdate、switchVersion、switchVersionLater、updateInfo、progress 等自行组合，完整示例见代码集成中的「自定义更新界面」。注意 useUpdate() 只能在 UpdateProvider 的子组件里调用。

Pushy 默认在开发环境（__DEV__）中不检查更新；即便打开 debug: true，也只能检查和下载，实际应用热更新必须在 release 包中进行。

#打包并上传原生基准包

这是 CodePush 没有、但 Pushy 必需的一步。先提高原生版本号（iOS 的 CFBundleShortVersionString、Android 的 versionName），按正常流程打 release 包，然后上传：

pushy uploadIpa <ipa 文件>
pushy uploadApk android/app/build/outputs/apk/release/app-release.apk
# 如果实际分发的是 aab：
pushy uploadAab android/app/build/outputs/bundle/release/app-release.aab

上传后再把同一份安装包提交到应用商店或分发渠道。以后只要重新打原生包，都要先改版本号、再上传，最后分发。同时产出 apk 和 aab、iOS 不要重新 archive 等细节，见发布热更新。

#发布第一个热更新

修改一处 JS 代码后执行：

pushy bundle --platform android

按提示发布并绑定原生包即可；也可以一条命令完成打包、发布和绑定（需 cli v1.46.1+）：

pushy bundle --platform android --name "1.0.1" --description "首个 Pushy 热更新" --packageVersion "2.0.0"

其中 --packageVersion 换成你刚上传的原生版本号，作用类似 CodePush 的 --targetBinaryVersion；需要一次绑定多个原生版本时可改用 --packageVersionRange。绑定后服务器会在几秒内生成增量补丁。

#测试与灰度验证

CodePush 常用 Staging deployment 做发布前测试。在 Pushy 中，推荐用管理后台的测试二维码：配置好测试用 Deep Link 后，用系统相机扫描某个热更版本的二维码，即可在与线上用户完全一致的 release 包上安装该版本，无需先绑定、也不影响线上用户，详见测试与回滚。如果应用自带扫码功能，也可以用 parseTestQrCode 实现。

测试通过后，先以较小比例灰度发布，观察版本健康度和数据分析，再逐步扩大到 100%：

pushy update --platform android --versionId <热更版本 id> --packageVersion "2.0.0" --rollout 10

灰度的工作原理和注意事项见灰度发布。同一原生包同时保留一个灰度版本和一个全量版本需要客户端 react-native-update v10.32.0+、cli v2.4.0+。