VSIX 資訊清單設計工具

修改 VSIX 套件指令清單檔，這個檔案會設定 Visual Studio 延伸模組的安裝行為。

VSIX 指令清單設計工具會對應至基礎 VSIX 架構。 架構中的每個元素都可以使用設計工具中的對應控制項來設定。 如需架構的詳細資訊，請參閱 VSIX 延伸模組架構 2.0 參考。

若要開啟 VSIX 指令清單設計工具，請在 方案總管 中找到 source.extension.vsixmanifest 檔案，然後開啟檔案。 如果檔案不包含有效的 XML，指令清單設計工具將不會開啟。

注意

建置套件時，source.extension.vsixmanifest 檔案會輸出至 extension.vsixmanifest。

UIElement 清單

VSIX 指令清單設計工具包含四個區段，這些區段對應至架構的這些最上層元素：

• 中繼資料
• 安裝目標
• 資產
• 相依性

標題區域包含下列控制項：

• 產品名稱 描述擴充功能名稱。
• 產品標識子 會指定此套件的唯一標識碼資訊。
• 作者 指定延伸模組作者的名稱。
• 版本 會指定擴充功能的版本號碼。

[元數據] 索引標籤包含下列控制項：

• 描述會提供延伸模組的文字描述，以顯示在延伸模組管理員中。
• 語言 會指定封裝的默認語言，該語言會對應至指令清單中的文字數據。 屬性 Language 會遵循資源元件的 Common Language Runtime （CLR） 地區設定程式代碼慣例，例如 en-us、en、fr-fr。 根據預設，此值為中性值，這表示套件將在任何語言版本的Visual Studio上執行。
• 如果存在使用者授權，License 會指定包含使用者授權的文字檔。
• 圖示會指定圖形檔案（.png、.bmp、.jpeg、.ico），其中包含在延伸模組管理員中顯示的圖示，如果圖示存在的話。 圖示影像必須是32x32像素，或調整為這些尺寸的大小。 如果未指定任何圖示， 延伸模組管理員 會使用預設圖示。
• 預覽影像會指定圖形檔案（.png、.bmp、.jpeg、.ico），其中包含在延伸模組管理員中顯示的預覽影像，如果預覽影像存在。 預覽影像必須是 200x200 像素。 如果未指定預覽映像， 擴充功能管理員 會使用預設映像。
• 標籤會新增要用於搜尋提示的文字標記。
• 版本資訊 會指定包含版本資訊的檔案 （.txt， .rtf）。 也接受顯示版本資訊的網站 URL。
• 用戶入門指南 會指定檔案 （.txt， .rtf），其中包含如何使用 VSIX 套件中擴展名或內容的相關信息。 當延伸模組安裝完成時，會出現本指南。 也接受顯示指南的網站 URL。
• 詳細資訊 URL 會指定包含產品其他資訊的網站 URL。

[ 安裝目標] 索引 標籤包含下列控制項：

• 安裝類型會列出 Visual Studio 擴充功能和延伸模組 SDK 作為目標安裝類型。 選項會根據您選擇的類型而有所不同。

  • Visual Studio 延伸模組 會列出 InstallTarget 元素，描述如何安裝套件，以及安裝此延伸模組的 Visual Studio 產品。 每個產品會分別依名稱和版本或版本範圍來識別。 產品可以新增至清單、修改和刪除。 產品的名稱和版本會對應至相關聯 InstallationTarget 元素的 Id 和 Version 屬性。

    • 版本範圍 是 [12.0， 14.0]，並使用下列表示法：
      • [ - 包含最低版本
      • ] - 包含最大版本
      • ( - 最低版本獨佔
      • ) - 最大版本獨佔
      • 單一版本 # - 只有指定的版本

  • 擴充功能 SDK 指定未限定於特定產品和版本的全域安裝。 目標平臺標識碼 是您的目標平臺，例如「Windows」。 目標平臺版本 是目標平臺的版本，例如8.0。 SDK 名稱和 SDK 版本 分別是 SDK 的名稱和版本號碼。

• 此 VSIX 會針對所有使用者安裝（需要安裝時提高許可權）。 如果您選取此複選框，則會為所有使用者安裝延伸模組;否則，它只會針對目前用戶安裝。

• 此 VSIX 是由 Windows Installer 所安裝。 如果您選取此複選框，則延伸模組是由 Windows Installer （.msi 檔案）安裝;否則，它會安裝為典型的 VSIX 套件 （.vsix 檔案）。

[資產] 索引標籤包含下列控件：

• 資產清單會列出描述此套件所呈現之延伸模組或內容專案的 Asset 元素。 每個延伸模組或內容元素會依來源、類型和路徑個別列出。 延伸模組和內容元素可以新增至清單、修改和刪除。 延伸模組或內容專案的類型和路徑會對應至Type相關聯Asset專案的 和 Path 屬性。 已知下列型態：

  • Microsoft.VisualStudio.Package
  • Microsoft.VisualStudio.MefComponent
  • Microsoft.VisualStudio.ToolboxControl
  • Microsoft.VisualStudio.Samples
  • Microsoft.VisualStudio.ProjectTemplate
  • Microsoft.VisualStudio.ItemTemplate
  • Microsoft.VisualStudio.Assembly
  • Microsoft.ExtensionSDK

  若要新增或編輯資產，您必須指定資產類型、資產是目前方案中的專案，還是文件系統中的檔案，以及項目的名稱。 您也可以指定要內嵌的資料夾名稱。

  您也可以建立自己的類型，併為其提供唯一的名稱。

[相依性] 索引標籤包含下列控件：

• 名稱、來源和版本範圍 會列出此套件的相依性元素，這是此套件相依的其他套件。 如果指定相依性套件，則必須先安裝它，才能安裝此套件;否則，此套件必須加以安裝。

  相依性套件是由標識碼、名稱、版本範圍、來源，以及要如何解析相依性所指定。 每個相依性套件會依名稱、版本和來源個別列出。 相依性套件可以新增至清單、修改和刪除。

  標識碼必須符合 ID 相依性套件元數據的 屬性。 來源可以是目前方案中的專案、目前安裝的延伸模組或檔案。 如何解析相依性設定可以是巢狀套件的相對路徑或相依性下載位置的 URL。 相依性套件的標識碼、版本和解析會對應至Id相關聯Dependency專案的、 Version和 Location 屬性。

另請參閱

• VSIX 擴充架構 2.0 參考
• VSIX 套件的結構