本地安装 Dojo

luojinxu0 2019-06-30

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

相关推荐