エクステンション開発プロジェクトテンプレート

概要

Next Designのエクステンション開発のためのプロジェクトテンプレートです。プロジェクトテンプレートを用いれば非常に簡単にエクステンションの開発をスタートできます。プロジェクトテンプレートにはあらかじめ次のような設定がされています。

• エクステンションの開発に関するライブラリパッケージの参照
• マニフェストファイル
• エクステンションの基本的な実装
• エクステンションが実行できるようにビルド時にファイルのコピー設定

プロジェクトテンプレートはVisual Studioおよび.NETのCLIで利用できます。 本テンプレートはNuget.orgで公開しています。

インストール方法

コマンドプロンプトより次のように実行するとプロジェクトテンプレートがインストールされます（実行フォルダはどこでも構いません）。
新しいバージョンへのアップデートも次のコマンドで実行できます。

dotnet new --install NextDesign.Extension.ProjectTemplates

確認のために次のコマンドを実行して下さい。

dotnet new 

正常にインストールが完了している場合は下記の表示されます。

Templates                                     Short Name           Language    Tags
--------------------------------------------  -------------------  ----------  ----------------------
Console Application                           console              [C#],F#,VB  Common/Console
...
Next Design Extension (Extension Points)      ndextp               [C#]        Next Design
Next Design Extension                         ndext                [C#]        Next Design
...

Visual Studioでプロジェクトを作成する

Visual Studioの新規プロジェクト作成のダイアログからエクステンション開発プロジェクトを作成可能です。

作成すると次のようにマニフェストファイルやエクステンションのサンプル実装まで含まれたプロジェクトが作成できます。

プロジェクトテンプレートは次の2種類が用意されています。

• Next Design Extension ... 標準のエクステンションのテンプレートです。
• Next Design Extension (Extension Points) ... 拡張ポイントの定義が非常にシンプルになるエクステンションのテンプレートです。

注意

プロジェクトテンプレートはVisual Studio 2019と2022の両方に対応していますが、1つのマシンにVisual Studio 2019と2022を両方インストールした場合は、Visual Studio 2022のみプロジェクトテンプレートが表示されるようになります。

コマンドラインからプロジェクトを作成する

コマンドラインからは次のように実行するとエクステンションのプロジェクトを作成できます。

dotnet new ndext -n MyExt1

また、よりシンプルにエクステンションの開発が可能な、NextDesign.Desktop.ExtensionPointsを利用したエクステンションのプロジェクトも作成可能です。

dotnet new ndextp -n MyExt2

アンインストール

プロジェクトテンプレートをアンインストールするには次のコマンドを実行して下さい。

dotnet new --uninstall NextDesign.Extension.ProjectTemplates

トラブルシューティング

• Visual Studio 2019でプロジェクトテンプレートが表示されない場合は、バージョンが16.8 Prview2以降であることと、下記の設定から「新しいプロジェクトダイアログにすべての .NET Core テンプレートを表示する」がチェックされているか確認して下さい。
  関連記事はMicrosoftのブログを参照して下さい。