安裝前注意:
1)在Max OS X 10.11(El Capitan)版本中,homebrew在安裝軟件時可能會碰到/usr/local目錄不可寫的權限問題。可以使用下面的命令修復:
sudo chown -R `whoami` /usr/local
2)如果命令行提示command not found,請加上sudo獲得最高權限
一、環境需求
1.1 安裝Homebrew
Homebrew是OS X的套件(包)管理器,用於安裝Node.js和一些其他必須的工具軟件。
安裝方式:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
1.2 安裝npm 和 Node.js
Node.js最好安裝5.0及其以上更高版本,node安裝成功后npm自動也就有了,直接下載安裝Node.js,網址:https://nodejs.org/en/download/ (資料中已有)。
brew install node
1.3 安裝WatchMan
WatchMan是由Facebook提供的監視文件系統變更的工具。安裝此工具可以提高開發時的性能(packager可以快速捕捉文件的變化從而實現實時刷新)。
brew install watchman
驗證是否安裝成功
1.4 安裝Flow
flow是一個 JavaScript 的靜態類型檢查器。這一語法並不屬於ES標准,只是Facebook自家的代碼規范。所以新手可以直接跳過(即不需要安裝這一工具,也不建議去費力學習flow相關語法)。
brew install flow
驗證是否安裝成功
二、React Native安裝
2.1 Yarn、React Native的命令行工具(react-native-cli)
Yarn是Facebook提供的替代npm的工具,可以加速node模塊的下載。React Native的命令行工具用於執行創建、初始化、更新項目、運行打包服務(packager)等任務。
npm install -g yarn react-native-cli
2.2 安裝截圖如下:
三、 ios開發環境需求
Xcode 8 及其以上更高版本
四、 Android開發環境需求
安裝最新版的JDK:
你可以在命令行中輸入 javac -version來查看你當前安裝的JDK版本。下載安裝地址:http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html (資料中已經存放)
建議安裝Android studio,在安裝過程中請嚴格執行以下選項:
1)選擇 Custom 選項
2)勾選Performance
和Android Virtual Device
3)安裝完成后,在Android Studio的啟動歡迎界面中選擇Configure | SDK Manager
4)在SDK Platforms
窗口中,選擇Show Package Details
,然后在Android 6.0 (Marshmallow)
中勾選Google APIs
、Android SDK Platform 23
、Intel x86 Atom System Image
、Intel x86 Atom_64 System Image
以及Google APIs Intel x86 Atom_64 System Image
。
5)在SDK Tools
窗口中,選擇Show Package Details
,然后在Android SDK Build Tools
中勾選Android SDK Build-Tools 23.0.1
(必須是這個版本)。然后還要勾選最底部的Android Support Repository。
6)ANDROID_HOME環境變量
確保ANDROID_HOME環境變量正確地指向了你安裝的Android SDK的路徑。具體的做法是把下面的命令加入到~/.bash_profile文件中,使用 vi ~/.bash_profile。
# 如果你不是通過Android Studio安裝的sdk,則其路徑可能不同,請自行確定清楚。
export ANDROID_HOME=~/Library/Android/sdk
然后使用下列命令使其立即生效:
source ~/.bash_profile
可以使用echo $ANDROID_HOME檢查此變量是否已正確設置。
4.1 安裝Genymotion
Genymotion是一個第三方模擬器,它比Google官方的模擬器更易設置且性能更好。但是,它只針對個人用戶免費。
1)下載並安裝Genymotion
https://www.genymotion.com/
2)打開Genymotion,如果你尚未安裝VirtualBox,它有可能會提示你安裝
3)創建一個模擬器並啟動
4)按下⌘+M可以打開開發者菜單(在安裝並啟動了React Native應用之后)
4.2 Gradle Daemon
開啟Gradle Daemon可以極大地提升java代碼的增量編譯速度。
touch ~/.gradle/gradle.properties && echo "org.gradle.daemon=true" >> ~/.gradle/gradle.properties
五、 React Native的第一個應用
5.1 執行命令,生成一個工程
react-native init 項目名稱
注意:由於眾所周知的網絡原因,需要等待一段時間(具體視網絡情況而定)。react-native命令行從npm官方源拖代碼時會遇上麻煩,可以將npm倉庫源替換為國內鏡像:
npm config set registry https://registry.npm.taobao.org
npm config set disturl https://npm.taobao.org/dist
5.2 運行截圖
5.3 目錄結構截圖
目錄結構分析:
a)默認生成android和ios兩個平台的原生項目;
b)其中,index.android.js和index.ios.js文件為Android和iOS的空殼應用文件;
c)此外,node_modules文件夾,是為Node.js存放和管理npm包資源,也包含React Native框架文件。
查看index.ios.js中的代碼:
六、運行工程文件
不管是 iOS 還是 Android,在開發調試階段,都需要在 Mac 上啟動一個 HTTP 服務,稱為Debug Server,默認運行在 8081 端口,APP 通 Debug Server 加載 js。
6.1 打開Xcode,運行你的第一個React Native創建的iOS應用
圖1 - 啟動React native 服務器
圖2 - 客戶端運行界面
6.2 把React Native創建的應用跑在Android上
a) 命令行執行cd SeeMyGoProduct,路徑切換到項目主目錄
b) 命令行執行react-native run-android進行加載運行android 應用。
c) 使用編輯器進行打開和修改index.android.js文件,接着通過菜單按鈕選擇Reload JS來進行刷新修改
七、管理React Native庫的版本
在開發中,會經常的去控制React Native的版本庫,得以適配各種條件下的開發,那該如何查看、控制ReactNative的版本呢?
7.1 查看本地的React Native的版本
命令行輸入
react-native --version
命令行效果
7.2 更新本地的React Native的版本
命令行輸入
npm update -g react-native-cli
7.3 查詢react-native的npm包最新版本
NPM的全稱是Node Package Manager ,是一個NodeJS包管理和分發工具,已經成為了非官方的發布Node模塊(包)的標准。
npm包地址 :
https://www.npmjs.com/package/react-native
命令行查詢
npm info react-native
查詢效果
項目中查看
7.4 升級或者降級npm包的版本
npm install --save react-native@0.18
7.5 更新項目templates文件(可選)
新的npm包會包含更新在運行react-native init命令生成的一些動態文件,例如init創建項目的時候會生成iOS和Android的子項目,我們可以通過以下的命令進行獲取最新的代碼
命令行查詢
react-native upgrade
八、WebStom設置React Native代碼提示
8.1 從gitHub上下載xml插件
git clone https://github.com/virtoolswebplayer/ReactNative-LiveTemplate
8.2 安裝
將ReactNative.xml復制到 ~/Library/Preferences/WebStorm10/templates ,然后重啟 WebStrom。