简介
CodePush是提供给React Native 和 Cordova 开发者直接部署移动应用更新给用户设备的云服务。CodePush 作为一个中央仓库,开发者可以推送更新到 (JS, HTML, CSS and images),应用可以从客户端 SDKs 里面查询更新。CodePush 可以让应用有更多的可确定性,也可以让你直接接触用户群。在修复一些小问题和添加新特性的时候,不需要经过二进制打包,可以直接推送代码进行实时更新。
配置CodePush CLI(终端工具)
安装:
npm install -g code-push-cli
注册账号:
运行该命令行会打开一个新的页面,支持Microsofe和github账号登陆,授权完毕会返回一个key值,终端输入该key值,即登陆成功
code-push register
终端输入key值
相关命令
code-push login 登陆
code-push loout 注销
code-push access-key ls 列出登陆的token
code-push access-key rm <accessKye> 删除某个 key值
在CodePush上注册app
code-push app add <appName>
结果
相关命令:code-push app
add 在账号里面添加一个新的app
remove 或者 rm 在账号里移除一个app
rename 重命名一个存在app
list 或则 ls 列出账号下面的所有app
transfer 把app的所有权转移到另外一个账号
安装CodePush插件(iOS)
1.在项目根目录下执行
npm install --save react-native-code-push@latest
2.打开node_modules找到react-native-code-push,在该文件夹下找到CodePush.xcodeproj拖入Xcode的Libraries文件夹下
3.将CodePush.xcodeproj文件夹下的Products文件夹里的库文件拖进 Link Binary With Libraries中
4.并在Link Binary With Libraries中添加libz.tbd
5.在Build Settings的Header Search Paths那一项中加入 $(SRCROOT)/../node_modules/react-native-code-push
iOS端设置
- AppDelegate.m中倒入头文件
import "CodePush.h"
2.将
jsCodeLocation = [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"];
替换成
NSURL *jsCodeLocation;
ifdef DEBUG
jsCodeLocation = [NSURL URLWithString:@"http://localhost:8081/index.ios.bundle?platform=ios&dev=true"];
else
jsCodeLocation = [CodePush bundleURL];
endif
js文件中调用
1.在入口文件(上手派项目是在Main.js文件中)引入
import codePush from "react-native-code-push";
- 在componentDidMount中调用sync方法,当APP启动时会在后台静默更新
componentDidMount(){
codePush.sync();
}
3.到此位置,所有的基本配置都已经完成
部署
App创建成功后会默认显示两个部署:Production 和Staging 。部署,简单的说就是环境,比如ReactNative的jsbundle,iOS和Android是不可以共用一个的,所以我们需要生成两个jsbundle,而我们可以通过部署这个功能,创建两个部署:AppDemo-iOS 和AppDemo-Android ,并且App中分别使用这两个部署的Key,之后我们上传jsbundle只要分别上传到这两个部署中就可以了。每个部署都有一个对应的Deployment Key ,需要在项目中使用对应的Key。
1.创建部署(添加一个部署"MyDeployment"到App"HandsOn-Mobile"中)
code-push deployment add <appName> <deploymentName>
2.列出所有部署
code-push deployment ls <appName>
3.其他相关命令
code-push deployment rename <appName> 重命名
code-push deployment rm <appName> 删除部署
code-push deployment ls <appName> 列出应用的部署情况
code-push deployment ls <appName> -k 查看部署的key
code-push deployment history <appName> <deploymentNmae> 查看历史版本(Production 或者 Staging)
发布
1.打包js文件
react-native bundle --platform 平台 --entry-file 启动文件 --bundle-output 打包js输出文件 --assets-dest 资源输出目录 --dev 是否调试
如:react-native bundle --platform ios --entry-file index.ios.js --bundle-output iOS1.js --dev false
2.发布
code-push release <appName> <bundle目录> <targetBinaryVersion>
[--deploymentName <deploymentName>]默认staging
[--description <description>]更新描述(string)默认为null
[--mandatory]是否强制更新,默认false
[--disabled] 该版本客户端是否可以获得更新,默认为false
[--rollout]此更新推送的用户的百分比(string),默认值为null
如:code-push release HandsOn-Mobile iOS1.js 1.0.0
其他说明
1.关于版本问题
2.回滚更新(Rolling Back Updates)
code-push rollback <appName> <deploymentName>
--targetRelease, -r 指定回归到哪个标签,默认是回滚到上一个更新 [string] [默认值: null]
示例:
code-push rollback MyApp Production "MyApp"中"Production"部署执行回滚
code-push rollback MyApp Production --targetRelease v4 "MyApp"中"Production"部署执行回滚,回滚到v4这个标签版本
例子如下图:
3.促进更新(Promoting Updates)
code-push promote <appName> <sourceDeploymentName> <destDeploymentName>
–description, –des 描述 [string] [默认值: null]
–disabled, -x 该促进更新,客户端是否可以获得更新 [boolean] [默认值: null]
–mandatory, -m 是否强制更新 [boolean] [默认值: null]
–rollout, -r 此促进更新推送用户的百分比 [string] [默认值: null]
示例:
code-push promote MyApp Staging Production
"MyApp" 中"Staging" 部署的最新更新发布到"Production" 部署中
code-push promote MyApp Staging Production –des "Production rollout" -r 25
"MyApp" 中"Staging" 部署的最新更新发布到"Production" 部署中, 并且只推送25%的用户
4.修改更新
code-push patch <appName> <deploymentName>
--label, -l 指定标签版本更新,默认最新版本 [string] [默认值: null]
--description, --des 描述 [string] [默认值: null]
--disabled, -x 该修改更新,客户端是否可以获得更新 [boolean] [默认值: null]
--mandatory, -m 是否强制更新 [boolean] [默认值: null]
--rollout, -r 此更新推送用户的百分比,此值仅可以从先前的值增加。 [string] [默认值: null]
示例:
code-push patch MyApp Production --des "Updated description" -r 50 修改"MyApp"的"Production"部署中最新更新的描述 ,并且更新推送范围为50%
code-push patch MyApp Production -l v3 --des "Updated description for v3" 修改"MyApp"的"Production"部署中标签为v3的更新的描述