Azure DevOps扩展开发：vss-extension.json中contributions配置项的type与targets参数说明及相关文档咨询

I’ve built a few Azure DevOps custom task extensions before, so let’s break down your questions clearly:

What do ms.vss-distributed-task.task and ms.vss-distributed-task.tasks mean? #

• ms.vss-distributed-task.task: This is the contribution type—think of it as a label that tells Azure DevOps exactly what kind of extension component you’re adding. For custom build/release tasks, this is the mandatory type you need to use. Without it, the platform won’t recognize your contribution as a runnable task in pipelines.
• ms.vss-distributed-task.tasks: This is the target location where your task gets registered. It’s like the "category" or "library" in Azure DevOps where your task will appear when users are picking tasks for their build/release pipelines. By targeting this value, you’re ensuring your task shows up in the global list of available tasks for anyone who installs your extension.

Are there other valid parameter values? #

Yep, there are plenty, depending on what kind of extension you’re building. Here are some key ones:

For task-related contributions #

• Alternate types: If you’re packaging a task group instead of a single task, you’d use ms.vss-distributed-task.task-group as the type. For core individual tasks though, ms.vss-distributed-task.task is the standard.
• Alternate targets: Most general-purpose tasks use ms.vss-distributed-task.tasks, but if you wanted to tie a task to a specific service integration (like Azure Resource Manager), you might see more niche targets—but those are rare for basic task extensions. For private tasks (only visible to your organization), you don’t change the target; instead, adjust your extension’s visibility settings in the manifest.

For other extension types (if you expand later) #

• Type: ms.vss-web.hub (adds a custom navigation hub in the Azure DevOps portal)
• Type: ms.vss-dashboards.widget (creates a custom dashboard widget)
• Target: ms.vss-web.project-hub-group (places your custom hub under the project-level navigation menu)

Where can I find official documentation? #

The official Azure DevOps Extension SDK docs have all the details you need. Look for these specific sections:

1. Contribution Model Overview: Explains how contributions work, including the relationship between types and targets.
2. Custom Build/Release Task Extension Guide: Walks through the exact contributions configuration for task extensions, with examples.
3. vss-xtension.json Schema Reference: A comprehensive list of all valid contribution types, targets, and other manifest parameters, with descriptions for each.

You can find these docs directly in the Azure DevOps developer documentation—just search for "Azure DevOps extension manifest contributions" to locate the relevant pages.

内容的提问来源于stack exchange，提问作者Frédéric De Lène Mirouze