VSIX 套件的剖析

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。

VSIX 套件是.vsix 檔案，其中包含一或多個 Visual Studio 擴充功能，以及 Visual Studio 會使用分類，並安裝擴充功能的中繼資料。 中繼資料包含在 VSIX 資訊清單和 [Content_Types].xml 檔案中。 VSIX 套件也包含一或多個 Extension.vsixlangpack 檔案來提供當地語系化的安裝程式文字，而且可能包含其他的 VSIX 套件安裝相依項目。

VSIX 套件格式遵循開放封裝慣例 (OPC) 標準。 封裝包含二進位檔和支援檔案，以及 [Content_Types].xml 檔案和.vsix 資訊清單檔案。 一個 VSIX 套件可能包含多個專案或有其本身的資訊清單的多個封裝的輸出。

注意

包含在 VSIX 套件的檔案名稱不得包含空格，也不會保留在統一資源識別元 (URI)，做為字元定義下[RFC2396]。

VSIX 資訊清單

VSIX 資訊清單包含要安裝擴充功能，如下所示 VSX 結構描述的相關資訊。 如需詳細資訊，請參閱VSIX 擴充功能結構描述 1.0 參考。 範例 VSIX 資訊清單，請參閱PackageManifest 元素 （根項目、 VSX 結構描述）。

VSIX 資訊清單必須命名為extension.vsixmanifest包含.vsix 檔案中時。

內容

VSIX 套件可能包含範本、 工具箱項目、 VSPackages 或任何其他種類的 Visual Studio 所支援的延伸模組。

語言套件

VSIX 套件可能包含一次或更多的 Extension.vsixlangpack 檔案，在安裝期間提供當地語系化的文字。 如需詳細資訊，請參閱當地語系化 VSIX 套件。

相依性和參考

VSIX 套件可能包含其他 VSIX 套件做為參考。 每個這些其他封裝必須包含它自己的 VSIX 資訊清單。

如果使用者嘗試安裝具有相依性的擴充功能，安裝程式會確認使用者系統上已安裝的必要的組件。 如果找不到必要的組件，擴充功能和更新顯示遺漏的組件的清單。

如果延伸模組資訊清單包含一或多個參考項目，擴充功能和更新比較每個參考系統已安裝的擴充功能的資訊清單，並且會安裝受參考的延伸模組，如果尚未安裝。 如果已安裝較早版本的參考延伸模組，較新版本取代它。

多專案方案中的專案包含另一個專案的參考相同方案中，如果 VSIX 套件包含該專案的相依性。 您可以依序按一下 [參考內部的專案，然後在 [覆寫這個行為屬性] 視窗中，設定輸出群組包含在 VSIX屬性BuiltProjectOutputGroup。

若要在 VSIX 套件中包含從參考組件的附屬 Dll，新增SatelliteDllsProjectOutputGroup至輸出群組包含在 VSIX屬性。

安裝位置

在安裝期間，擴充功能和更新求取在資料夾之下的 %localappdata%\microsoft\visualstudio\14.0\extensions VSIX 套件的內容。

根據預設，安裝只適用於目前的使用者，因為 %localappdata%是使用者特有的目錄。 不過，如果您設定AllUsers資訊清單的項目True，將會在安裝延伸模組...\ VisualStudioInstallationFolder\Common7\IDE\Extensions，便可以在電腦的所有使用者。

[Content_Types].xml

[Content_Types].xml 檔案識別此展開的.vsix 檔案中的檔案類型。 Visual Studio 安裝套件時使用此檔案，但不會安裝檔案本身。 如需此檔案的詳細資訊，請參閱結構 Content_types].xml 檔案。

[Content_Types].xml 檔案需要由開放封裝慣例 (OPC) 標準。 如需有關 OPC 的詳細資訊，請參閱OPC: 新標準的封裝您的資料MSDN 網站上。