Switch on by default. Update the docs

Author: dellis1972

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

@@ -318,7 +318,7 @@ automatically included in your package. So there is no need to upload
 it to the Google Play Store manually. If you are using `.apk` files
 you will need to manually upload the [`AndroidProguardMappingFile`](#androidproguardmappingfile).
 
-The default value is `False`.
+The default value is `True` when using `AndroidLinkTool=r8`.
 
 Added in Xamarin.Android 12.3.
 
@@ -1009,19 +1009,18 @@ mean the `mapping.txt` file will be produced in the `$(OutputPath)`
 folder. This file can then be used when uploading packages to the
 Google Play Store.
 
-By default this file is not produced.
+By default this file is produced automatically when using `AndroidLinkTool=r8`
+and will generate the following file `$(OutputPath)mapping.txt`.
 
-If you do want to generate this mapping file you can use the
-[`AndroidCreateProguardMappingFile`](#androidcreateproguardmappingfile) property to create it .
+If you do not want to generate this mapping file you can use the
+[`AndroidCreateProguardMappingFile`](#androidcreateproguardmappingfile) property to stop creating it .
 Add the following in your project
 
 ```
-<AndroidCreateProguardMappingFile>True</AndroidCreateProguardMappingFile>
+<AndroidCreateProguardMappingFile>False</AndroidCreateProguardMappingFile>
 ```
 
-or use `-p:AndroidCreateProguardMappingFile=True` on the command line.
-
-This will then generate the following file `$(OutputPath)mapping.txt`.
+or use `-p:AndroidCreateProguardMappingFile=False` on the command line.
 
 This property was added in Xamarin.Android 11.2.
 

src/Xamarin.Android.Build.Tasks/Xamarin.Android.Common.targets

@@ -264,6 +264,7 @@ Copyright (C) 2011-2012 Xamarin. All rights reserved.
 	<AndroidEnableDesugar  Condition=" '$(AndroidEnableDesugar)' == '' And ('$(AndroidDexTool)' == 'd8' Or '$(AndroidLinkTool)' == 'r8') ">True</AndroidEnableDesugar>
 	<AndroidEnableDesugar  Condition=" '$(AndroidEnableDesugar)' == '' ">False</AndroidEnableDesugar>
 	<AndroidR8IgnoreWarnings    Condition=" '$(AndroidR8IgnoreWarnings)' == '' ">True</AndroidR8IgnoreWarnings>
+	<AndroidCreateProguardMappingFile Condition="'$(AndroidCreateProguardMappingFile)' == '' And '$(AndroidLinkTool)' == 'r8'">True</AndroidCreateProguardMappingFile>
 
 	<!-- Figure out which is the main packaging format we want-->
 	<AndroidPackageFormat Condition=" $(AndroidPackageFormats.Contains('aab')) And '$(AndroidPackageFormat)' == '' ">aab</AndroidPackageFormat>