共用方式為

逐步解說：發佈Visual Studio擴充功能

本逐步解說說明如何將Visual Studio延伸模組發佈至Visual Studio Marketplace。 當您將擴充功能新增至 Visual Studio Marketplace 時，開發人員可以使用延伸 模組和更新 來流覽新的和更新的延伸模組。

先決條件

若要遵循本逐步解說，您必須安裝Visual Studio SDK。 如需詳細資訊，請參閱 安裝 Visual Studio SDK。

建立 Visual Studio 擴充功能

本文使用預設的 VSPackage 擴充功能，但步驟對每種擴充功能都有效。

封裝您的擴充套件

  1. 使用產品名稱、作者和版本的正確資訊更新擴展名 .vsixmanifest 。

    更新擴充功能 vsixmanifest

  2. 在 發行 模式中建置您的延伸模組。 現在，您的擴充元件已打包成 VSIX，位於 \bin\Release 資料夾。

  3. 您可以雙擊 VSIX 以確認安裝。

測試擴充功能

在散發延伸模組之前，請先建置並測試它，以確保它已在Visual Studio的實驗實例中正確安裝。

  1. 在Visual Studio中，開始偵錯以開啟Visual Studio的實驗實例。

  2. 在實驗實例中，移至 [ 工具] 功能表，然後按兩下 [ 擴充功能和更新]。 TestPublish 延伸模組應該會出現在中央窗格中並啟用。

  3. 在 [ 工具] 功能表上，確定您看到測試命令。

將延伸模組發佈至 Visual Studio Marketplace

  1. 請確定您已建置延伸模組的發行版本，且其為最新狀態。

  2. 在網頁瀏覽器中，移至 Visual Studio Marketplace。

  3. 在右上角，按兩下 [ 登入]。

  4. 使用您的Microsoft帳戶登入。 如果您沒有Microsoft帳戶，此時可以建立一個帳戶。

  5. 按一下發佈延伸模組。 此選項會導航至所有延伸模組的管理頁面。 如果您沒有發行者帳戶，系統會提示您此時建立一個帳戶。

    上傳至 Marketplace

  6. 選擇您要用來上傳延伸模組的發行者。 您可以按下左側所列的發行者名稱來變更發行者。 單擊 [新增擴充功能 ]，然後選取 [Visual Studio]。

  7. 在 1：上傳延伸模組中，您可以選擇將 VSIX 檔案直接上傳至 Visual Studio Marketplace，或直接將連結新增至您自己的網站。 在此範例中，會上傳 TestPublish.vsix 延伸模組。 拖放您的延伸模組，或使用 按兩下 連結來瀏覽檔案。 在專案的 \bin\Release 資料夾中尋找您的延伸模組。 按一下繼續。

  8. 在 2：提供擴充功能詳細資訊中，某些欄位會從擴充功能的 source.extension.vsixmanifest 檔案自動填入。 尋找下列各項的詳細資料：

    • 內部名稱 用於延伸模組詳細數據頁面的 URL 中。 例如，在發行者名稱 「myname」 下發佈延伸模組，並將內部名稱指定為 「my extension」 會導致延伸模組詳細數據頁面的 URL 為 「marketplace.visualstudio.com/items?itemName=myname.myextension」。

    • 延伸模組的顯示名稱。 此名稱會從 source.extension.vsixmanifest 檔案自動填入。

    • 您要上傳的擴充功能版本號碼。 此版本會從 source.extension.vsixmanifest 檔案自動填入。

    • VSIX 識別碼 是 Visual Studio 用於擴充功能的唯一識別碼。 如果您想要自動更新擴充功能，則需要此標識碼。 此標識符會從 source.extension.vsixmanifest 檔案自動填入。

    • 用於延伸模組的標誌。 如果提供，此標誌會從 source.extension.vsixmanifest 檔案自動填入。

    • 延伸模組用途的簡短描述。 此描述會從 source.extension.vsixmanifest 檔案自動填入。

    • 概觀 是包含螢幕快照和延伸模組用途詳細信息的絕佳位置。

    • 支援的 Visual Studio 版本 可讓您選擇擴充功能將運作的 Visual Studio 版本。 您的延伸模組只會安裝到這些版本。

    • 支援的 Visual Studio 版本 可讓您選擇擴充功能將運作的 Visual Studio 版本。 您的擴充功能只會安裝到這些版本。

    • 類型。 最常見的擴充功能類型是 [工具]。

    • 類別。 挑選最多三個最適合您擴充功能的選項。

    • 標籤 是可協助使用者尋找延伸模組的關鍵詞。 標籤可協助增加 Visual Studio Marketplace 中擴充套件的搜尋結果的相關性。

    • 定價類別 是您延伸模組的成本。

    • 原始程式碼存放庫 可讓您與社群共用原始程式碼的連結。

    • 允許延伸模組的問答功能讓使用者可以在延伸模組頁面上留下問題。

  9. 按兩下 [儲存及上傳]。 此選項會將您帶回發行者管理頁面。 您的延伸模組尚未發佈。

  10. 若要發佈延伸模組，請以滑鼠右鍵按兩下延伸模組，然後選取 [設為公用]。 若要查看延伸模組在 Visual Studio Marketplace 中的外觀，請選取 [檢視延伸模組]。 如需查詢取得數字，請點擊 報表。 若要變更延伸模組，請按兩下 [ 編輯]。

    擴充套件入口功能表

  11. 按兩下 [設為公用]，您的延伸模組現在為公用。 搜尋 Visual Studio Marketplace 以取得您的延伸模組。

