KonishiLee's Blog

React-Native 热更新方案(IOS)

背景

为什么一直使用 React-Native 来开发移动 App 呢?大概有两点比较吸引我。

1.整合了移动 App 的开发,不仅缩短了 App 的开发时间,也提高了 App 的开发效率,实现大前端的思路。
2.移动 App 尚且不能动态更新,而且更新流程特别麻烦,特别是 IOS。

所以选择了 RN 作为开发框架进军移动开发,我想这应该是以后的一个趋势,为什么我们需要一直去下载更新 App,特别是我这种有强迫症的孩子,一点也看不惯 App Store 上面的红点数字。但是很值得高兴的是 RN 能够进行热更新,原理其实就是 jsBundleFile 引用不同的 js 的 bundle 源,这也是一个突破口,但是这一块始终没有一个规范来做,虽然大家都知道怎么做,但是怎么管理你的版本?怎么回归?怎么打 tag?这些都是各自有各自的方式。

不过今天我推荐的是微软的 CodePush

CodePush 是微软提供的一套用于热更新 RN 和 Cordova 应用的服务。
CodePush 让 RN,Cordova 开发者可以直接部署移动 App 更新到用户设备的云服务。作为一个中间仓库,开发者可以推送打包好的(JS,HTML,Css,Images),应用可以从客户端 SDK 查询更新。在出现紧急问题处理的时候越过很多流程直接推送代码实现更新。

CodePush 开源了 RN 版本 react-native-code-push

Usage

创建 CodePush 账号

1.首先你的电脑应该装了 npm,我用的是 cnpm

1
cnpm install -g code-push-cli

2.安装好了之后 code-push -v, 检查是否安装成功。

3.注册一个 CodePush 账号,在终端输入 code-push register,跳转到 CodePush 的授权页面,然后选择你的授权方式。

注册

授权成功之后会返回一个 access key,就说明你注册成功。

4.然后在终端输入 code-push login,然后输入你的 access key,并且 Enter 进行登录。你的 session 文件将会写在 /Users/你的用户名/.code-push.config

以上就是 CodePush 登录的流程。PS:相关命令

  • code-push login 登录
  • code-push loout 注销
  • code-push access-key ls 列出登录的 token
  • code-push access-key rm <accessKye> 删除某个 token

用 CodePush 服务器注册 App

1.在终端输入 code-push app add <appName> 完成注册。

2.注册成功之后会返回一套 deployment key 给你,稍后会有使用到的地方。

PS:相关命令

  • code-push app add 在账号里面添加一个新的 App
  • code-push app remove 或者 rm 在账号里移除一个 App
  • code-push app rename 重命名一个存在 App
  • code-push app list 或则 ls 列出账号下面的所有 App
  • code-push app transfer 把 App 的所有权转移到另外一个账号

继承 CodePush SDK

这里涉及到 Android, IOS 两个系统的不同方式,因为我暂时只用了 IOS,所以就先讲讲 IOS 的方式。
CodePush 提供 RNPM 和 Manual 两种方式安装插件
这里我用到的是 RNPM

1
cnpm install -g rnpm
IOS

1.项目中安装 react-native-code-push 插件

1
cnpm install --save react-native-code-push

2.在项目中添加配置

1
rnpm link react-native-code-pus

这里终端会提示让你输入刚才的 deployment key,这里你如果本地测试只需要输入 Staging 的 deployment key 就可以。

3.设置 deployment key

在注册 App 的时候,Codepush 提供给我们两套 deployment key。 Production 和 Staging,然后我们使用一下步骤来设置,

  • 1.使用 Xcode 打开项目
  • 2.找到你的项目
  • 3.选择 info
  • 4.在 Configurations 节点下面点击 +
  • 5.选择 Duplicate “Release”,输入自定义名称(这里我输入的是 Staging)
  • 6.选择 Build Settings 单击 + 然后选择添加 User-Defined Setting
    User-Defined

  • 7.输入 CODEPUSH_KEY
    你可以通过输入 code-push deployment ls <APP_NAME> -k 来查看 deployment key

  • 8.打开 Info.plist 修改 CodePushDeploymentKey 的值为 $(CODEPUSH_KEY)
    info.plist

