Vytvoření vlastních šablon projektů a položek

Platí pro:yes Visual Studio Visual Studio pro Mac noVisual Studio noCode

Sada Visual Studio SDK obsahuje šablony projektů, které vytvářejí vlastní šablonu projektu a šablonu vlastní položky. Mezi tyto šablony patří některé běžné nahrazení parametrů a sestavení jako soubory ZIP. Nejsou nasazené automaticky a nejsou k dispozici v experimentální instanci. Vygenerovaný soubor ZIP musíte zkopírovat do adresáře šablony uživatele.

Šablony pro vytváření šablon umožňují zahrnout šablony do větších rozšíření. To vám umožní implementovat správu verzí ve zdrojových souborech a vytvořit skupinu projektů šablon do jednoho balíčku VSIX.

Můžete také nakonfigurovat šablonu pro instalaci balíčků NuGet. Další informace najdete v tématech Balíčky NuGet v šablonách sady Visual Studio.

V případě základních scénářů vytváření šablon byste měli použít průvodce exportem šablony , který vypíše komprimovaný soubor. Další informace o vytváření základních šablon naleznete v tématu Vytváření šablon projektů a položek.

Poznámka

Počínaje sadou Visual Studio 2017 se už nebude provádět vyhledávání vlastních šablon projektů a položek. Místo toho musí rozšíření poskytovat soubory manifestu šablony, které popisují umístění instalace těchto šablon. K aktualizaci rozšíření VSIX můžete použít Visual Studio 2017. Pokud nasadíte rozšíření pomocí MSI, musíte soubory manifestu šablony vygenerovat ručně. Další informace najdete v tématu Upgrade vlastních šablon projektů a položek pro Visual Studio 2017. Schéma manifestu šablony je zdokumentované v odkazu na schéma manifestu šablony sady Visual Studio.

Vytvoření šablony projektu

  1. Vytvořte projekt šablony projektu. Šablonu projektu najdete v dialogovém okně Nový projekt tak, že vyhledáte "šablonu projektu" a vyberete verzi jazyka C# nebo Visual Basic.

    Šablona vygeneruje soubor třídy, ikonu, soubor .vstemplate , upravitelný projektový soubor s názvem ProjectTemplate.vbproj nebo ProjectTemplate.csproj a některé soubory, které jsou obvykle generovány jinými typy projektů, například soubor resources.resx , soubor AssemblyInfo a soubor .settings . Každý soubor kódu obsahuje běžné náhrady parametrů, pokud je to vhodné.

project template project selection

  1. Podle potřeby přidejte a odeberte položky z projektu. Neodstraňujte upravitelný soubor projektu, soubor AssemblyInfo nebo soubor .vstemplate .

  2. Aktualizujte soubor .vstemplate tak, aby odrážel všechny dodatky a odstranění. Element Project musí obsahovat element ProjectItem pro každý soubor, který má být součástí šablony.

  3. Upravte soubory kódu a další uživatelsky orientovaný obsah a přidejte odpovídající náhrady parametrů.

  4. Upravte vygenerovaný obsah podle potřeby.

  5. Sestavte projekt.

    Visual Studio vytvoří .zip soubor, který obsahuje vaši šablonu. Není nasazená a není k dispozici v experimentální instanci.

Vytvoření šablony položky

  1. Vytvořte projekt šablony položky.

    Šablona vygeneruje soubor třídy, ikonu, soubor .vstemplate a soubor AssemblyInfo . Soubor třídy obsahuje některé běžné náhrady parametrů.

  2. Podle potřeby přidejte a odeberte položky z projektu.

  3. Aktualizujte soubor .vstemplate tak, aby odrážel všechny dodatky a odstranění. Element Project musí obsahovat element ProjectItem pro každý soubor, který má být součástí šablony.

  4. Upravte soubory kódu a další uživatelsky orientovaný obsah a přidejte odpovídající náhrady parametrů.

  5. Podle potřeby upravte vygenerovaný obsah.

  6. Sestavte projekt.

    Visual Studio vytvoří komprimovaný soubor, který obsahuje vaši šablonu. Není nasazená a není k dispozici v experimentální instanci.

Nasazení

Nasazení šablony projektu nebo položky

  1. Vytvořte projekt VSIX. Další informace najdete v šabloně projektu VSIX.

  2. Nastavte projekt VSIX jako spouštěný projekt. V Průzkumníku řešení vyberte uzel projektu VSIX, klikněte pravým tlačítkem myši a vyberte Nastavit jako spouštěný projekt.

  3. Nastavte projekt šablony projektu jako prostředek projektu VSIX. Otevřete soubor .vsixmanifest . Přejděte na kartu Prostředky a vyberte Nový.

    1. Nastavte pole Typ na Microsoft.VisualStudio.ProjectTemplate nebo Microsoft.VisualStudio.ItemTemplate.

    2. U zdroje vyberte projekt A v aktuální možnosti řešení a pak vyberte projekt, který obsahuje vaši šablonu.

  4. Sestavte řešení a stiskněte klávesu F5. Zobrazí se experimentální instance.

  5. V případě projektu šablony projektu byste měli vidět šablonu projektu uvedenou v dialogovém okně Nový projekt (Novýprojektsouboru>>) v uzlu Visual C# nebo Visual Basic. U projektu šablony položky byste měli vidět šablonu položky uvedenou v dialogovém okně Přidat novou položku . Pokud chcete zobrazit dialogové okno Přidat novou položku , v Průzkumníku řešení vyberte uzel projektu a vyberte Přidat>novou položku).

Viz také