本地安裝 Dojo

tutorials/000_local_installation/index.md

commit ef8cd9d90d326549aa3e6b43c2d4b78f846144d0

本地安裝 Dojo

概述

本教程介紹如何在本地安裝 Dojo 環(huán)境。

創(chuàng)建 Dojo 應(yīng)用程序

首先，我們需要?jiǎng)?chuàng)建一個(gè) Dojo 項(xiàng)目。 Dojo 為創(chuàng)建應(yīng)用程序提供強(qiáng)大和先進(jìn)的工具。 它提供了一個(gè)高效的命令行工具，來(lái)簡(jiǎn)化安裝過(guò)程， 使用以下命令安裝此工具：

npm install -g @dojo/cli

該命令會(huì)安裝 Dojo 命令行工具（@dojo/cli），它簡(jiǎn)化創(chuàng)建、測(cè)試和構(gòu)建應(yīng)用程序等相關(guān)的開(kāi)發(fā)任務(wù)。 @dojo/cli 工具默認(rèn)自帶兩個(gè)選項(xiàng)：

• ejet - 將一個(gè)項(xiàng)目與 @dojo/cli 工具斷開(kāi)，允許高階用戶自定義配置
• version - 顯示 @dojo/cli 版本信息和已安裝的命令

運(yùn)行 dojo 命令將顯示所有可用的子命令，即使這些子命令還沒(méi)有安裝。當(dāng)你嘗試運(yùn)行一個(gè)不可用的子命令時(shí)，CLI 會(huì)打印一條消息提示需要先安裝此命令。

在創(chuàng)建你的第一個(gè) Dojo 應(yīng)用程序前，請(qǐng)先全局安裝 @dojo/cli-create-app 命令，該命令用于創(chuàng)建項(xiàng)目模板：

npm install -g @dojo/cli-create-app

一旦命令安裝完成，請(qǐng)運(yùn)行以下命令創(chuàng)建你的 Dojo 項(xiàng)目：

dojo create app --name first-dojo-app

{% aside 'Dojo create arguments' %}
傳入 dojo create app 的很多參數(shù)都有縮寫版本。所以 dojo create app -n first-dojo-app 等價(jià)于 dojo create app --name first-dojo-app。
{% endaside %}

該命令將在新建的 “first-dojo-2-app” 文件夾下創(chuàng)建 Dojo 應(yīng)用程序的基本項(xiàng)目結(jié)構(gòu)，并預(yù)安裝的所有依賴庫(kù)。

就是這么簡(jiǎn)單，此刻我們已成功創(chuàng)建了第一個(gè)基本的 Dojo 應(yīng)用程序，并安裝了它的依賴庫(kù)。 現(xiàn)在讓我們看看新建的應(yīng)用程序能做什么！ 第一步，我們使用另一個(gè) @dojo/cli 命令。 您不需要自己動(dòng)手去安裝這個(gè)命令，它會(huì)隨著其他依賴一起安裝。 在終端切換到 first-dojo-app 文件夾，然后輸入 dojo build --mode dev --watch --serve 命令：

cd first-dojo-app
dojo build --mode dev --watch --serve

(或簡(jiǎn)寫為 dojo build -m dev -w -s)

{% aside 'Production build as a default' %}
@dojo/cli-build-app 命令默認(rèn)使用 --mode dist 參數(shù)創(chuàng)建一個(gè)可用于生產(chǎn)環(huán)境的構(gòu)建。提供的 --mode dev 參數(shù)將指示該命令創(chuàng)建一個(gè)對(duì)開(kāi)發(fā)友好的構(gòu)建，方便調(diào)試和不間斷的開(kāi)發(fā)。
{% endaside %}

此命令將觸發(fā) Dojo 工具使用 Webpack 構(gòu)建和 transpile 項(xiàng)目， Webpack 是一款優(yōu)秀的 JavaScript 源碼優(yōu)化工具。 --watch（或 -w） 標(biāo)志用于監(jiān)聽(tīng)變化，當(dāng)有任何變化發(fā)生并保存到硬盤后，就立即重新構(gòu)建項(xiàng)目；而 --serve （或 -s）標(biāo)志會(huì)啟動(dòng)一個(gè)輕量級(jí)的 web 服務(wù)器，這樣當(dāng)我們修改一些源碼后，可在瀏覽器中即時(shí)運(yùn)行程序。

為了查看應(yīng)用程序的功能， 請(qǐng)打開(kāi)一款主流的 web 瀏覽器（如最新版的 Chrome，Edge，F(xiàn)irefox，Internet Explore 或 Safari）， 并導(dǎo)航到 http://localhost:9999。 您將看到一個(gè)簡(jiǎn)陋的頁(yè)面，歡迎你訪問(wèn)新建的應(yīng)用程序。