React Native 熱更新 -- CodePush SDK 集成及使用

0. 安裝 react-native-code-push 插件

# cd 到工程根目錄

# 在項(xiàng)目中安裝 react-native-code-push 插件
$ npm install --save react-native-code-push@latest

1. iOS 端:

CodePush 提供 RNPM阵漏、CocoaPods手動(dòng) 三種在 iOS 項(xiàng)目中集成 CodePush 的方式顷扩。以下按照 鏈接 孵运、配置 兩個(gè)步驟進(jìn)行整理:

鏈接篇:

  1. RNPM - React Native包管理器(RNPM)是一個(gè)非常棒的工具怎爵,它為React Native插件提供了最簡(jiǎn)單的安裝體驗(yàn)锹杈。(該方式集合了鏈接闯割、配置兩個(gè)步驟 - 推薦
# cd 到工程根目錄
#
# 通過命令自動(dòng)在 iOS 中鏈接曙咽、配置好設(shè)置
$ rnpm link react-native-code-push
# 在終端運(yùn)行此命令之后拉讯,終端會(huì)提示讓你輸入 `deployment key`涤浇,如果不輸入則直接單擊`enter`跳過
rnpm link react-native-code-push
  • 從 React Native v0.27 版本開始,rnpm link 已經(jīng)被合并到 React Native CLI 中魔慷。只需運(yùn)行: react-native link react-native-code-push 即可只锭。

  • 如果您的應(yīng)用程序使用的版本低于 v0.27 的 React Native,請(qǐng)運(yùn)行以下命令: rnpm link react-native-code-push

  • 如果您尚未安裝 RNPM院尔,可以通過運(yùn)行 npm i -g rnpm 安裝 RNPM 蜻展,然后執(zhí)行上述命令來完成。

deployment key 的值可以通過 CodePush CLI 注冊(cè)邀摆、查詢得到纵顾。
如需更改項(xiàng)目中的 deployment key 可在 "iOS 工程文件"->"info.plist"->"CodePushDeploymentKey" 下圖位置更改:

info.plist

  1. CocoaPods該方式目前只是在 iOS 中進(jìn)行了插件鏈接,需繼續(xù)配置
    將 CodePush 插件依賴項(xiàng)添加到您的 Podfile栋盹,指向工程文件中的安裝路徑
# Podfile文件
pod 'CodePush', :path => '../node_modules/react-native-code-push'

執(zhí)行 pod 安裝

# cd 到 iOS 工程目錄 執(zhí)行
$ pod install

注:需繼續(xù)進(jìn)行配置施逾,見配置篇步驟。

  1. 手動(dòng)集成該方式目前只是在 iOS 中進(jìn)行了插件鏈接例获,需繼續(xù)配置
  • 1.在 Xcode 中打開應(yīng)用項(xiàng)目

  • 2.將工程文件目錄下 "node_modules/react-native-code-push/ios" 中的 "CodePush.xcodeproj" 文件拖動(dòng)到 Xcode 工程節(jié)點(diǎn) Libraries 里汉额,如下圖:


    將CodePush添加到項(xiàng)目
  • 3.在 Xcode 中選擇項(xiàng)目節(jié)點(diǎn),并選擇項(xiàng)目配置的 "Build Phases" 選項(xiàng)卡榨汤。

  • 4.從 "Libraries/CodePush.xcodeproj/Products" 拖動(dòng) "libCodePush.a" 到項(xiàng)目"Build Phases" 的 "Link Binary With Libraries" 闷愤。


    在構(gòu)建期間鏈接CodePush
  • 5.單擊 "Link Binary With Libraries" 列表下方的加號(hào),添加 "libz.tbd"件余。


    Libz參考

注:需繼續(xù)進(jìn)行配置,見配置篇步驟遭居。

配置篇:

:如果您使用了 RNPM 的集成方式啼器,那么您可以跳過此部分。

當(dāng)你的 iOS 項(xiàng)目鏈接到 CodePush 插件俱萍,你需要配置你的應(yīng)用程序來咨詢 CodePush 的 JS包 的位置端壳,因?yàn)樗?fù)責(zé)將其與發(fā)布到 CodePush 服務(wù)器的更新同步。

步驟:

  1. 打開 AppDelegate.m 文件枪蘑,并引入 CodePush 頭文件:
