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 <appName>
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 <appName> <platform>
eg:
$ code-push release-react CodePushDemo-ios ios # iOS版
$ code-push release-react CodePushDemo-android android #Android版
添加参数高级用法:
$ code-push release-react <appName> <platform> [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 <应用名称> <bundle所在目录> <对应的应用版本> -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 <accessKye>
5.2 code-push app 相关命令
# 添加 app
$ code-push app add <appName>
# 重命名 app
$ code-push app rename <appName> <newAppName>
# 移除 app
$ code-push app remove <appName>
# 列出所有 app
$ code-push app list
# app 所有权转移
$ code-push app transfer <appName> <newOwnerEmail>
5.3 code-push deployment 相关命令
# 添加部署环境
$ code-push deployment add <appName> <deploymentName>
# 重命名部署环境名称
$ code-push deployment rename <appName> <deploymentName> <newDeploymentName>
# 删除部署环境
$ code-push deployment rm <appName> <deploymentName>
# 列出应用的所有部署环境
$ code-push deployment ls <appName>
# 列出应用的所有部署环境及 key
$ code-push deployment ls <appName> -k
# 查看历史版本(Production 或者 Staging)
$ code-push deployment history <appName> <deploymentName>
# 清除某个部署环境的更新记录
$ code-push deployment clear <appName> <deploymentName>
更多命令,可以在终端输入
code-push
进行查看
网友评论