feat(core): add option to configure Android's minimum SDK version (#6651)

Author: lucasfernog

.changes/downgrade-min-sdk-version.md

@@ -0,0 +1,6 @@
+---
+"cli.rs": patch
+"tauri": patch
+---
+
+Change minimum Android SDK version to 21 for the plugin library.

.changes/min-sdk-version.md

@@ -0,0 +1,5 @@
+---
+"tauri-utils": patch
+---
+
+Added `android` configuration object under `tauri > bundle`.

core/config-schema/schema.json

@@ -131,6 +131,9 @@
         },
         "bundle": {
           "active": false,
+          "android": {
+            "minSdkVersion": 24
+          },
           "appimage": {
             "bundleMediaFramework": false
           },
@@ -270,6 +273,9 @@
           "description": "The bundler configuration.",
           "default": {
             "active": false,
+            "android": {
+              "minSdkVersion": 24
+            },
             "appimage": {
               "bundleMediaFramework": false
             },
@@ -1169,6 +1175,17 @@
               "$ref": "#/definitions/IosConfig"
             }
           ]
+        },
+        "android": {
+          "description": "Android configuration.",
+          "default": {
+            "minSdkVersion": 24
+          },
+          "allOf": [
+            {
+              "$ref": "#/definitions/AndroidConfig"
+            }
+          ]
         }
       },
       "additionalProperties": false
@@ -1772,6 +1789,20 @@
       },
       "additionalProperties": false
     },
+    "AndroidConfig": {
+      "description": "General configuration for the iOS target.",
+      "type": "object",
+      "properties": {
+        "minSdkVersion": {
+          "description": "The minimum API level required for the application to run. The Android system will prevent the user from installing the application if the system's API level is lower than the value specified.",
+          "default": 24,
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0.0
+        }
+      },
+      "additionalProperties": false
+    },
     "AllowlistConfig": {
       "description": "Allowlist configuration. The allowlist is a translation of the [Cargo allowlist features](https://docs.rs/tauri/latest/tauri/#cargo-allowlist-features).\n\n# Notes\n\n- Endpoints that don't have their own allowlist option are enabled by default. - There is only \"opt-in\", no \"opt-out\". Setting an option to `false` has no effect.\n\n# Examples\n\n- * [`\"app-all\": true`](https://tauri.app/v1/api/config/#appallowlistconfig.all) will make the [hide](https://tauri.app/v1/api/js/app#hide) endpoint be available regardless of whether `hide` is set to `false` or `true` in the allowlist.",
       "type": "object",

core/tauri-utils/src/config.rs

@@ -680,6 +680,9 @@ pub struct BundleConfig {
   /// iOS configuration.
   #[serde(rename = "iOS", default)]
   pub ios: IosConfig,
+  /// Android configuration.
+  #[serde(default)]
+  pub android: AndroidConfig,
 }
 
 /// A CLI argument definition.
@@ -2626,6 +2629,30 @@ pub struct IosConfig {
   pub development_team: Option<String>,
 }
 
+/// General configuration for the iOS target.
+#[skip_serializing_none]
+#[derive(Debug, PartialEq, Eq, Clone, Deserialize, Serialize)]
+#[cfg_attr(feature = "schema", derive(JsonSchema))]
+#[serde(rename_all = "camelCase", deny_unknown_fields)]
+pub struct AndroidConfig {
+  /// The minimum API level required for the application to run.
+  /// The Android system will prevent the user from installing the application if the system's API level is lower than the value specified.
+  #[serde(alias = "min-sdk-version", default = "default_min_sdk_version")]
+  pub min_sdk_version: u32,
+}
+
+impl Default for AndroidConfig {
+  fn default() -> Self {
+    Self {
+      min_sdk_version: default_min_sdk_version(),
+    }
+  }
+}
+
+fn default_min_sdk_version() -> u32 {
+  24
+}
+
 /// Defines the URL or assets to embed in the application.
 #[derive(Debug, PartialEq, Eq, Clone, Deserialize, Serialize)]
 #[cfg_attr(feature = "schema", derive(JsonSchema))]
@@ -3416,6 +3443,7 @@ mod build {
       let external_bin = opt_vec_str_lit(self.external_bin.as_ref());
       let windows = &self.windows;
       let ios = quote!(Default::default());
+      let android = quote!(Default::default());
 
       literal_struct!(
         tokens,
@@ -3435,7 +3463,8 @@ mod build {
         macos,
         external_bin,
         windows,
-        ios
+        ios,
+        android
       );
     }
   }
@@ -3853,6 +3882,7 @@ mod test {
         external_bin: None,
         windows: Default::default(),
         ios: Default::default(),
+        android: Default::default(),
       },
       cli: None,
       updater: UpdaterConfig {

core/tauri/mobile/android/build.gradle.kts

@@ -8,7 +8,7 @@ android {
     compileSdk = 33
 
     defaultConfig {
-        minSdk = 24
+        minSdk = 21
         targetSdk = 33
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"