ReactNative使用CodePush热更新文档(iOS篇)

此文档是在以前公司使用RN时我自己总结iOS使用codePush相关的文档,现在放上来供需要的同学参考。

CodePush安装及账号注册

1.安装CodePush CLI

管理CodePush账号需要通过NodeJS-based CLI。

只需要在终端输入npm install -g

code-push-cli,就可以安装了。

安装完毕后,输入code-push -v查看版本。

*npm为NodeJS的包管理器,如果你没安装NodeJS请先安装。

2.创建一个CodePush账号

在终端输入code-push register会咋浏览器中打开授权页面。授权通过之后,CodePush会告诉你“access key”,复制此key到终端即可完成注册。

然后终端输入code-push login进行登陆,登陆成功后,你的session文件将会写在/Users/你的用户名/.code-push.config。

3.CodePush终端命令

code-push

login登陆

code-push

loout注销

code-push

access-key ls列出登陆的token

code-push

access-key rm 删除某个access-key

4.CodePush服务器注册app

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环境配置(iOS)

1.Native项目利用cocoaPods集成好ReactNative之后,在终端cd到项目根目录,执行一下命令行:

npm install --save

react-native-code-push@latest安装react-native-code-push模块;

2.利用cocoapod导入codePush到项目中,在podfile文件中输入

pod'CodePush',:path =>

'../node_modules/react-native-code-push'然后终端cd到ios项目根目录执行podinstall

打开项目在BuildPhases->Link Binary With Libraries中点击”+”添加libCodePush.a , libz.tbd

3.在RN View承载controller中#import

并添加如下代码

#if DEBUG

jsCodeLocation=[[NSBundle mainBundle] URLForResource:@"main"withExtension:@"jsbundle"];

#else

jsCodeLocation =[CodePush bundleURL];

#endif

4.为了让CodePush运行的时候知道需要更新哪些应用,打开项目的Info.plist文件添加一个新的键CodePushDeploymentKey,值就是你配置的让app连接的服务。

查看键值的命令:code-push deployment ls您的应用名–k,终端显示如下图

测试版填写Staging Deployment key下的键值;正式版填写Production Deployment key下的键值。

CodePush热更新操作

1.iOS打离线bundle命令

注意打包前手动需要在指定目录下新建存储jsBundle和asset文件的bundle文件。

react-native bundle

--entry-file index.ios.js --bundle-output ./ios/bundle/main.jsbundle --platform

ios --assets-dest ./ios/bundle --dev false

2.CodePush上传bundle命令

以下命令将本地bundle文件上传到服务器

code-push release一仟金融_DAT /Users/ebiz/Desktop/代码管理/一仟金融/DEV/YQfinance_RN/ios/bundle 1.1.2 --deploymentName Staging--description "测试更新1" --mandatory true

deploymentName:生产(Production),测试(Staging)

mandatory:false(下次更新),true(本次强制更新)

3.测试发布的JS发布到正式版

测试版发布成功测试没有问题后可以通过此方法将bundle发布到正式版

code-push promote

–description, –des描述[string] [默认值: null]

–disabled, -x该促进更新,客户端是否可以获得更新[boolean] [默认值: null]

–mandatory, -m是否强制更新[boolean] [默认值:null]

–rollout, -r此促进更新推送用户的百分比[string] [默认值: null]

示例:

code-push promote MyAppStaging Production

"MyApp"中"Staging"部署的最新更新发布到"Production"部署中

code-push promote MyAppStaging Production –des "Production rollout" -r 25

"MyApp"中"Staging"部署的最新更新发布到"Production"部署中,并且只推送25%的用户

4.CodePush查看上传版本历史

一下命令可以查看测试环境下的版本发布及安装,回滚信息

code-push deploymenthistory

5.CodePush版本回滚

当发现新版本bundle使用报错时可以使用一下命令进行回滚操作

code-push rollback一仟金融_DAT Staging

