ReactNative模块植入iOS 原生项目经验总结


  • 项目文件目录结构如下图所示:


    项目文件目录结构.png

目录结构解释:

  1. ReactNative目录:React Native所有相关的文件
  2. bundle:离线包所需的文件(注意:本地离线包,必须固定的名字,内容无需手动创建,通过打离线资源包,自动生成)
  3. main:JavaScript的所有代码文件
  4. index.ios.js:JavaScript的启动的入口文件(供iOS使用)
  5. node_modules:React Native需要的依赖包,通过命令(nom install)生成
  6. package.json:React Native需要的配置文件

原生iOS项目接入React Native模块

1.创建package.json,并且添加所需要的配置

{
  "name": "Calculate",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "start": "node node_modules/react-native/local-cli/cli.js start",
    "test": "jest"
  },
  "dependencies": {
    "react": "~15.4.1",
    "react-native": "0.42.3",
    "react-native-code-push": "^1.17.4-beta"
  },
  "devDependencies": {
    "babel-jest": "19.0.0",
    "babel-preset-react-native": "1.9.1",
    "eslint": "^3.19.0",
    "eslint-plugin-react": "^6.10.3",
    "jest": "19.0.2",
    "native-echarts": "^0.3.0",
    "react-navigation": "^1.0.0-beta.7",
    "react-test-renderer": "~15.4.1"
  },
  "jest": {
    "preset": "react-native"
  }
}

2.在包含package.json的根目录中输出:npm install 命令,自动生成node_modules文件

node_modules文件夹.png

3.在xcode项目的Podfile文件中配置需要的React Native组件,然后通过pod添加管理需要的依赖库(通过:pod install导入)

# platform :ios, '9.0'

target 'ReactNativeApp' do
    
    pod 'React', :path => ‘./ReactNative/node_modules/react-native', :subspecs => [
        'Core',
        'ART',
        'RCTActionSheet',
        'RCTAdSupport',
        'RCTGeolocation',
        'RCTImage',
        'RCTNetwork',
        'RCTPushNotification',
        'RCTSettings',
        'RCTText',
        'RCTVibration',
        'RCTWebSocket',
        'RCTLinkingIOS',
    ]
    pod "Yoga", :path => “./ReactNative/node_modules/react-native/ReactCommon/yoga"
    pod 'CodePush', :path => ‘./ReactNative/node_modules/react-native-code-push'
end

特别注意:path:=>对应的路径,需要根据项目文件所在的目录来决定


4.创建一个index.ios.js文件(这里借用React Native官网的代码)

'use strict';

import React from 'react';
import {
  AppRegistry,
  StyleSheet,
  Text,
  View
} from 'react-native';

class RNHighScores extends React.Component {
  render() {
    var contents = this.props["scores"].map(
      score => <Text key={score.name}>{score.name}:{score.value}{"\n"}</Text>
    );
    return (
      <View style={styles.container}>
        <Text style={styles.highScoresTitle}>
          2048 High Scores!
        </Text>
        <Text style={styles.scores}>    
          {contents}
        </Text>
      </View>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#FFFFFF',
  },
  highScoresTitle: {
    fontSize: 20,
    textAlign: 'center',
    margin: 10,
  },
  scores: {
    textAlign: 'center',
    color: '#333333',
    marginBottom: 5,
  },
});

// 整体js模块的名称
AppRegistry.registerComponent('RNHighScores', () => RNHighScores);

注意:到此,所有JS相关的代码准备已经完成,本次总结,直接跳过使用本地服务的形式,而采用bundle离线资源包的形式


5.在ReactNatvie目录中创建bundle(命名必须固定)空文件夹

1.在index.ios.js 和node_modules所在的根目录中打包

react-native bundle --entry-file index.ios.js --platform ios --dev false --bundle-output bundle/main.ios.jsbundle --assets-dest bundle

index.ios.js:为iOS平台,加载资源的入口文件
bundle/main.ios.jsbundle:bundle固定,main.ios.jsbundle为后续Xcode加载所需要的文件
--assets-dest bundle:将图片资源打包进bundle中

