官方支持的 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 v6@quasar/app-webpack v3.9+
要求
- 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-webpack v3.9+
要求
- 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-webpack v3.9+
假设您已安装 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 > server > type: “https”)不受支持。如果您正在使用依赖于它的 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 功能。
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"
}