为什么捐赠
API 探索器
升级指南
NEW!
quasar.config 文件
将项目转换为使用 Vite 的 CLI
浏览器兼容性
支持 TypeScript
目录结构
命令列表
CSS 预处理器
路由
延迟加载 - 代码拆分
处理资产
启动文件
预取功能
API 代理
处理 Vite
处理 process.env
使用 Pinia 进行状态管理
使用 Vuex 进行状态管理
代码检查器
测试与审计
开发移动应用程序
Ajax 请求
向公众开放开发服务器
使用 Vite 的 Quasar CLI - @quasar/app-vite
Capacitor 版本

官方支持的 Capacitor 版本是 v1 到 v6。

升级 Capacitor

如果您之前使用的是较低版本的 Capacitor,并且想要升级到较新的版本,那么

  1. 删除 /src-capacitor/ios 和 /src-capacitor/android 文件夹,但请确保您知道在这些文件夹中所做的任何更改,因为您需要在步骤 4 之后重新执行这些更改。
  2. 更改 /src-capacitor/package.json 以反映 Capacitor 依赖项的正确版本(您可以在与您所需的 Capacitor 版本相关的下一个适当部分中读取这些版本)。
  3. 删除 yarn.lock/package-lock.json,然后在 /src-capacitor 中运行 yarn / npm install
  4. 此时,您将安装 Capacitor。现在您可以运行 quasar dev -m capacitor -T [ios|android]quasar build -m capacitor -T [ios|android],它将添加与您的 Capacitor 版本相对应的升级后的 iOS/Android 平台。

查看 Capacitor 自身的更改日志,了解其重大更改也是明智之举。

Capacitor v6
@quasar/app-vite v1.4+

需求

  • Xcode 15+(适用于 iOS)
  • Android Studio Jellyfish 2023.3.1.18 或更高版本(适用于 Android)

假设您已经安装了 Capacitor 模式,以下是 /src-capacitor/package.json 中的依赖项应有的样子

dependencies: {
  "@capacitor/app": "^6.0.0",
  "@capacitor/cli": "^6.0.0",
  "@capacitor/core": "^6.0.0",
  "@capacitor/splash-screen": "^6.0.0"
}

@capacitor/app@capacitor/splash-screen 是可选的,但如果安装了它们,它将帮助 Quasar 完成一些 UI 功能。

Capacitor v5
@quasar/app-vite v1.4+

需求

  • Xcode 14.1+(适用于 iOS)
  • Android Studio Flamingo 2022.2.1 或更高版本(适用于 Android)

假设您已经安装了 Capacitor 模式,以下是 /src-capacitor/package.json 中的依赖项应有的样子

dependencies: {
  "@capacitor/app": "^5.0.0",
  "@capacitor/cli": "^5.0.0",
  "@capacitor/core": "^5.0.0",
  "@capacitor/splash-screen": "^5.0.0"
}

@capacitor/app@capacitor/splash-screen 是可选的,但如果安装了它们,它将帮助 Quasar 完成一些 UI 功能。

Capacitor v4
@quasar/app-vite v1.4+

假设您已经安装了 Capacitor 模式,以下是 /src-capacitor/package.json 中的依赖项应有的样子

dependencies: {
  "@capacitor/app": "^4.0.0",
  "@capacitor/cli": "^4.0.0",
  "@capacitor/core": "^4.0.0",
  "@capacitor/splash-screen": "^4.0.0"
}

@capacitor/app@capacitor/splash-screen 是可选的,但如果安装了它们,它将帮助 Quasar 完成一些 UI 功能。

Capacitor v3

已知问题

不支持 HTTPS devserver(通过 quasar.config 文件 > devServer > https: true)。如果您使用的是依赖于它的 Capacitor 插件,最好升级到较新的支持的 Capacitor 版本。

假设您已经安装了 Capacitor 模式,以下是 /src-capacitor/package.json 中的依赖项应有的样子

dependencies: {
  "@capacitor/app": "^1.0.0",
  "@capacitor/cli": "^3.0.0",
  "@capacitor/core": "^3.0.0",
  "@capacitor/splash-screen": "^1.0.0"
}

@capacitor/app@capacitor/splash-screen 是可选的,但如果安装了它们,它将帮助 Quasar 完成一些 UI 功能。

有关更多信息,请参见 切换到自动 Android 插件加载.

Capacitor v2

假设您已经安装了 Capacitor 模式,以下是 /src-capacitor/package.json 中的依赖项应有的样子

dependencies: {
  "@capacitor/cli": "^2.0.0",
  "@capacitor/core": "^2.0.0"
}

Capacitor v1

假设您已经安装了 Capacitor 模式,以下是 /src-capacitor/package.json 中的依赖项应有的样子

dependencies: {
  "@capacitor/cli": "^1.0.0",
  "@capacitor/core": "^1.0.0"
}