From f74c15f6f57938a24b11578dcb5a890582aff604 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Thu, 23 Apr 2026 14:48:10 -0500 Subject: [PATCH 1/4] [Build] Pin 1ES pipeline template to refs/tags/release in apidocs pipeline Without an explicit ref, Azure DevOps resolves to refs/heads/release in the MicroBuildTemplate repo, where v1/1ES.Official.PipelineTemplate.yml no longer exists. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- build-tools/automation/azure-pipelines-apidocs.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/build-tools/automation/azure-pipelines-apidocs.yaml b/build-tools/automation/azure-pipelines-apidocs.yaml index bafabba812d..61d41658217 100644 --- a/build-tools/automation/azure-pipelines-apidocs.yaml +++ b/build-tools/automation/azure-pipelines-apidocs.yaml @@ -13,6 +13,7 @@ resources: - repository: 1esPipelines type: git name: 1ESPipelineTemplates/MicroBuildTemplate + ref: refs/tags/release parameters: - name: apiLevel From 1e70f2e2f5d06064e82a724eb487779be46ba928 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Thu, 23 Apr 2026 15:01:55 -0500 Subject: [PATCH 2/4] [Build] Use 1ESPipelineTemplates repo instead of deprecated MicroBuildTemplate The MicroBuildTemplate repo has been deprecated and no longer contains the v1/ template files. The templates now live in the 1ESPipelineTemplates/1ESPipelineTemplates repo. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- build-tools/automation/azure-pipelines-apidocs.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build-tools/automation/azure-pipelines-apidocs.yaml b/build-tools/automation/azure-pipelines-apidocs.yaml index 61d41658217..5bdbd58d155 100644 --- a/build-tools/automation/azure-pipelines-apidocs.yaml +++ b/build-tools/automation/azure-pipelines-apidocs.yaml @@ -12,7 +12,7 @@ resources: repositories: - repository: 1esPipelines type: git - name: 1ESPipelineTemplates/MicroBuildTemplate + name: 1ESPipelineTemplates/1ESPipelineTemplates ref: refs/tags/release parameters: From fa0f4eab609d1db08f054a9b7bcb407feb266fc0 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Thu, 23 Apr 2026 15:46:02 -0500 Subject: [PATCH 3/4] [Build] Fix DocsApiLevel to use AndroidApiLevel instead of hardcoded value DocsApiLevel was hardcoded to 36, but AndroidApiLevel is now 36.1. This caused _RunMdoc to look for assemblies in the 36.1/ directory while _UpdateExternalDocumentation built them into 36/, resulting in 'No assemblies specified' from mdoc. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- src/Mono.Android/Mono.Android.targets | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Mono.Android/Mono.Android.targets b/src/Mono.Android/Mono.Android.targets index 900e4a1c651..6f2fab65325 100644 --- a/src/Mono.Android/Mono.Android.targets +++ b/src/Mono.Android/Mono.Android.targets @@ -240,7 +240,7 @@ - 36 + $(AndroidApiLevel) $(DocsApiLevel) net-android-$(DocsApiLevel).0 $(_MonoAndroidNETDefaultOutDir)Mono.Android.xml From 48349d5c80190fc3e4675aa566991f77e451ad0f Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Thu, 23 Apr 2026 17:15:49 -0500 Subject: [PATCH 4/4] [Build] Use agent's preinstalled JDK in apidocs pipeline The pipeline was using useAgentJdkPath: false which sets JAVA_HOME to ~/android-toolchain/jdk-17, a path that no longer exists on the Mac build agents. Switch to the default (useAgentJdkPath: true) to use the agent's preinstalled JDK instead. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- build-tools/automation/azure-pipelines-apidocs.yaml | 2 -- 1 file changed, 2 deletions(-) diff --git a/build-tools/automation/azure-pipelines-apidocs.yaml b/build-tools/automation/azure-pipelines-apidocs.yaml index 5bdbd58d155..fcfd00281f0 100644 --- a/build-tools/automation/azure-pipelines-apidocs.yaml +++ b/build-tools/automation/azure-pipelines-apidocs.yaml @@ -101,8 +101,6 @@ extends: submodules: recursive - 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') }}: