Change ' AndroidEnableRestrictToAttributes' to enum style for future-proofing.

Author: jpobst

Documentation/guides/building-apps/build-properties.md

@@ -488,7 +488,9 @@ This property is `False` by default.
 
 ## AndroidEnableRestrictToAttributes
 
-A boolean property that determines whether types and members marked with
+An enum-style property with a valid value of `obsolete`. Set to no value to disable.
+
+When set to `obsolete`, types and members marked with
 the Java annotation `androidx.annotation.RestrictTo` will be marked with an
 `[Obsolete]` attribute in the C# binding.
 
@@ -510,7 +512,7 @@ this property to prevent these types from being bound:
 
 Support for this property was added in .NET 8.
 
-This property is `True` by default.
+This property is set to `obsolete` by default.
 
 ## AndroidEnableSGenConcurrent
 

src/Xamarin.Android.Build.Tasks/Microsoft.Android.Sdk/targets/Microsoft.Android.Sdk.DefaultProperties.targets

@@ -36,7 +36,7 @@
     <AndroidBoundInterfacesContainStaticAndDefaultInterfaceMethods Condition=" '$(AndroidBoundInterfacesContainStaticAndDefaultInterfaceMethods)' == '' ">true</AndroidBoundInterfacesContainStaticAndDefaultInterfaceMethods>
     <AndroidBoundInterfacesContainTypes Condition=" '$(AndroidBoundInterfacesContainTypes)' == '' ">true</AndroidBoundInterfacesContainTypes>
     <AndroidBoundInterfacesContainConstants Condition=" '$(AndroidBoundInterfacesContainConstants)' == '' ">true</AndroidBoundInterfacesContainConstants>
-    <AndroidEnableRestrictToAttributes Condition=" '$(AndroidEnableRestrictToAttributes)' == '' ">true</AndroidEnableRestrictToAttributes>
+    <AndroidEnableRestrictToAttributes Condition=" '$(AndroidEnableRestrictToAttributes)' == '' ">obsolete</AndroidEnableRestrictToAttributes>
 
     <!-- Mono components -->
     <AndroidEnableProfiler Condition=" '$(AndroidEnableProfiler)' == ''">false</AndroidEnableProfiler>

src/Xamarin.Android.Build.Tasks/Tasks/Generator.cs

@@ -51,7 +51,7 @@ public class BindingsGenerator : AndroidDotnetToolTask
 		public bool EnableBindingStaticAndDefaultInterfaceMethods { get; set; }
 		public bool EnableBindingNestedInterfaceTypes { get; set; }
 		public bool EnableBindingInterfaceConstants { get; set; }
-		public bool EnableRestrictToAttributes { get; set; }
+		public string EnableRestrictToAttributes { get; set; }
 		public string Nullable { get; set; }
 
 		public ITaskItem[] TransformFiles { get; set; }
@@ -217,7 +217,7 @@ protected override string GenerateCommandLineCommands ()
 					if (EnableBindingStaticAndDefaultInterfaceMethods)
 						features.Add ("default-interface-methods");
 
-					if (EnableRestrictToAttributes)
+					if (string.Equals (EnableRestrictToAttributes, "obsolete", StringComparison.OrdinalIgnoreCase))
 						features.Add ("restrict-to-attributes");
 
 					if (string.Equals (Nullable, "enable", StringComparison.OrdinalIgnoreCase))