React Native iOS打包详解

2018-12-15 本文已影响30人星辰大海_王

BG:

我们在功能开发调试阶段不必去关心怎么打包以及发布。因为React Native提供了很🐂的功能：Hot Reloading，也就是热加载。通过开启开发菜单中的Hot Reloading选项，我们开发调试省了不少时间。
到了APP开发完毕，需要上线的时候，我们要想输出工作成果（ipa、apk）还需要经过打包环节，本文先介绍一下iOS的打包过程，下文补充Android的打包介绍。

iOS打包过程：

对比Hot Reloading加载的是在线js代码及资源文件（在Debug Server上），其实我们发布出去的App加载的就是离线的js代码和图片（手机本地），这就需要我们先把JavaScript和图片等资源打包成离线资源。
有了离线资源，我们还需要添加到iOS项目中，修改iOS项目启动配置，然后打包iOS项目得到ipa，上传到App Strore，用户就能下载我们的APP了。

以上可知，关键步骤就2步：

1.打包离线资源文件（包含jsbundle和资源文件）

我们先要在自己项目的ios文件夹下新建一个文件夹取名bundle（ps:ios文件夹和node_modules文件夹在同一级目录下，这个bundle文件夹名称可以随意取，下面要用到。

打包资源文件命令：react-native bundle

react-native bundle的详细命令选项https://github.com/facebook/react-native/blob/master/local-cli/bundle/bundleCommandLineArgs.js。
其中常用主要选项有：

--entry-file ,ios或者android入口的js名称，比如index.js(老版本的RN项目的默认入口文件是index.ios.js)
--platform ,平台名称(ios或者android)
--dev ,设置为false的时候将会对JavaScript代码进行优化处理。
--bundle-output, 生成的jsbundle文件的名称，比如./ios/bundle/index.jsbundle (老版本的RN项目是区分iOS和android的，要改为index.ios.jsbundle)
--assets-dest 图片以及其他资源存放的目录,比如./ios/bundle

注意：--entry-file和--bundle-output文件名称需要根据自己项目实际情况设置；--assets-dest输出目录可以自定义，但我们通常和生成的jsbundle文件放在同一目录下，也就是统一放到ios下的我们自己创建的bundle文件夹中。

由于app有迭代及反复打包需求，我们要把打包命令直接配置到package.json文件中：

"scripts": {
    "start": "node node_modules/react-native/local-cli/cli.js start",
    "test": "jest",
    "bundle-ios": "node node_modules/react-native/local-cli/cli.js bundle --entry-file index.js --platform ios --dev false --bundle-output ./ios/bundle/index.jsbundle --assets-dest ./ios/bundle"
  },

以后每次通过运行命令即可输出jsbundle和资源文件了：

npm run bundle-ios //运行命令直接打包

2.向iOS项目中添加我们得到的资源文件

离线包生成后，如果你可以在ios目录下看到bundle目录中已经有生成的离线资源文件了，恭喜你已经胜利✌️一半了，由两部分组成：assets文件夹中是项目用到图片文件所在的目录（子目录和你的RN项目中的图片目录一致），.jsbundle文件就是RNjs代码的产出物。
在Xcode中添加资源到项目中，必须使用Create folder references的方式(也就是文件夹的方式，goups和folder区别，这里不详细介绍了)添加bundle文件夹：

WX20181215-190028@2x.png
必须使用Create folder references的方式添加

WX20181215-190320@2x.png

添加后是这样的，如果你看见bundle是蓝色的，恭喜你又离胜利✌️进了一步：

WX20181215-193050@2x.png

胜利前最后一步，修改启动加载文件：

在开发的过程中可以在这里配置Debug Server的地址，当发布上线的时候，就需要使用离线的jsbundle文件，因此需要设置jsCodeLocation为本地的离线jsbundle。

在AppDelegate设置离线的jsCodeLocation:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  NSURL *jsCodeLocation;

//  jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index" fallbackResource:nil];
//  jsCodeLocation = [NSURL URLWithString:@"http://192.0.0.0:8081/index.bundle?platform=ios&dev=true"];//真机Hot reloading
#ifdef DEBUG
     jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index" fallbackResource:nil];//开发调试
#else
    jsCodeLocation = [[NSBundle mainBundle] URLForResource:@"bundle/index" withExtension:@"jsbundle"];//上线打包
  
#endif
 ........
}

也就是通过这一句代码来加载我们上面打包命令打包出的RN代码的产出物的：

jsCodeLocation = [[NSBundle mainBundle] URLForResource:@"bundle/index" withExtension:@"jsbundle"]

接下来，你需要做的就是输出ipa了，打包ipa跟iOS原生开发app的打包一模一样，这里就不再说了，_{你要是不知道可以问问原生开发人员，或者随便网上一搜，一大堆，相信你肯定会成功的}~~~

有了ipa，你就可以进行上传App Store了，这里也不做介绍了~ 根据我的经验，上线到App Store时，RN项目跟原生项目一样，主要注意下隐私权限的设置、icon图标的格式等等，我上线第一个RN项目时还是比较顺利的~不用担心，胜利就在你眼前了😁😁😄

以上就是RN代码的iOS平台离线打包的过程了~~~