React Native 热更新 -- CodePush CLI 安装及基本使用

CodePush CLI

CodePush CLI 是用于管理 CodePush 账户的工具。

1. 安装 code-push-cli

$ npm install code-push-cli -g

执行 code-push -v 显示版本号表示安装成功

2. 登录 code-push

登录 code-push 需要在 Web端 注册/登录 CodePush 服务，获取登录所需 token，以下是两种提供 CodePush 服务的方式（微软/私有部署）

• 微软 CodePush 服务：
  • 注册：

$ code-push register

• 登录：

$ code-push login

• 自建 CodePush 服务：
  • 登录：

$ code-push login http://服务器IP:3000/

默认账号密码为 account: admin password: 123456

• 修改默认密码：

$ curl -X PATCH -H "Authorization: Bearer 登录获取的token" -H "Accept: application/json" -H "Content-Type:application/json" -d '{"oldPassword":"123456","newPassword":"654321"}' http://服务器IP:3000/users/password

在 Web端 登录成功之后获取 token
将获取到的 token 复制粘贴到登录终端，点击回车登录成功。

3. 注册app

即在 CodePush Server 服务器注册添加 app

$ code-push app add 

eg:
$ code-push app add CodePushDemo-ios #iOS版
$ code-push app add CodePushDemo-android #Android版

注册完之后会返回一套 Deployment Key，该 key 会在应用集成中用到。

注意：如果你的应用分为 Android 和 iOS ，那么在向 CodePush 注册应用的时候需要注册两个 app 获取两套 Deployment Key。

4. 发布更新

CodePush 发布更新的方式分为 简单 和 复杂 两种。

4.1 简单方式：(将打包与发布两个命令合二为一，建议使用)

基本用法：

$ code-push release-react  

eg:
$ code-push release-react CodePushDemo-ios ios # iOS版
$ code-push release-react CodePushDemo-android android #Android版

添加参数高级用法：

$ code-push release-react   [options]

eg:
$ code-push release-react CodePushDemo-ios ios -t 1.0.0 --dev false -d Production --des "更新描述说明" -m true

[options]
# -t 1.0.0 (对应的应用版本)
# --dev false (是否启用开发者模式(默认为false))
# -d Production (发布更新的环境分为Production与Staging(默认为Staging))
# --des "更新描述说明" （更新描述说明）
# -m true (是否强制更新(默认为false))

更多可选参数，可以在终端输入 code-push release-react 进行查看

4.2 复杂方式：(先需要打包才能发布，不建议使用)

首先将 js 与 图片资源 打包成 bundle，再通过命令 code-push release 发布。

• 打包 bundle

# cd 到工程目录

# 新增 bundles 文件夹
$ mkdir bundles

# 运行命令打包 
$ react-native bundle --platform <平台> --entry-file <启动文件> --bundle-output <打包js输出文件> --assets-dest <资源输出目录> --dev <是否调试>

eg:
$ react-native bundle --platform ios --entry-file index.ios.js --bundle-output ./bundles/index.ios.bundle --dev false 

• 发布更新

$ code-push release <应用名称>  <对应的应用版本> -d <更新环境> --des <更新描述说明> -m <是否强制更新>

eg:
$ code-push release CodePushDemo-ios ./bundles/index.ios.bundle 1.0.0 -d Production  --des "更新描述说明" -m true

注意：

• <对应的应用版本> 为 app 的版本号，不是 CodePush 所更新的 js 的版本号
• -d <更新环境> 默认值是更新 staging 环境的

5. 其他命令

5.1 code-push 账号管理 相关命令

# 注册
$ code-push register

# 登录
$ code-push login
$ code-push login http://服务器IP:3000

# 注销
$ code-push logout

# 当前登录账号
$ code-push whoami

# 列出登录的 token
$ code-push access-key ls 

# 删除某个 key 值
$ code-push access-key rm 

5.2 code-push app 相关命令

# 添加 app
$ code-push app add 

# 重命名 app
$ code-push app rename  

# 移除 app
$ code-push app remove 

# 列出所有 app
$ code-push app list

# app 所有权转移
$ code-push app transfer  

5.3 code-push deployment 相关命令

# 添加部署环境
$ code-push deployment add  

# 重命名部署环境名称
$ code-push deployment rename   

# 删除部署环境
$ code-push deployment rm  

# 列出应用的所有部署环境
$ code-push deployment ls 

# 列出应用的所有部署环境及 key
$ code-push deployment ls  -k 

# 查看历史版本(Production 或者 Staging) 
$ code-push deployment history  

# 清除某个部署环境的更新记录
$ code-push deployment clear  

更多命令，可以在终端输入 code-push 进行查看