6.CodePush修改更新

code-pushpatch

--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的更新的描述CodePush安装及账号注册

1.安装CodePush CLI

管理CodePush账号需要通过NodeJS-based CLI。

只需要在终端输入npm install -g

code-push-cli,就可以安装了。

安装完毕后,输入code-push -v查看版本。

*npm为NodeJS的包管理器,如果你没安装NodeJS请先安装。

2.创建一个CodePush账号

在终端输入code-push register会咋浏览器中打开授权页面。授权通过之后,CodePush会告诉你“access key”,复制此key到终端即可完成注册。

然后终端输入code-push login进行登陆,登陆成功后,你的session文件将会写在/Users/你的用户名/.code-push.config。

3.CodePush终端命令

code-push

login登陆

code-push

loout注销

code-push

access-key ls列出登陆的token

code-push

access-key rm 删除某个access-key

4.CodePush服务器注册app

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环境配置(iOS)

1.Native项目利用cocoaPods集成好ReactNative之后,在终端cd到项目根目录,执行一下命令行:

npm install --save

react-native-code-push@latest安装react-native-code-push模块;

2.利用cocoapod导入codePush到项目中,在podfile文件中输入

pod'CodePush',:path =>

'../node_modules/react-native-code-push'然后终端cd到ios项目根目录执行podinstall

打开项目在BuildPhases->Link Binary With Libraries中点击”+”添加libCodePush.a , libz.tbd

3.在RN View承载controller中#import

并添加如下代码

#if DEBUG

jsCodeLocation=[[NSBundle mainBundle] URLForResource:@"main"withExtension:@"jsbundle"];

#else

jsCodeLocation =[CodePush bundleURL];

#endif

4.为了让CodePush运行的时候知道需要更新哪些应用,打开项目的Info.plist文件添加一个新的键CodePushDeploymentKey,值就是你配置的让app连接的服务。

查看键值的命令:code-push deployment ls您的应用名–k,终端显示如下图

测试版填写Staging Deployment key下的键值;正式版填写Production Deployment key下的键值。

CodePush热更新操作

1.iOS打离线bundle命令

注意打包前手动需要在指定目录下新建存储jsBundle和asset文件的bundle文件。

react-native bundle

--entry-file index.ios.js --bundle-output ./ios/bundle/main.jsbundle --platform

ios --assets-dest ./ios/bundle --dev false

2.CodePush上传bundle命令

以下命令将本地bundle文件上传到服务器

code-push release一仟金融_DAT /Users/ebiz/Desktop/代码管理/一仟金融/DEV/YQfinance_RN/ios/bundle 1.1.2 --deploymentName Staging--description "测试更新1" --mandatory true

deploymentName:生产(Production),测试(Staging)

mandatory:false(下次更新),true(本次强制更新)

3.测试发布的JS发布到正式版

测试版发布成功测试没有问题后可以通过此方法将bundle发布到正式版

code-push promote

–description, –des描述[string] [默认值: null]

–disabled, -x该促进更新,客户端是否可以获得更新[boolean] [默认值: null]

–mandatory, -m是否强制更新[boolean] [默认值:null]

–rollout, -r此促进更新推送用户的百分比[string] [默认值: null]

示例:

code-push promote MyAppStaging Production

"MyApp"中"Staging"部署的最新更新发布到"Production"部署中

code-push promote MyAppStaging Production –des "Production rollout" -r 25

"MyApp"中"Staging"部署的最新更新发布到"Production"部署中,并且只推送25%的用户

4.CodePush查看上传版本历史

一下命令可以查看测试环境下的版本发布及安装,回滚信息

code-push deploymenthistory

5.CodePush版本回滚

当发现新版本bundle使用报错时可以使用一下命令进行回滚操作

code-push rollback一仟金融_DAT Staging

6.CodePush修改更新

code-pushpatch

--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的更新的描述。

推荐阅读更多精彩内容