本地安裝 Dojo

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。 您將看到一個簡陋的頁面，歡迎你訪問新建的應用程序。