update node20 handler for XamarinAndroidV1 (#19298)

Author: qianz2

Tasks/XamarinAndroidV1/task.json

@@ -12,7 +12,7 @@
     "author": "Microsoft Corporation",
     "version": {
         "Major": 1,
-        "Minor": 230,
+        "Minor": 231,
         "Patch": 0
     },
     "demands": [

Tasks/XamarinAndroidV1/task.loc.json

@@ -12,7 +12,7 @@
   "author": "Microsoft Corporation",
   "version": {
     "Major": 1,
-    "Minor": 230,
+    "Minor": 231,
     "Patch": 0
   },
   "demands": [

_generated/XamarinAndroidV1.versionmap.txt

@@ -1,2 +1,2 @@
-Default|1.230.0
-Node20-225|1.230.1
+Default|1.231.0
+Node20-225|1.231.1

_generated/XamarinAndroidV1/Get-JavaDevelopmentKitPath.ps1

@@ -0,0 +1,116 @@
+function Get-JavaDevelopmentKitPath{
+    [CmdletBinding()]
+    param(
+        [string]$Version,
+        [string]$Arch)
+
+    Trace-VstsEnteringInvocation $MyInvocation
+    try {
+        # Check for JDK
+        $jdkKeyName;
+        if ($Version -eq '1.8') {
+            $jdkKeyName = "Software\JavaSoft\Java Development Kit\1.8"
+        }
+        ElseIf ($Version -eq '1.7') {
+            $jdkKeyName = "Software\JavaSoft\Java Development Kit\1.7"
+        }
+        ElseIf ($Version -eq '1.6') {
+            $jdkKeyName = "Software\JavaSoft\Java Development Kit\1.6"
+        }
+        if($Arch -eq 'x64') {
+            $view = "Registry64"
+        }
+        ElseIf ($Arch -eq 'x86') {
+            $view = "Registry32"
+        }
+
+        $jdkPath;
+        if (-not [string]::IsNullOrEmpty($jdkKeyName)) {
+            $jdkPath = Get-RegistryValue -Hive 'LocalMachine' -View $view -KeyName $jdkKeyName -ValueName 'JavaHome'
+        }
+        
+        Write-Verbose "jdkPath from registry = $jdkPath"
+        if ([string]::IsNullOrEmpty($jdkPath)) {
+            $jdkVersionShort = $jdkVersion.Substring(2)
+            $javaHomeEnvVariable = "JAVA_HOME_" + $jdkVersionShort + "_" + $jdkArchitecture
+            Write-Verbose "javaHomeEnvVariable = $javaHomeEnvVariable"
+            try {
+                $jdkPath = (Get-Item env:$javaHomeEnvVariable).Value
+            } catch {
+                throw "Failed to find the specified JDK version. Please ensure the specified JDK version is installed on the agent and the environment variable $javaHomeEnvVariable exists and is set to the location of a corresponding JDK or use the [Java Tool Installer](https://go.microsoft.com/fwlink/?linkid=875287) task to install the desired JDK."
+            }
+        }
+        
+        Write-Verbose "jdkPath from environment variable $javaHomeEnvVariable = $jdkPath"
+        if ([string]::IsNullOrEmpty($jdkPath)) {
+            throw "Failed to find the specified JDK version. Please ensure the specified JDK version is installed on the agent or use the [Java Tool Installer](https://go.microsoft.com/fwlink/?linkid=875287) task to install the desired JDK."
+        }
+        return $jdkPath
+    } finally {
+        Trace-VstsLeavingInvocation $MyInvocation
+    }
+}
+
+function Get-RegistryValue {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory = $true)]
+        [ValidateSet('CurrentUser', 'LocalMachine')]
+        [string]$Hive,
+
+        [Parameter(Mandatory = $true)]
+        [ValidateSet('Default', 'Registry32', 'Registry64')]
+        [string]$View,
+
+        [Parameter(Mandatory = $true)]
+        [string]$KeyName,
+
+        [string]$ValueName)
+
+    Write-Verbose "Checking: hive '$Hive', view '$View', key name '$KeyName', value name '$ValueName'"
+    if ($View -eq 'Registry64' -and !([System.Environment]::Is64BitOperatingSystem)) {
+        Write-Verbose "Skipping."
+        return
+    }
+
+    $baseKey = $null
+    $subKey = $null
+    try {
+        # Open the base key.
+        $baseKey = [Microsoft.Win32.RegistryKey]::OpenBaseKey($Hive, $View)
+
+        # Open the sub key as read-only.
+        $subKey = $baseKey.OpenSubKey($KeyName, $false)
+
+        # Check if the sub key was found.
+        if (!$subKey) {
+            Write-Verbose "Key not found."
+            return
+        }
+
+        # Get the value.
+        $value = $subKey.GetValue($ValueName)
+
+        # Check if the value was not found or is empty.
+        if ([System.Object]::ReferenceEquals($value, $null) -or
+            ($value -is [string] -and !$value)) {
+
+            Write-Verbose "Value not found or is empty."
+            return
+        }
+
+        # Return the value.
+        Write-Verbose "Found $($value.GetType().Name) value: '$value'"
+        return $value
+    } finally {
+        # Dispose the sub key.
+        if ($subKey) {
+            $null = $subKey.Dispose()
+        }
+
+        # Dispose the base key.
+        if ($baseKey) {
+            $null = $baseKey.Dispose()
+        }
+    }
+}

