植入原生应用

由于React并没有假设你其余部分的技术栈——它通常只作为MVC模型中的V存在——它也很容易嵌入到一个并非由React Native开发的应用当中。实际上,它可以和常见的许多工具结合,譬如CocoaPods

需求#

  • CocoaPodsgem install cocoapods
  • Node.js
    • 安装 nvm(安装向导在这里)。然后运行nvm install node && nvm alias default node,这将会默认安装最新版本的Node.js并且设置好命令行的环境变量,这样你可以输入node命令来启动Node.js环境。nvm使你可以可以同时安装多个版本的Node.js,并且在这些版本之间轻松切换。
  • 在你JS代码文件所在目录下,安装React Native依赖:npm install react-native --save

通过CocoaPods安装React Native#

CocoaPods是iOS/Mac开发最常用的包管理工具。我们需要用它来引入React Native。如果你还没安装过CocoaPods,参考这篇文章

当你准备好开始使用CocoaPods之后,往Podfile中增加以下的内容。如果你还没有这个文件,在你工程的根目录下创建一个。

# 取决于你的工程如何组织,你的node_modules文件夹可能会在别的地方。
# 请将:path后面的内容修改为正确的路径。
pod 'React', :path => './node_modules/react-native', :subspecs => [
  'Core',
  'RCTImage',
  'RCTNetwork',
  'RCTText',
  'RCTWebSocket',
  # 添加其他你想在工程中使用的依赖。
]

记得要添加所有你需要的依赖。举例来说,<Text>元素如果不添加RCTText依赖就不能运行。

接着安装你的pods:

$ pod install

创建你的React Native应用#

有两个地方需要准备:

  1. 入口JavaScript文件必须要包含你实际的React Native应用和其他的组件。
  2. 封装Objective-C代码,加载你的脚本并创建一个RCTRootView来显示和管理你的React Native组件。

首先,创建一个文件夹来保存你的React代码,然后创建一个index.ios.js文件。

$ mkdir ReactComponent
$ touch ReactComponent/index.ios.js

然后复制并粘贴一个index.ios.js的初始代码——这是一个简单的React Native应用:

'use strict';

var React = require('react-native');
var {
  Text,
  View
} = React;

var styles = React.StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: 'red'
  }
});

class SimpleApp extends React.Component {
  render() {
    return (
      <View style={styles.container}>
        <Text>This is a simple application.</Text>
      </View>
    )
  }
}

React.AppRegistry.registerComponent('SimpleApp', () => SimpleApp);

SimpleApp就是你的模块名,这个在后面会要用到。

往应用里添加容器视图#

你需要添加一个容器视图来容纳React Native组件。它可以是你应用里任何的UIView

Container view example

不过,为了让代码更整洁,我们可以派生一个UIView,取名ReactView。打开你的Yourproject.xcworkspace来创建一个新的ReactView类(你也可以取任何你想要的名字!)

// ReactView.h

#import <UIKit/UIKit.h>
@interface ReactView : UIView
@end

在想要管理这个视图的视图管理器中,添加一个outlet然后连接它:

// ViewController.m

@interface ViewController ()
@property (weak, nonatomic) IBOutlet ReactView *reactView;
@end

注意:对于Swift应用来说不需要这一步。
这里我出于简化目的禁用了AutoLayout。在实际生产环境中,通常你都应该打开AutoLayout并且设置相应的约束。

往容器视图里添加RCTRootView#

准备好开始最有意思的部分了吗?现在我们要创建RCTRootView来包含你的React Native应用。

ReactView.m中,我们需要先使用你的index.ios.bundle的URI来初始化RCTRootViewindex.ios.bundle会由packager服务创建,可以通过React Native服务器访问到。我们会在后面讨论这个问题。

NSURL *jsCodeLocation = [NSURL URLWithString:@"http://localhost:8081/index.ios.bundle?platform=ios"];
// For production use, this `NSURL` could instead point to a pre-bundled file on disk:
//
//   NSURL *jsCodeLocation = [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"];
//
// generated by "Bundle React Native code and images" build step.
//
//   curl http://localhost:8081/index.ios.bundle -o main.jsbundle
RCTRootView *rootView = [[RCTRootView alloc] initWithBundleURL:jsCodeLocation
                                                    moduleName: @"SimpleApp"
                                                 launchOptions:nil];

然后把它添加为ReactView的子视图。

[self addSubview:rootView];
rootView.frame = self.bounds;

Swift应用#

在ReactView.swift文件中添加下列代码:

import UIKit
import React

class ReactView: UIView {

  let rootView: RCTRootView = RCTRootView(bundleURL: NSURL(string: "http://localhost:8081/index.ios.bundle?platform=ios"),
    moduleName: "SimpleApp", initialProperties: nil, launchOptions: nil)

  override func layoutSubviews() {
    super.layoutSubviews()

    loadReact()
  }

  func loadReact () {
        addSubview(rootView)
        rootView.frame = self.bounds
  }
}

然后确保你的视图被添加到了ViewContainer或是story board文件中。

启动开发服务器。#

译注:这一部分的官方文档都有一些过时。翻译组在翻译&审校完其它部分的文档后,如果官方文档还没有更新,会帮助校正官方文档的同时翻译中文文档。

在工程的根目录下,我们可以开启React Native开发服务器:

(JS_DIR=`pwd`/ReactComponent; cd node_modules/react-native; npm run start -- --root $JS_DIR)

这条命令会启动一个React Native开发服务器,用于构建我们的bundle文件。--root选项用来标明你的React Native应用所在的根目录。在我们这里是ReactComponents目录,里面有一个index.ios.js文件。开发服务器启动后会打包出index.ios.bundle文件来,并可以通过http://localhost:8081/index.ios.bundle来访问。

更新App Transport Security#

在iOS 9以上的系统中,除非明确指明,否则应用无法通过http协议连接到localhost主机。可以参考这篇帖子了解一些解决方案。

我们建议你在Info.plist文件中将localhost列为App Transport Security的例外:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSExceptionDomains</key>
    <dict>
        <key>localhost</key>
        <dict>
            <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
            <true/>
        </dict>
    </dict>
</dict>

如果不这样做,在尝试通过http连接到服务器时,会遭遇这个错误 - Could not connect to development server.

编译和运行#

现在编译和运行你的应用。你应该可以看到你的React Native应用在ReactView内运行。

Example

在模拟器下也可以实现热加载(需要在Build Settings -> Preprocessor Macros中设置DEBUG=1)。现在你已经拥有了一个React组件,它在Objective-C中完全表现为一个UIView的子类。

总结#

在底层,当RCTRootView初始化完成以后,它会尝试从开发服务器下载、解析并运行打包后的脚本文件。所以你所要做的就是实现你自己的容器视图或者视图控制器,然后把RCTRootView作为子视图加入——接下来RCTRootView会搞定你的脚本文件然后渲染你的React组件。太棒了!

你可以在这里获得一个样例应用的完整源代码。