[Mono.Android] Bind API-37 Beta 3 (#11038)

Context: https://developer.android.com/about/versions/17
Context: https://android-developers.googleblog.com/2026/03/the-third-beta-of-android-17.html

Android 17 Beta 3 has been released.

  * [API-37 Beta 3 vs. API-CinnamonBun Beta 2][0]
  * [API-37 Beta 3 vs. API-36.1][1]

The Android 17 Beta 3 announcement states that Beta 3 is API stable.

> Android 17 has officially reached platform stability today with
> Beta 3. That means that the API surface is locked; you can perform
> final compatibility testing and push your Android 17-targeted apps
> to the Play Store.

We're not yet ready to do the enumification work, though.

Bind API-37 Beta 3 as an *unstable*, *un-enumified* binding.

[0]: https://developer.android.com/sdk/api_diff/37-incr/changes
[1]: https://developer.android.com/sdk/api_diff/37/changes

Author: jonpryor

Configuration.props

@@ -36,7 +36,7 @@
     -->
     <!-- *Latest* *unstable* API level binding that we support; this can be the same as *stable* -->
     <AndroidLatestUnstableApiLevel Condition="'$(AndroidLatestUnstableApiLevel)' == ''">37</AndroidLatestUnstableApiLevel>
-    <AndroidLatestUnstablePlatformId Condition="'$(AndroidLatestUnstablePlatformId)' == ''">CinnamonBun</AndroidLatestUnstablePlatformId>
+    <AndroidLatestUnstablePlatformId Condition="'$(AndroidLatestUnstablePlatformId)' == ''">37</AndroidLatestUnstablePlatformId>
     <AndroidLatestUnstableFrameworkVersion Condition="'$(AndroidLatestUnstableFrameworkVersion)'==''">v17.0</AndroidLatestUnstableFrameworkVersion>
     <!-- The default API level used for $(TargetPlatformVersion) -->
     <AndroidDefaultTargetDotnetApiLevel Condition=" '$(AndroidDefaultTargetDotnetApiLevel)' == '' ">$(AndroidLatestStableApiLevel)</AndroidDefaultTargetDotnetApiLevel>

Documentation/workflow/HowToAddNewApiLevel.md

@@ -243,7 +243,7 @@ cp src/Mono.Android/PublicAPI/API-36/* src/Mono.Android/PublicAPI/API-36.1
 To build *just* `src/Mono.Android/Mono.Android.csproj`:
 
 ```dotnetcli
-./dotnet-local.sh build src/Mono.Android/*.csproj -p:AndroidApiLevel=36.1 -p:AndroidPlatformId=CANARY -p:AndroidFrameworkVersion=v16.1 -p:IsUnstableVersion=true
+./dotnet-local.sh build -bl src/Mono.Android/*.csproj -p:AndroidApiLevel=36.1 -p:AndroidPlatformId=CANARY -p:AndroidFrameworkVersion=v16.1 -p:IsUnstableVersion=true
 ```
 
 ### New AndroidManifest.xml Elements

build-tools/api-merge/merge-configuration.xml

@@ -26,9 +26,9 @@
     <File Path="api-35.xml.in" Level="35" />
     <File Path="api-36.xml.in" Level="36" />
     <File Path="api-36.1.xml.in"  Level="36.1" />
-    <File Path="api-CinnamonBun.xml.in"  Level="37" />
+    <File Path="api-37.xml.in" Level="37" />
   </Inputs>
   <Outputs>
-    <File Path="api-CinnamonBun.xml"     LastLevel="37" />
+    <File Path="api-37.xml"    LastLevel="37" />
   </Outputs>
 </Configuration>

build-tools/automation/yaml-templates/variables.yaml

@@ -63,7 +63,7 @@ variables:
 - name: IsRelOrTargetingRel
   value: $[or(startsWith(variables['Build.SourceBranch'], 'refs/heads/release/'), startsWith(variables['System.PullRequest.TargetBranch'], 'release/'))]
 - name: DefaultTestSdkPlatforms  # Comma-separated SDK Platform(s) to install on test agents (no spaces)
-  value: 35,36,36.1,CinnamonBun
+  value: 35,36,36.1,37
 - name: DefaultJavaSdkMajorVersion
   value: 17
 - name: LatestJavaSdkMajorVersion

build-tools/xaprepare/xaprepare/ConfigAndData/BuildAndroidPlatforms.cs

@@ -50,7 +50,7 @@ class BuildAndroidPlatforms
 			new AndroidPlatform (apiName: "VanillaIceCream",        apiLevel: 35, platformID: "35",  include: "v15.0",   framework: "v15.0"),
 			new AndroidPlatform (apiName: "Baklava",                apiLevel: 36, platformID: "36",  include: "v16.0",   framework: "v16.0"),
 			new AndroidPlatform (apiName: "CANARY",                 apiLevel: new Version (36, 1),   platformID: "36.1", include: "v16.1",   framework: "v16.1", stable: true),
-			new AndroidPlatform (apiName: "CinnamonBun",            apiLevel: new Version (37, 0),   platformID: "CinnamonBun", include: "v17.0",   framework: "v17.0", stable: false),
+			new AndroidPlatform (apiName: "CinnamonBun",            apiLevel: new Version (37, 0),   platformID: "37",   include: "v17.0",   framework: "v17.0", stable: false),
 		};
 
 	}

build-tools/xaprepare/xaprepare/ConfigAndData/Dependencies/AndroidToolchain.cs

@@ -75,7 +75,7 @@ public AndroidToolchain ()
 				new AndroidPlatformComponent ("platform-35_r02",   apiLevel: "35", pkgRevision: "2"),
 				new AndroidPlatformComponent ("platform-36_r02",   apiLevel: "36", pkgRevision: "2"),
 				new AndroidPlatformComponent ("platform-36.1_r01", apiLevel: "36.1",    pkgRevision: "1", isLatestStable: true),
-				new AndroidPlatformComponent ("platform-CinnamonBun_r02", apiLevel: "CinnamonBun",    pkgRevision: "2", isLatestStable: false, isPreview: true),
+				new AndroidPlatformComponent ("platform-37.0_r01", apiLevel: "37",      pkgRevision: "1", isLatestStable: false, isPreview: true),
 
 				new AndroidToolchainComponent ("source-36_r01",
 					destDir: Path.Combine ("sources", "android-36"),

…roid/Profiles/api-CinnamonBun.params.txt …/Mono.Android/Profiles/api-37.params.txtsrc/Mono.Android/Profiles/api-CinnamonBun.params.txt renamed to src/Mono.Android/Profiles/api-37.params.txt src/Mono.Android/Profiles/api-CinnamonBun.params.txt renamed to src/Mono.Android/Profiles/api-37.params.txt

@@ -2006,6 +2006,37 @@
       name="propertyName"
   ></attr>
 
+  <!-- Fix CS0549 errors about adding new `virtual` methods in `sealed` types -->
+  <attr
+      api-since="37"
+      path="/api/package[@name='java.lang']/class[@name='StringBuffer']/method[@name='getChars' and count(parameter)=4 and parameter[1][@type='int'] and parameter[2][@type='int'] and parameter[3][@type='char[]'] and parameter[4][@type='int']]"
+      name="managedOverride"
+  >none</attr>
+  <attr
+      api-since="37"
+      path="/api/package[@name='java.lang']/class[@name='StringBuilder']/method[@name='getChars' and count(parameter)=4 and parameter[1][@type='int'] and parameter[2][@type='int'] and parameter[3][@type='char[]'] and parameter[4][@type='int']]"
+      name="managedOverride"
+  >none</attr>
+
+  <!-- Covariant return type methods need to be emitted as `override` -->
+  <attr
+      api-since="37"
+      path="/api/package[@name='android.view']/class[@name='RoundedRectBlurRegion']/method[@name='copy' and count(parameter)=0]"
+      name="managedOverride"
+  >override</attr>
+
+  <!-- Fix CS0534+CS0549: method *should* be `override`, but is instead emitted as `virtual`, resulting in two errors for one method! -->
+  <attr
+      api-since="37"
+      path="/api/package[@name='android.text']/class[@name='SpannedString']/method[@name='getChars' and count(parameter)=4 and parameter[1][@type='int'] and parameter[2][@type='int'] and parameter[3][@type='char[]'] and parameter[4][@type='int']]"
+      name="managedOverride"
+  >override</attr>
+  <attr
+      api-since="37"
+      path="/api/package[@name='android.text']/class[@name='SpannableString']/method[@name='getChars' and count(parameter)=4 and parameter[1][@type='int'] and parameter[2][@type='int'] and parameter[3][@type='char[]'] and parameter[4][@type='int']]"
+      name="managedOverride"
+  >override</attr>
+
   <!--
     ***********************************************************************
     THE FOLLOWING LINES MUST BE CREATED FOR ANY NEW PLATFORM THAT IS ADDED.
@@ -2037,6 +2068,7 @@
   <attr api-since="36.1" path="/api/package[contains(@merge.SourceFile,'api-CANARY.xml.in')]/interface" name="no-alternatives">true</attr>
   <attr api-since="36.1" path="/api/package[contains(@merge.SourceFile,'api-36.1.xml.in')]/interface" name="no-alternatives">true</attr>
   <attr api-since="37" path="/api/package[contains(@merge.SourceFile,'api-CinnamonBun.xml.in')]/interface" name="no-alternatives">true</attr>
+  <attr api-since="37" path="/api/package[contains(@merge.SourceFile,'api-37.xml.in')]/interface" name="no-alternatives">true</attr>
 
   <!-- Set ApiSince based on merge sourcefile. -->
   <attr api-since="22" path="/api//*[contains(@merge.SourceFile,'api-22.xml.in')]" name="api-since">22</attr>
@@ -2064,6 +2096,7 @@
   <attr api-since="36.1" path="/api//*[contains(@merge.SourceFile,'api-CANARY.xml.in')]" name="api-since">36.1</attr>
   <attr api-since="36.1" path="/api//*[contains(@merge.SourceFile,'api-36.1.xml.in')]" name="api-since">36.1</attr>
   <attr api-since="37" path="/api//*[contains(@merge.SourceFile,'api-CinnamonBun.xml.in')]" name="api-since">37</attr>
+  <attr api-since="37" path="/api//*[contains(@merge.SourceFile,'api-37.xml.in')]" name="api-since">37</attr>
 
   <!-- Erase some 'api-since' attributes (This has to be done after they are set above) -->