feat: include option to force cordova inclusion

cli/src/android/update.ts

@@ -37,12 +37,15 @@ export async function updateAndroid(config: Config): Promise<void> {
   printPlugins(capacitorPlugins, 'android');
 
   const cordovaPlugins = plugins.filter((p) => getPluginType(p, platform) === PluginType.Cordova);
-  const enableCordova = cordovaPlugins.length > 0;
+  const enableCordova = cordovaPlugins.length > 0 || config.app.forceCordova;
 
   await writePluginsJson(config, capacitorPlugins, enableCordova);
   await removePluginsNativeFiles(config);
   if (enableCordova) {
     logger.info('Found Cordova Plugins: Including Android Cordova Support');
+    if (config.app.forceCordova) {
+      logger.info('Cordova support installation has been forced');
+    }
     await copyPluginsNativeFiles(config, cordovaPlugins);
   }
   if (!(await pathExists(config.android.webDirAbs))) {
@@ -157,7 +160,7 @@ export async function installGradlePlugins(
     );
   }
 
-  const enableCordova = cordovaPlugins.length > 0;
+  const enableCordova = cordovaPlugins.length > 0 || config.app.forceCordova;
 
   const capacitorAndroidPath = resolve(dirname(capacitorAndroidPackagePath), 'capacitor');
   const capacitorCordovaAndroidPath = resolve(dirname(capacitorAndroidPackagePath), 'capacitor-cordova');

cli/src/config.ts

@@ -53,6 +53,7 @@ export async function loadConfig(): Promise<Config> {
   const appId = conf.extConfig.appId ?? '';
   const appName = conf.extConfig.appName ?? '';
   const webDir = conf.extConfig.webDir ?? 'www';
+  const forceCordova = conf.extConfig.forceCordovaInclusion ?? false;
   const cli = await loadCLIConfig(cliRootDir);
 
   const config: Config = {
@@ -66,6 +67,7 @@ export async function loadConfig(): Promise<Config> {
       appName,
       webDir,
       webDirAbs: resolve(appRootDir, webDir),
+      forceCordova,
       package: (await tryFn(readJSON, resolve(appRootDir, 'package.json'))) ?? {
         name: appName,
         version: '1.0.0',

cli/src/declarations.ts

@@ -85,6 +85,15 @@ export interface CapacitorConfig {
    */
   initialFocus?: boolean;
 
+  /**
+   * If set, will include Cordova support libraries regardless
+   * of whether or not they are needed by plugins.
+   *
+   * @since 9.0.0
+   * @default false
+   */
+  forceCordovaInclusion?: boolean;
+
   android?: {
     /**
      * Specify a custom path to the native Android project.

cli/src/definitions.ts

@@ -65,6 +65,7 @@ export interface AppConfig {
   readonly extConfigName: string;
   readonly extConfigFilePath: string;
   readonly extConfig: ExternalConfig;
+  readonly forceCordova: boolean;
 }
 
 export interface AndroidConfig extends PlatformConfig {

cli/src/ios/update.ts

@@ -43,10 +43,13 @@ export async function updateIOS(config: Config, deployment: boolean): Promise<vo
 async function updatePluginFiles(config: Config, plugins: Plugin[], deployment: boolean) {
   await removePluginsNativeFiles(config);
   const cordovaPlugins = plugins.filter((p) => getPluginType(p, platform) === PluginType.Cordova);
-  const enableCordova = cordovaPlugins.length > 0;
+  const enableCordova = cordovaPlugins.length > 0 || config.app.forceCordova;
 
   if (enableCordova) {
     logger.info('Found Cordova Plugins: Including iOS Cordova Support');
+    if (config.app.forceCordova) {
+      logger.info('Cordova support installation has been forced');
+    }
     await copyPluginsNativeFiles(config, cordovaPlugins);
   }
 

cli/src/util/spm.ts

@@ -101,7 +101,7 @@ export async function generatePackageText(config: Config, plugins: Plugin[]): Pr
   const iosPlatformVersion = await getCapacitorPackageVersion(config, config.ios.name);
   const iosVersion = getMajoriOSVersion(config);
   const cordovaPlugins = await getCordovaPlugins(config, 'ios');
-  const enableCordova = cordovaPlugins.length > 0;
+  const enableCordova = cordovaPlugins.length > 0 || config.app.forceCordova;
   const packageTraits = config.app.extConfig.experimental?.ios?.spm?.packageTraits ?? {};
   const packageOptions = config.app.extConfig.experimental?.ios?.spm?.packageOptions ?? {};
   const swiftToolsVersion = config.app.extConfig.experimental?.ios?.spm?.swiftToolsVersion ?? '5.9';

cli/test/framework-detection.spec.ts

@@ -15,6 +15,7 @@ describe('framework detection', () => {
         appName: 'appName',
         webDir: '',
         webDirAbs: '',
+        forceCordova: false,
         package: {
           name: 'package-name',
           version: '0.0.0',