Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
延伸模組會將功能新增至 Azure DevOps UI 和 REST 介面。 本文列出您可以鎖定的最常見擴充點,並顯示您在延伸模組資訊清單中使用的識別碼。 如需延伸模組模型和貢獻模式的概觀,請參閱貢獻 模型。
小提示
如果您要啟動新的 Azure DevOps 延伸模組,請先嘗試這些維護的範例集合,它們可與目前的產品組建搭配使用,並涵蓋新式案例 (例如,在提取要求頁面上新增索引標籤) 。
- Azure DevOps 延伸模組範例 (GitHub) — 示範常見延伸模組模式的精簡入門範例: https://github.com/microsoft/azure-devops-extension-sample
- Azure DevOps 延伸模組範例 (舊版集合和貢獻指南) — 安裝以檢查 UI 目標,或檢視來源: https://marketplace.visualstudio.com/items/ms-samples.samples-contributions-guide 和 https://github.com/Microsoft/vso-extension-samples/tree/master/contributions-guide
- Microsoft Learn 範例(瀏覽 Azure DevOps 範例)— Microsoft 文件中精選的最新範例:/samples/browse/?terms=azure%20devops%20extension
如果範例在您的組織中無法運作,請將它安裝到個人或測試組織中,並將擴充功能資訊清單的目標識別碼和 API 版本與現有的文件進行比較。如需參考和 API,請參見:
集線器和集線器群組
中樞和中樞群組會在 Azure DevOps 中提供主要導覽 (例如, 檔案、 版本、 待辦專案、 查詢) 。 中樞屬於中樞群組;例如, 檔案 中樞屬於專案層級 Azure Repos 中樞群組。 中樞群組可以存在於組織/集合層級或專案層級。 大部分的延伸模組都會於專案層級進行貢獻。
下表列出常見的中樞群組及其貢獻 ID。
| 名稱 | ID | 等級 | 預覽影像 |
|---|---|---|---|
| Azure Boards | ms.vss-work-web.work-hub-group |
專案/小組 |
|
| Azure Repos | ms.vss-code-web.code-hub-group |
專案/小組 |
|
| Azure Pipelines | ms.vss-build-web.build-release-hub-group |
專案/小組 |
|
| Azure Test Plans | ms.vss-test-web.test-hub-group |
專案/小組 |
|
| 專案設定 | ms.vss-web.project-admin-hub-group |
專案 |
|
| 組織設定 | ms.vss-web.collection-admin-hub-group |
組織/收藏 |
|
貢獻一個樞紐
此範例顯示以程式碼中樞群組為目標的中樞貢獻:
{
"contributions": [
{
"id": "my-custom-hub",
"type": "ms.vss-web.hub",
"targets": [
"ms.vss-code-web.code-hub-group"
],
"properties": {
"name": "Code Hub",
"order": 30,
"uri": "/views/code/custom.html"
}
}
]
}
-
ms.vss-web.hub是貢獻的類型。vss-web擴充功能由ms出版商發布並定義這種類型。 此類型定義了此類貢獻的可選性與必修屬性(例如名稱、順序)。 -
ms.vss-code-web.code-hub-group是此 Hub 所針對的 Hub 組貢獻的完整 ID。 在ms出版商名下發布的vss-code-web擴充功能聲明此貢獻。 -
my-custom-hub是此貢獻的短 ID;{publisherId}.{extensionId}.my-custom-hub是完整的ID。
將圖示新增至功能表或工具列
新增圖示屬性,這樣你可以直接用名稱來參考。
建議您提供您自己的圖示。 使用您自己的圖示作為範例:
"name": "Sample hub",
"uri": "dist/Hub/Hub.html",
"icon": "asset://static/sample-icon.png",
"supportsMobile": true
}
使用 Office UI Fabric Icons 的範例:
"iconName": "Code",
"name": "Code Hub",
"order": 30,
"uri": "/views/code/custom.html"
}
備註
圖示和 iconiconName 屬性不支援分頁貢獻。 它們只適用於中樞、選單和工具列。
功能表和工具列的設定
| 名稱 | 目標標識碼 |
|---|---|
| 組織/集合概觀工具列 | ms.vss-admin-web.collection-overview-toolbar-menu |
| 集合概觀專案方格 | ms.vss-admin-web.projects-grid-menu |
| 專案概觀工具列 | ms.vss-admin-web.project-overview-toolbar-menu |
| 專案概觀團隊網格 | ms.vss-admin-web.teams-grid-menu |
Azure Boards 選單和工具列
| 名稱 | 目標標識碼 | 預覽影像 |
|---|---|---|
| 工作項目查詢功能表 | ms.vss-work-web.work-item-query-menu |
|
| 工作項目查詢結果的工具列選單 | ms.vss-work-web.work-item-query-results-toolbar-menu |
|
| 工作專案查詢結果選單項目 | ms.vss-work-web.query-result-work-item-menu |
|
| 工作項目查詢結果標籤 | ms.vss-work-web.query-tabs |
|
| 右鍵選單的工作項目 | ms.vss-work-web.work-item-toolbar-menu |
|
| 待辦工作項目清單 | ms.vss-work-web.backlog-item-menu |
|
| 衝刺板篩選選單 | ms.vss-work-web.sprint-board-pivot-filter-menu |
|
| 面板樞紐篩選功能表 | ms.vss-work-web.backlog-board-pivot-filter-menu |
|
| 卡片選單 | ms.vss-work-web.backlog-board-card-item-menu |
|
| 產品待辦清單分頁 | ms.vss-work-web.product-backlog-tabs |
|
| 反覆待辦事項標籤 | ms.vss-work-web.iteration-backlog-tabs |
|
| 公事包待辦專案窗格 | ms.vss-work-web.portfolio-backlog-toolpane |
|
| 產品待辦清單視窗 | ms.vss-work-web.requirement-backlog-toolpane |
|
| 迭代待辦事項窗格 | ms.vss-work-web.iteration-backlog-toolpane |
|
Azure Pipelines 功能表和工具列
| 名稱 | 目標標識碼 | 預覽 |
|---|---|---|
| 已完成建立選單 | ms.vss-build-web.completed-build-menu |
|
| 定義建立選單 | ms.vss-build-web.build-definition-menu |
|
| 測試結果工具列動作 | ms.vss-test-web.test-results-actions-menu |
|
| 測試結果詳細標籤 | ms.vss-test-web.test-result-details-tab-items |
|
| 發行管線檢視器內容功能表 | ms.vss-releaseManagement-web.release-definition-explorer-context-menu |
|
| 發行管線檢視器工具列選單 | ms.vss-releaseManagement-web.release-definition-explorer-toolbar-menu |
|
| 發佈摘要工具列選單 | ms.vss-releaseManagement-web.release-editor-tool-bar-menu |
|
| 發行摘要標籤 | ms.vss-releaseManagement-web.release-details-view |
|
| 發行摘要區段 | ms.vss-releaseManagement-web.release-details-summary-tab |
|
Azure Pipelines 功能表和工具列
| 名稱 | 目標標識碼 | 預覽 |
|---|---|---|
| 已完成建立選單 | ms.vss-build-web.completed-build-menu |
|
| 測試結果工具列動作 | ms.vss-test-web.test-results-actions-menu |
|
| 測試結果詳細標籤 | ms.vss-test-web.test-result-details-tab-items |
|
| 發行管線檢視器內容功能表 | ms.vss-releaseManagement-web.release-definition-explorer-context-menu |
|
| 管線細節檢視,標題按鈕 | ms.vss-build-web.pipelines-header-menu |
|
| 管線詳細資料檢視,資料夾內容功能表 | ms.vss-build-web.pipelines-folder-menu |
|
Azure Pipelines 任務
工作會在構建或釋出過程中執行。 有關詳細資訊,請參閱 添加自定義管道任務擴展。
Azure Repos 功能表和工具列
| 名稱 | 目標標識碼 | 預覽影像 |
|---|---|---|
| 來源項目(網格)功能表 | ms.vss-code-web.source-grid-item-menu |
|
| 來源項目樹狀選單 | ms.vss-code-web.source-tree-item-menu |
|
| 來源項目【格狀和樹狀】選單 | ms.vss-code-web.source-item-menu |
|
| 變更列表項目選單 | ms.vss-code-web.change-list-item-menu |
|
| 修改清單總結項目功能表 | ms.vss-code-web.change-list-summary-item-menu |
|
| Git 分支樹狀菜單 | ms.vss-code-web.git-branches-tree-menu |
|
| Git 拉取請求動作選單 | ms.vss-code-web.pull-request-action-menu |
|
| Git 拉取請求標籤頁 | ms.vss-code-web.pr-tabs |
|
| Git 提交列表功能表 | ms.vss-code-web.git-commit-list-menu |
|
| Git 提交詳細功能表 | ms.vss-code-web.git-commit-details-menu |
|
Azure 測試計劃功能表和工具列
| 名稱 | 目標標識碼 | 預覽影像 |
|---|---|---|
| 測試執行網格選單 | ms.vss-test-web.test-run-grid-menu |
|
| 測試計畫套件樹狀選單 | ms.vss-test-web.test-plans-suites-context |
|
| 測試計劃中心旋轉標籤 | ms.vss-test-web.test-plan-pivot-tabs |
|
其他擴充點
- 儀表板小工具:擴充功能可以貢獻一種新的小工具類型,使用者可以新增到 儀表板中。 瞭解如何 貢獻儀錶板小工具。
- 工作項目表單:擴充功能透過新增區段、分頁、動作及自訂欄位渲染器來強化工作項目表單。 如需詳細資訊,請瞭解如何 擴充工作項目窗體。
- 服務掛鉤: 消費者 是服務掛鉤傳送事件的服務對象。 擴充套件可以提供使用者服務。 使用者(或程式化)會將這些服務設定為將事件傳送到該服務。 有關更多資訊,請參閱 為服務挂鉤創建自定義消費者。