開始使用 VSIX 專案範本

  • 發行項

您可以使用 VSIX 專案範本來建立擴充功能，或封裝現有的擴充功能以進行部署。 VSIX 專案範本同時具有 Visual Basic 和 Visual C# 版本，並會安裝為 Visual Studio SDK 的一部分。

VSIX 專案範本只包含一個 source.extension.vsixmanifest 檔案，其中包含擴充功能及其隨附資產的相關資訊。

若要尋找 VSIX 專案範本，您必須安裝 Visual Studio SDK。 如需詳細資訊，請參閱 Visual Studio SDK。

使用 VSIX 專案範本部署自訂專案範本

下列步驟示範如何使用 VSIX 專案封裝您可以與其他開發人員共用的專案範本，或上傳至 Visual Studio 資源庫。

  1. 建立專案範本。

    1. 開啟要從中建立範本的專案。 此專案可以是任何專案類型。

    2. 按一下 [專案] 功能表上的 [匯出範本]。 完成此精靈的步驟。

      會在 %USERPROFILE%\My Documents\Visual Studio {version}\My Exported Templates\ 中建立 .zip 檔案。

  2. 建立空白 VSIX 專案。

    選取 [檔案]> [新增]> [專案]。 在搜尋方塊中，輸入「vsix」，然後選取 C# 或 VSIX 專案的 Visual Basic 版本。

  3. 將 .zip 檔案新增到專案中。 將其 [複製到輸出目錄] 屬性設定為 Copy Always。

  4. 在 [解決方案總管] 中，按一下 source.extension.vsixmanifest 檔案，在 [VSIX 資訊清單設計工具] 中開啟它，然後進行下列變更：

    • 將 [產品名稱] 欄位設定為 [我的專案範本]。

    • 將 [產品識別碼] 欄位設定為 MyProjectTemplate - 1。

    • 將 [作者] 欄位設定為 Fabrikam。

    • 將 [描述] 欄位設定為 [我的專案範本]。

    • 在 [資產] 區段中，新增 Microsoft.VisualStudio.ProjectTemplate 類型，並將其路徑設定為 .zip 檔案的名稱。

  5. 儲存並關閉 source.extension.vsixmanifest 檔案。

  6. 組建專案。

  7. 在輸出目錄中，按兩下 .vsix 檔案。

  8. VSIX 安裝程式訊息方塊隨即出現。 遵循安裝擴充功能的相關指示。

  9. 結束再重新開啟 Visual Studio。

  10. 選取 [管理擴充功能] (在 [擴充功能] 功能表上，然後選取 [範本] 類別。 其中一個可用的擴充功能應該是 [我的專案範本]。

  11. 新的專案範本會出現在 [新增專案] 對話方塊中，與原始專案範本位於相同的位置。 例如，如果您從 Visual Basic 控制台應用程式建立名為 VB 控制台的範本， VB 控制台會出現在與 Visual Basic 控制台應用程式範本相同的窗格中。

如何在 [新增專案] 對話方塊中指定範本的位置

  1. 範本資料夾位於 {Visual Studio Installation Path}\Common7\IDE\ProjectTemplates 和 {Visual Studio Installation Path}\Common7\IDE\ItemTemplates 目錄中。 [新增專案] 對話方塊中最上層區段的名稱與範本資料夾的名稱不完全相符。 如果不同，請使用範本資料夾的名稱。

    將 .vsix 副檔名變更為 .zip，然後開啟檔案。

  2. 建立與 [新增專案] 對話方塊區段相同名稱的新資料夾，範本應該會出現在其中。

  3. 如果範本要出現在子區段，請建立同名的子資料夾。

  4. 將範本 .zip 檔案移至新資料夾。

  5. 將 .zip 擴充功能變更為 .vsix。

  6. 開啟 VSIX 資訊清單。

  7. 在 VSIX 資訊清單中，更新範本的 [資產] 路徑，使其指向包含範本檔案的目錄樹狀目錄根目錄。 例如，如果範本位於 \CSharp\Windows 中，則參考應該指向 \CSharp。