共用方式為


從命令行發佈

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

您可以使用適用於 Azure DevOps 的跨平臺 CLI (tfx-cli) 將擴充功能發佈至 Visual Studio Marketplace。

如需詳細資訊,請參閱發佈、安裝和共用的概觀。

必要條件

從節點 封裝管理員 取得 TFX CLI,併產生個人存取令牌 (PAT)。 此外,如果您尚未設定,請在資源庫中設定發行者。

取得適用於 Azure DevOps 的跨平臺 CLI

  1. 如果您沒有它,請下載並安裝 NodeJS。 在設定期間,請確定您保留 [新增至 PATH ] 選擇。

  2. 開啟命令提示字元並輸入 npm i -g tfx-cli

如果您已安裝 TFX CLI,您可以執行 npm up -g tfx-cli來更新至最新版本。

建立個人存取權杖

  1. 登入您的組織 (https:dev.azure.com/{organization})。

  2. 從首頁開啟用戶設定圖示,然後選取 [配置檔]。

    選擇使用者設定圖示之後選取 [設定檔]

  3. 在 [安全性] 底下,選取 [個人存取令牌],然後選取 [新增令牌]。

    建立新的個人存取令牌

  4. 完成表單:

    • 為您的令牌命名
    • 選取 [所有可存取的組織],這是透過 CLI 發佈時唯一可運作的值。 如果您只選取一個組織,即使 PAT 有效,也會導致錯誤
    • 選取令牌的到期時間範圍。 這是必要專案,因為Visual Studio Marketplace 發佈 API 在組織內容之外運作
    • 設定與此令牌相關聯的存取範圍。 請務必選取 Marketplace (publish) 範圍。 此範圍會將令牌限制為只能夠將擴充功能發佈至 Marketplace。
    • 選取 [建立]

    ..

  5. 複製您產生的個人存取令牌。 請務必將它保密。

    複製您的令牌並保留秘密

從命令行發佈

安裝 TFX CLI 並擁有 PAT 之後,您可以使用工具來封裝和發佈延伸模組。

  1. 開啟命令提示字元至延伸模組的根目錄。
  2. 執行下列命令來發佈延伸模組。 出現提示時,請輸入您的個人存取令牌進行驗證。
tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

如果您的延伸模組已發行,您可能會收到下列錯誤:

Failed Request: Internal Server Error(500) - Version number must increase each time an extension is published. Extension: fabrikam.my-extension  Current version: 0.1.9  Updated version: 0.1.9

您可以新增 --rev-version 旗標,以自動遞增 延伸模組的修補程式 版本。 這也會將新版本儲存至您的指令清單。

注意

命令可使用createpublish的所有選項。

範例

C:\vso-team-calendar>tfx extension publish --publisher publishFabrikam --manifest-js fabrikam.config.js --share-with fabrikam --rev-version
Copyright Microsoft Corporation
> Personal access token:
Checking if this extension is already published
It is, update the extension
Waiting for server to validate extension package...
Sharing extension with fabrikam.

=== Completed operation: publish extension ===
 - Packaging: C:\vso-team-calendar\fabrikam.team-calendar-0.2.6.vsix
 - Publishing: success
 - Sharing: shared with fabrikam