feat(android): Add android.minWebviewVersion configuration option

android/capacitor/src/main/java/com/getcapacitor/Bridge.java

@@ -77,7 +77,6 @@ public class Bridge {
     private static final String BUNDLE_PLUGIN_CALL_BUNDLE_KEY = "capacitorLastPluginCallBundle";
     private static final String LAST_BINARY_VERSION_CODE = "lastBinaryVersionCode";
     private static final String LAST_BINARY_VERSION_NAME = "lastBinaryVersionName";
-    private final int MINIMUM_ANDROID_WEBVIEW_VERSION = 60;
     private static final String MINIMUM_ANDROID_WEBVIEW_ERROR = "System WebView is not supported";
 
     // The name of the directory we use to look for index.html and the rest of our web assets
@@ -86,6 +85,8 @@ public class Bridge {
     public static final String CAPACITOR_HTTPS_SCHEME = "https";
     public static final String CAPACITOR_FILE_START = "/_capacitor_file_";
     public static final String CAPACITOR_CONTENT_START = "/_capacitor_content_";
+    public static final int DEFAULT_ANDROID_WEBVIEW_VERSION = 60;
+    public static final int MINIMUM_ANDROID_WEBVIEW_VERSION = 55;
 
     // Loaded Capacitor config
     private CapConfig config;
@@ -306,7 +307,7 @@ public boolean isMinimumWebViewInstalled() {
             PackageInfo info = WebView.getCurrentWebViewPackage();
             String majorVersionStr = info.versionName.split("\\.")[0];
             int majorVersion = Integer.parseInt(majorVersionStr);
-            return majorVersion >= MINIMUM_ANDROID_WEBVIEW_VERSION;
+            return majorVersion >= config.getMinWebViewVersion();
         }
 
         // Otherwise manually check WebView versions
@@ -318,7 +319,7 @@ public boolean isMinimumWebViewInstalled() {
             PackageInfo info = pm.getPackageInfo(webViewPackage, 0);
             String majorVersionStr = info.versionName.split("\\.")[0];
             int majorVersion = Integer.parseInt(majorVersionStr);
-            return majorVersion >= MINIMUM_ANDROID_WEBVIEW_VERSION;
+            return majorVersion >= config.getMinWebViewVersion();
         } catch (Exception ex) {
             Logger.warn("Unable to get package info for 'com.google.android.webview'" + ex.toString());
         }
@@ -327,7 +328,7 @@ public boolean isMinimumWebViewInstalled() {
             PackageInfo info = pm.getPackageInfo("com.android.webview", 0);
             String majorVersionStr = info.versionName.split("\\.")[0];
             int majorVersion = Integer.parseInt(majorVersionStr);
-            return majorVersion >= MINIMUM_ANDROID_WEBVIEW_VERSION;
+            return majorVersion >= config.getMinWebViewVersion();
         } catch (Exception ex) {
             Logger.warn("Unable to get package info for 'com.android.webview'" + ex.toString());
         }

android/capacitor/src/main/java/com/getcapacitor/CapConfig.java

@@ -1,6 +1,8 @@
 package com.getcapacitor;
 
 import static com.getcapacitor.Bridge.CAPACITOR_HTTP_SCHEME;
+import static com.getcapacitor.Bridge.DEFAULT_ANDROID_WEBVIEW_VERSION;
+import static com.getcapacitor.Bridge.MINIMUM_ANDROID_WEBVIEW_VERSION;
 import static com.getcapacitor.FileUtils.readFile;
 
 import android.content.Context;
@@ -43,6 +45,7 @@ public class CapConfig {
     private boolean webContentsDebuggingEnabled = false;
     private boolean loggingEnabled = true;
     private boolean initialFocus = true;
+    private int minWebViewVersion = DEFAULT_ANDROID_WEBVIEW_VERSION;
     private String errorPath;
 
     // Embedded
@@ -125,6 +128,7 @@ private CapConfig(Builder builder) {
         this.webContentsDebuggingEnabled = builder.webContentsDebuggingEnabled;
         this.loggingEnabled = builder.loggingEnabled;
         this.initialFocus = builder.initialFocus;
+        this.minWebViewVersion = builder.minWebViewVersion;
         this.errorPath = builder.errorPath;
 
         // Embedded
@@ -180,6 +184,7 @@ private void deserializeConfig(@Nullable Context context) {
                 "android.allowMixedContent",
                 JSONUtils.getBoolean(configJSON, "allowMixedContent", allowMixedContent)
             );
+        minWebViewVersion = JSONUtils.getInt(configJSON, "android.minWebViewVersion", DEFAULT_ANDROID_WEBVIEW_VERSION);
         captureInput = JSONUtils.getBoolean(configJSON, "android.captureInput", captureInput);
         webContentsDebuggingEnabled = JSONUtils.getBoolean(configJSON, "android.webContentsDebuggingEnabled", isDebug);
 
@@ -279,6 +284,15 @@ public boolean isInitialFocus() {
         return initialFocus;
     }
 
+    public int getMinWebViewVersion() {
+        if (minWebViewVersion < MINIMUM_ANDROID_WEBVIEW_VERSION) {
+            Logger.warn("Specified minimum webview version is too low, defaulting to " + MINIMUM_ANDROID_WEBVIEW_VERSION);
+            return MINIMUM_ANDROID_WEBVIEW_VERSION;
+        }
+
+        return minWebViewVersion;
+    }
+
     public PluginConfig getPluginConfiguration(String pluginId) {
         PluginConfig pluginConfig = pluginsConfiguration.get(pluginId);
         if (pluginConfig == null) {
@@ -436,6 +450,7 @@ public static class Builder {
         private Boolean webContentsDebuggingEnabled = null;
         private boolean loggingEnabled = true;
         private boolean initialFocus = false;
+        private int minWebViewVersion = DEFAULT_ANDROID_WEBVIEW_VERSION;
 
         // Embedded
         private String startPath = null;

cli/src/declarations.ts

@@ -211,6 +211,16 @@ export interface CapacitorConfig {
      * @default true
      */
     initialFocus?: boolean;
+
+    /**
+     * The minimum supported webview version on Android supported by your app.
+     *
+     * The minimum supported cannot be lower than version `55`, which is required for Capacitor.
+     *
+     * @since 4.0.0
+     * @default 60
+     */
+    minWebViewVersion?: number;
   };
 
   ios?: {