打包並發佈整合

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

在 Visual Studio 市集發佈與 Azure DevOps 整合的工具、服務或產品。 市集是用戶發現整合與擴充的核心平台。

先決條件

發佈至 Marketplace 之前，必須先符合下列需求清單。

你還需要以下資產：

• 至少要有一張關於你的系統集成的截圖
• 一個給使用者的行動呼籲或入門網址

建立發行者

每個延伸模組或整合，包括來自Microsoft的擴充功能，都必須有發行者。 任何人都可以建立發行者，並在其下發佈延伸模組。 您也可以與其他使用者共享發行者存取權，例如您的開發小組。

1. 登入 Visual Studio Marketplace 發佈入口網站。

2. 如果您不是現有發行者的一部分，請選取 [+ 建立發行者]。
   輸入發行者名稱;標識元欄位會根據您的項目自動填入。

   

   備註

   • 確保您的發行者名稱在多字節字符的16個字元內。
   • 儲存發行者識別碼—您需要它於延伸模組的指令清單檔案中。

   如果未提示您建立發行者，請卷動至 [相關網站] 底下的 [發佈延伸模組]。

   • 設定唯一的發行者識別碼，例如 mycompany-myteam。 將此數值用於您的 manifest 檔中的 publisher 屬性。
   • 設定顯示名稱，例如 My Team。

3. 檢閱 Marketplace 發行者合約，然後選取 [建立]。

   

建立發行者之後，您可以管理項目，但您發佈之前，項目不會顯示。

建立專案架構

建立以下目錄配置：

home/
├── images/
│   ├── integration-logo.png    (128×128 px minimum)
│   └── screenshot.png          (1366×768 px)
├── overview.md
└── vss-integration.json

建立清單檔

請先建立 vss-integration.json 以下內容，然後更新整合值：

{
    "manifestVersion": 1,
    "id": "myservice",
    "version": "1.0.0",
    "name": "My Service",
    "publisher": "mycompany",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ],    
    "icons": {
        "default": "images/service-logo.png"
    },
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "screenshots": [
        {
            "path": "images/screen1.png"
        },
        {
            "path": "images/screen2.png"
        }
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "fabrikam-license-terms.md"
        }
    },
    "links": {
        "getstarted": {
            "uri": "https://www.mycompany.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.mycompany.com/features"
        },
        "support": {
            "uri": "https://www.mycompany.com/support"
        }
    },
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    }
}

使用以下參考資料更新欄位：

需要下列屬性：

下列選擇性屬性可協助使用者探索及瞭解您的擴充功能：

打包整合

1. 如果你還沒安裝包裝工具，請先安裝：

   npm install -g tfx-cli
   

2. 將你的整合內容封裝成 .vsix 檔案：

   tfx extension create --manifest-globs vss-integration.json
   

   小提示

   使用 --rev-version 以自動遞增補丁版本號。

發佈至應用程式市集

封裝延伸模組之後，您可以將它上傳至發行者下的 Marketplace。 publisher擴充功能的清單檔中指定的識別碼必須與上傳擴充功能的發行者的識別碼相符。

1. 從管理入口網站中，從頁面頂端的下拉功能表中選取您的發行者。

2. 選擇 新增擴充功能>Azure DevOps。

   

3. 拖放您的檔案，或選取它來尋找您在上一個封裝步驟中建立的 VSIX 檔案，然後選擇 [ 上傳]。

   

   快速驗證之後，您的延伸模組會出現在已發佈的延伸模塊清單中。 別擔心，這個擴充功能只有您可見。

   

此時，任何帳戶都看不到您的擴充套件。 若要讓其他人看得見，您需要共用延伸模組。

分享此系統整合

在你能在 Azure DevOps 組織中安裝整合之前，必須先與該組織分享它。

1. 從顯示的項目列表中選擇您的整合項目。
2. 選取共用。
3. 輸入組織名稱（例如， fabrikam-fiber-inc 為 dev.azure.com/fabrikam-fiber-inc）。

更新整合

若要更新您已發佈的擴充功能，請執行下列步驟：

1. 從顯示的項目清單中選取您的延伸模組。
2. 以滑鼠右鍵點擊並選取 更新 以更新開發版本，如 publisher.extension-dev。
3. 驗證您的擴充功能。
4. 將相同的更新套用至生產版本，例如 publisher.extension。
5. 瀏覽至擴充功能的 .vsix 檔案並將其上傳。

Azure DevOps 會自動安裝已擁有擴充功能之所有帳戶的更新版本。 新的安裝也會收到最新版本。

公開整合結果

為了讓你的整合對所有 Marketplace 用戶都可見，請在清單設定檔中將public旗標設定為true，然後重新發布。

欲了解更多關於公開上市所需資格的資訊，請參閱公開擴充功能。

相關內容

• 延伸模組清單參考資料
• 封裝和發佈延伸模組
• Visual Studio 市集