Monaca Now Supports Cordova 12: Upgrade Details and Steps Inside
We are excited to announce that Monaca now supports Cordova 12.
The OS versions supported in Cordova 12 projects are as follows. Please note that the Android platform version has been updated to 12.0.0 with Cordova 12, which might impact existing applications.
Android
- Cordova Android Platform: 12.0.0 (API Level 33)
- Gradle Version: 7.6
iOS
- Cordova iOS Platform: 6.2.0
- Xcode: 14.2
How to Upgrade Your Project
To upgrade your current project to Cordova 12, please follow these steps:
- Open the target project.
- Click on “Settings” in the header menu.
- Click on “Manage Cordova Plugins.”
- Click on “Upgrade to 12.0.0” as shown in the diagram below.
Splash Screen Settings (Applicable only to Android)
Starting with Android Platform version 12, splash screen settings will be limited to “Auto-resize mode” only.
In the Auto-resize mode, users set a single splash screen image and the background color for the splash screen image.
During the project upgrade process, your settings will be automatically updated to Auto-resize mode. Please verify the splash screen image set in Auto-resize mode when building the app.
Issues with Camera and Media Capture Plugins on Android 13 and Monaca’s Solution
There are identified issues with the Camera and Media Capture plugins not functioning correctly on Android 13.
To address this, Monaca has prepared patched versions of these plugins. Until the official Cordova plugins resolve this issue, please make use of the following patched plugins provided by Monaca:
- Camera Plugin: https://github.com/monaca-plugins/cordova-plugin-camera.git#6.0.0-monaca.1
- Media Capture Plugin: https://github.com/monaca-plugins/cordova-plugin-media-capture.git#4.0.0-monaca.1
To install the plugins, please use the Cordova Plugin Management interface and install using the provided URLs.
Solution to Build Error: File Plugin Dependency Issue
The following plugins might cause build errors due to their dependency on the file plugin:
- Media Plugin (cordova-plugin-media)
- Media Capture Plugin (cordova-plugin-media-capture)
- Camera Plugin (cordova-plugin-camera)
To resolve this, we recommend disabling the file plugin and then reinstalling it.
Status Bar Plugin Not Included in the Store Version of Android Debugger
The Android Debugger available on the Google Play Store does not include the status bar plugin. This is due to specification changes from version 3 of the status bar plugin, which made it difficult to verify its operation on the Android Debugger.
When verifying the operation of the status bar plugin, please conduct a debug build for Android and check there.
Available Cordova Versions for Individual Plans
For individual plans (Free/Pro plans), the latest 2 versions (Cordova 12,11) are available.
If you wish to continue using your project with Cordova 10, an upgrade to a Business plan or higher is required.
Project Downgrade
Projects that have been upgraded cannot be downgraded to a previous version. However, an automatic backup of the previous version of the project is created during the upgrade. Please use that for any necessary reverts.
