Wprowadzenie do szablonu projektu VSIX

Szablon projektu VSIX umożliwia utworzenie rozszerzenia lub spakowanie istniejącego rozszerzenia na potrzeby wdrożenia. Szablon projektu VSIX ma wersje Visual Basic i Visual C# i jest instalowany jako część zestawu Visual Studio SDK.

Szablon projektu VSIX składa się tylko z source.extension.vsixmanifest pliku zawierającego informacje o rozszerzeniu i dostarczanych przez niego zasobach.

Aby znaleźć szablon projektu VSIX, musisz zainstalować zestaw Visual Studio SDK. Aby uzyskać więcej informacji, zobacz Visual Studio SDK.

Wdrażanie niestandardowego szablonu projektu przy użyciu szablonu projektu VSIX

W poniższych krokach pokazano, jak za pomocą projektu VSIX spakować szablon projektu, który można udostępnić innym deweloperom lub przekazać do galerii programu Visual Studio.

1. Utwórz szablon projektu.

   1. Otwórz projekt, z którego chcesz utworzyć szablon. Ten projekt może być dowolnego typu projektu.

   2. W menu Projekt kliknij pozycję Eksportuj szablon. Wykonaj kroki kreatora.

      Plik .zip jest tworzony w pliku %USERPROFILE%\My Documents\Visual Studio {version}\My Exported Templates\.

2. Utwórz pusty projekt VSIX.

   Wybierz kolejno pozycje Plik>Nowy>Projekt. W polu wyszukiwania wpisz "vsix" i wybierz wersję C# lub Visual Basic projektu VSIX.

3. Dodaj plik .zip do projektu. Ustaw jej właściwość Copy na Output Directory na Copy Alwayswartość .

4. W Eksplorator rozwiązań kliknij dwukrotnie plik source.extension.vsixmanifest, aby otworzyć go w Projektant manifestu VSIX, a następnie wprowadź następujące zmiany:

   • Ustaw pole Product Name (Nazwa produktu) na My Project Template (Mój szablon projektu).

   • W polu Identyfikator produktu ustaw wartość MyProjectTemplate — 1.

   • W polu Autor ustaw wartość Fabrikam.

   • Ustaw pole Opis na Mój szablon projektu.

   • W sekcji Zasoby dodaj typ Microsoft.VisualStudio.ProjectTemplate i ustaw jego ścieżkę na nazwę pliku .zip.

5. Zapisz i zamknij source.extension.vsixmanifest plik.

6. Skompiluj projekt.

7. W katalogu wyjściowym kliknij .vsix dwukrotnie plik.

8. Zostanie wyświetlone okno komunikatu Instalatora VSIX. Postępuj zgodnie z instrukcjami, aby zainstalować rozszerzenie.

9. Zamknij program Visual Studio, a następnie otwórz go ponownie.

10. Wybierz pozycję Zarządzaj rozszerzeniami (w menu Rozszerzenia ) i wybierz kategorię Szablony . Jednym z dostępnych rozszerzeń powinien być Mój szablon projektu.

11. Nowy szablon projektu zostanie wyświetlony w oknie dialogowym Nowy projekt w tym samym miejscu co oryginalny szablon projektu. Jeśli na przykład utworzono szablon o nazwie VB Console z poziomu aplikacji konsolowej języka Visual Basic, konsola VB zostanie wyświetlona w tym samym okienku co szablon aplikacji konsoli Visual Basic.

Aby określić lokalizację szablonu w oknie dialogowym Nowy projekt

1. Foldery szablonów znajdują się w {Visual Studio Installation Path}\Common7\IDE\ProjectTemplates katalogach i {Visual Studio Installation Path}\Common7\IDE\ItemTemplates . Nazwy sekcji najwyższego poziomu w oknie dialogowym Nowy projekt nie są dokładnie zgodne z nazwami folderów szablonu. Gdzie się różnią, użyj nazwy folderu szablonu.

   Zmień rozszerzenie pliku na .vsix.zip, a następnie otwórz plik.

2. Utwórz nowy folder o takiej samej nazwie jak sekcja okna dialogowego Nowy projekt , w których powinien zostać wyświetlony szablon.

3. Jeśli szablon ma zostać wyświetlony w podsekcji, utwórz podfolder o tej samej nazwie.

4. Przenieś plik szablonu .zip do nowego folderu.

5. Zmień rozszerzenie na .zip.vsix.

6. Otwórz manifest VSIX.

7. W manifeście VSIX zaktualizuj ścieżkę elementu zawartości szablonu, aby wskazywać katalog główny drzewa katalogów zawierającego plik szablonu. Jeśli na przykład szablon znajduje się w \CSharp\Windowselemencie , odwołanie powinno wskazywać wartość \CSharp.