通过以上的设置,IOS 系统的热更新设置算是基本完成了。

利用 CodePush 进行热更新

IOS 热更新其实是比 Android 方便很多,基本上不用改什么代码。很方便的就可以体会到热更新的效果了。

发布更新

CodePush 提供了两种方式发布,简单方式 code-push release-react,复杂方式 code-push release

  • 1.简单方式
1
code-push release-react MyApp ios #code-push release-react <appName> <platform>

来个简单方式中比较高级的。

1
code-push release-react MyApp ios --t 1.0.0 --dev false --d Production --des "第一次体验热更新" --m true

参数介绍:

  • –t 二进制(.ipa与apk)安装包的的版本
  • –dev 为是否启用开发者模式(默认为false)
  • –d 是要发布更新的环境分 Production 与 Staging(默认为 Staging)
  • –des为更新说明
  • –m 是否强制更新

需要查看参数详细信息,在终端输入code-push release-react 自行查看。
我们也可以通过在终端输入 code-push deployment ls <appName> 查看我们 App 的发布以及安装情况。

简单方式发布就是这么简单。

  • 2.复杂方式

复杂方式发布更新需要先将 js 进行打包。

  • 1.在终端在当前工作目录下执行 mkdir bundles
  • 2.在终端执行打包 react-native bundle –platform 平台 –entry-file 启动文件 –bundle-output 打包js输出文件 –assets-dest 资源输出目录 –dev 是否调试。

注意

  • 忽略了资源输出是因为 输出资源文件后,会把bundle文件覆盖了。
  • 输出的bundle文件名不叫其他,而是 index.android.bundle,是因为 在debug模式下,工程读取的bundle就是叫做 index.android.bundle。
  • 平台可以选择 android 或者 ios。

发布更新

打包bundle结束后,就可以通过CodePush发布更新了。
在终端输入 code-push release <appName> <bundles所在目录> <1.0.0> --deploymentName: 更新环境 --description: 更新描述 --mandatory: 是否强制更新

到此为止复杂方式的发布更新也算是完成了。是不是也不是那么难呢。

注意事项
  • 1.CodePush 默认是更新 Staging 环境的。所以只需要发布 Staging,就不需要添加 –deploymentName。
  • 2.如果有 mandatory 则 CodePush 会根据 mandatory 是 true or false 来控制应用是否强制更新。默认是为 false
  • 3.对应的应用版本 targetBinaryVersion 是指当前app的版本 (对应 build.gradle 中设置的 versionName “1.0.1”),这里的版本包括 JS,HTML,Css,Images 所有,不是说只更新了 JS。
  • 4.对于对某个应用版本进行多次更新的情况,CodePush 会检查每次上传的 bundle,如果在该版本下如 1.0.0 已经存在与这次上传完全一样的 bundle(对应一个版本有两个 bundle 的 md5 完全一样),那么CodePush会拒绝此次更新。
    error

PS:相关命令

  • 1.code-push deployment add 部署
  • 2.code-push deployment rename 重命名
  • 3.code-push deployment rm 删除部署
  • 4.code-push deployment ls 列出应用的部署情况
  • 5.code-push deployment ls -k 查看部署的key
  • 6.code-push deployment history 查看历史版本(Production 或者 Staging)
参考

总结

读到这里你应该就了解以及使用 CodePush 进行热更新了,不过对于 CodePush 还应该会出现一些问题。

  1. CodePush 服务器在国外,速度可能会有点影响。
  2. 其升级服务器端程序并不开源的,后期微软会不会对其收费都还不能确定。
  3. 微软的这一套对移动 App 市场的技术支持苹果公司是否会采取到一些技术措施,这些也指日可待。

不过作为开发者来说,我们并不一定需要利用技术来做出什么样的东西,有些东西我们理念明白就可以了。热更新的原理我相信你应该理解了,对于自己开发服务来管理自己的移动 App,管理自己的版本,这个应该不难的。

技术改变生活!

The End!

如果喜欢这个分享,就帮忙买杯咖啡吧