一、React Native 搭建開發環境(1)(Mac OS - IOS項目篇)

React Native是Facebook推出的一個開發IOS和安卓APP的技術。至於更多的詳情,這裏不再描述,大家可以自行百度它的定義。

 

原因:由於我想在一臺電腦上同時開發IOS和Android兩個APP,所以用的Mac。

這裏就講一講我在搭建開發環境過程中遇到的坑,也爲後面學習該技術的道友指一條坑少的路。

 

本文講解的是,在Mac OS上,搭建IOS開發環境的步驟。

Android篇,請移步:React Native 搭建開發環境(2)(Mac OS - Android項目篇)

 

 

1.安裝Homebrew

Homebrew, Mac系統的包管理器,用於安裝NodeJS和一些其他必需的工具軟件。

打開 Mac OS裏的 終端,直接複製粘貼以下命令,回車:

/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之後,有必要的童鞋也可以設置一下國內的加速源。

我用的是:http://ban.ninja

a.在Mac OS的 終端 裏輸入 vi ~/.bash_profile 會打開這個配置文件;

b.然後在裏面加上一行:export HOMEBREW_BOTTLE_DOMAIN=http://7xkcej.dl1.z0.glb.clouddn.com

c.加了之後,按 ESC 鍵,退出編輯;

d.然後再輸入命令 :wq 保存並退出當前配置文件;

e.讓剛纔的更改生效:source ~/.bash_profile

f.輸入下面的命令,查看剛纔更改的環境變量是否生效:

echo $HOMEBREW_BOTTLE_DOMAIN

如果看到 http://7xkcej.dl1.z0.glb.clouddn.com 等字樣,說明我們剛纔的配置已經OK了。

  

 

2.安裝NodeJS

使用Homebrew來安裝Node.js。

注意:如果你的電腦上已經裝了NodeJS,只要保證版本在5.0及以上,就不用再次安裝。)

React Native目前需要 NodeJS 5.0 或更高版本。本文發佈時Homebrew默認安裝的是最新版本,一般都滿足要求。

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

 

 

3.安裝Yarn、React Native的命令行工具(react-native-cli)

Yarn是Facebook提供的替代npm的工具,可以加速node模塊的下載。

React Native的命令行工具用於執行創建、初始化、更新項目、運行打包服務(packager)等任務。

npm 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 `whoami` /usr/local

 

安裝完yarn之後就可以用yarn代替npm了,例如用yarn代替npm install命令;

用 yarn add 某第三方庫名代替 npm install --save 某第三方庫名。

注意:目前npm5(發文時最新版本爲5.0.4)存在安裝新庫時會刪除其他庫的問題,導致項目無法正常運行。

請儘量使用 yarn 代替 npm 操作。)

 

 

4.安裝XCode

React Native目前需要Xcode 8.0 或更高版本。你可以通過App Store或是到Apple開發者官網上下載。

這一步驟會同時安裝Xcode IDE和Xcode的命令行工具。

雖然一般來說命令行工具都是默認安裝了,但你最好還是啓動Xcode,並在 Xcode > Preferences > Locations 菜單中檢查一下,

是否裝有某個版本的Command Line Tools。Xcode的命令行工具中也包含一些必須的工具,比如git等。

 

 

5.安裝Watchman

Watchman是由Facebook提供的監視文件系統變更的工具。

安裝此工具可以提高開發時的性能(packager可以快速捕捉文件的變化從而實現實時刷新)。

brew install watchman

 

 

6.安裝開發工具

根據你的喜好,選擇安裝一款開發工具。

我是搞C#的,自然對微軟的工具情有獨鍾:VSCode,另外還裝了款比較喜愛、易上手的工具:WebStorm

除此之外,還有很多其他的工具,比如:Sublime Text、還有Facebook自己出品的 Nuclide 等等。

 

 

7.測試安裝

注意init 命令默認會創建最新的版本,而目前最新的 0.45 及以上版本需要下載 boost 庫編譯。

此庫體積龐大,在國內即便FQ也很難下載成功,導致很多人無法正常運行iOS項目,中文網在論壇中提供了這些庫的國內下載鏈接。

如果你嫌麻煩,又沒有對新版本的需求,那麼可以暫時創建0.44.3的版本。

提示:你可以使用 --version 參數(注意是兩個槓)創建指定版本的項目。

例如: react-native init MyApp --version 0.44.3   注意版本號必須精確到兩個小數點。)

 

這裏接着踩一個大點的坑:

boost 編譯庫百度網盤下載地址:http://pan.baidu.com/s/1kVDUAZ9

下載下來後請放置到 ~/.rncache 目錄,比如你可以打開 終端,輸入:

cd ~ (進入到用戶目錄)

mkdir .rncache (創建rncache目錄,如果有,就不用創建,再次創建時會提示目錄已存在)

cp ~/Downloads/boost_1_63_0.tar.gz ~/.rncache/  (複製下載目錄文件地址,然後拷貝到rncache目錄下)

........ (複製剛剛下載的其他文件)

 

全部複製完成後,就可以開始init ReactNative項目了: 

react-native init MyFirstRNProject

cd MyFirstRNProject

react-native run-ios

 

然後經過漫長的等待,編譯完成後,虛擬機上會打開一個有個react native字樣的頁面,說明咱們的IOS開發環境搭建成功了!

 

提示:如果 run-ios 無法正常運行,請使用Xcode運行來查看具體錯誤(run-ios的報錯沒有任何具體信息)。

你也可以在 Nuclide 中打開 MyFirstRNProject 文件夾 然後運行,或是雙擊 ios/AwesomeProject.xcodeproj 文件然後在 Xcode 中點擊Run按鈕。)

 

 

8.修改項目

現在你已經成功運行了項目,我們可以開始嘗試動手改一改了:

  ·使用你喜歡的編輯器打開 index.ios.js 並隨便改上幾行。

  ·在iOS Emulator中按下⌘+R(保存)就可以刷新APP並看到你的最新修改!

 

 

9.完成

恭喜!你已經成功運行並修改了你的第一個React Native應用。

  

 

如果您覺得此文對您有所幫助,那麼您也可以打賞我。

不在乎數目的多少,我只需要知道,我幫助到了您,那就是我持之以恆的動力!

   

 

編程是一門藝術。我用代碼,改變您的生活!

 

帥帥的小毛驢

2017-09-19

  

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章