能否在单个VSIX中打包多个VSTS自定义构建任务？

当然可以！虽然单一职责原则建议为独立功能的任务创建单独扩展，但把多个关联性强的自定义任务打包进同一个VSIX是完全支持的——这种方式能让用户一次性安装一组相关工具，提升使用体验。

推荐的文件结构 #

假设你有两个自定义任务TaskA和TaskB，可以采用这样的目录结构来管理：

my-multi-task-extension/
├── extensions.json
├── images/
│   └── logo.png  # 扩展的主图标
├── tasks/
│   ├── TaskA/
│   │   ├── task.json
│   │   ├── icon.png
│   │   └── (TaskA的其他依赖文件，比如PowerShell脚本、C# DLL等)
│   └── TaskB/
│       ├── task.json
│       ├── icon.png
│       └── (TaskB的其他依赖文件，比如Python脚本、配置文件等)

核心扩展清单（extensions.json）示例 #

这个清单文件是扩展的核心，用来定义扩展信息并注册所有任务：

{
  "manifestVersion": 1,
  "id": "my-multi-task-extension",
  "name": "我的多任务扩展",
  "version": "1.0.0",
  "publisher": "你的发布者ID",
  "targets": [
    {
      "id": "Microsoft.VisualStudio.Services"
    }
  ],
  "description": "一组用于Azure DevOps的关联自定义构建/发布任务",
  "categories": [
    "Build and release"
  ],
  "icons": {
    "default": "images/logo.png"
  },
  "files": [
    // 包含TaskA的所有文件到VSIX包中
    {
      "path": "tasks/TaskA",
      "addressable": true,
      "packagePath": "tasks/TaskA"
    },
    // 包含TaskB的所有文件到VSIX包中
    {
      "path": "tasks/TaskB",
      "addressable": true,
      "packagePath": "tasks/TaskB"
    }
  ],
  "contributions": [
    // 注册TaskA到Azure DevOps
    {
      "id": "custom-task-a",
      "type": "ms.vss-distributed-task.task",
      "targets": [
        "ms.vss-distributed-task.tasks"
      ],
      "properties": {
        "name": "tasks/TaskA"
      }
    },
    // 注册TaskB到Azure DevOps
    {
      "id": "custom-task-b",
      "type": "ms.vss-distributed-task.task",
      "targets": [
        "ms.vss-distributed-task.tasks"
      ],
      "properties": {
        "name": "tasks/TaskB"
      }
    }
  ]
}

关键部分说明 #

• files数组：指定要包含进VSIX的文件目录，每个任务的目录都需要单独配置，确保所有依赖文件被打包。
• contributions数组：每个条目对应一个自定义任务的注册，告诉Azure DevOps平台有这个任务存在，properties.name指向任务的目录路径。

打包与验证 #

1. 先安装Azure DevOps扩展工具tfx-cli：

npm install -g tfx-cli

2. 在扩展根目录运行打包命令：

tfx extension create --manifest-globs extensions.json

执行完成后，会生成一个.vsix文件，包含所有自定义任务。

后续拆分的灵活性 #

如果之后你想遵循单一职责原则拆分每个任务到独立VSIX，操作也很简单：

• 把对应任务的目录（比如TaskA）复制到新的扩展项目
• 新建一个extensions.json，只保留该任务的files和contributions配置
• 重新打包即可

内容的提问来源于stack exchange，提问作者Thad Peiffer