应用程序扩展
应用程序扩展可以为 Quasar 应用注入各种库与依赖项、启动文件、模板或自定义逻辑。它们可以扩展 webpack、quasar.config
文件,将外部 UI 组件与核心紧密耦合,甚至在 Quasar CLI 中注册新命令。它们可以通过 quasar dev
运行,并且可以访问当前实时的 ctx
(上下文)。
开发模式实际上打开了使 Quasar 成为最具可扩展性和功能强大的框架之一的大门——现在只受您的想象力和创新的限制。本页将向您介绍应用程序扩展的用法。
WARNING
应用扩展专为仅适用于 Quasar CLI 而设计。这意味着您将无法在 Quasar Vite 插件、Vue CLI 或 UMD 环境中安装或运行它们。
应用扩展能做什么?
- 使用新命令增强 CLI 行为
- 制作 Quasar UI 插件
- 安装配套应用程序
- 创建和共享自定义组件
- 为框架或其他应用程序创建和共享附加功能
- 构建、启动和控制 API 服务器
- 组合和扩展 Quasar 核心组件
- 根据动态变化的值修改代码,这些值位于 Quasar 环境之外
- 创建和管理特定平台接口的抽象
- … 还有很多
应用扩展取代了创建自定义启动套件的需要。您添加到官方启动套件之上的任何内容都可以采用应用扩展的形式。这还消除了维护非官方启动套件与官方套件同步的维护开销,因此我们可以确保每个开发人员始终能够获得最新和最棒的 Quasar 规格。
应用扩展 ext-id
所有应用扩展必须以 quasar-app-extension-
为前缀命名。在此前缀之后的所有内容被视为其短别名。在文档中,我们称之为 ext-id
。
例如:
quasar-app-extension-awesomeness
的ext-id
是awesomeness
@some-npm-org/quasar-app-extension-awesomeness
的ext-id
是@some-npm-org/awesomeness
这种命名方案的好处之一是,在搜索其 npm 包时,使 Quasar 应用扩展易于发现:应用扩展 - 发现。
应用扩展的解剖
应用扩展可以安装、执行,也可以卸载。以下指南以一种抽象的方式讨论了这一点。有关单个扩展及如何使用它们的详细信息,请查阅它们各自的存储库。
安装应用扩展
$ quasar ext add <ext-id>
此命令将查找并安装扩展的模块。安装完成后,可能会有一个或多个提示,询问您进行选择或添加扩展所需的信息。安装完成后,您将返回到命令行。
列出已安装的应用扩展
有几种方法可以“查询”已安装的应用扩展:
$ quasar ext
$ quasar info
$ cat quasar.extensions.json
“运行”应用扩展
没有一种运行应用扩展的方法,因为其中一些甚至可能没有任何要运行的代码(即仅为项目中特定文件夹复制的模板文件),而其他一些可能仅是安装助手,而其他一些可能选择向 Quasar CLI 添加新命令。
尽管如此,每个应用扩展都将在 quasar dev
和 quasar build
期间初始化。
更新应用扩展
您可能需要更新扩展,这可以通过与用于安装的相同命令完成:
$ quasar ext add <ext-id>
::: 警告 重新安装扩展可能会覆盖您更改的文件。您将有选择覆盖检测到的文件的选项。 :::
移除应用扩展
您可以通过运行此命令从 Quasar CLI 中删除应用扩展。取决于作者和扩展本身,您可能需要手动清理文件。
$ quasar ext remove <ext-id>
官方应用扩展列表
查看发现应用扩展页面。