Next Design V3.1 用エクステンション開発継続時の注意点
概要
V4.0 へアップデートせず V3.1 を継続利用するために、V3.1 向けエクステンション開発を継続する場合、エクステンション開発プロジェクトの設定変更が必要です。 （ビルド済みのエクステンションをそのまま使用する場合は変更不要です）
対象
設定変更が必要となるのは次のいずれかの場合です。
- 次のプロジェクトテンプレートを利用してプロジェクトを作成
- Next Design Extension プロジェクトテンプレート
- Next Design Extension (Extension Points) プロジェクトテンプレート
- NDExt コマンドを使ってプロジェクトを作成
現象
上記方法で作成したプロジェクトではエクステンション開発用パッケージの最新版を利用する設定になっています。 V4.0 のアップデートに伴いエクステンション開発用パッケージの最新版も V4.0 用パッケージにアップデートします。 そのため、V3.1 用エクステンションをビルドする場合は、エクステンション開発用パッケージとして V3.1 対応バージョンを利用するように設定変更する必要があります。
設定変更しないままリビルドした場合、最新版の V4.0 用パッケージを利用するように自動更新されてしまいます。そのエクステンションをインストールして Next Design V3.1 を起動した場合、次のエラーメッセージが表示されてエクステンションが動作しません。
エクステンション"xxxx"の活性化に失敗しました。(Unable to load one or more of the requested types. Could not load file or assembly 'NextDesign.Desktop, Version=4.0.x.xxxxx, Culture=neutral, PublicKeyToken=null'. 指定されたファイルが見つかりません。)
対処
上記エラーを回避するために、以下の通り、エクステンション開発プロジェクトの設定変更をお願いいたします。
エクステンション開発プロジェクトで利用中の下記パッケージに対して、V3.1 対応バージョンを利用するようにバージョンを明示的に指定してください。
| 該当パッケージ | V3.1 対応バージョン |
|---|---|
| NextDesign.Desktop | 3.1.3.30714 |
| NextDesign.Core | 3.1.3.30714 |
| NextDesign.Desktop.ExtensionPoints (*) | 1.2.2.41030 (リリース予定) |
(*) ExtensionPoints ライブラリを利用していない場合は不要です。
なお、エクステンション開発プロジェクトのターゲットフレームワークは .NET 6.0 のまま変更しないでください。
手順
Visual Studio による設定変更の手順は次の通りです。
-
Visual Studio でソリューションを開きます。
-
ソリューション エクスプローラーでプロジェクトを右クリックし、[NuGet パッケージの管理] を実行して [NuGet パッケージ マネージャー] を表示します。
-
[インストール済み] タブを選択して、上記該当パッケージをアンインストールします。
-
[参照] タブを選択して、該当パッケージを検索します。
-
該当パッケージの V3.1 対応バージョンを指定してパッケージをインストールします。
-
ビルドを実行して成功することを確認します。
補足
上記設定変更を行ったエクステンションは V3.1 と V4.0 の両方で動作します。
以上です。