如何在Azure DevOps清单文件中配置扩展与Boards等同级显示？

要让自定义扩展与Azure Boards、Repos、Pipeline等模块在顶部导航栏处于同一层级，你需要在扩展清单中创建顶级Hub Group（中心组），再将自定义Hub关联到这个组。具体配置步骤如下：

1. 定义顶级Hub Group #

在清单的contributions数组中添加一个类型为ms.vss-web.hub-group的贡献，目标指向全局导航栏节点ms.vss-web.nav-bar：

{
  "id": "custom-top-hub-group",
  "type": "ms.vss-web.hub-group",
  "targets": [
    "ms.vss-web.nav-bar"
  ],
  "properties": {
    "name": "我的自定义模块", // 导航栏显示的名称
    "icon": "images/custom-icon.png", // 导航栏图标路径（需包含在扩展包中）
    "order": 100 // 控制导航栏排序，数字越大越靠后；默认Boards是10、Repos是20、Pipelines是30
  }
}

2. 关联自定义Hub到新的Hub Group #

接着添加自定义Hub的贡献，将目标指向你刚创建的Hub Group ID：

{
  "id": "custom-top-hub",
  "type": "ms.vss-web.hub",
  "targets": [
    "custom-top-hub-group" // 对应上面Hub Group的ID
  ],
  "properties": {
    "name": "主页面", // Hub显示的名称
    "uri": "index.html" // 扩展页面的入口路径
  }
}

关键说明 #

• 之前你实现的是将Hub挂载到现有Hub Group（比如Boards的ms.vss-work-web.work-hub-group）下，而现在需要独立创建自己的顶级Hub Group才能和默认模块同级。
• order属性决定了你的模块在导航栏中的位置，可根据需求调整数值，比如设置为40就能放在Pipelines之后。
• 图标文件需要打包到扩展中，确保路径正确；也可以使用微软提供的图标类名（比如icon-build）替代图片路径。

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