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

此文档是在以前公司使用RN时(安卓同事)总结的,现在放上来供需要的同学参考。

                                                                             React Native热更新(CodePush

一、CodePush简介

CodePush是微软提供的一套用于热更新React Native和Cordova应用的服务。

CodePush是提供给React Native和Cordova开发者直接部署移动应用更新给用户设备的云服务。CodePush作为一个中央仓库,开发者可以推送更新(JS, HTML, CSS and images),应用可以从客户端SDK里面查询更新。CodePush可以让应用有更多的可确定性,也可以让你直接接触用户群。在修复一些小问题和添加新特性的时候,不需要经过二进制打包,可以直接推送代码进行实时更新。

二、操作步骤

1)安装CodePush CLI

在终端输入npm install -g code-push-cli,就可以安装了。

安装完毕后,输入code-push -v查看版本,如看到版本代表成功。

2创建一个CodePush账号

在终端输入code-push register,会打开如下注册页面让你选择授权账号。

授权通过之后,CodePush会告诉你“access key”,复制此key到终端即可完成注册。

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

3在CodePush服务器注册app

为了让CodePush服务器知道你的app,我们需要向它注册app: 在终端输入code-push app add

即可完成注册

4

1.Android集成CodePush SDK

下面我们通过如下步骤在Android项目中集成CodePush。

第一步:在项目中安装react-native插件,终端进入你的项目根目录然后运行npminstall --save react-native-code-push

第二步:在Anroid Project中安装插件。

CodePush提供了两种方式:RNPM和Manual,本次演示所使用的是RNPM。

运行npm

i -g rnpm,来安装RNPM。

第三步: 运行rnpm link react-native-code-push。这条命令将会自动帮我们在anroid文件中添加好设置。

第四步: 如果link成功,此步骤可以忽略,查看build.gradle文件中是否有如下配置,如果没有需要在android/app/build.gradle文件里面添如下代码:

第五步:运行code-push deployment ls

获取 部署秘钥。默认的部署名是staging,所以 部署秘钥(deployment key) 就是staging。

第六步: 添加配置。当APP启动时我们需要让app向CodePush咨询JS bundle的所在位置,这样CodePush就可以控制版本。更新MainApplication.java文件:

第七步:修改versionName。

在android/app/build.gradle中有个android.defaultConfig.versionName属性,我们需要把 应用版本改成1.0.0(默认是1.0,但是codepush需要三位数)。

至此Code Push for Android的SDK已经集成完成。

2.iOS集成CodePush SDK

第一步 安装CodePush

SDK到node_modules文件

在终端cd到项目根目录,执行一下命令行:

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

第二步 利用cocoaPod将CodePush集成到项目

1>.在podfile文件中输入:pod'CodePush',:path => '../node_modules/react-native-code-push'然后终端cd到ios项目根目录执行pod install

2>打开项目在BuildPhases->Link

Binary With Libraries中点击”+”添加libCodePush.a, libz.tbd

第三步native代码配置

在RN View承载controller中导入SDK:#import

并添加如下代码

#if DEBUG

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

#else

jsCodeLocation =[CodePush bundleURL];

#endif

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

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

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

Deployment key下的键值。

三、CodePush更新

设置更新策略

最简单的方式是在根component中进行上述策略控制。

1>.在js中加载CodePush模块:import

codePush from 'react-native-code-push'

2>.在componentDidMount中调用sync方法,后台请求更新codePush.sync()

(1)如果可以进行更新,CodePush会在后台静默地将更新下载到本地,等待APP下一次启动的时候应用更新,以确保用户看到的是最新版本。

(2)如果更新是强制性的,更新文件下载好之后会立即进行更新。

(3)如果你期望更及时的获得更新,可以在每次APP从后台进入前台的时候去主动的检查更新

生成bundle

android项目根目录下执行:react-native bundle --platform android --devfalse --entry-file index.android.js --bundle-outputandroid/app/src/main/assets/index.android.bundle --assets-destandroid/app/src/main/res/

ios项目根目录下执行react-native bundle

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

--assets-dest ./ios --dev false生成main.jsbundle和assets文件

当然可以将bundle文件放在其他文件目录中,不一定是assets目录。

打包bundle结束后,就可以通过CodePush发布更新了。在终端输入

code-push

release <应用名称> <对应的应用版本> --deploymentName更新环境--description更新描述--mandatory是否强制更新

本例为:

mandatory设为true强制第一次就重新加载,mandatory设为false下次启动再加载新的bundle

尝试几次热更新后输入命令code-push deployment history ,如下图所示,可以看到相关Label的版本、app的版本、是否为强制更新、发布的作者是谁、描述等信息。


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

code-push promote

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

code-push rollback

四、CodePush的缺点和局限性

(1)服务器在国外,在国内访问,网速不是很理想。

(2)其升级服务器端程序并不开源的,后期微软会不会对其收费还是个未知数。

(3)不支持增量更新。

五.适用范围

(1)适用页面账户页面、消息集合页面;

(2)颠覆性修改页面样式,支持页面样式显示bug热更新;支持页面现有跳转逻辑bug修复;

(3)支持添加ReactNative添加新页面,以及ReactNative现有页面与新页面见跳转,传值。

*转载请注明出处。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,711评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,932评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,770评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,799评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,697评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,069评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,535评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,200评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,353评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,290评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,331评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,020评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,610评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,694评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,927评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,330评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,904评论 2 341

推荐阅读更多精彩内容