官方支持的 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-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"
}