React Native集成到現有的原生項目

因為項目需求,在iOS原生項目中會嵌套幾個RN界面,這就牽涉到了原生代碼中嵌套RN代碼的問題,至于集成步驟以及過程中遇到的坑都在下面一一列舉,以幫助后來人。

前提

RN環境已經搭建完成,如若未完成,請移步
React Native環境搭建

將React Native集成到iOS應用中主要有如下幾個步驟:

  1. 配置好React Native依賴和項目結構
  2. 了解你要集成的React Native組件
  3. 使用CocoaPods把這些組件以依賴的形式加入到項目中
  4. 創建js文件,編寫React Native組件的js代碼
  5. 在應用中添加一個RCTRootView,這個RCTRootView正是用來承載你的React Native組件的容器
  6. 啟動React Native的Packager服務,運行應用
  7. 驗證這部分組件是否正常工作

1. 配置項目目錄結構

我在此也是為了更加深入的了解RN,所以在這里拿以前的小demo來做示范了。
首先創建一個空目錄用于存放React Native項目,然后在這個空目錄中創建一個ios子目錄,把現有的iOS項目拷貝到ios子目錄中

目錄結構

2. 安裝JavaScript依賴包

在項目根目錄下創建一個名為package.json的文件,其中填入以下內容:

{
  "name": "MyReactNativeApp",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "start": "node node_modules/react-native/local-cli/cli.js start"
  }
}

接下來使用yarn或者npm(兩者都是node的包管理器)來安裝React和React Native模塊。
打開終端,進入到根目錄中(即package.json)文件所在目錄,然后運行以下命令安裝:

yarn add react-native

這樣默認安裝最新版本的React Native,命令執行完畢后可以看到輸出中有兩個警告信息:

warning " > react-native@0.57.4" has unmet peer dependency "react@16.6.0-alpha.8af6728".
warning Your current version of Yarn is out of date. The latest version is "1.12.3", while you're on "1.9.4".

第一個警告提示還要安裝指定版本的React,第二個警告說是yarn版本不是最新的
然后執行命令安裝指定版本的React

yarn add react@16.6.0-alpha.8af6728

注意:必須嚴格匹配警告信息中所列出的版本,高了或者低了都是不可以嘀!

完成這個步驟之后可以發現我們的根目錄下多了一些東西:

根目錄

項目根目錄下的node_modules目錄中安裝的都是JavaScript的以來模塊(對于這個目錄,我們的原則是不復制、不移動、不修改、不上傳、隨用隨裝)

node_modules/目錄記錄到.gitignore文件中(即不上傳到版本控制系統,只保留到本地)

3. 安裝CocoaPods

CocoaPods是針對iOS和Mac開發的包管理工具。執行一下命令安裝CocoaPods

brew install cocoapods

安裝就不用過多的說了(畢竟都安裝的有)

4. 配置CocoaPods依賴

React Native框架整體是作為node模塊安裝到項目中的。接下來我們就要在CocoaPods的Podfile中指定我們需要使用的subspecs

可用的subspecs都列在node_modules/react-native/React.podspec文件中,基本上都是按照其功能命名的。一般來說第一個要添加的就是Core,其包含了必須的AppRegistryStyleSheetView以及其他的一些React Native核心庫。如果要使用React Native的Text庫(即<Text>組件),那就需要添加TCTTextsubspec,等等。

我們需要在Podfile文件中指定所需要的subspec。創建Podfile的最簡單方法就是在/ios目錄中使用CocoaPods的init命令(如果原先項目中已經創建了Podfile文件,可以跳過此步):

pod init

這樣Podfile就已經創建了,接下來就需要調整其內容以滿足集成需求,調整后的Podfile內容類似下面的:

# target的名字一般與你的項目名字相同
target 'NumberTileGame' do

  # 'node_modules'目錄一般位于根目錄中
  # 但是如果你的結構不同,那你就要根據實際路徑修改下面的`:path`
  pod 'React', :path => '../node_modules/react-native', :subspecs => [
    'Core',
    'CxxBridge', # 如果RN版本 >= 0.47則加入此行
    'DevSupport', # 如果RN版本 >= 0.43,則需要加入此行才能開啟開發者菜單
    'RCTText',
    'RCTNetwork',
    'RCTWebSocket', # 調試功能需要此模塊
    'RCTAnimation', # FlatList和原生動畫功能需要此模塊
    # 在這里繼續添加你所需要的其他RN模塊
  ]
  # 如果你的RN版本 >= 0.42.0,則加入下面這行
  pod 'yoga', :path => '../node_modules/react-native/ReactCommon/yoga'

  # 如果RN版本 >= 0.45則加入下面三個第三方編譯依賴
  pod 'DoubleConversion', :podspec => '../node_modules/react-native/third-party-podspecs/DoubleConversion.podspec'
  pod 'glog', :podspec => '../node_modules/react-native/third-party-podspecs/glog.podspec'
  pod 'Folly', :podspec => '../node_modules/react-native/third-party-podspecs/Folly.podspec'

