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
androidEngine12	^7.0.0	^6.0.0	^4.0.0
androidEngine11	^7.0.0	-	-
androidEngine10	^7.0.0	-	-
androidEngine9	^6.0.0	^5.0.0	^3.0.0

Android Engine Version

cordova-plugin-file

cordova-plugin-media

cordova-plugin-media-capture

androidEngine12

^7.0.0

^6.0.0

^4.0.0

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

Special Notes

For Android Engine Version 9, Cordova will self-heal by fetching cordova-plugin-file version 6 if no spec is provided. Android Engine Version 9 and iOS will not build together. This limitation is accepted for now.