The officially supported versions of Capacitor are v1, v2 and v3.
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 install
in /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 v3
Known issue
HTTPS devserver (through quasar.config.js > devServer > https: true) is not yet supported. If you are using Capacitor plugins that depend on it, it’s better to stay with Capacitor v2 for the moment.
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" }
The @capacitor/app
and @capacitor/splash-screen
are optional, but it helps Quasar with some UI functionality if they are installed.
More info for Switch to automatic Android plugin loading.
Capacitor v2
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
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" }