_generated/XamarinAndroidV1/Strings/resources.resjson/de-DE/resources.resjson

@@ -0,0 +1,43 @@
+{
+  "loc.friendlyName": "Xamarin.Android",
+  "loc.helpMarkDown": "[Weitere Informationen zu dieser Aufgabe](https://go.microsoft.com/fwlink/?LinkID=613728) oder [Xamarin Android-Dokumentation anzeigen](https://docs.microsoft.com/xamarin/android/)",
+  "loc.description": "Android-App mit Xamarin erstellen",
+  "loc.instanceNameFormat": "Xamarin.Android-Projekt $(project) erstellen",
+  "loc.group.displayName.msbuildOptions": "MSBuild-Optionen",
+  "loc.group.displayName.jdkOptions": "JDK-Optionen",
+  "loc.input.label.project": "Projekt",
+  "loc.input.help.project": "Der relative Pfad vom Repositorystamm der zu erstellenden Xamarin.Android-Projekte. Platzhalter können verwendet werden ([weitere Informationen](https://go.microsoft.com/fwlink/?linkid=856077)). Beispiel: \"**/*.csproj\" für alle CSPROJ-Dateien in sämtlichen Unterordnern. Das Projekt muss ein PackageForAndroid-Ziel aufweisen, wenn \"App-Paket erstellen\" ausgewählt ist.",
+  "loc.input.label.target": "Ziel",
+  "loc.input.help.target": "Erstellt diese Ziele in diesem Projekt. Trennen Sie mehrere Ziele mit einem Semikolon.",
+  "loc.input.label.outputDir": "Ausgabeverzeichnis",
+  "loc.input.help.outputDir": "Geben Sie optional das Ausgabeverzeichnis für den Build an, z. B. \"$(build.binariesDirectory)/bin/Release\".",
+  "loc.input.label.configuration": "Konfiguration",
+  "loc.input.label.createAppPackage": "App-Paket erstellen",
+  "loc.input.help.createAppPackage": "Übergibt das Ziel (/t:PackageForAndroid) bei der Erstellung, um ein APK zu generieren.",
+  "loc.input.label.clean": "Bereinigen",
+  "loc.input.help.clean": "Übergibt das clean-Ziel (/t:clean) während des Buildvorgangs.",
+  "loc.input.label.msbuildLocationMethod": "MSBuild",
+  "loc.input.label.msbuildVersion": "MSBuild-Version",
+  "loc.input.help.msbuildVersion": "Wenn die bevorzugte Version nicht gefunden werden kann, wird stattdessen die neueste gefundene Version verwendet. Unter macOS wird xbuild (Mono) oder MSBuild (Visual Studio für Mac) verwendet.",
+  "loc.input.label.msbuildLocation": "MSBuild-Speicherort",
+  "loc.input.help.msbuildLocation": "Geben Sie optional den Pfad zu MSBuild (unter Windows) oder xbuild (unter macOS) an.",
+  "loc.input.label.msbuildArchitecture": "MSBuild-Architektur",
+  "loc.input.help.msbuildArchitecture": "Geben Sie optional die auszuführende MSBuild-Architektur an (x86, x64).",
+  "loc.input.label.msbuildArguments": "Zusätzliche Argumente",
+  "loc.input.help.msbuildArguments": "Zusätzliche Argumente, die an MSBuild (unter Windows) oder xbuild (unter macOS) übergeben werden.",
+  "loc.input.label.jdkSelection": "Für den Build zu verwendendes JDK auswählen",
+  "loc.input.help.jdkSelection": "Wählen Sie das während des Buildvorgangs zu verwendende JDK aus, indem Sie eine JDK-Version auswählen, die während des Buildvorgangs erkannt wird, oder indem Sie manuell einen JDK-Pfad eingeben.",
+  "loc.input.label.jdkVersion": "JDK-Version",
+  "loc.input.help.jdkVersion": "Verwendet während des Buildvorgangs die ausgewählte JDK-Version.",
+  "loc.input.label.jdkUserInputPath": "JDK-Pfad",
+  "loc.input.help.jdkUserInputPath": "Verwendet die JDK-Version im angegebenen Pfad beim Buildvorgang.",
+  "loc.input.label.jdkArchitecture": "JDK-Architektur",
+  "loc.input.help.jdkArchitecture": "Geben Sie optional die JDK-Architektur an (x86, x64).",
+  "loc.messages.LocateJVMBasedOnVersionAndArch": "JAVA_HOME für Java %s %s finden",
+  "loc.messages.UnsupportedJdkWarning": "JDK 9 und JDK 10 werden nicht unterstützt. Wechseln Sie in Ihrem Projekt und Ihrer Pipeline zu einer neueren Version. Es wird versucht, die Erstellung mit JDK 11 durchzuführen...",
+  "loc.messages.FailedToLocateSpecifiedJVM": "Die angegebene JDK-Version wurde nicht gefunden. Stellen Sie sicher, dass die angegebene JDK-Version auf dem Agent installiert und die Umgebungsvariable \"%s\" vorhanden und auf den Speicherort eines entsprechenden JDK festgelegt ist. Sie können auch die Aufgabe [Installer für Java-Tools](https://go.microsoft.com/fwlink/?linkid=875287) verwenden, um das gewünschte JDK zu installieren.",
+  "loc.messages.NoMatchingProjects": "Es wurden keine Dateien gefunden, die %s entsprechen.",
+  "loc.messages.XamarinAndroidBuildFailed": "%s\nWeitere Informationen hierzu finden Sie unter https://go.microsoft.com/fwlink/?LinkId=760847.",
+  "loc.messages.XamarinAndroidSucceeded": "Xamarin.Android-Aufgabenausführung ohne Fehler abgeschlossen.",
+  "loc.messages.MSB_BuildToolNotFound": "MSBuild oder Xbuild (Mono) wurden auf dem MacOS oder Linux-Agent nicht gefunden."
+}

