Návrhář manifestu VSIX

  • Článek

Upraví soubor manifestu balíčku VSIX, který nastaví chování instalace pro rozšíření sady Visual Studio.

Návrhář manifestu VSIX se mapuje na podkladové schéma VSIX. Každý prvek ve schématu lze nastavit pomocí odpovídajícího ovládacího prvku v návrháři. Další informace o schématu naleznete v tématu VSIX Extension Schema 2.0 Reference.

Chcete-li otevřít Návrhář manifestu VSIX, vyhledejte v Průzkumník řešení soubor source.extension.vsixmanifest a otevřete soubor. Pokud soubor neobsahuje platný kód XML, návrhář manifestu se neotevře.

Poznámka:

Soubor source.extension.vsixmanifest je výstupem souboru extension.vsixmanifest při sestavení balíčku.

Seznam UIElement

Návrhář manifestu VSIX obsahuje čtyři části, které odpovídají těmto prvkům schématu nejvyšší úrovně:

  • Metadata
  • Cíle instalace
  • Materiály
  • Závislosti

Oblast nadpisu obsahuje následující ovládací prvky:

  • Název produktu popisuje název rozšíření.
  • ID produktu určuje jedinečné identifikační údaje pro tento balíček.
  • Autor určuje jméno autora rozšíření.
  • Verze určuje číslo verze rozšíření.

Karta Metadata obsahuje následující ovládací prvky:

  • Popis obsahuje textový popis rozšíření, který se má zobrazit ve Správci rozšíření.
  • Jazyk určuje výchozí jazyk balíčku, který odpovídá textovým datům v manifestu. Atribut Language se řídí konvencí kódu národního prostředí CLR (Common Language Runtime) pro sestavení prostředků, například en-us, en, fr-fr. Ve výchozím nastavení je hodnota neutrální, což znamená, že balíček se spustí v libovolné jazykové verzi sady Visual Studio.
  • Licence určuje textový soubor, který obsahuje uživatelskou licenci, pokud existuje.
  • Ikona určuje grafický soubor (.png, .bmp, .jpeg, .ico), který obsahuje ikonu, která se má zobrazit ve Správci rozšíření, pokud je k dispozici ikona. Obrázek ikony musí mít velikost 32 × 32 pixelů nebo se změní na tyto rozměry. Pokud není zadána žádná ikona, Správce rozšíření použije výchozí ikonu.
  • Obrázek náhledu určuje grafický soubor (.png, .bmp, .jpeg, .ico), který obsahuje obrázek náhledu, který se má zobrazit ve Správci rozšíření, pokud je k dispozici obrázek náhledu. Náhled obrázku musí být 200 × 200 pixelů. Pokud není zadán žádný obrázek náhledu, Správce rozšíření použije výchozí obrázek.
  • Značky přidávají textové značky, které se mají použít pro nápovědu hledání.
  • Poznámky k verzi určují soubor (.txt, .rtf), který obsahuje poznámky k verzi. Vezme také adresu URL webu, který zobrazuje poznámky k verzi.
  • Příručka Začínáme určuje soubor (.txt, .rtf), který obsahuje informace o tom, jak použít příponu nebo obsah v balíčku VSIX. Tato příručka se zobrazí po dokončení instalace rozšíření. Přebírá také adresu URL webu, který zobrazuje průvodce.
  • Další informace URL určuje adresu URL webu, který obsahuje další informace o produktu.

Karta Cíle instalace obsahuje následující ovládací prvky:

  • Typ instalace uvádí sadu Visual Studio Extension a Extension SDK jako cílové typy instalace. Možnosti se liší v závislosti na zvoleném typu.

    • Rozšíření sady Visual Studio obsahuje seznam elementů InstallationTarget , které popisují, jak lze balíček nainstalovat a do kterých produktů sady Visual Studio lze toto rozšíření nainstalovat. Každý produkt je identifikovaný samostatně podle názvu a verze nebo rozsahu verzí. Produkty lze přidat do seznamu, upravit a odstranit. Název a verze produktu odpovídají atributům ID a version přidruženého elementu InstallationTarget .

      • Rozsah verzí je [12.0, 14.0] a používá následující zápis:
        • [ – minimální verze včetně
        • ] - maximální verze včetně
        • ( - minimální verze s výhradním
        • ) - maximální verze s výhradním
        • Jedna verze # – pouze zadaná verze

    • Sada SDK rozšíření určuje globální instalaci, která není vymezená na konkrétní produkt a verzi. Identifikátor cílové platformy je platforma, například Windows, na kterou cílíte. Verze cílové platformy je verze cílové platformy, například 8.0. Název sady SDK a verze sady SDK jsou název a číslo verze sady SDK.

  • Tento VSIX je nainstalovaný pro všechny uživatele (vyžaduje zvýšení oprávnění při instalaci). Pokud toto políčko zaškrtnete, rozšíření se nainstaluje pro všechny uživatele; v opačném případě se nainstaluje jenom pro aktuálního uživatele.

  • Tento VSIX je nainstalován instalační službou systému Windows. Pokud toto políčko zaškrtnete, nainstaluje rozšíření Instalační služba systému Windows (soubor MSI ), jinak se nainstaluje jako typický balíček VSIX (soubor .vsix ).

Karta Prostředky obsahuje následující ovládací prvky:

  • Seznam prostředků obsahuje prvky assetů , které popisují prvky rozšíření nebo obsahu, které tento balíček zobrazí. Každé rozšíření nebo prvek obsahu je uvedené samostatně podle zdroje, typu a cesty. Rozšíření a prvky obsahu lze přidat do seznamu, upravit a odstranit. Typ a cesta rozšíření nebo elementu obsahu odpovídá Type a Path atributům přidruženého Asset prvku. Jsou známy následující typy:

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

    Chcete-li přidat nebo upravit prostředek, musíte zadat typ prostředku, zda je asset projektem v aktuálním řešení nebo souborem v systému souborů a název projektu. Můžete také zadat název složky, do které se má vložit.

    Můžete také vytvořit vlastní typy a pojmenovat je jedinečnými názvy.

Karta Závislosti obsahuje následující ovládací prvky:

  • Název, Zdroj a Rozsah verzí uvádí prvky závislosti tohoto balíčku, což jsou další balíčky, na kterých tento balíček závisí. Pokud je zadán balíček závislostí, musí být nainstalován před instalací tohoto balíčku; jinak musí tento balíček nainstalovat.

    Balíčky závislostí jsou určeny identifikátorem, názvem, rozsahem verzí, zdrojem a způsobem řešení závislosti. Každý balíček závislostí je uvedený samostatně podle názvu, verze a zdroje. Balíčky závislostí lze přidat do seznamu, upravit a odstranit.

    Identifikátor musí odpovídat atributu ID metadat balíčku závislostí. Zdrojem může být projekt v aktuálním řešení, aktuálně nainstalované rozšíření nebo soubor. Nastavení Způsob řešení závislostí může být relativní cestou vnořeného balíčku nebo adresy URL umístění pro stažení závislosti. ID, verze a rozlišení balíčku závislostí odpovídají Id, Versiona Location atributy přidruženého Dependency prvku.

Viz také