https://github.com/shm-open/code-push-server/blob/master/README.cn.md
https://github.com/Microsoft/react-native-code-push
依赖
本地需要安装nodejs
安装cli
npm install -g @shm-open/code-push-cli
确认安装结果
code-push -v
我本地安装成功后的版本为2.6.1
创建账号
服务账号和密码
- https://code-push-server-feature.***.com/ admin YYHHwO9oNULsnU3m0Lpi
code-push register https://code-push-server-feature.***.com/
此时浏览器会自动打开生成token的页面,同时终端会提示需要你输入token。
在网页内点击获取token,然后点击生成token,即可拿到token的值。
点击获取token按钮,生成token
然后把token复制下来,粘贴到终端里
敲击回车键,既可以看到登陆成功的提示。
身份认证
如果是刚刚操作完register,并输入了token。即表示身份认证成功。可略过此步骤。
如果长时间未操作,不确定是否需要认证。可以通过一些方法判断是否需要认证.
当你从CLI登录后,你的访问密钥(Access Key)就一直保存在你本地磁盘上,所以不必每次使用帐号都需要登录
查询是否已登录
可以在任何时候,通过下面的命令,确认本地是否已经登录
code-push whoami
如果显示邮箱地址,表示已登录。否则会提示当前未登录。
登录
code-push login https://code-push-server-feature.***.com/
这个命令也会打开浏览器,然后去生成token,然后把token复制粘贴到终端里。和register命令行为差不多
退出登录
code-push logout
主动退出登录
查看已登录账号列表
code-push access-key ls
删除某个账号
code-push access-key rm <accessKey>
登录多个账号
创建一个账号
如果你需要其他账号,也可以新建一个其他的账号
code-push access-key add "VSTS Integration"
通过上面的命令可以生成一个新的token
登录其他账号
然后登录一下
code-push login --accessKey <accessKey>
应用管理
每一个热更新的页面,都需要在热更新服务里创建对应的应用。
同一个页面,需要分别创建Android和iOS的应用,不可以使用同一个。
应用创建
code-push app add <appName> <os> <platform>
appName: 应用名称
os: 操作系统
platform: 支持react-native和cordova。 cordova暂时用不到
创建应用的时候,推荐通过不同的后缀区分对应的系统
所有新的Apps自动会出现两个部署环境(Staging
和Production
)
示例:
code-push app add MyApp-Android android react-native
code-push app add MyApp-iOS ios react-native
查询某个app的Deployment key
code-push deployment ls <appName> -k
示例:
应用重命名
code-push app rename <appName> <newAppName>
示例:
应用删除
code-push app rm <appName>
示例:
应用合作
可以将自己账号下的某一个应用的操作权限,分配给其他账号,一起合作管理应用
code-push collaborator add <appName> <collaboratorEmail>
这里需要别人提供一个已注册的账号
一旦添加了,所有的合作者将立即拥有了最新分享App的如下权限:
相反的,这就意味着一个合作者不能做任何如下的事情:
重命名或删除应用。
转让应用的所有权。
创建,重命名或删除新的部署环境。
清除一个部署历史。
添加或删除合作者。
一个合作的开发者可以移除他/她自己
解除合作者关系
code-push collaborator rm <appName> <collaboratorEmail>
列出应用的所有合作者
code-push collaborator ls <appName>
转让给其他开发者
code-push app transfer <appName> <newOwnerEmail>
部署管理
打包
发布更新
code-push release MyApp-iOS /Users/***/Documents/***/demos/AwesomeProject/bundles 1.0.0
code-push release <应用名称> <Bundles所在目录> <对应的应用版本> --deploymentName: 更新环境 --description: 更新描述 --mandatory: 是否强制更新
注意:
CodePush默认是更新 staging 环境的,如果是staging,则不需要填写 deploymentName。
如果有 mandatory 则Code Push会根据mandatory 是true或false来控制应用是否强制更新。默认情况下mandatory为false即不强制更新。
对应的应用版本(targetBinaryVersion)是指当前app的版本(对应build.gradle中设置的versionName "1.0.6"),也就是说此次更新的js/images对应的是app的那个版本。不要将其理解为这次js更新的版本。 如客户端版本是 1.0.6,那么我们对1.0.6的客户端更新js/images,targetBinaryVersion填的就是1.0.6。
对于对某个应用版本进行多次更新的情况,CodePush会检查每次上传的 bundle,如果在该版本下如1.0.6已经存在与这次上传完全一样的bundle(对应一个版本有两个bundle的md5完全一样),那么CodePush会拒绝此次更新。 如图:
- 所以如果我们要对某一个应用版本进行多次更新,只需要上传与上次不同的bundle/images即可。如: eg: 对1.0.6的版本进行第一次更新:
code-push release GitHubPopular ./bundles/index.android.bundle 1.0.6 --deploymentName Production --description "1.支持文章缓存。" --mandatory true
对1.0.6的版本进行第二次更新:code-push release GitHubPopular ./bundles/index.android.bundle 1.0.6 --deploymentName Production --description "1.新添加收藏功能。" --mandatory true
在终端输入code-push deployment history <appName> Staging
可以看到Staging版本更新的时间、描述等等属性。 eg:code-push release Equipment ./bundles 1.0.1
app版本号的填写说明
发布更新&打包
code-push release-react MyApp-iOS ios
Code-push release-react <appName> <platform>
执行该命令,会自动打包切上传
这里可能可能会有个目录结构的问题,执行过程中会自动检测ios/文件下的内容,可能会因为目录问题报错