在 Visual Studio Marketplace 中更新已發佈的延伸模組

開始之前，請確定您已建置新版的延伸模組，且其為最新狀態。

  1. 在網頁瀏覽器中，移至 Visual Studio Marketplace。

  2. 在右上角，按兩下 [ 登入]，然後使用您的Microsoft帳戶登入。

    顯示在 [檔案總管] 中選取上傳擴充檔案的螢幕快照。

  3. 按兩下 [發佈擴充功能]，然後選擇您要用來上傳更新延伸模組的發行者。

    Visual Studio Marketplace 的螢幕快照，其中醒目提示 [發佈延伸模組] 連結。

  4. 在您要更新的延伸模組旁邊，將滑鼠停留在三個水準點上，然後選擇 [ 編輯]。

    顯示選擇要編輯之延伸模組的螢幕快照。

  5. 於 1：上傳延伸模組之後，按一下鉛筆圖示以編輯已發佈的延伸模組。

    顯示單擊鉛筆圖示以編輯延伸模組的螢幕快照。

  6. 找到您更新後的 VSIX 擴充功能檔案。 按兩下檔案，然後按兩下 [ 開啟]。

    您更新的延伸模組上傳。

    上傳編輯延伸模組之後上傳檔案通知的螢幕快照。

  7. 在 2：提供擴充功能詳細資料時，某些詳細資料在擴充功能更新時是唯讀的，或是從您的擴充功能的 source.extension.vsixmanifest 檔案自動填入。 以下是擴充套件的相關資訊：

    • 內部名稱* 用於擴充套件詳細資訊頁面的 URL。 例如，在發行者名稱 「myname」 下發佈延伸模組，並將內部名稱指定為 「my extension」 會導致延伸模組的詳細數據頁面的 URL 為 「marketplace.visualstudio.com/items?itemName=myname.myextension」。

    • 延伸模組的顯示名稱* 。 此名稱會從 source.extension.vsixmanifest 檔案自動填入。

    • 版本* 您正在上傳的擴充功能版本號碼。 此版本會從 source.extension.vsixmanifest 檔案自動填入。

    • VSIX ID* 是 Visual Studio 用於擴充功能的唯一標識符。 如果您想要自動更新擴充功能，則需要此標識碼。 此標識符會從 source.extension.vsixmanifest 檔案自動填入。

    • 用於延伸模組的標誌* 。 如果提供，此標誌會從 source.extension.vsixmanifest 檔案自動填入。

    • 延伸模組用途的簡短描述* 。 此描述會從 source.extension.vsixmanifest 檔案自動填入。

    • 概觀 是包含螢幕快照和延伸模組用途詳細信息的絕佳位置。

    • 支援的 Visual Studio 版本* 可讓您選擇擴充功能將運作的 Visual Studio 版本。 您的延伸模組只會安裝到這些版本。

    • 支援的 Visual Studio 版本* 可讓您選擇擴充功能將運作的 Visual Studio 版本。 您的擴充功能只會安裝在這些版本上。

    • 類型。 最常見的擴充功能類型是 [工具]。

    • 類別。 挑選最多三個最適合您擴充功能的選項。

    • 標籤 是可協助使用者尋找延伸模組的關鍵詞。 標籤可協助增加 Visual Studio Marketplace 中擴充套件的搜尋結果的相關性。

    • 定價類別 是您延伸模組的成本。

    • 原始程式碼存放庫 可讓您與社群共用原始程式碼的連結。

    • 允許延伸模組的問答功能讓使用者可以在延伸模組頁面上留下問題。

      * 擴充功能更新無法變更此詳細數據。

  8. 按兩下 [儲存及上傳]。 此選項會將您帶回發行者管理頁面。 您的延伸模組尚未發佈。

  9. 若要發佈延伸模組，請以滑鼠右鍵按下您的延伸模組，然後選取 [設為公用]。 若要查看延伸模組在 Visual Studio Marketplace 中的外觀，請選取 [檢視延伸模組]。 如需取得資訊，請按 [報表]。 若要變更延伸模組，請按兩下 [ 編輯]。

