Quasar CLI 安装

确保您的计算机上安装了Node>=10和NPM>=5。

WARNING

**不要使用任何高于12+**的Node版本。Webpack 4不支持任何高于12的Nod版本(支持Node 12),如果不进行重大更改,我们无法移动到Webpack 5。如果您需要Node.js 14+,请查看可替代的Quasar v2(基于Webpack 5)。

WARNING

**不要使用非偶数的Node版本,例如11,13等等。**这些版本没有用Quasar进行测试,并且由于它们的实验性质,经常会引起问题。我们强烈建议始终使用Node的LTS版本。

# Node.js> = 10是必需的。

$ yarn global add @quasar/cli
# 或者
$ npm install -g @quasar/cli

:: tip 如果使用的是Yarn,请确保Yarn全局安装位置在PATH中:

# 在~/.bashrc或等效文件中
export PATH="$(yarn global bin):$PATH"

在Windows下,修改用户的PATH环境变量。如果使用yarn,则添加%LOCALAPPDATA%\yarn\bin,否则,如果使用npm,则添加%APPDATA%\npm。 :::

然后我们使用Quasar CLI创建一个项目文件夹:

$ yarn create quasar
# 或:
$ npm init quasar

# ..然后选择“App with Quasar CLI”和“Quasar v1”选项

TIP

一些高级场景需要使用自定义的入门套件(例如测试或个人预置)。在那些罕见的情况下,您可以使用--kit选项。在创建命令描述中阅读更多关于这个选项的信息。记住,推荐的方法是编写一个Quasar应用扩展。

WSL2

微软推荐的在WSL2中的安装Nodejs开发环境

使用WSL2(Windows Subsystem for Linux)时Microsoft推荐将文件保存在linux文件系统中以最大限度地提高性能。如果项目文件在Windows挂载上而不是本地linux文件系统上,项目的构建速度将慢3倍,而且HMR(热模块重新加载)将无法工作(没有黑客)。在Docker for Windows开发环境中也是如此。

请注意,如果要构建可用的平台,则不需要单独的项目。 这个项目可以无缝地处理所有这些项目。

要继续学习Quasar,您应该深入了解Quasar CLI,因为您将大量使用它。

如何运作

Quasar CLI由两个软件包组成:@quasar/cli@quasar/app。 第一个是可选的,只允许您创建项目文件夹并全局运行Quasar命令。 第二个包是它的核心,它被安装到每个Quasar项目文件夹中。

生成项目文件夹后,Quasar CLI将仅帮助全局运行@quasar/app命令。 此时你不需要它的任何其他东西。 为确保完全独立于Quasar CLI,您可以编写npm脚本(在package.json中)以运行Quasar命令。 @quasar/app(特定于每个项目)将运行所有CLI命令。

在你的package.json中添加几个npm脚本的例子:

// package.json
"scripts": {
  "dev": "quasar dev",
  "build": "quasar build",
  "build:pwa": "quasar build -m pwa"
}

如果您愿意,以上配置将允许您运行$ yarn dev$ yarn build而无需全局安装@quasar/cli

或者,您甚至可以使用npx运行quasar命令,而无需全局安装@quasar/cli。。

$ npx quasar dev