NDExt

Next Designのエクステンションの開発を支援するコマンドラインツールです。

• 必要環境
• インストール方法
• 利用方法
• リリースノート
• パッケージの公開方法
  • ローカル環境からの公開
  • Github Actionsによる公開
• 参照
• ライセンス

Notice: 本ツールはNext Design V2以降を対象としています。 Next Design V1.Xでは利用できません。

必要環境

• このプログラムを動作させるには .NET8のSdkおよびnuget.exeのインストールが必要です。
• nuget.exe は公式サイトからダウンロードし、適切なフォルダーに保存して、そのフォルダーを PATH 環境変数に追加してください（パスの設定が通っていないと正しく動作しません）。

インストール方法

Next Designのエクステンション開発支援コマンドラインツールをグローバルツールとしてnuget.orgに公開しています。コマンドプロンプトから次のように実行してインストールします。

> dotnet tool install --global NDExt 

利用方法

Next Design のエクステンション開発を支援するコマンドラインツールです。次のような操作が簡単になります。

• エクステンション開発プロジェクトの作成
• Visual Studioでのプロジェクトテンプレートの登録
• エクステンションのパッケージ化

利用できるコマンドは下記を実行して確認して下さい。

NDExt:
  Next Designのエクステンションを作成できるユーティリティです。

Usage:
  NDExt [options] [command]

Options:
  --version    Display version information

Commands:
  install            プロジェクトのテンプレートをインストールします。最初に実行して下さい。
  new <name>         現在のフォルダにNext Designのエクステンションのプロジェクトを作成します。
  new-extp <name>    現在のフォルダにExtensionPointsライブラリを用いたエクステンションのプロジェクトを作成します。
  pack               エクステンションをパッケージ化します。
  uninstall          プロジェクトのテンプレートをアンインストールします。

詳しくはNDExtのドキュメントを参照して下さい。

リリースノート

• 各バージョンごとの変更点はリリースノートを参照して下さい。

パッケージの公開方法

nuget.orgへの公開方法を説明します。

ローカル環境からの公開

原則、Github Actinsによる公開をして下さい。

1. 事前準備

   • nuget.orgで densocreateの組織に所属するアカウントを登録して下さい。
   • 環境変数 NUGET_APIKEY をセットして下さい。

2. 公開方法

   • publish.cmdを実行して下さい。

Github Actionsによる公開

• publishブランチにマージすると自動的に https://www.nuget.org/packages/NDExt に公開されます。
• publish to nugetアクションで実行しています。

参照

• プロジェクトテンプレート
  • インストール・作成するプロジェクトテンプレートは NextDesign.Extension.ProjectTemplates のプロジェクトテンプレートを用いています。
  • Githubリポジトリ
  • Nuget.org
• 関連パッケージもnuget.orgにて公開しています。

ライセンス

本ライブラリはMITライセンスです。詳細はLICENSE を確認してください。