目标平台:iOS
开发平台:Mac
安装
必须软件
Homebrew
Home-brew,Mac系统的包管理器, 用于安装NodeJS和一些其他必需的工具软件
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
译注: 在Max OS X 10.11 (EI Capitan)版本中, Homebrew在安装软件时可能会碰到/usr/local目录不可写的权限问题. 可以使用下面的命令修复:
sudo chown -R 'whom' /usr/local
Node
使用Homebrew来安装Node.js
React Native 目前需要NodeJS5.0或更高版本.
brew install node
安装完node后建议设置npm镜像以加速后面的过程(或使用科学上网工具)。注意:不要使用cnpm!cnpm安装的模块路径比较奇怪,packager不能正常识别!
npm config set registry https://registry.npm.taobao.org --global
npm config set disturl https://npm.taobao.org/dist --global
Yarn, React-Native的命令行工具 (react-native-cli)
Yarn是Facebook提供的替代npm的工具,可以加速node模块的下载。React Native的命令行工具用于执行创建、初始化、更新项目、运行打包服务(packager)等任务。
nam install -g yarn react-native-cli
安装完yarn后同理也要设置镜像源:
yarn config set registry https://registry.npm.taobao.org --global
yarn config set disturl https://npm.taobao.org/dist --global
如果你看到EACCES: permission denied这样的权限报错,那么请参照上文的homebrew译注,修复/usr/local目录的所有权:
sudo chown -R 'whom' /usr/local
Xcode
React Native目前需要Xcode 8.0 或更高版本。你可以通过App Store或是到Apple开发者官网上下载。这一步骤会同时安装Xcode IDE和Xcode的命令行工具。
虽然一般来说命令行工具都是默认安装了,但你最好还是启动Xcode,并在Xcode | Preferences | Locations菜单中检查一下是否装有某个版本的Command Line Tools。Xcode的命令行工具中也包含一些必须的工具,比如git等。
推荐安装工具
Watchman
Watchman是由Facebook提供的监视文件系统变更的工具。安装此工具可以提高开发时的性能(packager可以快速捕捉文件的变化从而实现实时刷新)。
brew install watchman
Flow
Flow是一个静态的JS类型检查工具。译注:你在很多示例中看到的奇奇怪怪的冒号问号,以及方法参数中像类型一样的写法,都是属于这个flow工具的语法。这一语法并不属于ES标准,只是Facebook自家的代码规范。所以新手可以直接跳过(即不需要安装这一工具,也不建议去费力学习flow相关语法)。
brew install flow
测试安装
react-native init HelloProject
cd HelloProject
react-native run-ios
提示:你可以使用–version参数创建指定版本的项目。例如react-native init MyApp –version 0.39.2。注意版本号必须精确到两个小数点。
修改项目
现在你已经成功运行了项目,我们可以开始尝试动手改一改了:
- 使用你喜欢的编辑器打开index.ios.js并随便改上几行。
- 在iOS Emulator中按下⌘-R就可以刷新APP并看到你的最新修改!
注
在确保 react-native 在 0.29.0 版本之后
如果在打开工程时出现 “RCTBundleURLProvider.h” file not found
在Header Search Paths 设置以下路径
$(SRCROOT)/../node_modules/react-native/Libraries