feat: include option to force cordova inclusion

Signed-off-by: Mark Anderson <mark.anderson@outsystems.com>

Author: markemer

cli/src/android/update.ts

@@ -37,7 +37,7 @@ 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);

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,7 +43,7 @@ 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');

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';