Homebrew, Mac系統的包管理器,用于安裝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目錄不可寫的權限問題。可以使用下面的命令修復:
sudo chown -R `whoami` /usr/local
使用Homebrew來安裝Node.js.
React Native目前需要NodeJS 5.0或更高版本。本文發布時Homebrew默認安裝的是最新版本,一般都滿足要求。
brew installnode
安裝完node后建議設置npm鏡像以加速后面的過程(或使用科學上網工具)。注意:不要使用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的命令行工具用于執行創建、初始化、更新項目、運行打包服務(packager)等任務。
npminstall -g yarn react-native-cli
安裝完yarn后同理也要設置鏡像源:
yarn configsetregistry https://registry.npm.taobao.org--globalyarn configsetdisturl https://npm.taobao.org/dist--global
如果你看到EACCES: permission denied這樣的權限報錯,那么請參照上文的homebrew譯注,修復/usr/local目錄的所有權:
sudo chown -R `whoami` /usr/local
React Native目前需要Xcode8.0 或更高版本。你可以通過App Store或是到Apple開發者官網上下載。這一步驟會同時安裝Xcode IDE和Xcode的命令行工具。
雖然一般來說命令行工具都是默認安裝了,但你最好還是啟動Xcode,并在Xcode | Preferences | Locations菜單中檢查一下是否裝有某個版本的Command Line Tools。Xcode的命令行工具中也包含一些必須的工具,比如git等。
Watchman是由Facebook提供的監視文件系統變更的工具。安裝此工具可以提高開發時的性能(packager可以快速捕捉文件的變化從而實現實時刷新)。
brew install watchman
Flow是一個靜態的JS類型檢查工具。譯注:你在很多示例中看到的奇奇怪怪的冒號問號,以及方法參數中像類型一樣的寫法,都是屬于這個flow工具的語法。這一語法并不屬于ES標準,只是Facebook自家的代碼規范。所以新手可以直接跳過(即不需要安裝這一工具,也不建議去費力學習flow相關語法)。
brew install flow
Nuclide(此鏈接需要科學上網)是由Facebook提供的基于atom的集成開發環境,可用于編寫、運行和調試React Native應用。
點擊這里閱讀Nuclide的入門文檔。
譯注:我們更推薦使用WebStorm或Sublime Text來編寫React Native應用。
測試安裝?
react-nativeinit XLsn0w XLsn0w-nativerun-ios
提示:你可以使用--version參數創建指定版本的項目。例如react-native init MyApp --version 0.39.2。注意版本號必須精確到兩個小數點。
你也可以在Nuclide中打開AwesomeProject文件夾 然后運行,或是雙擊ios/AwesomeProject.xcodeproj文件然后在Xcode中點擊Run按鈕。
現在你已經成功運行了項目,我們可以開始嘗試動手改一改了:
使用你喜歡的編輯器打開index.ios.js并隨便改上幾行。
在iOS Emulator中按下?-R就可以刷新APP并看到你的最新修改!
恭喜!你已經成功運行并修改了你的第一個React Native應用。