应用程序扩展

应用程序扩展可以为 Quasar 应用注入各种库与依赖项、启动文件、模板或自定义逻辑。它们可以扩展 webpack、quasar.config 文件,将外部 UI 组件与核心紧密耦合,甚至在 Quasar CLI 中注册新命令。它们可以通过 quasar dev 运行,并且可以访问当前实时的 ctx(上下文)。

开发模式实际上打开了使 Quasar 成为最具可扩展性和功能强大的框架之一的大门——现在只受您的想象力和创新的限制。本页将向您介绍应用程序扩展的用法。

WARNING

应用扩展专为仅适用于 Quasar CLI 而设计。这意味着您将无法在 Quasar Vite 插件、Vue CLI 或 UMD 环境中安装或运行它们。

应用扩展能做什么?

  1. 使用新命令增强 CLI 行为
  2. 制作 Quasar UI 插件
  3. 安装配套应用程序
  4. 创建和共享自定义组件
  5. 为框架或其他应用程序创建和共享附加功能
  6. 构建、启动和控制 API 服务器
  7. 组合和扩展 Quasar 核心组件
  8. 根据动态变化的值修改代码,这些值位于 Quasar 环境之外
  9. 创建和管理特定平台接口的抽象
  10. … 还有很多

应用扩展取代了创建自定义启动套件的需要。您添加到官方启动套件之上的任何内容都可以采用应用扩展的形式。这还消除了维护非官方启动套件与官方套件同步的维护开销,因此我们可以确保每个开发人员始终能够获得最新和最棒的 Quasar 规格。

应用扩展 ext-id

所有应用扩展必须以 quasar-app-extension- 为前缀命名。在此前缀之后的所有内容被视为其短别名。在文档中,我们称之为 ext-id

例如:

  • quasar-app-extension-awesomenessext-idawesomeness
  • @some-npm-org/quasar-app-extension-awesomenessext-id@some-npm-org/awesomeness

这种命名方案的好处之一是,在搜索其 npm 包时,使 Quasar 应用扩展易于发现:应用扩展 - 发现

应用扩展的解剖

应用扩展可以安装、执行,也可以卸载。以下指南以一种抽象的方式讨论了这一点。有关单个扩展及如何使用它们的详细信息,请查阅它们各自的存储库。

安装应用扩展

$ quasar ext add <ext-id>

此命令将查找并安装扩展的模块。安装完成后,可能会有一个或多个提示,询问您进行选择或添加扩展所需的信息。安装完成后,您将返回到命令行。

列出已安装的应用扩展

有几种方法可以“查询”已安装的应用扩展:

$ quasar ext
$ quasar info
$ cat quasar.extensions.json

“运行”应用扩展

没有一种运行应用扩展的方法,因为其中一些甚至可能没有任何要运行的代码(即仅为项目中特定文件夹复制的模板文件),而其他一些可能仅是安装助手,而其他一些可能选择向 Quasar CLI 添加新命令。

尽管如此,每个应用扩展都将在 quasar devquasar build 期间初始化。

更新应用扩展

您可能需要更新扩展,这可以通过与用于安装的相同命令完成:

$ quasar ext add <ext-id>

::: 警告 重新安装扩展可能会覆盖您更改的文件。您将有选择覆盖检测到的文件的选项。 :::

移除应用扩展

您可以通过运行此命令从 Quasar CLI 中删除应用扩展。取决于作者和扩展本身,您可能需要手动清理文件。

$ quasar ext remove <ext-id>

官方应用扩展列表

查看发现应用扩展页面。