1.3 開(kāi)發(fā)環(huán)境及工具介紹

Taro項(xiàng)目開(kāi)發(fā)依賴(lài)Node.js環(huán)境，并且要求Node.js版本高于8.0.0，Taro允許使用大多npm中的庫(kù)，支持更友好的第三方依賴(lài)管理。如果你剛接觸Taro，那么推薦使用Taro提供的腳手架工具創(chuàng)建項(xiàng)目，同時(shí)該工具提供了很多功能，譬如診斷依賴(lài)、創(chuàng)建模塊、更新包、打包構(gòu)建等。我們就從安裝Taro腳手架開(kāi)始吧！

1.3.1 安裝Taro腳手架工具

你可以選用npm或者Yarn全局安裝＠tarojs/cli，或者使用npx。不過(guò)由于Node.js版本限制等問(wèn)題，推薦使用nvm這一工具來(lái)管理Node.js版本。

使用npm全局安裝Taro腳手架：

使用Yarn全局安裝Taro腳手架：

安裝過(guò)程可能會(huì)提示Sass相關(guān)依賴(lài)安裝錯(cuò)誤，這時(shí)請(qǐng)終止，然后手動(dòng)安裝mirror-config-china后重試。安裝命令如下：

1.3.2 初始化項(xiàng)目

上一節(jié)已經(jīng)成功安裝Taro腳手架工具，現(xiàn)在只需一行命令就能創(chuàng)建出基礎(chǔ)Taro項(xiàng)目了，命令如下：

如果你的npm版本大于5.2，則可以直接使用npx創(chuàng)建項(xiàng)目：

項(xiàng)目模板及相關(guān)配置文件創(chuàng)建完成以后，Taro會(huì)自動(dòng)安裝項(xiàng)目中所需要的相關(guān)依賴(lài)。為了提升安裝速度，Taro內(nèi)部會(huì)為我們按照Yarn、cnpm、npm的順序檢測(cè)并選擇更快的方式去安裝依賴(lài)。如果在依賴(lài)安裝過(guò)程中出現(xiàn)錯(cuò)誤導(dǎo)致安裝終止，則可以進(jìn)入項(xiàng)目的根目錄嘗試手動(dòng)安裝。

1.3.3 運(yùn)行項(xiàng)目

Taro開(kāi)發(fā)環(huán)境的啟動(dòng)命令較多，分別對(duì)應(yīng)不同端的代碼編譯與調(diào)試，但是為了更方便記憶與語(yǔ)義化，Taro定義了相對(duì)一致的開(kāi)發(fā)環(huán)境啟動(dòng)命令，以npm運(yùn)行命令為例，如下表所示。

通過(guò)以上命令，可以將Taro項(xiàng)目編譯為不同端開(kāi)發(fā)環(huán)境的代碼。這時(shí)，只需要使用各端（除了H5）對(duì)應(yīng)的開(kāi)發(fā)工具，打開(kāi)編譯生成的項(xiàng)目文件，即可預(yù)覽調(diào)試。以微信小程序?yàn)槔?/p>

（1）運(yùn)行針對(duì)微信小程序的編譯命令：npm run dev：weapp。

（2）使用微信小程序開(kāi)發(fā)工具，打開(kāi)該項(xiàng)目目錄下的dist文件夾，即可在微信小程序開(kāi)發(fā)者工具中進(jìn)行預(yù)覽與調(diào)試。

如果你需要同時(shí)調(diào)試預(yù)覽多端應(yīng)用，則需要修改項(xiàng)目下的config/index.js文件，配置outputRoot參數(shù)：

1.3.4 打包項(xiàng)目

Taro的打包命令同樣有多個(gè)，也分別對(duì)應(yīng)不同端的線上環(huán)境代碼生成。為了方便記憶與語(yǔ)義化，Taro定義了相對(duì)一致的打包線上環(huán)境的代碼命令，以npm為例，如下表所示。

通過(guò)以上命令，可以將Taro項(xiàng)目編譯為不同端線上環(huán)境的代碼，這時(shí)只需要使用各端（除了H5）對(duì)應(yīng)的開(kāi)發(fā)工具發(fā)布項(xiàng)目即可。打包生成線上環(huán)境的代碼相較運(yùn)行本地開(kāi)發(fā)環(huán)境的代碼，做了更多優(yōu)化相關(guān)的處理，例如JavaScript代碼壓縮丑化等。

1.3.5 Taro腳手架命令

Taro腳手架提供了很多功能輔助我們開(kāi)發(fā)，可使用taro--help查看Taro腳手架工具的相關(guān)提示。這里給大家講解開(kāi)發(fā)過(guò)程中常使用的幾個(gè)命令，更多命令可前往Taro官網(wǎng)查看學(xué)習(xí)。

1.更新——update

該命令用來(lái)更新項(xiàng)目中的Taro相關(guān)依賴(lài)或者更新自身的腳手架工具。

更新項(xiàng)目依賴(lài)：

如果用以上方法更新項(xiàng)目依賴(lài)失敗，則可嘗試修改package.json文件指定對(duì)應(yīng)的依賴(lài)版本，然后使用npm或Yarn手動(dòng)安裝。

更新腳手架：

2.環(huán)境及依賴(lài)信息——info

該命令用來(lái)檢測(cè)Taro環(huán)境及依賴(lài)的版本等信息，從而方便開(kāi)發(fā)者查看項(xiàng)目環(huán)境及依賴(lài)，更便捷地排查因開(kāi)發(fā)環(huán)境引起的問(wèn)題。用法如下：

命令執(zhí)行完畢，會(huì)打印出項(xiàng)目的相關(guān)信息，示例如下：

這樣一來(lái)，我們可以發(fā)現(xiàn)當(dāng)前使用的Taro腳手架工具版本為2.2.4。但項(xiàng)目中的依賴(lài)版本卻是2.1.6，此時(shí)需要更新項(xiàng)目依賴(lài)，以保證與Taro腳手架工具版本一致，更新命令為：

3.項(xiàng)目診斷——doctor

該命令可以診斷項(xiàng)目的依賴(lài)、設(shè)置、結(jié)構(gòu)及代碼的規(guī)范是否存在問(wèn)題，診斷結(jié)束后會(huì)嘗試給出對(duì)應(yīng)問(wèn)題的解決方案。使用示例如下：