新增其他使用者來管理您的發行者帳戶

Visual Studio Marketplace 支援授與其他使用者存取和管理發行者帳戶的許可權。

  1. 要求您想要新增的成員在 Marketplace 上登入其帳戶，並取得使用者識別碼。 將滑鼠停留在電子郵件上方，即可看見 [用戶標識符]，如下圖所示：

    顯示 Marketplace 中使用者名稱和電子郵件位址旁使用者識別碼的螢幕快照。

  2. 成員可以按下 [複製到剪貼簿] 按鈕來複製使用者識別碼，然後與您共用。

  3. 流覽至您想要新增其他使用者的發行者帳戶。

  4. 選取 [成員 ]，然後按兩下 [ 新增]。

    新增其他使用者

  5. 然後，您可以指定您想要新增之使用者的使用者識別碼，並在 [選取角色] 底下授與正確的存取層級。 您可以從下列選項中選擇：

    • 建立者：使用者可以發佈延伸模組，但無法檢視或管理其他用戶發佈的延伸模組。

    • 讀者：使用者可以檢視延伸模組，但無法發佈或管理延伸模組。

    • 參與者：使用者可以發佈和管理延伸模組，但無法編輯發行者設定或管理存取權。

    • 擁有者：使用者可以發佈和管理延伸模組、編輯發行者設定，以及管理存取權。

解決將使用者新增至發行者帳戶時的問題

當您使用電子郵件地址將使用者新增至發行者設定檔時，您可能會看到錯誤 TF14045: The identity could not be found。

若要避免此錯誤，請使用使用者的使用者標識碼，而不是電子郵件位址，將使用者新增至發行者帳戶。 若要尋找使用者的使用者標識碼，請在 Visual Studio Marketplace 中，將滑鼠停留在窗格頂端的用戶名稱上。 選取複製圖示以複製使用者識別碼。

顯示 Marketplace 中使用者名稱和電子郵件位址旁使用者識別碼的螢幕快照。

然後，您可以使用其使用者識別碼 來新增 使用者。

從 Visual Studio Marketplace 安裝延伸模組

現在，擴充功能已發行，請在Visual Studio中加以安裝，並在該處進行測試。

  1. 在 Visual Studio 的 [ 工具] 功能表上，按兩下 [ 擴充功能和更新]。

  2. 按兩下 [在線 ]，然後搜尋 TestPublish。

  3. 按一下 [下載] 。 然後會排程擴充功能進行安裝。

  4. 若要完成安裝，請關閉 Visual Studio 的所有實例。

移除擴充功能

您可以從 Visual Studio Marketplace 和電腦移除延伸模組。

若要從 Visual Studio Marketplace 移除或下架延伸模組

  1. 移至 Visual Studio Marketplace。

  2. 在右上角，點擊 [發佈擴充功能]。 挑選您用來發行的發行者（例如： TestPublish）。 延伸模組的清單隨即出現。

  3. 按一下擴充功能選單按鈕，然後點選移除。 系統會要求您確認是否要移除延伸模組。

顯示 [移除] 選單項目的螢幕快照。

若要防止意外解除發佈，您必須在警告對話框中填入延伸模組名稱來確認移除作業。 請注意，移除/取消發佈動作不可反轉

顯示警告的螢幕快照。

移除您電腦上的擴充功能

  1. 在 Visual Studio 的 [ 工具] 功能表上，按兩下 [ 擴充功能和更新]。

  2. 選取 [TestPublish ]，然後按兩下 [ 卸載]。 然後，擴充功能會排程卸載。

  3. 若要完成卸載，請關閉 Visual Studio 的所有實例。

  • Last updated on