Capacitor 的官方支持版本是 v1 到 v6。
¥The officially supported versions of Capacitor are v1 through v6.
升级 Capacitor(Upgrading Capacitor)
¥Upgrading Capacitor
如果你之前使用的是较低版本的 Capacitor,并且想要升级到较新版本,则:
¥If you previously used a lower version of Capacitor and you want to upgrade to a newer version, then:
删除 /src-capacitor/ios 和 /src-capacitor/android 文件夹,但请确保你了解在这些文件夹中所做的任何更改,因为你必须在步骤 4 之后重新执行这些更改。
¥Delete the /src-capacitor/ios and /src-capacitor/android folders, but make sure that you are aware of any changes that you made in those folders as you will have to redo them after step 4.
修改 /src-capacitor/package.json 文件以反映 Capacitor 依赖的正确版本(你可以在下一个与你所需的 Capacitor 版本相关的相应部分中阅读它们)。
¥Change /src-capacitor/package.json to reflect the correct versions of Capacitor dependencies (you can read them in the next appropriate section related to your desired Capacitor version).
删除 yarn.lock/package-lock.json,然后在 /src-capacitor 中运行
yarn
/npm install
。¥Delete yarn.lock/package-lock.json then run
yarn
/npm install
in /src-capacitor.此时,Capacitor 已安装完毕。现在你可以运行
quasar dev -m capacitor -T [ios|android]
或quasar build -m capacitor -T [ios|android]
,它将添加与你的 Capacitor 版本对应的升级版 iOS/Android 平台。¥At this point, you will have Capacitor installed. Now you can run
quasar dev -m capacitor -T [ios|android]
orquasar build -m capacitor -T [ios|android]
and it will add the upgraded iOS/Android platform that corresponds to your Capacitor version.
检查 Capacitor 本身的更新日志,了解它有哪些重大变更也是明智之举。
¥It would also be wise to check the changelog of Capacitor itself to see what breaking changes it has.
Capacitor v7(Capacitor v7)
要求
Xcode 16+(适用于 iOS)
¥Xcode 16+ (for iOS)
Xcode 命令行工具
¥Xcode Command Line Tools
Homebrew
Cocoapods
Android Studio 2024.2.1+
Android SDK(API 23+)
假设你已经安装了 Capacitor 模式,/src-capacitor/package.json
中的依赖应如下所示:
¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json
should look like:
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 功能。
¥The @capacitor/app
and @capacitor/splash-screen
are optional, but it helps Quasar with some UI functionality if they are installed.
Capacitor v6(Capacitor v6)
要求
Xcode 15+(适用于 iOS)
¥Xcode 15+ (for iOS)
Android Studio Jellyfish 2023.3.1.18 或更新版本(适用于 Android)
¥Android Studio Jellyfish 2023.3.1.18 or newer (for Android)
假设你已经安装了 Capacitor 模式,/src-capacitor/package.json
中的依赖应如下所示:
¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json
should look like:
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 功能。
¥The @capacitor/app
and @capacitor/splash-screen
are optional, but it helps Quasar with some UI functionality if they are installed.
Capacitor v5(Capacitor v5)
要求
Xcode 14.1+(适用于 iOS)
¥Xcode 14.1+ (for iOS)
Android Studio Flamingo 2022.2.1 或更新版本(适用于 Android)
¥Android Studio Flamingo 2022.2.1 or newer (for Android)
假设你已经安装了 Capacitor 模式,/src-capacitor/package.json
中的依赖应如下所示:
¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json
should look like:
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 功能。
¥The @capacitor/app
and @capacitor/splash-screen
are optional, but it helps Quasar with some UI functionality if they are installed.
Capacitor v4(Capacitor v4)
假设你已经安装了 Capacitor 模式,/src-capacitor/package.json
中的依赖应如下所示:
¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json
should look like:
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 功能。
¥The @capacitor/app
and @capacitor/splash-screen
are optional, but it helps Quasar with some UI functionality if they are installed.
Capacitor v3(Capacitor v3)
已知问题
不支持 HTTPS 开发服务器(通过 quasar.config 文件 > devServer > https: true)。如果你正在使用依赖于 Capacitor 的插件,最好升级到较新支持的 Capacitor 版本。
¥HTTPS devserver (through quasar.config file > devServer > https: true) is not supported. If you are using Capacitor plugins that depend on it, it’s better to upgrade to the newer supported Capacitor versions.
假设你已经安装了 Capacitor 模式,/src-capacitor/package.json
中的依赖应如下所示:
¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json
should look like:
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 功能。
¥The @capacitor/app
and @capacitor/splash-screen
are optional, but it helps Quasar with some UI functionality if they are installed.
更多关于 切换到自动 Android 插件加载 的信息。
¥More info for Switch to automatic Android plugin loading.
Capacitor v2(Capacitor v2)
假设你已经安装了 Capacitor 模式,/src-capacitor/package.json
中的依赖应如下所示:
¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json
should look like:
dependencies: {
"@capacitor/cli": "^2.0.0",
"@capacitor/core": "^2.0.0"
}
Capacitor v1(Capacitor v1)
假设你已经安装了 Capacitor 模式,/src-capacitor/package.json
中的依赖应如下所示:
¥Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json
should look like:
dependencies: {
"@capacitor/cli": "^1.0.0",
"@capacitor/core": "^1.0.0"
}