2.成功生成离线资源包,如下图所示

生成离线资源包.png

3.热更新............后续补充,暂时请跳转至RN热更新——codepush@bonon

//本次项目中使用到的命令

//打包命令
react-native bundle --entry-file index.ios.js --platform ios --dev false --bundle-output bundle/main.ios.jsbundle --assets-dest bundle

//上传code-push服务器
code-push release ReactNative bundle/main.ios.jsbundle 1.0.0
//解释
code-push release <#项目名称#>  bundle/<#项目中入口名称#> <#xcode项目中Version#>


6.Xcode项目中(建议直接跳过方式1,阅读方式2)

方式1:使用本地服务(即官网的基本方式)

  • Xcode编辑器中,代码如下(借用官网,不推荐)
- (IBAction)highScoreButtonPressed:(id)sender {
    NSURL *jsCodeLocation = [NSURL URLWithString:@"http://localhost:8081/index.ios.bundle?platform=ios"];
    RCTRootView *rootView = [[RCTRootView alloc] initWithBundleURL:jsCodeLocation
                                                        moduleName:@"RNHighScores"
                                                 initialProperties:nil
                                                 launchOptions    :nil];
    UIViewController *vc = [[UIViewController alloc] init];
    vc.view = rootView;
    [self presentViewController:vc animated:YES completion:nil];
}
  • 【终端】进入package.json所在的目录,开启本地服务,否则会如图所示
本地服务没开启.png.jpeg
//在node_modules文件所在的根目录,输入以下命令,开启本地服务
 react-native start
  • 成功接入,如图所示


    成功显示.png

方式2:使用本离线资源包(后期上线使用的方式)

至此,离线包已经在5.1步骤中完成,可以直接使用

  • 将bundle文件添加到Xcode项目中,如图所示


    bundle离线资源包添加到项目中.png
  • 头文件导入

#import <React/RCTRootView.h>      //容器
#import <RCTBundleURLProvider.h>   
#import <CodePush.h>               //热更库
  • 代码

- (IBAction)onClickReactApp:(UIButton *)sender {
    NSURL *jsCodeLocation;
#ifdef DEBUG
    //Debug模式,本地调试,加载资源方式
    jsCodeLocation = [[NSBundle mainBundle] URLForResource:@"main.ios" withExtension:@"jsbundle"];
#else
    //Release模式或者服务器使用方式
    jsCodeLocation = [CodePush bundleURLForResource:@"main.ios"];
#endif

    //moduleName:即index.ios.js中的AppRegistry对应模块名称
    RCTRootView *rootView = [[RCTRootView alloc] initWithBundleURL:jsCodeLocation
                                                        moduleName:@"Calculate"
                                                 initialProperties:nil
                                                     launchOptions:nil];
    
    UIViewController *vc = [[UIViewController alloc] init];
    vc.view = rootView;
    [self presentViewController:vc animated:YES completion:nil];
}
  • 效果如图所示
显示效果.jpeg

检查缺失的配置文件

  • info.plist 中App Transport Security
    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>

        //copy这一段缺少的配置
        //--------------------以下---------------------//
        <key>NSExceptionDomains</key>
        <dict>
            <key>localhost</key>
            <dict>
                <key>NSExceptionAllowsInsecureHTTPLoads</key>
                <true/>
            </dict>
            <key>static.centanet.com</key>
            <dict>
                <key>NSExceptionAllowsInsecureHTTPLoads</key>
                <true/>
                <key>NSIncludesSubdomains</key>
                <true/>
            </dict>
        </dict>
        //--------------------以上---------------------//

    </dict>
  • info.plist添加热更新所需要的标识key,
  <key>CodePushDeploymentKey</key>
  <string>前面添加应用得到的发布key(注意这里要选择是正式版的key还是测试版的key,不是发布到appstore可以用Staging的key)</string>
  • 报错:Argument list too long: recursive header expansion failed at:/....../
1.原因:因为RN的文件项目路径过于长,循环遍历,遍历不过来,然后就报错提示了

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

推荐阅读更多精彩内容