The officially supported versions of Capacitor are v5+.
Upgrading Capacitor
If you previously used a lower version of Capacitor and you want to upgrade to a newer version, then:
- 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.
- 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).
- Delete yarn.lock/package-lock.json then run
yarn/npm installin /src-capacitor. - 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.
It would also be wise to check the changelog of Capacitor itself to see what breaking changes it has.
Capacitor v8
Requirements
- Node v22.21.1+
- Xcode 16+ (for iOS)
- Xcode Command Line Tools
- Homebrew
- Cocoapods
- Android Studio 2024.2.1+
- Android SDK (API 23+)
Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:
dependencies: {
"@capacitor/app": "^8.0.0",
"@capacitor/cli": "^8.0.0",
"@capacitor/core": "^8.0.0",
"@capacitor/splash-screen": "^8.0.0"
}The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.
Capacitor v7
Requirements
- Xcode 16+ (for iOS)
- Xcode Command Line Tools
- Homebrew
- Cocoapods
- Android Studio 2024.2.1+
- Android SDK (API 23+)
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"
}The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.
Capacitor v6
Requirements
- Xcode 15+ (for iOS)
- Android Studio Jellyfish 2023.3.1.18 or newer (for Android)
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"
}The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.
Capacitor v5
Requirements
- Xcode 14.1+ (for iOS)
- Android Studio Flamingo 2022.2.1 or newer (for Android)
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"
}The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.