tutorials/000_local_installation/index.md

commit ef8cd9d90d326549aa3e6b43c2d4b78f846144d0

本地安裝 Dojo

概述

本教程介紹如何在本地安裝 Dojo 環境。

建立 Dojo 應用程式

首先，我們需要建立一個 Dojo 項目。 Dojo 為建立應用程式提供強大和先進的工具。 它提供了一個高效的指令行工具，來簡化安裝過程， 使用以下指令安裝此工具：

npm install -g @dojo/cli

           

該指令會安裝 Dojo 指令行工具（

@dojo/cli

），它簡化建立、測試和建構應用程式等相關的開發任務。

@dojo/cli

工具預設自帶兩個選項：

• ejet

  - 将一個項目與

  @dojo/cli

  工具斷開，允許高階使用者自定義配置

• version

  - 顯示

  @dojo/cli

  版本資訊和已安裝的指令

運作

dojo

指令将顯示所有可用的子指令，即使這些子指令還沒有安裝。當你嘗試運作一個不可用的子指令時，CLI 會列印一條消息提示需要先安裝此指令。

在建立你的第一個 Dojo 應用程式前，請先全局安裝

@dojo/cli-create-app

指令，該指令用于建立項目模闆：

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

           

一旦指令安裝完成，請運作以下指令建立你的 Dojo 項目：

dojo create app --name first-dojo-app

           

{% aside ‘Dojo create arguments’ %} 傳入

dojo create app

的很多參數都有縮寫版本。是以

dojo create app -n first-dojo-app

等價于

dojo create app --name first-dojo-app

。 {% endaside %}

該指令将在建立的 “first-dojo-2-app” 檔案夾下建立 Dojo 應用程式的基本項目結構，并預安裝的所有依賴庫。

就是這麼簡單，此刻我們已成功建立了第一個基本的 Dojo 應用程式，并安裝了它的依賴庫。 現在讓我們看看建立的應用程式能做什麼！ 第一步，我們使用另一個

@dojo/cli

指令。 您不需要自己動手去安裝這個指令，它會随着其他依賴一起安裝。 在終端切換到

first-dojo-app

檔案夾，然後輸入

dojo build --mode dev --watch --serve

指令：

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

           

(或簡寫為

dojo build -m dev -w -s

)

{% aside ‘Production build as a default’ %}

@dojo/cli-build-app

指令預設使用

--mode dist

參數建立一個可用于生産環境的建構。提供的

--mode dev

參數将訓示該指令建立一個對開發友好的建構，友善調試和不間斷的開發。 {% endaside %}

此指令将觸發 Dojo 工具使用 Webpack 建構和 transpile 項目， Webpack 是一款優秀的 JavaScript 源碼優化工具。

--watch

（或

-w

） 标志用于監聽變化，當有任何變化發生并儲存到硬碟後，就立即重新建構項目；而

--serve

（或

-s

）标志會啟動一個輕量級的 web 伺服器，這樣當我們修改一些源碼後，可在浏覽器中即時運作程式。

為了檢視應用程式的功能， 請打開一款主流的 web 浏覽器（如最新版的 Chrome，Edge，Firefox，Internet Explore 或 Safari）， 并導航到 http://localhost:9999。 您将看到一個簡陋的頁面，歡迎你通路建立的應用程式。