React Native使用指南-植入原生应用

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

需求

• CocoaPods – gem 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。

不过，为了让代码更整洁，我们可以派生一个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

这里我出于简化目的禁用了AutoLayout。在实际生产环境中，通常你都应该打开AutoLayout并且设置相应的约束。

往容器视图里添加RCTRootView

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

在ReactView.m中，我们需要先使用你的index.ios.bundle的URI来初始化RCTRootView。index.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;

启动开发服务器。

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

在工程的根目录下，我们可以开启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来访问。

编译和运行

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

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

总结

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

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

本文转自React Native中文网：http://reactnative.cn/docs/0.20/embedded-app-ios.html#content