_generated/XamarinAndroidV1/Strings/resources.resjson/en-US/resources.resjson

@@ -0,0 +1,43 @@
+{
+  "loc.friendlyName": "Xamarin.Android",
+  "loc.helpMarkDown": "[Learn more about this task](https://go.microsoft.com/fwlink/?LinkID=613728) or [see the Xamarin Android documentation](https://docs.microsoft.com/xamarin/android/)",
+  "loc.description": "Build an Android app with Xamarin",
+  "loc.instanceNameFormat": "Build Xamarin.Android project $(project)",
+  "loc.group.displayName.msbuildOptions": "MSBuild Options",
+  "loc.group.displayName.jdkOptions": "JDK Options",
+  "loc.input.label.project": "Project",
+  "loc.input.help.project": "Relative path from repo root of Xamarin.Android project(s) to build.  Wildcards can be used ([more information](https://go.microsoft.com/fwlink/?linkid=856077)).  For example, `**/*.csproj` for all csproj files in all subfolders.  The project must have a PackageForAndroid target if `Create App Package` is selected.",
+  "loc.input.label.target": "Target",
+  "loc.input.help.target": "Build these targets in this project. Use a semicolon to separate multiple targets.",
+  "loc.input.label.outputDir": "Output directory",
+  "loc.input.help.outputDir": "Optionally provide the output directory for the build. Example: $(build.binariesDirectory)/bin/Release.",
+  "loc.input.label.configuration": "Configuration",
+  "loc.input.label.createAppPackage": "Create app package",
+  "loc.input.help.createAppPackage": "Passes the target (/t:PackageForAndroid) during build to generate an APK.",
+  "loc.input.label.clean": "Clean",
+  "loc.input.help.clean": "Passes the clean target (/t:clean) during build.",
+  "loc.input.label.msbuildLocationMethod": "MSBuild",
+  "loc.input.label.msbuildVersion": "MSBuild version",
+  "loc.input.help.msbuildVersion": "If the preferred version cannot be found, the latest version found will be used instead. On macOS, xbuild (Mono) or MSBuild (Visual Studio for Mac) will be used.",
+  "loc.input.label.msbuildLocation": "MSBuild location",
+  "loc.input.help.msbuildLocation": "Optionally supply the path to MSBuild (on Windows) or xbuild (on macOS).",
+  "loc.input.label.msbuildArchitecture": "MSBuild architecture",
+  "loc.input.help.msbuildArchitecture": "Optionally supply the architecture (x86, x64) of MSBuild to run.",
+  "loc.input.label.msbuildArguments": "Additional arguments",
+  "loc.input.help.msbuildArguments": "Additional arguments passed to MSBuild (on Windows) or xbuild (on macOS).",
+  "loc.input.label.jdkSelection": "Select JDK to use for the build",
+  "loc.input.help.jdkSelection": "Pick the JDK to be used during the build by selecting a JDK version that will be discovered during builds or by manually entering a JDK path.",
+  "loc.input.label.jdkVersion": "JDK version",
+  "loc.input.help.jdkVersion": "Use the selected JDK version during build.",
+  "loc.input.label.jdkUserInputPath": "JDK path",
+  "loc.input.help.jdkUserInputPath": "Use the JDK version at specified path during build.",
+  "loc.input.label.jdkArchitecture": "JDK architecture",
+  "loc.input.help.jdkArchitecture": "Optionally supply the architecture (x86, x64) of JDK.",
+  "loc.messages.LocateJVMBasedOnVersionAndArch": "Locate JAVA_HOME for Java %s %s",
+  "loc.messages.UnsupportedJdkWarning": "JDK 9 and JDK 10 are out of support. Please switch to a later version in your project and pipeline. Attempting to build with JDK 11...",
+  "loc.messages.FailedToLocateSpecifiedJVM": "Failed to find the specified JDK version. Please ensure the specified JDK version is installed on the agent and the environment variable '%s' exists and is set to the location of a corresponding JDK or use the [Java Tool Installer](https://go.microsoft.com/fwlink/?linkid=875287) task to install the desired JDK.",
+  "loc.messages.NoMatchingProjects": "No files were found matching: %s.",
+  "loc.messages.XamarinAndroidBuildFailed": "%s\nSee https://go.microsoft.com/fwlink/?LinkId=760847.",
+  "loc.messages.XamarinAndroidSucceeded": "Xamarin.Android task execution completed with no errors.",
+  "loc.messages.MSB_BuildToolNotFound": "MSBuild or xbuild (Mono) were not found on the macOS or Linux agent."
+}

