React Native iOS打包详解

BG:

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

iOS打包过程:

对比Hot Reloading加载的是在线js代码及资源文件(在Debug Server上),其实我们发布出去的App加载的就是离线的js代码和图片(手机本地),这就需要我们先把JavaScript和图片等资源打包成离线资源。
有了离线资源,我们还需要添加到iOS/Android项目中,修改iOS项目启动配置,然后打包iOS/Android项目得到ipa/apk,上传到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文件中,即bundle-ios字段:

"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了(就是配置iOS开发证书及Archive的过程),打包ipa跟iOS原生开发app的打包一模一样,这里就不再说了,你要是不知道可以问问原生开发人员,或者随便网上一搜,一大堆,相信你肯定会成功的~~~

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

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

ps:文中如有错误欢迎大家指正,欢迎各位留言交流~~~Android打包可以看这里React Native Android打包

推荐阅读更多精彩内容