Anatomie balíčku VSIX

Balíček VSIX je .vsix soubor, který obsahuje jedno nebo více rozšíření sady Visual Studio společně s metadaty, která Sada Visual Studio používá ke klasifikaci a instalaci rozšíření. Tato metadata jsou obsažena v manifestu VSIX a souboru [Content_Types].xml . Balíček VSIX může také obsahovat jeden nebo více souborů Extension.vsixlangpack pro poskytnutí lokalizovaného instalačního textu a může obsahovat další balíčky VSIX pro instalaci závislostí.

Formát balíčku VSIX se řídí standardem OPC (Open Packaging Conventions). Balíček obsahuje binární soubory a podpůrné soubory společně se souborem [Content_Types].xml a souborem manifestu .vsix . Jeden balíček VSIX může obsahovat výstup více projektů nebo dokonce více balíčků, které mají vlastní manifesty.

Poznámka:

Názvy souborů obsažených v balíčcích VSIX nesmí obsahovat mezery ani znaky, které jsou vyhrazeny v identifikátorech URI (Uniform Resource Identifier), jak je definováno v části [RFC2396].

Manifest VSIX

Manifest VSIX obsahuje informace o rozšíření, které se má nainstalovat, a řídí se schématem VSIX. Další informace najdete v referenčních informacích ke schématu rozšíření VSIX 2.0.

Manifest VSIX musí být pojmenován extension.vsixmanifest , pokud je součástí .vsix souboru.

Obsah

Balíček VSIX může obsahovat šablony, položky sady nástrojů, balíčky VSPackage nebo jakýkoli jiný druh rozšíření, které visual Studio podporuje.

Jazykové sady

Balíček VSIX může obsahovat jeden nebo více souborů Extension.vsixlangpack , aby poskytoval lokalizovaný text během instalace. Další informace naleznete v tématu Lokalizace balíčků VSIX.

Závislosti a odkazy

Balíček VSIX může obsahovat další balíčky VSIX jako odkazy. Každý z těchto dalších balíčků musí obsahovat vlastní manifest VSIX.

Pokud se uživatel pokusí nainstalovat rozšíření, které má závislosti, instalační program ověří, zda jsou požadovaná sestavení nainstalována v uživatelském systému. Pokud nejsou nalezena požadovaná sestavení, zobrazí rozšíření a Aktualizace seznam chybějících sestavení.

Pokud manifest rozšíření obsahuje jeden nebo více elementů závislostí, rozšíření a Aktualizace porovnávají manifest každého odkazu na rozšíření, která jsou nainstalována v systému, a nainstaluje odkazované rozšíření, pokud ještě není nainstalované. Pokud je nainstalovaná starší verze odkazovaného rozšíření, novější verze ji nahradí.

Pokud projekt v řešení s více projekty obsahuje odkaz na jiný projekt ve stejném řešení, balíček VSIX obsahuje závislosti tohoto projektu. Toto chování můžete přepsat tak, že vyberete odkaz pro interní projekt a potom v okně Vlastnosti nastavíte výstupní skupiny zahrnuté do vlastnosti VSIX na BuiltProjectOutputGrouphodnotu .

Pokud chcete do balíčku VSIX zahrnout satelitní knihovny DLL z odkazovaných sestavení, přidejte SatelliteDllsProjectOutputGroup do výstupních skupin zahrnutých ve vlastnosti VSIX .

Umístění instalace

Během instalace rozšíření a Aktualizace vyhledá obsah balíčku VSIX ve složce v části %LocalAppData%\Microsoft\VisualStudio\{version}\Extensions.

Ve výchozím nastavení se instalace vztahuje pouze na aktuálního uživatele, protože %LocalAppData% je adresář specifický pro uživatele. Pokud však nastavíte AllUsers prvek manifestu na True, rozšíření se nainstaluje pod ..\{VisualStudioInstallationFolder}\Common7\IDE\Extensions a bude k dispozici pro všechny uživatele počítače.

[Content_Types].xml

Soubor [Content_Types].xml identifikuje typy souborů v rozbaleném .vsix souboru. Visual Studio tento soubor používá během instalace balíčku, ale neinstaluje samotný soubor. Další informace o tomto souboru naleznete v části Struktura souboru [Content_types].xml.

Standard OPC (Open Packaging Conventions) vyžaduje soubor [Content_Types].xml . Další informace o OPC naleznete v tématu OPC: Nový standard pro balení dat.