[Bindings.targets] Warn about deprecated jar2xml and XamarinAndroid values.

Documentation/guides/messages/README.md

@@ -134,6 +134,8 @@ ms.date: 01/24/2020
 + XA4228: Unable to find specified //activity-alias/@android:targetActivity: '{targetActivity}'
 + XA4229: Unrecognized \`TransformFile\` root element: {element}.
 + XA4230: Error parsing XML: {exception}
++ [XA4231](xa4231.md): The Android class parser value 'jar2xml' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.
++ [XA4232](xa4232.md): The Android code generation target 'XamarinAndroid' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.
 + XA4300: Native library '{library}' will not be bundled because it has an unsupported ABI.
 + [XA4301](xa4301.md): Apk already contains the item `xxx`.
 + [XA4302](xa4302.md): Unhandled exception merging \`AndroidManifest.xml\`: {ex}

Documentation/guides/messages/xa4231.md

@@ -0,0 +1,29 @@
+---
+title: Xamarin.Android warning XA4231
+description: XA4231 warning code
+ms.date: 04/23/2020
+---
+# Xamarin.Android warning XA4231
+
+## Example messages
+
+```
+warning XA4231: The Android class parser value 'jar2xml' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.
+```
+
+## Issue
+
+The Android class parser `jar2xml` has been deprecated.
+
+## Solution
+
+To resolve this warning, update the **Android Class Parser** setting in the Visual
+Studio project property pages or the **.jar file parser** setting in Visual
+Studio for Mac to **class-parse**.  This corresponds to the `class-parse` value
+for the `AndroidClassParser` MSBuild property in the _.csproj_ file:
+
+```xml
+<PropertyGroup>
+  <AndroidClassParser>class-parse</AndroidClassParser>
+</PropertyGroup>
+```

Documentation/guides/messages/xa4232.md

@@ -0,0 +1,30 @@
+---
+title: Xamarin.Android warning XA4232
+description: XA4232 warning code
+ms.date: 04/23/2020
+---
+# Xamarin.Android warning XA4232
+
+## Example messages
+
+```
+warning XA4232: The Android code generation target 'XamarinAndroid' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.
+```
+
+## Issue
+
+The Android code generation target `XamarinAndroid` has been deprecated.
+
+## Solution
+
+To resolve this warning, update the **Android Codegen target** setting in the
+Visual Studio project property pages or the **Code generation target** setting
+in Visual Studio for Mac to **XAJavaInterop1**.  This corresponds to the
+`XAJavaInterop1` value for the `AndroidCodegenTarget` MSBuild property in the
+_.csproj_ file:
+
+```xml
+<PropertyGroup>
+  <AndroidCodegenTarget>XAJavaInterop1</AndroidCodegenTarget>
+</PropertyGroup>
+```

Documentation/release-notes/4577.md

@@ -0,0 +1,42 @@
+### Bindings projects XA4231 warning for deprecated jar2xml parser
+
+Any bindings project that has the `AndroidClassParser` MSBuild property set to
+the old `jar2xml` parser or any other unrecognized value will now get a XA4231
+build warning:
+
+```
+warning XA4231: The Android class parser 'jar2xml' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse' instead.
+```
+
+To resolve this warning, update the **Android Class Parser** setting in the Visual
+Studio project property pages or the **.jar file parser** setting in Visual
+Studio for Mac to **class-parse**.  This corresponds to the `class-parse` value
+for the `AndroidClassParser` MSBuild property in the _.csproj_ file:
+
+```xml
+<PropertyGroup>
+  <AndroidClassParser>class-parse</AndroidClassParser>
+</PropertyGroup>
+```
+
+### Bindings projects XA4232 warning for deprecated XamarinAndroid code generation target
+
+Any bindings project that has the `AndroidCodegenTarget` MSBuild property set to
+the old `XamarinAndroid` code generation target or any other unrecognized value
+will now get a XA4232 build warning:
+
+```
+warning XA4232: The Android code generation target value 'XamarinAndroid' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.
+```
+
+To resolve this warning, update the **Android Codegen target** setting in the
+Visual Studio project property pages or the **Code generation target** setting
+in Visual Studio for Mac to **XAJavaInterop1**.  This corresponds to the
+`XAJavaInterop1` value for the `AndroidCodegenTarget` MSBuild property in the
+_.csproj_ file:
+
+```xml
+<PropertyGroup>
+  <AndroidCodegenTarget>XAJavaInterop1</AndroidCodegenTarget>
+</PropertyGroup>
+```

src/Xamarin.Android.Build.Tasks/Properties/Resources.resx

@@ -559,6 +559,16 @@ In this message, "root element" refers to the root element of an XML file.
     <value>Error parsing XML: {0}</value>
     <comment>{0} - The exception message and stack trace of the associated exception</comment>
   </data>
+  <data name="XA4231" xml:space="preserve">
+    <value>The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</value>
+    <comment>The following are literal names and should not be translated: class-parse
+{0} - The name of the current class parser value</comment>
+  </data>
+  <data name="XA4232" xml:space="preserve">
+    <value>The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</value>
+    <comment>The following are literal names and should not be translated: XAJavaInterop1
+{0} - The name of the current code generation target</comment>
+  </data>
   <data name="XA4300" xml:space="preserve">
     <value>Native library '{0}' will not be bundled because it has an unsupported ABI.</value>
     <comment>The abbreviation "ABI" should not be translated.

src/Xamarin.Android.Build.Tasks/Properties/xlf/Resources.cs.xlf

@@ -537,6 +537,18 @@ In this message, "root element" refers to the root element of an XML file.
         <target state="new">Error parsing XML: {0}</target>
         <note>{0} - The exception message and stack trace of the associated exception</note>
       </trans-unit>
+      <trans-unit id="XA4231">
+        <source>The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</source>
+        <target state="new">The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</target>
+        <note>The following are literal names and should not be translated: class-parse
+{0} - The name of the current class parser value</note>
+      </trans-unit>
+      <trans-unit id="XA4232">
+        <source>The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</source>
+        <target state="new">The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</target>
+        <note>The following are literal names and should not be translated: XAJavaInterop1
+{0} - The name of the current code generation target</note>
+      </trans-unit>
       <trans-unit id="XA4300">
         <source>Native library '{0}' will not be bundled because it has an unsupported ABI.</source>
         <target state="translated">Nativní knihovna {0} se nezahrne do sady prostředků, protože má nepodporované ABI.</target>

src/Xamarin.Android.Build.Tasks/Properties/xlf/Resources.de.xlf

@@ -537,6 +537,18 @@ In this message, "root element" refers to the root element of an XML file.
         <target state="new">Error parsing XML: {0}</target>
         <note>{0} - The exception message and stack trace of the associated exception</note>
       </trans-unit>
+      <trans-unit id="XA4231">
+        <source>The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</source>
+        <target state="new">The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</target>
+        <note>The following are literal names and should not be translated: class-parse
+{0} - The name of the current class parser value</note>
+      </trans-unit>
+      <trans-unit id="XA4232">
+        <source>The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</source>
+        <target state="new">The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</target>
+        <note>The following are literal names and should not be translated: XAJavaInterop1
+{0} - The name of the current code generation target</note>
+      </trans-unit>
       <trans-unit id="XA4300">
         <source>Native library '{0}' will not be bundled because it has an unsupported ABI.</source>
         <target state="translated">Die native Bibliothek "{0}" wird nicht gebündelt, weil sie eine nicht unterstützte ABI umfasst.</target>

src/Xamarin.Android.Build.Tasks/Properties/xlf/Resources.es.xlf

@@ -537,6 +537,18 @@ In this message, "root element" refers to the root element of an XML file.
         <target state="new">Error parsing XML: {0}</target>
         <note>{0} - The exception message and stack trace of the associated exception</note>
       </trans-unit>
+      <trans-unit id="XA4231">
+        <source>The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</source>
+        <target state="new">The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</target>
+        <note>The following are literal names and should not be translated: class-parse
+{0} - The name of the current class parser value</note>
+      </trans-unit>
+      <trans-unit id="XA4232">
+        <source>The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</source>
+        <target state="new">The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</target>
+        <note>The following are literal names and should not be translated: XAJavaInterop1
+{0} - The name of the current code generation target</note>
+      </trans-unit>
       <trans-unit id="XA4300">
         <source>Native library '{0}' will not be bundled because it has an unsupported ABI.</source>
         <target state="translated">La biblioteca nativa "{0}" no se empaquetará porque tiene un conjunto ABI no admitido.</target>

src/Xamarin.Android.Build.Tasks/Properties/xlf/Resources.fr.xlf

@@ -537,6 +537,18 @@ In this message, "root element" refers to the root element of an XML file.
         <target state="new">Error parsing XML: {0}</target>
         <note>{0} - The exception message and stack trace of the associated exception</note>
       </trans-unit>
+      <trans-unit id="XA4231">
+        <source>The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</source>
+        <target state="new">The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</target>
+        <note>The following are literal names and should not be translated: class-parse
+{0} - The name of the current class parser value</note>
+      </trans-unit>
+      <trans-unit id="XA4232">
+        <source>The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</source>
+        <target state="new">The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</target>
+        <note>The following are literal names and should not be translated: XAJavaInterop1
+{0} - The name of the current code generation target</note>
+      </trans-unit>
       <trans-unit id="XA4300">
         <source>Native library '{0}' will not be bundled because it has an unsupported ABI.</source>
         <target state="translated">La bibliothèque native '{0}' n'est pas incluse dans le bundle, car elle a un ABI non pris en charge.</target>

src/Xamarin.Android.Build.Tasks/Properties/xlf/Resources.it.xlf

@@ -537,6 +537,18 @@ In this message, "root element" refers to the root element of an XML file.
         <target state="new">Error parsing XML: {0}</target>
         <note>{0} - The exception message and stack trace of the associated exception</note>
       </trans-unit>
+      <trans-unit id="XA4231">
+        <source>The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</source>
+        <target state="new">The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</target>
+        <note>The following are literal names and should not be translated: class-parse
+{0} - The name of the current class parser value</note>
+      </trans-unit>
+      <trans-unit id="XA4232">
+        <source>The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</source>
+        <target state="new">The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</target>
+        <note>The following are literal names and should not be translated: XAJavaInterop1
+{0} - The name of the current code generation target</note>
+      </trans-unit>
       <trans-unit id="XA4300">
         <source>Native library '{0}' will not be bundled because it has an unsupported ABI.</source>
         <target state="translated">La libreria nativa '{0}' non verrà inclusa nel bundle perché contiene un ABI non supportato.</target>

src/Xamarin.Android.Build.Tasks/Properties/xlf/Resources.ja.xlf

@@ -537,6 +537,18 @@ In this message, "root element" refers to the root element of an XML file.
         <target state="new">Error parsing XML: {0}</target>
         <note>{0} - The exception message and stack trace of the associated exception</note>
       </trans-unit>
+      <trans-unit id="XA4231">
+        <source>The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</source>
+        <target state="new">The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</target>
+        <note>The following are literal names and should not be translated: class-parse
+{0} - The name of the current class parser value</note>
+      </trans-unit>
+      <trans-unit id="XA4232">
+        <source>The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</source>
+        <target state="new">The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</target>
+        <note>The following are literal names and should not be translated: XAJavaInterop1
+{0} - The name of the current code generation target</note>
+      </trans-unit>
       <trans-unit id="XA4300">
         <source>Native library '{0}' will not be bundled because it has an unsupported ABI.</source>
         <target state="translated">サポートされていない ABI が含まれるため、ネイティブ ライブラリ '{0}' はバンドルされません。</target>

src/Xamarin.Android.Build.Tasks/Properties/xlf/Resources.ko.xlf

@@ -537,6 +537,18 @@ In this message, "root element" refers to the root element of an XML file.
         <target state="new">Error parsing XML: {0}</target>
         <note>{0} - The exception message and stack trace of the associated exception</note>
       </trans-unit>
+      <trans-unit id="XA4231">
+        <source>The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</source>
+        <target state="new">The Android class parser value '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'class-parse'.</target>
+        <note>The following are literal names and should not be translated: class-parse
+{0} - The name of the current class parser value</note>
+      </trans-unit>
+      <trans-unit id="XA4232">
+        <source>The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</source>
+        <target state="new">The Android code generation target '{0}' is deprecated and will be removed in a future version of Xamarin.Android. Update the project properties to use 'XAJavaInterop1'.</target>
+        <note>The following are literal names and should not be translated: XAJavaInterop1
+{0} - The name of the current code generation target</note>
+      </trans-unit>
       <trans-unit id="XA4300">
         <source>Native library '{0}' will not be bundled because it has an unsupported ABI.</source>
         <target state="translated">네이티브 라이브러리 '{0}'은(는) 지원되지 않는 ABI를 포함하므로 함께 제공되지 않습니다.</target>