Skip to page content
Quasar CLI with Vite - @quasar/app-vite

Capacitor 版本

官方支持的 Capacitor 版本是 v5+。

升级 Capacitor

如果以前使用的是低版本的 Capacitor,而现在想升级到较新的版本,那么:

请遵循 Capacitor 官方的升级指南,使用文档的版本选择器来升级到对应的主版本。指南涵盖了依赖更新、原生项目迁移和必要的工具链变更——这些都无法仅通过修改 package 版本来安全处理。

升级之前,请提交或备份 /src-capacitor,包括任何原生改动。在 /src-capacitor 目录中执行迁移命令,使用项目已选择的 lockfile 和包管理器,升级后验证两个原生平台。

检查 Capacitor 本身的更新日志,看看它有哪些破坏性变更,也是明智之举。

Capacitor v8

环境要求
  • Node v22.22+
  • Xcode 26+(用于 iOS)
  • Xcode Command Line Tools
  • iOS 15+
  • Android Studio Otter 2025.2.1+
  • Android SDK(最低 API 24;编译和目标 API 36)

Capacitor v8 在添加新的 iOS 平台时默认使用 Swift Package Manager。只有在维护或显式创建基于 CocoaPods 的 iOS 项目时才需要 CocoaPods。

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/src-capacitor/package.json

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

其中,@capacitor/app@capacitor/splash-screen 插件是可选的,但安装它们可以让 Quasar 提供额外的 UI 行为。

Capacitor v7

环境要求
  • Xcode 16+(用于 iOS)
  • Xcode Command Line Tools
  • Homebrew
  • CocoaPods
  • Android Studio 2024.2.1+
  • Android SDK(API 23+)

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/src-capacitor/package.json

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

其中,@capacitor/app@capacitor/splash-screen 插件是可选的,但安装它们可以让 Quasar 提供额外的 UI 行为。

Capacitor v6

环境要求
  • Xcode 15+(用于 iOS)
  • Android Studio Jellyfish 2023.3.1.18 或更高版本(用于 Android)

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/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

环境要求
  • Xcode 14.1+(用于 iOS)
  • Android Studio Flamingo 2022.2.1 或更高版本(用于 Android)

假设您已经安装了 Capacitor 模式,那么您的 /src-capacitor/package.json 中的依赖项应该是这样的:

/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 行为。