确保您的计算机上安装了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