[ci] Add template for setting JAVA_HOME vars (#9671)

Adds a `setup-jdk-variables.yaml` template to set the `JAVA_HOME` and 
`JI_JAVA_HOME` variables from a single script location.

A new `JI_JAVA_HOME_DEFAULT` variable will also be set to point to a
current JDK that can be used to run various Android SDK tools as needed.

Consolidating this logic should make it easier to update the default
JDK version we install and/or test against in the future.

Build jobs and some test jobs that run on custom agents will use the
default android-toolchain path that xaprepare installs into.

Most other test jobs will attempt to use the value of a preinstalled JDK
found at `$JAVA_HOME_$(JAVA_VERSION)_$(OS_ARCH)` if it is defined.

Author: pjcollins

build-tools/automation/azure-pipelines-apidocs.yaml

@@ -100,10 +100,9 @@ extends:
         - checkout: self
           submodules: recursive
 
-        - script: |
-            echo "##vso[task.setvariable variable=JI_JAVA_HOME]$HOME/android-toolchain/jdk-17"
-            echo "##vso[task.setvariable variable=JAVA_HOME]$HOME/android-toolchain/jdk-17"
-          displayName: set JI_JAVA_HOME
+        - template: /build-tools/automation/yaml-templates/setup-jdk-variables.yaml@self
+          parameters:
+            useAgentJdkPath: false
 
         # Set MSBuild property overrides if parameters are set
         - ${{ if ne(parameters.apiLevel, 'default') }}:

build-tools/automation/azure-pipelines-nightly.yaml

@@ -123,7 +123,7 @@ stages:
     - template: /build-tools/automation/yaml-templates/setup-test-environment.yaml
       parameters:
         xaprepareScenario: EmulatorTestDependencies
-        jdkTestFolder: $(JAVA_HOME_11_X64)
+        jdkMajorVersion: 11
 
     - template: /build-tools/automation/yaml-templates/run-dotnet-preview.yaml
       parameters:
@@ -138,6 +138,7 @@ stages:
         avdApiLevel: $(avdApiLevel)
         avdAbi: $(avdAbi)
         avdType: $(avdType)
+        emulatorMSBuildArgs: -p:JavaSdkDirectory=$(JI_JAVA_HOME_DEFAULT)
 
     - template: /build-tools/automation/yaml-templates/apk-instrumentation.yaml
       parameters:
@@ -162,7 +163,6 @@ stages:
       emulatorMSBuildArgs: -p:TestAvdExtraBootArgs=-writable-system
       jobName: SystemApplicationTests
       jobTimeout: 120
-      jdkTestFolder: $HOME/android-toolchain/jdk-17
       use1ESTemplate: false
       testSteps:
       - template: run-nunit-tests.yaml
@@ -195,15 +195,11 @@ stages:
     steps:
     - template: agent-cleanser/v1.yml@yaml-templates
 
-    - script: |
-        echo "##vso[task.setvariable variable=JAVA_HOME]$HOME/android-toolchain/jdk-17"
-      displayName: set JAVA_HOME to $HOME/android-toolchain/jdk-17
-
     - template: /build-tools/automation/yaml-templates/setup-test-environment.yaml
       parameters:
         installTestSlicer: true
         xaprepareScenario: EmulatorTestDependencies
-        jdkTestFolder: $HOME/android-toolchain/jdk-17
+        useAgentJdkPath: false
 
     - task: DownloadPipelineArtifact@2
       inputs:
@@ -251,15 +247,11 @@ stages:
     steps:
     - template: agent-cleanser/v1.yml@yaml-templates
 
-    - script: |
-        echo "##vso[task.setvariable variable=JAVA_HOME]$HOME/android-toolchain/jdk-17"
-      displayName: set JAVA_HOME to $HOME/android-toolchain/jdk-17
-
     - template: /build-tools/automation/yaml-templates/setup-test-environment.yaml
       parameters:
         installTestSlicer: true
         xaprepareScenario: EmulatorTestDependencies
-        jdkTestFolder: $HOME/android-toolchain/jdk-17
+        useAgentJdkPath: false
 
     - task: DownloadPipelineArtifact@2
       inputs:

build-tools/automation/azure-pipelines.yaml

@@ -152,11 +152,6 @@ extends:
           inputs:
             forceReinstallCredentialProvider: true
 
-        - script: |
-            echo ##vso[task.setvariable variable=JI_JAVA_HOME]%JAVA_HOME_17_X64%
-            echo ##vso[task.setvariable variable=JAVA_HOME]%JAVA_HOME_17_X64%
-          displayName: set JI_JAVA_HOME, JAVA_HOME to $(JAVA_HOME_17_X64)
-
         - script: echo "##vso[task.prependpath]C:\Windows\System32\WindowsPowerShell\v1.0\"
           displayName: add powershell to path
 

build-tools/automation/yaml-templates/build-windows.yaml

@@ -39,9 +39,7 @@ stages:
 
     - template: /build-tools/automation/yaml-templates/clean.yaml
 
-    - script: |
-        echo ##vso[task.setvariable variable=JI_JAVA_HOME]%JAVA_HOME_17_X64%
-      displayName: set JI_JAVA_HOME to $(JAVA_HOME_17_X64)
+    - template: /build-tools/automation/yaml-templates/setup-jdk-variables.yaml
 
     - template: /build-tools/automation/yaml-templates/use-dot-net.yaml
       parameters:

build-tools/automation/yaml-templates/commercial-build.yaml

@@ -8,8 +8,9 @@ parameters:
   use1ESTemplate: true
 
 steps:
-- script: echo "##vso[task.setvariable variable=JI_JAVA_HOME]$HOME/android-toolchain/jdk-17"
-  displayName: set JI_JAVA_HOME
+- template: /build-tools/automation/yaml-templates/setup-jdk-variables.yaml
+  parameters:
+    useAgentJdkPath: false
 
 - template: /build-tools/automation/yaml-templates/use-dot-net.yaml
   parameters:

build-tools/automation/yaml-templates/run-emulator-tests.yaml

@@ -4,7 +4,8 @@ parameters:
   emulatorMSBuildArgs: ''
   jobName: CheckTimeZoneInfoIsCorrectNode1
   jobTimeout: 360
-  jdkTestFolder: $(JAVA_HOME_17_X64)
+  jdkMajorVersion: $(DefaultJavaSdkMajorVersion)
+  useAgentJdkPath: false
   testSteps: []
   use1ESTemplate: true
 
@@ -22,14 +23,11 @@ jobs:
     steps:
     - template: agent-cleanser/v1.yml@yaml-templates
 
-    - script: |
-        echo "##vso[task.setvariable variable=JAVA_HOME]${{ parameters.jdkTestFolder }}"
-      displayName: set JAVA_HOME to ${{ parameters.jdkTestFolder }}
-
     - template: /build-tools/automation/yaml-templates/setup-test-environment.yaml
       parameters:
         xaprepareScenario: EmulatorTestDependencies
-        jdkTestFolder: ${{ parameters.jdkTestFolder }}
+        jdkMajorVersion: ${{ parameters.jdkMajorVersion }}
+        useAgentJdkPath: ${{ parameters.useAgentJdkPath }}
 
     - task: DownloadPipelineArtifact@2
       inputs:

build-tools/automation/yaml-templates/setup-jdk-variables.yaml

@@ -0,0 +1,26 @@
+parameters:
+  jdkMajorVersion: $(DefaultJavaSdkMajorVersion)
+  useAgentJdkPath: true
+
+steps:
+- pwsh: |
+    $agentOS="$(Agent.OS)"
+    $agentArch="$(Agent.OSArchitecture)"
+    $jdkMajorVersion="${{ parameters.jdkMajorVersion }}"
+    $xaPrepareJdkPath="$env:HOME/android-toolchain/jdk-$jdkMajorVersion"
+    if ("$agentOS" -eq "Windows_NT") {
+      $xaPrepareJdkPath="$env:USERPROFILE\android-toolchain\jdk-$jdkMajorVersion"
+    }
+    $jdkHomePath=$xaPrepareJdkPath
+    if ("${{ parameters.useAgentJdkPath }}" -eq "true") {
+      $defaultJdkHomeVarName="JAVA_HOME_$(DefaultJavaSdkMajorVersion)_${agentArch}"
+      $defaultJdkHomePath=(Get-Item -Path "env:$defaultJdkHomeVarName").Value
+      $jdkHomeVarName="JAVA_HOME_${jdkMajorVersion}_${agentArch}"
+      $jdkHomePath=(Get-Item -Path "env:$jdkHomeVarName").Value
+    }
+    Write-Host "Setting variable 'JI_JAVA_HOME_DEFAULT' to '$defaultJdkHomePath'"
+    Write-Host "##vso[task.setvariable variable=JI_JAVA_HOME_DEFAULT]$defaultJdkHomePath"
+    Write-Host "Setting variable 'JAVA_HOME' and 'JI_JAVA_HOME' to '$jdkHomePath'"
+    Write-Host "##vso[task.setvariable variable=JAVA_HOME]$jdkHomePath"
+    Write-Host "##vso[task.setvariable variable=JI_JAVA_HOME]$jdkHomePath"
+  displayName: set JAVA_HOME and JI_JAVA_HOME

build-tools/automation/yaml-templates/setup-test-environment.yaml

@@ -1,7 +1,8 @@
 parameters:
   configuration: $(XA.Build.Configuration)
   xaSourcePath: $(System.DefaultWorkingDirectory)
-  jdkTestFolder: $(JAVA_HOME_17_X64)
+  jdkMajorVersion: $(DefaultJavaSdkMajorVersion)
+  useAgentJdkPath: true
   remove_dotnet: false
   dotnetVersion: $(DotNetSdkVersion)
   dotnetQuality: $(DotNetSdkQuality)
@@ -21,17 +22,10 @@ steps:
     clean: true
     submodules: recursive
 
-- script: |
-    echo "##vso[task.setvariable variable=JI_JAVA_HOME]${{ parameters.jdkTestFolder }}"
-    echo "##vso[task.setvariable variable=DOTNET_TOOL_PATH]${{ parameters.xaSourcePath }}/bin/${{ parameters.configuration }}/dotnet/dotnet"
-  displayName: set JI_JAVA_HOME to ${{ parameters.jdkTestFolder }}
-  condition: and(succeeded(), ne(variables['agent.os'], 'Windows_NT'))
-
-- script: |
-    echo ##vso[task.setvariable variable=JI_JAVA_HOME]${{ parameters.jdkTestFolder }}
-    echo ##vso[task.setvariable variable=DOTNET_TOOL_PATH]${{ parameters.xaSourcePath }}\bin\${{ parameters.configuration }}\dotnet\dotnet.exe
-  displayName: set JI_JAVA_HOME to ${{ parameters.jdkTestFolder }}
-  condition: and(succeeded(), eq(variables['agent.os'], 'Windows_NT'))
+- template: /build-tools/automation/yaml-templates/setup-jdk-variables.yaml
+  parameters:
+    jdkMajorVersion: ${{ parameters.jdkMajorVersion }}
+    useAgentJdkPath: ${{ parameters.useAgentJdkPath }}
 
 # Install latest .NET
 - template: /build-tools/automation/yaml-templates/use-dot-net.yaml

build-tools/automation/yaml-templates/variables.yaml

@@ -58,6 +58,8 @@ variables:
   value: $[or(startsWith(variables['Build.SourceBranch'], 'refs/heads/release/'), startsWith(variables['System.PullRequest.TargetBranch'], 'release/'))]
 - name: DefaultTestSdkPlatforms  # Comma-separated SDK Platform(s) to install on test agents (no spaces)
   value: 35,Baklava
+- name: DefaultJavaSdkMajorVersion
+  value: 17
 - name: ExcludedNightlyNUnitCategories
   value: 'cat != SystemApplication & cat != TimeZoneInfo & cat != Localization'
 - name: RunMAUITestJob

build-tools/scripts/TestApks.targets

@@ -380,6 +380,7 @@
     <!-- SDK component installation can be frail, try a few times. -->
     <Exec
         Command="&quot;$(CommandLineToolsBinPath)\sdkmanager&quot; &quot;$(SdkManagerImageName)&quot;"
+        EnvironmentVariables="JAVA_HOME=$(JavaSdkDirectory)"
         ContinueOnError="true">
       <Output TaskParameter="ExitCode" PropertyName="_SdkManagerExitCode" />
     </Exec>
@@ -389,6 +390,7 @@
     />
     <Exec
         Command="&quot;$(CommandLineToolsBinPath)\sdkmanager&quot; &quot;$(SdkManagerImageName)&quot;"
+        EnvironmentVariables="JAVA_HOME=$(JavaSdkDirectory)"
         ContinueOnError="true"
         Condition=" '$(_SdkManagerExitCode)' != '0' ">
       <Output TaskParameter="ExitCode" PropertyName="_SdkManagerExitCode" />
@@ -399,6 +401,7 @@
     />
     <Exec
         Command="&quot;$(CommandLineToolsBinPath)\sdkmanager&quot; &quot;$(SdkManagerImageName)&quot;"
+        EnvironmentVariables="JAVA_HOME=$(JavaSdkDirectory)"
         ContinueOnError="true"
         Condition=" '$(_SdkManagerExitCode)' != '0' ">
       <Output TaskParameter="ExitCode" PropertyName="_SdkManagerExitCode" />