貢獻模型

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

延伸模組會藉由提供貢獻，以及定義其他擴充功能插入的方式，將新功能新增至系統中。 參與類型會定義可以新增至系統的專案。 參與是參與類型的特定實例。 例如， hub 是由核心 Microsoft 提供的延伸模組所定義的參與類型。 建 Explorer 置中樞群組底下的中樞是 類型 hub的特定貢獻。

如需詳細資訊，請參閱下列參考資料：

• 擴充點
• azure-devops-extension-api
• azure-devops-extension-sdk

貢獻類型

參與 類型 會定義合約，該類型系統的所有貢獻都必須遵守。 參與類型也可以從另一個貢獻類型延伸。 下列參與類型的範例會定義該類型的實體所設定的屬性：

• hub
• action
• build-task

每個屬性定義都會指定下列層面：

• 屬性類型，例如字串、布爾值等等。
• 屬性是否為必要專案
• 默認值，如果未由貢獻指定（選擇性）。

範例

以下是延伸模組指令清單中參與類型宣告的範例：

{
    ...
    "contributionTypes": [
        {
            "id": "hub",
            "name": "Web Access Hub",
            "description": "A hub that appears in the hubs menu at the top of web pages.",
            "properties": {
                "name": {
                    "description": "The text to display for the hub",
                    "type": "string",
                    "required": true
                },
                "uri": {
                    "description": "URI of the contents of the hub page",
                    "type": "string",
                    "required": true
                },
                "order": {
                    "description": "An optional ordering value which can indicate in which position to place the hub within the hub group",
                    "type": "integer"
                }
				...
            }
        }
    ]
}

投稿文章

參與是參與類型的實例。 例如， Queries 工作中樞群組底下的中樞是 類型 hub 的貢獻，而 Publish Test Results 建置工作是 類型 build-task的貢獻。

所有貢獻都必須指定類型，併為該貢獻類型所需的任何屬性指定值。

範例

以下是延伸模組指令清單中中樞貢獻宣告的範例：

{
    "contributions": [
        {
            "id": "build-explorer-hub",
            "type": "ms.vss-web.hub",
            "targets": [
                ".build-hub-group"
            ],
            "properties": {
                "name": "Explorer",
                "uri": "/_build",
                "order": 22
            }
        }
    ]
}

目標貢獻

參與可以 針對 一或多個其他參與，這會建立參與與其每個目標之間的關聯性。 系統可以在運行時間探索目標的貢獻。 例如， hub 貢獻 （Explorer） 可能會以特定 hub-group 貢獻 （Build） 為目標。

{
    "id": "build-explorer-hub",
    "type": "ms.vss-web.hub",
    "targets": [
        ".build-hub-group"
    ]
}

當中樞群組轉譯時，系統可以查詢以中樞群組為目標的所有中樞貢獻，以瞭解要轉譯的中樞。

識別貢獻和類型

每個參與和貢獻類型在宣告的延伸模組內都必須有唯一標識符。

完整貢獻識別碼包含下列專案，您會以點.分隔：

• 發行者標識碼
• 擴充識別碼
• 參與/類型標識碼

例如： ms.vss-web.hub 是下列貢獻的完整識別碼：

• 發行者識別碼： ms
• 延伸模組識別碼： vss-web
• 參與/類型識別碼： hub

您可以在延伸模組指令清單內使用 相對 貢獻參考，以參考該相同延伸模組內另一個貢獻或貢獻類型。 在此情況下，不會包含發行者和延伸模組標識碼，而且標識碼是一個點 . ，後面接著貢獻標識符。 例如， .hub 可以在先前所述的延伸模組內 vss-web 使用，做為 的 ms.vss-web.hub快捷方式。