1 安装 Homebrew
Homebrew是神马 类比cocoapods
linux系统有个让人蛋疼的通病,软件包依赖,好在当前主流的两大发行版本都自带了解决方案,Red hat有yum,Ubuntu有apt-get
神马,你用mac os,不好意Mac os木有类似的东东,泪奔中几经折腾总算找到了第三方支持:Homebrew,Homebrew简称brew,是Mac OSX上的软件包管理工具,能在Mac中方便的安装软件或者卸载软件,可以说Homebrew就是mac下的apt-get、yum神器
Homebrew安装
ruby -e"$(curl -fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/install)"
2 安装Javascript运行环境 Node.js
看到Node.js这个名字,初学者可能会误以为这是一个Javascript应用,事实上,Node.js采用C++语言编写而成,是一个Javascript的运行环境。为什么采用C++语言呢?据Node.js创始人Ryan Dahl回忆,他最初希望采用Ruby来写Node.js,但是后来发现Ruby虚拟机的性能不能满足他的要求,后来他尝试采用V8引擎,所以选择了C++语言。既然不是Javascript应用,为何叫.js呢?因为Node.js是一个Javascript的运行环境。提到Javascript,大家首先想到的是日常使用的浏览器,现代浏览器包含了各种组件,包括渲染引擎、Javascript引擎等,其中Javascript引擎负责解释执行网页中的Javascript代码。作为Web前端最重要的语言之一,Javascript一直是前端工程师的专利。不过,Node.js是一个后端的Javascript运行环境(支持的系统包括*nux、Windows),这意味着你可以编写系统级或者服务器端的Javascript代码,交给Node.js来解释执行,简单的命令类似于:
#node helloworld.js
Node.js采用了Google Chrome浏览器的V8引擎,性能很好,同时还提供了很多系统级的API,如文件操作、网络编程等。浏览器端的Javascript代码在运行时会受到各种安全性的限制,对客户系统的操作有限。相比之下,Node.js则是一个全面的后台运行时,为Javascript提供了其他语言能够实现的许多功能。
brew install node
3 安装 React 和 React Native依赖
在你JS代码文件所在目录下,安装React和React Native依赖:
npm install react
npm install react-native
或者直接运行 npm install 类比 pod install pod 需要一个pod file文件 执行npm 同样也需要一个文件,文件名称是package.json 文件
Package.json 属性
name- 包的名称
version- 包的版本
description- 包的描述
homepage- 包的网站主页
author- 包的作者
contributors- 包的贡献者的名称列表
dependencies- 依赖性列表。npm自动安装所有在node_module文件夹中的包提到的依赖关系。
repository- 包的存储库类型和URL
main- 包的入口点
keywords- 关键字
4 通过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',# 添加其他你想在工程中使用的依赖。]
记得要添加所有你需要的依赖。举例来说,元素如果不添加RCTText依赖就不能运行。
接着安装你的pods:
$ pod install
有两个地方需要准备:
入口JavaScript文件必须要包含你实际的React Native应用和其他的组件。
封装Objective-C代码,加载你的脚本并创建一个RCTRootView来显示和管理你的React Native组件。
首先,创建一个文件夹来保存你的React代码,然后创建一个index.ios.js文件。
$ mkdir ReactComponent
$ touch ReactComponent/index.ios.js
然后复制并粘贴一个index.ios.js的初始代码——这是一个简单的React Native应用:
import React, { Component } from 'react';
import {
AppRegistry,
StyleSheet,
Text,
View
} from 'react-native';
class ReactNativeApp extends Component {
render() {
return (
Welcome to React Native!
To get started, edit index.ios.js
Press Cmd+R to reload,{'\n'}
Cmd+D or shake for dev menu
);
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
justifyContent: 'center',
alignItems: 'center',
backgroundColor: '#F5FCFF',
},
welcome: {
fontSize: 222,
textAlign: 'center',
margin: 10,
},
instructions: {
textAlign: 'center',
color: '#333333',
marginBottom: 5,
},
});
AppRegistry.registerComponent('ReactNativeApp', () => ReactNativeApp);
ReactNativeApp就是你的模块名,这个在后面会要用到。
在想要管理这个视图的视图管理器中,添加一个outlet然后连接它:
// ViewController.m
@interfaceViewController ()
@property(nonatomic,strong) RCTRootView *rootView;;
@end
准备好开始最有意思的部分了吗?现在我们要创建RCTRootView来包含你的React Native应用。
在ReactView.m中,我们需要先使用你的index.ios.bundle的URI来初始化RCTRootView。index.ios.bundle会由packager服务创建,可以通过React Native服务器访问到。我们会在后面讨论这个问题。
NSURL*jsCodeLocation = [NSURLURLWithString:@"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.
//
// curlhttp://localhost:8081/index.ios.bundle-o main.jsbundle
_rootView = [[RCTRootViewalloc]initWithBundleURL:jsCodeLocation
moduleName:@"AwesomeProject"
initialProperties:nil
launchOptions:launchOptions];
self.view =rootView;
译注:这一部分的官方文档都有一些过时。翻译组在翻译&审校完其它部分的文档后,如果官方文档还没有更新,会帮助校正官方文档的同时翻译中文文档。
在工程的根目录下,我们可以开启React Native开发服务器:
(JS_DIR=`pwd`/ReactComponent;cdnode_modules/react-native; npmrunstart -- --root$JS_DIR)
这条命令会启动一个React Native开发服务器,用于构建我们的bundle文件。--root选项用来标明你的React Native应用所在的根目录。在我们这里是ReactComponents目录,里面有一个index.ios.js文件。开发服务器启动后会打包出index.ios.bundle文件来,并可以通过http://localhost:8081/index.ios.bundle来访问。
在iOS 9以上的系统中,除非明确指明,否则应用无法通过http协议连接到localhost主机。可以参考这篇帖子了解一些解决方案。
我们建议你在Info.plist文件中将localhost列为App Transport Security的例外:
NSAppTransportSecurityNSExceptionDomainslocalhostNSTemporaryExceptionAllowsInsecureHTTPLoads
如果不这样做,在尝试通过http连接到服务器时,会遭遇这个错误 -Could not connect to development server.
现在编译和运行你的应用。你应该可以看到你的React Native应用在ReactView内运行。