カスタムプロジェクトテンプレートを作成してインストールする

カスタムプロジェクトテンプレートを作成する

1. 目的の構造でプロジェクトを作成します。任意のプロジェクトを開始点として使用することも、既存のテンプレートを使用して新しいプロジェクトを作成することもできます。

   これを説明するために、1 つのファイルのみを含む最も単純なプロジェクトを取り上げます。

   ConsoleAppAsyncMain ├── bin ├── obj ├── MyProject.csproj ├── Program.cs

   Program.cs には、デフォルトのアプリケーションエントリポイントとして async main メソッドが含まれています。

   using System; using System.Threading.Tasks; namespace MyProject { class Program { static async Task Main(string[] args) { Console.WriteLine("Hello World!"); } } }

2. プロジェクトフォルダーを、テンプレートとして使用する場所にコピーします。

3. bin、obj、テンプレートのソースコードに関連しないその他のディレクトリとファイルを削除します。

4. コピーしたプロジェクトディレクトリ（現在はテンプレートディレクトリ）に、.template.config という名前のフォルダーとその中に template.json という名前のファイルを追加します。

   これで、テンプレート構造は次のようになります。

   MyTemplates ├── ConsoleAppAsyncMain ├── .template.config ├── template.json ├── MyProject.csproj ├── Program.cs

5. テンプレート記述子 template.json でテンプレートプロパティを指定します

   最小記述子は次のようになりますが、必要に応じてさらに詳細な構成を提供できます。この Microsoft.NET ブログ記事(英語)でより多くの情報と例を見つけることができます。

   { "author": "Your Name", "name": "Async Main Console Application", "description": "A project for creating a command-line application that can run on .NET on Windows, Linux and macOS, and has an async Main method.", "identity": "YourName.ConsoleApp.1.0", "shortName": "consoleasync", "tags": { "language": "C#", "type": "project" }, "sourceName": "MyProject", "symbols": { "Framework": { "type": "parameter", "description": "The target framework for the project.", "datatype": "choice", "choices": [ { "choice": "netcoreapp2.0" }, { "choice": "netcoreapp3.0" } ], "defaultValue": "netcoreapp2.0" } } }

6. 上記の構成のプロパティは、"sourceName": "MyProject" を除いて、一目瞭然です。

   このテンプレートを使用してプロジェクトを作成すると、このプロパティの値は、すべての場所で、新しいプロジェクトに指定した名前に置き換えられます。

   この例では、新しい名前が Program.cs のプロジェクトファイル名と名前空間に置き換わります。

7. 新しいプロジェクトテンプレートの準備ができました。新規プロジェクト / 新規ソリューションダイアログにインストールできます。左側のその他のテンプレートをクリックし、テンプレートをインストールするをクリックして、保存した場所にある ConsoleAppAsyncMain フォルダーを選択します。

   テンプレートへのパスがリストに表示されたら、再ロードをクリックします。

8. テンプレートがインストールされるとすぐに、左側のリストでテンプレートを見つけて、新しいプロジェクトを作成するために使用できます。