Task Reference

Mon, 01 Jan 0001 00:00:00 +0000

ALCopsDownloadAnalyzers@1

Download ALCops analyzer DLLs with automatic target framework detection.

Inputs

Input	Required	Default	Description
`detectUsing`	No		Input for TFM auto-detection. Accepts a BC artifact URL, a local compiler path, a channel (`latest`, `preview`, `current`), or a specific version number.
`detectFrom`	No	(auto)	Force the detection source: `bc-artifact`, `marketplace`, `nuget-devtools`, or `compiler-path`. When omitted, the task infers the source from the format of `detectUsing`.
`tfm`	No		Explicit target framework: `netstandard2.1`, `net8.0`, or `net10.0`. Skips detection entirely.
`version`	No	`latest`	ALCops package version to download: `latest`, `preview`, or a pinned version (e.g., `1.2.3`).
`outputPath`	No	`$(Build.SourcesDirectory)/.alcops`	Directory where analyzer DLLs are extracted.

Output variables

Reference these using the task’s name attribute (e.g., $(ALCopsDownload.version)).

Examples

Mon, 01 Jan 0001 00:00:00 +0000

Each example shows the ALCops-relevant steps. Full working pipelines are available in the demo repository .

All examples use the same pattern:

Download analyzers with ALCopsDownloadAnalyzers@1
Pass DLLs to the compiler via /analyzer flags or your build tool’s analyzer parameter

NuGet DevTools (`dotnet al`)

Cross-platform. Uses the BC Development Tools from NuGet for compilation. No Docker, no BC artifacts required for the compiler itself.

- task: ALCopsDownloadAnalyzers@1
 name: ALCopsDownload
 displayName: ALCops - Download Analyzers
 inputs:
 detectUsing: "latest"
 detectFrom: "nuget-devtools"

- pwsh: |
 $alcopsPath = "$(ALCopsDownload.outputDir)"

 dotnet al compile `
 "/project:$(Build.SourcesDirectory)" `
 "/analyzer:$alcopsPath/ALCops.ApplicationCop.dll" `
 "/analyzer:$alcopsPath/ALCops.DocumentationCop.dll" `
 "/analyzer:$alcopsPath/ALCops.FormattingCop.dll" `
 "/analyzer:$alcopsPath/ALCops.LinterCop.dll" `
 "/analyzer:$alcopsPath/ALCops.PlatformCop.dll" `
 "/analyzer:$alcopsPath/ALCops.TestAutomationCop.dll" `
 "/analyzer:$alcopsPath/ALCops.Common.dll"

Full pipeline