#import <CodePush/CodePush.h>
  1. 找到以下代碼行:
 jsCodeLocation = [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"]; 
  1. 將其替換為此行:
jsCodeLocation = [CodePush bundleURL];

此更改將應(yīng)用配置為始終加載應(yīng)用的 jsbundle的最新版本 损谦。在通過 CodePush 推送更新前岖免,他只會(huì)使用應(yīng)用程序編譯的文件。但是照捡,在通過 CodePush 推送更新后颅湘,它將返回最近安裝更新的位置。

注意:
bundleURL 方法假定應(yīng)用程序的 jsbundle 為默認(rèn)的 main.jsbundle 栗精。如果你更改了應(yīng)用程序 jsbundle 的文件名闯参,則只需調(diào)用方法 bundleURLForResource:bundleURLForResource:withExtension: 以覆蓋默認(rèn)的行為。

建議使用 DEBUG 宏預(yù)處理器悲立,實(shí)現(xiàn)在開發(fā)模式下調(diào)試 和 在生產(chǎn)模式下使用 CodePush 熱更新之間動(dòng)態(tài)切換鹿寨。具體代碼如下:

NSURL *jsCodeLocation;

#ifdef DEBUG
    jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index.ios" fallbackResource:nil];
#else
    jsCodeLocation = [CodePush bundleURL];
#endif
在應(yīng)用程序中添加 CodePushDeploymentKey

為了要讓程序在執(zhí)行 [CodePush bundleURL] 時(shí)知道它應(yīng)該查詢哪個(gè)部署更新,需要在應(yīng)用程序 "Info.plist" 文件中薪夕,添加一個(gè)新的條目 CodePushDeploymentKey脚草,其值是你在 CodePush CLI 中注冊(cè)此應(yīng)用程序的 Deployment Key 值。

info.plist

你可以通過運(yùn)行 code-push deployment ls <appName> -kCodePush CLI 中檢索此值原献。

code-push deployment ls <appName> -k

2. ReactNative 端:

設(shè)置更新控制策略:

在使用 CodePush 更新你的應(yīng)用之前馏慨,需要先設(shè)置一下更新控制策略,即:

  1. 什么時(shí)候檢查更新嚼贡?(在APP啟動(dòng)的時(shí)候熏纯?在設(shè)置頁面添加一個(gè)檢查更新按鈕?設(shè)置一個(gè)固定的間隔周期性的檢查粤策?)
  2. 什么時(shí)候可以更新樟澜,如何將更新呈現(xiàn)給客戶端用戶?

最簡(jiǎn)單的方式是在根組件中進(jìn)行策略控制:

import codePush from "react-native-code-push";

class MyApp extends Component {
}

MyApp = codePush(MyApp);

或者

import codePush from 'react-native-code-push'

class MyApp extends Component {
    componentDidMount() {
        codePush.sync();
    }

}

默認(rèn)情況下叮盘,在應(yīng)用程序啟動(dòng)的時(shí)候 CodePush 將檢查更新秩贰。

  • 如果有可用的更新,它將被靜默下載柔吼,并在下次應(yīng)用程序重新啟動(dòng)時(shí)安裝更新毒费,確保用戶看到的是最新版本。
  • 如果可用更新是強(qiáng)制性的愈魏,更新文件下載好之后會(huì)立即進(jìn)行更新觅玻。

如果你希望應(yīng)用程序更快地發(fā)現(xiàn)更新,可以在每次應(yīng)用程序從后臺(tái)恢復(fù)時(shí)與 CodePush 服務(wù)器同步培漏,檢查更新:

let codePushOptions = { checkFrequency: codePush.CheckFrequency.ON_APP_RESUME };

class MyApp extends Component {
}

MyApp = codePush(codePushOptions)(MyApp);


發(fā)布更新
可參考 React Native 熱更新 -- CodePush CLI 安裝及基本使用4.發(fā)布更新 的提示進(jìn)行操作溪厘。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市牌柄,隨后出現(xiàn)的幾起案子畸悬,更是在濱河造成了極大的恐慌,老刑警劉巖珊佣,帶你破解...
    沈念sama閱讀 222,104評(píng)論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件蹋宦,死亡現(xiàn)場(chǎng)離奇詭異披粟,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)冷冗,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,816評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門守屉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人贾惦,你說我怎么就攤上這事胸梆。” “怎么了须板?”我有些...
    開封第一講書人閱讀 168,697評(píng)論 0 360
  • 文/不壞的土叔 我叫張陵碰镜,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我习瑰,道長(zhǎng)绪颖,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 59,836評(píng)論 1 298
  • 正文 為了忘掉前任甜奄,我火速辦了婚禮柠横,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘课兄。我一直安慰自己牍氛,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,851評(píng)論 6 397
  • 文/花漫 我一把揭開白布烟阐。 她就那樣靜靜地躺著搬俊,像睡著了一般。 火紅的嫁衣襯著肌膚如雪蜒茄。 梳的紋絲不亂的頭發(fā)上唉擂,一...
    開封第一講書人閱讀 52,441評(píng)論 1 310
  • 那天,我揣著相機(jī)與錄音檀葛,去河邊找鬼玩祟。 笑死,一個(gè)胖子當(dāng)著我的面吹牛屿聋,可吹牛的內(nèi)容都是我干的空扎。 我是一名探鬼主播,決...
    沈念sama閱讀 40,992評(píng)論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼润讥,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼转锈!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起象对,我...
    開封第一講書人閱讀 39,899評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎宴抚,沒想到半個(gè)月后勒魔,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體甫煞,經(jīng)...
    沈念sama閱讀 46,457評(píng)論 1 318
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,529評(píng)論 3 341
  • 正文 我和宋清朗相戀三年冠绢,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了抚吠。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,664評(píng)論 1 352
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡弟胀,死狀恐怖楷力,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情孵户,我是刑警寧澤萧朝,帶...
    沈念sama閱讀 36,346評(píng)論 5 350
  • 正文 年R本政府宣布,位于F島的核電站夏哭,受9級(jí)特大地震影響检柬,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜竖配,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,025評(píng)論 3 334
  • 文/蒙蒙 一何址、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧进胯,春花似錦用爪、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,511評(píng)論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至希停,卻和暖如春烁巫,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背宠能。 一陣腳步聲響...
    開封第一講書人閱讀 33,611評(píng)論 1 272
  • 我被黑心中介騙來泰國打工亚隙, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人违崇。 一個(gè)月前我還...
    沈念sama閱讀 49,081評(píng)論 3 377
  • 正文 我出身青樓阿弃,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國和親羞延。 傳聞我的和親對(duì)象是個(gè)殘疾皇子渣淳,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,675評(píng)論 2 359

推薦閱讀更多精彩內(nèi)容