本地安装 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。 您将看到一个简陋的页面，欢迎你访问新建的应用程序。