官方支持的 Capacitor 版本是从 v1 到 v6。
升级 Capacitor
如果以前使用的是低版本的 Capacitor,而现在想升级到较新的版本,那么:
- 删除 /src-capacitor/ios 和 /src-capacitor/android 文件夹,但要确保您清楚在这些文件夹中所做的任何改动,因为在第 4 步之后将不得不重做这些改动。
- 修改 /src-capacitor/package.json 文件中 Capacitor 依赖版本(可以在下面与所需 Capacitor 版本对应的章节中查看具体版本号)。
- 删除 yarn.lock/package-lock.json 文件后在 /src-capacitor 目录中运行
yarn/npm install命令。 - 在这一步中,将会安装好 Capacitor。现在可以运行
quasar dev -m capacitor -T [ios|android]或者quasar build -m capacitor -T [ios|android]命令,这将添加与您的 Capacitor 版本对应的升级后的 iOS/Android 平台。
检查 Capacitor 本身的更新日志,看看它有哪些破坏性变更,也是明智之举。
Capacitor v8
环境要求
- Node v22.21.1+
- 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": "^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 功能。
Capacitor v4
假设您已经安装了 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 开发服务器(通过 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"
}