官方支持的 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 中的依赖项应该是这样的:
{
"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 中的依赖项应该是这样的:
{
"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 中的依赖项应该是这样的:
{
"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 中的依赖项应该是这样的:
{
"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 行为。