From 69502b26ab2cba2603d23bbfbae75b0b2117d2f9 Mon Sep 17 00:00:00 2001
From: Jonathan Peppers <jonathan.peppers@microsoft.com>
Date: Fri, 7 Aug 2026 12:51:39 -0500
Subject: [PATCH] [Mono.Android] Deprecate removed constructors

Mark 15 public constructors removed before the minimum supported Android API level as obsolete through binding metadata, including WebKit constructors whose containing types were removed and therefore lack removed-since annotations.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: bded62c4-4507-4f48-a38a-c4162b9d28a0
---
 src/Mono.Android/metadata | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/Mono.Android/metadata b/src/Mono.Android/metadata
index 3f1d008a312..a17ed011637 100644
--- a/src/Mono.Android/metadata
+++ b/src/Mono.Android/metadata
@@ -1133,6 +1133,14 @@
     The problem with this is that our tooling doesn't have any real support for stating that
     a method was removed; api-merge assumes that once an API is added, it's present for ALL TIME.
     -->
+  <!-- These constructors were removed before the minimum supported Android API level. -->
+  <attr path="/api/package[@name='android.util']/class[@name='Config' or @name='DebugUtils' or @name='EventLog' or @name='StateSet' or @name='TimeUtils' or @name='Xml']/constructor[(@visibility='public' or @visibility='protected') and count(parameter)=0]" name="deprecated">This constructor was removed in Android API level 15.</attr>
+  <attr path="/api/package[@name='android.webkit']/class[@name='Plugin' or @name='PluginList' or @name='UrlInterceptRegistry']/constructor[@visibility='public' or @visibility='protected']" name="deprecated">This constructor was removed in Android API level 15.</attr>
+  <attr path="/api/package[@name='android.webkit']/class[@name='GeolocationPermissions' or @name='WebStorage']/constructor[(@visibility='public' or @visibility='protected') and count(parameter)=0]" name="deprecated">This constructor was removed in Android API level 16.</attr>
+  <attr path="/api/package[@name='android.webkit']/class[@name='CacheManager']/constructor[(@visibility='public' or @visibility='protected') and count(parameter)=0]" name="deprecated">This constructor was removed in Android API level 17.</attr>
+  <attr path="/api/package[@name='android.media']/class[@name='AudioFormat']/constructor[(@visibility='public' or @visibility='protected') and count(parameter)=0]" name="deprecated">This constructor was removed in Android API level 21.</attr>
+  <attr path="/api/package[@name='android.os']/class[@name='BatteryManager' or @name='RecoverySystem']/constructor[(@visibility='public' or @visibility='protected') and count(parameter)=0]" name="deprecated">This constructor was removed in Android API level 23.</attr>
+
   <!-- View.fitsSystemWindows() was removed from docs/android.jar, but still appears to exist on-device. -->
   <attr api-since="14" path="/api/package[@name='android.view']/class[@name='View']/method[@name='fitsSystemWindows' and count(parameters)=0]"
       name="managedName"