end

修改好Podfile文件后,就可以開始安裝React Native的pod包了:

pod install

5. RN代碼集成

依賴搞好之后,就可以愉快的搞代碼咯,接下來我們在根目錄中創建一個名為home.js的文件(個人建議功能文件單獨創建文件夾放到一塊,不要都擠在根目錄中),實現以下內容(這里的內容可以隨便咯):

import React, {Component} from 'react';
import {Platform, StyleSheet, Text, View, NativeModules, NativeAppEventEmitter} from 'react-native';

const instructions = Platform.select({
  ios: 'Press Cmd+R to reload,\n' + 'Cmd+D or shake for dev menu',
  android:
    'Double tap R on your keyboard to reload,\n' +
    'Shake or press menu button for dev menu',
});

var rn = NativeModules.HmRNViewController;

type Props = {};

export default class App extends Component<Props> {
  render() {
    return (
      <View style={styles.container}>
        <Text style={styles.welcome}>Welcome to React Native!</Text>
        <Text style={styles.instructions}>Hello World</Text>
        <Text style={styles.instructions}>這里是RN界面</Text>
      </View>
    );
  }
}

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

代碼碼好了,接下來就是要iOS原生應用能夠調用的到的這個頁面,我們需要在項目根目錄下創建一個空的index.js文件(入口文件建議放在根目錄下)

index.js文件是React Native應用在iOS上的入口文件,該入口文件也可以像iOS的main入口文件一樣簡單,在其中實現以下內容即可完成:

import {AppRegistry} from 'react-native';
import home from './home.js';  // 引入當前目錄下的home.js文件

// 注冊組件
AppRegistry.registerComponent('homePage', () => home);

6. iOS代碼集成

RN代碼搞定,接下來就是在iOS原生項目中對接RN了,這也是重點:

假設當前的原生項目中A界面有一個按鈕,點擊之后要讓跳轉到RN界面,主要實現如下:
在iOS項目中新建一個ViewController界面B,在B界面的viewDidLoad方法中實現以下代碼:

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view.
    self.title = @"B";
    NSURL *jsCodeLocation;
    jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index" fallbackResource:nil];
    RCTRootView *rootView = [[RCTRootView alloc] initWithBundleURL:jsCodeLocation moduleName:@"homePage" initialProperties:@{@"name" : @"Max", @"value" : @"123456"} launchOptions:nil];
    // 這里如果引入的是一個頁面,可以使用self.view = rootView;,也可以使用[self.view addSubview:rootView];,不過使用addSubview:方法必須要給rootView設置frame
    //如果是一個組件(如按鈕、輪播圖等等),則可以直接使用[self.view addSubview:rootView];將組件添加到當前view,并設置frame值:rootView.frame = CGRectMake(0, 100, 100, 100);
    self.view = rootView;
}

A界面的按鈕點擊事件中實現的功能就是普通的跳轉到B界面,這里就略去了

7. 運行項目

運行項目,點擊A界面的按鈕,即可跳轉到RN界面:

報錯咯

別慌別慌,要穩住,不就是一個紅屏嘛 哈哈哈
出現這個紅屏報錯的原因在于:有沒有發現運行項目少了點什么?一般情況下,RN項目運行的時候都會自動啟動packager服務的,但是這里沒有自動啟動,至于怎么設置自動啟動packager服務我暫時也不知道,但是可以手動啟動的:

打開終端,到達項目根目錄下(即package.json所在目錄),然后執行命令:

npm start

然后終端形如:

啟動packager服務

剛剛打開的終端就用于啟動packager服務了,想要運行項目要么再打開一個終端至根目錄下運行react-native run-ios,要么進入ios文件夾打開Xcode運行,運行結果如下:

運行結果

在RN界面如果不想要原生的導航欄,可以在B界面中隱藏導航欄,總之,隨便搞起來吧

這篇文章所介紹的主要是更改目錄結構,環境配置等等,具體代碼部分很有限,所以源代碼就不貼出來了。在后面還會陸續的貼出來我在學習RN中遇到的問題我和經驗分享。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,527評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,687評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,640評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,957評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,682評論 6 413
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,011評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,009評論 3 449
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,183評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,714評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,435評論 3 359
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,665評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,148評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,838評論 3 350
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,251評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,588評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,379評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,627評論 2 380

推薦閱讀更多精彩內容