_generated/XamarinAndroidV1/Strings/resources.resjson/es-ES/resources.resjson

@@ -0,0 +1,43 @@
+{
+  "loc.friendlyName": "Xamarin.Android",
+  "loc.helpMarkDown": "[Obtener más información acerca de esta tarea](https://go.microsoft.com/fwlink/?LinkID=613728) o [consultar la documentación de Xamarin.Android](https://docs.microsoft.com/xamarin/android/)",
+  "loc.description": "Compilar una aplicación de Android con Xamarin",
+  "loc.instanceNameFormat": "Compilar proyecto Xamarin.Android $(project)",
+  "loc.group.displayName.msbuildOptions": "Opciones de MSBuild",
+  "loc.group.displayName.jdkOptions": "Opciones de JDK",
+  "loc.input.label.project": "Proyecto",
+  "loc.input.help.project": "Ruta de acceso relativa de la raíz del repositorio de los proyectos Xamarin.Android que se van a compilar. Se pueden usar caracteres comodín ([más información](https://go.microsoft.com/fwlink/?linkid=856077)). Por ejemplo, \"**\\*.csproj\" para todos los archivos csproj de todas las subcarpetas. El proyecto debe tener un destino PackageForAndroid si se seleccionó \"Crear paquete de aplicación\".",
+  "loc.input.label.target": "Destino",
+  "loc.input.help.target": "Compile estos destinos en este proyecto. Use puntos y comas para separar distintos destinos.",
+  "loc.input.label.outputDir": "Directorio de salida",
+  "loc.input.help.outputDir": "Si quiere, proporcione el directorio de salida de la compilación. Ejemplo: $(build.binariesDirectory)/bin/Release.",
+  "loc.input.label.configuration": "Configuración",
+  "loc.input.label.createAppPackage": "Crear paquete de aplicación",
+  "loc.input.help.createAppPackage": "Pasa el destino (/t:PackageForAndroid) durante la compilación para generar un APK.",
+  "loc.input.label.clean": "Limpiar",
+  "loc.input.help.clean": "Pasa el destino clean (/t:clean) durante la compilación.",
+  "loc.input.label.msbuildLocationMethod": "MSBuild",
+  "loc.input.label.msbuildVersion": "Versión de MSBuild",
+  "loc.input.help.msbuildVersion": "Si no se encuentra la versión preferida, se usará la versión más reciente que se encuentre. En macOS, se usará xbuild (Mono) o MSBuild (Visual Studio para Mac).",
+  "loc.input.label.msbuildLocation": "Ubicación de MSBuild",
+  "loc.input.help.msbuildLocation": "Si quiere, proporcione la ruta de acceso a MSBuild (en Windows) o xbuild (en macOS).",
+  "loc.input.label.msbuildArchitecture": "Arquitectura MSBuild",
+  "loc.input.help.msbuildArchitecture": "Indique opcionalmente la arquitectura (x86, x64) de MSBuild que se va a ejecutar.",
+  "loc.input.label.msbuildArguments": "Argumentos adicionales",
+  "loc.input.help.msbuildArguments": "Argumentos adicionales pasados a MSBuild (en Windows) o xbuild (en macOS).",
+  "loc.input.label.jdkSelection": "Seleccionar JDK que se va a usar para la compilación",
+  "loc.input.help.jdkSelection": "Elija el JDK que se usará durante la compilación seleccionando una versión de JDK que se detectará durante las compilaciones o escribiendo manualmente una ruta de acceso de JDK.",
+  "loc.input.label.jdkVersion": "Versión de JDK",
+  "loc.input.help.jdkVersion": "Use la versión de JDK seleccionada durante la compilación.",
+  "loc.input.label.jdkUserInputPath": "Ruta de acceso de JDK",
+  "loc.input.help.jdkUserInputPath": "Use la versión del JDK en la ruta de acceso especificada durante la compilación.",
+  "loc.input.label.jdkArchitecture": "Arquitectura JDK",
+  "loc.input.help.jdkArchitecture": "Indique opcionalmente la arquitectura (x86, x64) de JDK.",
+  "loc.messages.LocateJVMBasedOnVersionAndArch": "Buscar JAVA_HOME para Java %s %s",
+  "loc.messages.UnsupportedJdkWarning": "JDK 9 y JDK 10 no tienen soporte técnico. Cambie a una versión posterior del proyecto y la canalización. Intentando compilar con JDK 11...",
+  "loc.messages.FailedToLocateSpecifiedJVM": "No se encontró la versión de JDK especificada. Asegúrese de que dicha versión está instalada en el agente y de que la variable de entorno \"%s\" existe y está establecida en la ubicación de un JDK correspondiente. En caso contrario, use la tarea de [Instalador de herramientas de Java](https://go.microsoft.com/fwlink/?linkid=875287) para instalar el JDK deseado.",
+  "loc.messages.NoMatchingProjects": "No se han encontrado archivos que coincidan con %s.",
+  "loc.messages.XamarinAndroidBuildFailed": "%s\nVea https://go.microsoft.com/fwlink/?LinkId=760847.",
+  "loc.messages.XamarinAndroidSucceeded": "La ejecución de la tarea de Xamarin.Android ha finalizado sin errores.",
+  "loc.messages.MSB_BuildToolNotFound": "No se ha encontrado MSBuild o xbuild (Mono) en el agente de macOS o Linux."
+}