VSIX プロジェクト テンプレートの概要

  • [アーティクル]

VSIX プロジェクト テンプレートを使用して拡張機能を作成する方法、または配置用の既存の拡張機能をパッケージ化することができます。 VSIX プロジェクト テンプレートには Visual Basic と Visual C# の両方のバージョンがあり、Visual Studio SDK の一部としてインストールされます。

VSIX プロジェクト テンプレートは、拡張機能と付属の source.extension.vsixmanifest 資産に関する情報を含むファイルで構成されます。

VSIX プロジェクト テンプレートを見つけるには、Visual Studio SDK をインストールする必要があります。 詳細については、「Visual Studio SDK」を参照してください。

VSIX プロジェクト テンプレートを使用したカスタム プロジェクト テンプレートの配置

次の手順では、VSIX プロジェクトを使用して、他の開発者と共有したり、Visual Studio ギャラリーにアップロードしたりできるプロジェクト テンプレートをパッケージ化する方法について説明します。

  1. プロジェクト テンプレートを作成します。

    1. テンプレートを作成するプロジェクトを開きます。 このプロジェクトは、任意のプロジェクト タイプにすることができます。

    2. [プロジェクト] メニューの [テンプレートのエクスポート] をクリックします。 ウィザードの手順を完了します。

      で .zip ファイルが作成されます %USERPROFILE%\My Documents\Visual Studio {version}\My Exported Templates\。

  2. 空の VSIX プロジェクトを作成します。

    ファイル>新規作成>プロジェクトを選択します。 検索ボックスに「vsix」と入力し、VSIX プロジェクトの C# または Visual Basic バージョンを選択します。

  3. プロジェクトに .zip ファイルを追加します。 [出力ディレクトリにコピー] プロパティを Copy Always に設定します。

  4. ソリューション エクスプローラーで、source.extension.vsixmanifest ファイルをダブルクリックして VSIX マニフェスト デザイナーでそれを開き、次のように変更します。

    • [製品名] フィールドを「My Project Template」に設定します。

    • [製品 ID] フィールドを「MyProjectTemplate - 1」に設定します。

    • [作成者] フィールドを「Fabrikam」に設定します。

    • [説明] フィールドを「マイ プロジェクト テンプレート」に設定します。

    • [アセット] セクションで、Microsoft.VisualStudio.ProjectTemplate 型を追加し、そのパスを .zip ファイルの名前に設定します。

  5. source.extension.vsixmanifest ファイルを保存し、閉じます。

  6. プロジェクトをビルドします。

  7. 出力ディレクトリで、ファイルを .vsix ダブルクリックします。

  8. VSIX インストーラーのメッセージ ボックスが表示されます。 手順に従って拡張機能をインストールします。

  9. Visual Studio をいったん閉じて開きなおします。

  10. [拡張機能] メニューの [拡張機能の管理] を選択し、[テンプレート] カテゴリを選択します。 使用可能な拡張機能の 1 つが、My Project Template になっているはずです。

  11. 新しいプロジェクト テンプレートは、元のプロジェクト テンプレートと同じ場所にある [新しいプロジェクト] ダイアログに表示されます。 たとえば、Visual Basic コンソール アプリケーションから VB Console という名前のテンプレートを作成した場合、VB Console は、Visual Basic コンソール アプリケーション テンプレートと同じウィンドウに表示されます。

[新しいプロジェクト] ダイアログ ボックスでテンプレートの場所を指定する方法

  1. テンプレート フォルダーは、ディレクトリ内{Visual Studio Installation Path}\Common7\IDE\ProjectTemplates{Visual Studio Installation Path}\Common7\IDE\ItemTemplatesにあります。 [新しいプロジェクト] ダイアログ ボックスの最上位セクションの名前は、テンプレート フォルダーの名前と完全には一致しません。 違いがある場合は、テンプレート フォルダーの名前を使用します。

    ファイル拡張子を .vsix [] に .zip変更し、ファイルを開きます。

  2. テンプレートが表示されるはずの [新しいプロジェクト] ダイアログのセクションと同じ名前の新しいフォルダーを作成します。

  3. テンプレートがサブセクションに表示される場合は、同じ名前のサブフォルダーを作成します。

  4. テンプレート .zip ファイルを新しいフォルダーに移動します。

  5. 拡張子を . に変更します.zip.vsix。

  6. VSIX マニフェストを開きます。

  7. VSIX マニフェストで、テンプレート ファイルを含むディレクトリ ツリーのルートをポイントするように、テンプレートのアセット パスを更新します。 たとえば、テンプレートが含まれている \CSharp\Windows場合、参照 \CSharpは .