[ 卡卡 DAY 30 ] - React Native codepush iOS 热更新

第一次认识 React Native 就是因为热更新
所以怎麽可以不介绍大家一下呢～
AppCenter 热更新（codepush）你听过吗?

热更新是什麽?

CodePush 为一个中央仓库，开发者可以推送更新 (JS, HTML, CSS and images)，应用可以从客户端 SDK 里面查询更新。

安装 react-native-code-push

npm install --save react-native-code-push
cd ios
pod install
cd ..

安装 appcenter

先申请 appcenter 的帐号，且参照 getting start 的设定

npm install -g appcenter-cli
appcenter -v
cd ios
pod install
cd ..
appcenter login
 <<输入网页的Authentication>>

App center 登入
他会跳出权限码，回到 cmd Access code from browser 填入 enter，即登入成功。

bundle 配置开启 AppDelegate.m 档案

#import <CodePush/CodePush.h>

修改 sourceURLForBridge：
主要是在 release 环境的时候读取 codepush 的 jsbundle

- (NSURL *)sourceURLForBridge:(RCTBridge *)bridge
{
#if DEBUG // 测试 debug
  return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index" fallbackResource:nil];
#else
  // 删掉这个
  return [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"];

  // 使用这个
  return [CodePush bundleURL];
#endif }

RN配置

於App.js引入

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

class App extends Component {
  constructor(props) {
    super(props);
  }

  codePushStatusDidChange(status) {
    switch (status) {
      case codePush.SyncStatus.CHECKING_FOR_UPDATE:
        console.log('Checking for updates.');
        break;
      case codePush.SyncStatus.DOWNLOADING_PACKAGE:
        console.log('Downloading package.');
        break;
      case codePush.SyncStatus.INSTALLING_UPDATE:
        console.log('Installing update.');
        break;
      case codePush.SyncStatus.UP_TO_DATE:
        console.log('Up-to-date.');
        break;
      case codePush.SyncStatus.UPDATE_INSTALLED:
        console.log('Update installed.');
        break;
    }
  }

  codePushDownloadDidProgress(progress) {
    console.log(
      progress.receivedBytes + ' of ' + progress.totalBytes + ' received.'
    );
  }

  render() {
    const initRouteName = this.props.componentName || appRouter.HOME;
    return (  
   {..... code }
    );
  }
}


const CodePushOptions = {
  // 检查更新（ON_APP_START:启动APP/ON_APP_RESUME:程序从後台控制/MANUAL:手动控制）
  checkFrequency: codePush.CheckFrequency.ON_APP_RESUME,
  // 何时安装（ON_NEXT_RESTART:下次程序启动/ON_NEXT_RESUME:下次程序从後台进入前台/ON_NEXT_SUSPEND:在後台更新/IMMEDIATE:立即更新，并重新启动）
  installMode: codePush.InstallMode.IMMEDIATE,
  // 重启之前，在後台待的最短时间
  minimumBackgroundDuration: 0,
  // 强制更新并启动
  mandatoryInstallMode: codePush.InstallMode.IMMEDIATE,
  // 更新时的提示更新窗，iOS不支援
  rollbackRetryOptions: {
    delayInHours: 1, // rollback重试，1小时/次
    maxRetryAttempts: 24 // rollback重试，最多尝试24次
  }
};

App = codePush(CodePushOptions)(App);
export default App;

环境配置 custom build settings

这个步骤很重要唷！！！我也是研究了很久才成功...

This mechanism allows you to easily configure your builds to produce binaries, which are configured to synchronize with different CodePush deployments.

打开 xcode 此专案 Project navigator
选取专案 targets 的 info tab

於 configurations 按 + 选取 "Duplicate Release Configuration"
把名字改成 Staging
於 Build Settings tab，在 toolbar 按 + 选取 Add User-Defined Setting
把名字设定成 “Multi_Deployment_Config”
- Release 设定 value：$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)
- Staging 设定 value： $(BUILD_DIR)/Release$(EFFECTIVE_PLATFORM_NAME)
选 Build Settings tab，在 toolbar 按 + 选取 Add User-Defined Setting
把名字设定成 “CODEPUSH_KEY”，再将 value 设定成 appcenter codepush 的 key。
於 iOS folder 的 Info.plist 将 CodePushDeploymentKey 输入 $(CODEPUSH_KEY)，配置完成。

appcenter codepush 指令介绍及补充

appcenter codepush release-react
-a {专案名称}
-d {环境}
-t {版本号}
-- description {叙述}
-m： 强制更新

看现在版本状态

code-push deployment ls {专案名称}

看所有版本列表

code-push deployment h {专案名称} {环境}

Install metrics 中各个引数的意思

Active 成功安装并执行当前 release 的使用者的数量（当使用者开启你的 App 就会执行这个 release），这个数字会根据使用者成功 installed 这个 release 或者离开这个 release（installed 了别的更新包，或者解除安装了 App），总之有它就知道当前 release 的活跃使用者量
Total 成功 installed 这个 release 的使用者的数量，这个数量只会增不会减。
Pending 当前这个 release 被下载的数量，但是还没有被 installed，因此这一个数值会在 release 被下载时增长，在 installed 时降低。这个指标主要是适配於没有为更新配置立马安装（mandatory）。如果你为更新配置了立马安装但是还是有 pending，很有可能是你的 App 启动时没有呼叫 notifyApplicationReady。
Rollbacks 这个数字代表在客户端自动回滚的数量，理想状态下，它应该为 0，如果你释出了一个更新包，在 installing 中发生 crash，code-push 将会把它回滚到之前的一个更新包中。