Cordova Engine and Plugin Version Compatibility Documentation
This documentation outlines how different versions of the Cordova Android Engine are compatible with specific versions of Cordova plugins. The Neptune Mobile Build Service implements code to adjust the spec attribute of various Cordova plugins based on the selected Android Engine version. It also manages the plugin versions for iOS.
Android Engine Versions
| Android Engine Version | cordova-plugin-file | cordova-plugin-media | cordova-plugin-media-capture |
|---|---|---|---|
androidEngine11 |
^7.0.0 |
- |
- |
androidEngine10 |
^7.0.0 |
- |
- |
androidEngine9 |
^6.0.0 |
^5.0.0 |
^3.0.0 |
iOS Plugin Version Setup
For iOS, regardless of the Android Engine version, the code sets the plugin versions as follows:
- cordova-plugin-file
-
^7.0.0
- cordova-plugin-media
-
^6.0.0
- cordova-plugin-media-capture
-
^4.0.0
Combined Android and iOS
When building for both Android and iOS, if the selected Android Engine version is androidEngine9, then the plugin versions will be:
- cordova-plugin-file
-
^6.0.0
- cordova-plugin-media
-
^5.0.0
- cordova-plugin-media-capture
-
^3.0.0
Deprecation of Cordova Android 9
The Cordova Android 9 package is officially deprecated. If you build applications using Cordova Android 9, you will encounter errors and failed builds.
If you still rely on Cordova Android 9 to build applications and require a
temporary fix, there is a workaround that involves adjusting your projects build.gradle
files and making sure dependencies are compatible with newer Android build tools
(see the workaround guide that walks you through common build errors with Cordova
Android 9 - How to fix Cordova Android 9 build errors - Neptune Community).
|
While this workaround can help in the short term, Neptune strongly recommends that you migrate your project to a newer version of Cordova to ensure long-term support, compatibility, and security.
To ensure compatibility, performance, and security, all builds using Cordova Android 12 or higher automatically leverage the latest stable versions of Cordova and its core plugins. This means that your apps benefit from the most recent updates, bug fixes, and improvements without requiring manual adjustments.
By staying up-to-date with plugin versions, Cordova Android 12 (or higher) avoids many of the build and compatibility issues seen in older platform versions. This also helps to ensure that your application is aligned with the latest Android SDK requirements and best practices.