由于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,并且在这些版本之间轻松切换。
- 安装 nvm(安装向导在这里)。然后运行
- 在你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应用
有两个地方需要准备:
- 入口JavaScript文件必须要包含你实际的React Native应用和其他的组件。
- 封装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组件。太棒了!
你可以在这里获得一个样例应用的完整源代码。