搭建開發(fā)環(huán)境
歡迎使用React Native!這篇文檔會幫助你搭建基本的React Native開發(fā)環(huán)境。如果你已經(jīng)搭好了環(huán)境,那么可以嘗試一下編寫Hello World。
根據(jù)你所使用的操作系統(tǒng)、針對的目標平臺不同,具體步驟有所不同。如果想同時開發(fā)iOS和Android也沒問題,你只需要先選一個平臺開始,另一個平臺的環(huán)境搭建只是稍有不同。
目標平臺:iOSAndroid開發(fā)平臺:macOSLinuxWindows
譯注:如果閱讀完本文檔后還碰到很多環(huán)境搭建的問題,我們建議你還可以再看看由本站提供的環(huán)境搭建視頻教程、windows環(huán)境搭建文字教程、以及常見問題。
Homebrew, Mac系統(tǒng)的包管理器,用于安裝NodeJS和一些其他必需的工具軟件。
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
譯注:在Max OS X 10.11(El Capitan)版本中,homebrew在安裝軟件時可能會碰到/usr/local目錄不可寫的權(quán)限問題??梢允褂孟旅娴拿钚迯?fù):
sudo chown -R `whoami` /usr/local
使用Homebrew來安裝Node.js.
React Native目前需要NodeJS 5.0或更高版本。本文發(fā)布時Homebrew默認安裝的是最新版本,一般都滿足要求。
brew installnode
安裝完node后建議設(shè)置npm鏡像以加速后面的過程(或使用科學(xué)上網(wǎng)工具)。注意:不要使用cnpm!cnpm安裝的模塊路徑比較奇怪,packager不能正常識別!
npmconfig set registry https://registry.npm.taobao.org --globalnpmconfig set disturl https://npm.taobao.org/dist --global
Yarn、React Native的命令行工具(react-native-cli)
Yarn是Facebook提供的替代npm的工具,可以加速node模塊的下載。React Native的命令行工具用于執(zhí)行創(chuàng)建、初始化、更新項目、運行打包服務(wù)(packager)等任務(wù)。
npminstall -g yarn react-native-cli
如果你看到EACCES: permission denied這樣的權(quán)限報錯,那么請參照上文的homebrew譯注,修復(fù)/usr/local目錄的所有權(quán):
sudo chown -R `whoami` /usr/local
React Native目前需要Xcode7.0 或更高版本。你可以通過App Store或是到Apple開發(fā)者官網(wǎng)上下載。這一步驟會同時安裝Xcode IDE和Xcode的命令行工具。
雖然一般來說命令行工具都是默認安裝了,但你最好還是啟動Xcode,并在Xcode | Preferences | Locations菜單中檢查一下是否裝有某個版本的Command Line Tools。Xcode的命令行工具中也包含一些必須的工具,比如git等。
Watchman是由Facebook提供的監(jiān)視文件系統(tǒng)變更的工具。安裝此工具可以提高開發(fā)時的性能(packager可以快速捕捉文件的變化從而實現(xiàn)實時刷新)。
brewinstallwatchman
Flow是一個靜態(tài)的JS類型檢查工具。譯注:你在很多示例中看到的奇奇怪怪的冒號問號,以及方法參數(shù)中像類型一樣的寫法,都是屬于這個flow工具的語法。這一語法并不屬于ES標準,只是Facebook自家的代碼規(guī)范。所以新手可以直接跳過(即不需要安裝這一工具,也不建議去費力學(xué)習(xí)flow相關(guān)語法)。
brewinstallflow
Nuclide(此鏈接需要科學(xué)上網(wǎng))是由Facebook提供的基于atom的集成開發(fā)環(huán)境,可用于編寫、運行和調(diào)試React Native應(yīng)用。
點擊這里閱讀Nuclide的入門文檔。
譯注:我們更推薦使用WebStorm或Sublime Text來編寫React Native應(yīng)用。
react-nativeinit AwesomeProjectcd AwesomeProjectreact-nativerun-ios
你也可以在Nuclide中打開AwesomeProject文件夾 然后運行,或是雙擊ios/AwesomeProject.xcodeproj文件然后在Xcode中點擊Run按鈕。
現(xiàn)在你已經(jīng)成功運行了項目,我們可以開始嘗試動手改一改了:
使用你喜歡的編輯器打開index.ios.js并隨便改上幾行。
在iOS Emulator中按下?-R就可以刷新APP并看到你的最新修改!
恭喜!你已經(jīng)成功運行并修改了你的第一個React Native應(yīng)用。

如果你想要在真機上運行應(yīng)用,請參閱在設(shè)備上運行。
如果你碰到了一些問題,請參閱常見問題。zh