.NET プロジェクトを作成するには、Visual Studio の「WPF アプリケーション」プロジェクトテンプレートを使用してプロジェクトを作成します。作成したプロジェクトにて本製品のコンポーネントを使用するには、プロジェクトに本製品のアセンブリへの参照を追加する必要がありますが、.NET Framework プロジェクトのようにアセンブリファイル（*.dll）への参照を直接追加するのではなく、代わりにそれらのコンポーネントに対応する NuGet パッケージをインストールすることになります。
例として、Visual Studio 2022 にて.NET6の新規プロジェクトを作成し、NuGet パッケージをインストールするまでの手順を以下に示します。
- Visual Studio 2022 を起動します。
-
スタート画面で「新しいプロジェクトの作成」を選択します。または、メインメニューから[ファイル]-[新規作成]-[プロジェクト]を選択します。
-
「新しいプロジェクトの作成」画面にて、「WPF アプリケーション」を選択します。
-
プロジェクト名およびソリューション名を指定し、次へボタンをクリックします。
-
ターゲットフレームワークとして「.NET6」を指定し、作成ボタンをクリックします。
これにより、プロジェクトおよびソリューションが作成され、生成されたソリューションの内容がソリューションエクスプローラーに表示されます。
- ソリューションエクスプローラーで、プロジェクトのコンテキストメニューから NuGet パッケージの管理を選択し、「NuGet パッケージマネージャー」を開きます。
-
画面右上にある「パッケージソース」を「nuget.org」に設定します。
参照タブに切り替え、検索ボックスに「MESCIUS.WPF.InputMan」と入力すると、本製品の NuGet パッケージが表示されます。
-
本製品の NuGet パッケージ（MESCIUS.WPF.InputMan）を選択します。
-
使用するバージョンを選択し、インストールボタンをクリックします。依存関係にある NuGet パッケージが検出され、それら含めたライセンスの同意画面が表示されるので、続行する場合は同意するボタンをクリックします。
本製品のNuGetパッケージをインストールすると、本製品の以下のアセンブリファイルと System.Text.Encoding.CodePages のパッケージがプロジェクトの依存関係に追加されます。
- GrapeCity.WPF.InputMan.dll
- GrapeCity.WPF.InputMan.Aero.dll
- GrapeCity.WPF.InputMan.Aero2.dll
- GrapeCity.WPF.InputMan.AeroLite.dll
- GrapeCity.WPF.InputMan.BureauBlack.dll
- GrapeCity.WPF.InputMan.BureauBlue.dll
- GrapeCity.WPF.InputMan.Classic.dll
- GrapeCity.WPF.InputMan.ExpressionDark.dll
- GrapeCity.WPF.InputMan.Luna.dll
- GrapeCity.WPF.InputMan.Royale.dll
- GrapeCity.WPF.InputMan.Design.dll
.NET6 プロジェクトで本製品を使用する場合は、アプリケーションの開始時に以下のコードを実行する必要があります。
System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance);
本製品の NuGet パッケージをインストールした後に、プログラムの Main() メソッドなどに追加してください。
本バージョンのSP1からNuGet パッケージ名が変更になりました。SP1以降をご利用の際は、変更後のパッケージをインストールする必要があります。
初版からSP1以降へ移行される場合は、GrapeCity.WPF.InputManをアンインストールの上、MESCIUS.WPF.InputManをインストールしてください。
変更前：GrapeCity.WPF.InputMan
変更後：MESCIUS.WPF.InputMan
本製品の NuGet パッケージファイルは、本製品のインストール先フォルダにある「Package」フォルダに保存されています。
インターネットに接続されていない環境では、それら NuGet パッケージファイルを任意のフォルダにコピーし、下記の手順に従って NuGet パッケージソースを追加してから、本製品の NuGet パッケージをインストールしてください。
- Visual Studio の［ツール］メニューから、［NuGet パッケージマネージャー］→［パッケージマネージャー設定］を選択します。［オプション］ダイアログボックスが表示されます。
- 左ペインで、［パッケージソース］を選択します。
- 右上隅にある
ボタンをクリックします。［利用可能なパッケージソース］に新しいソースが追加されます。
- 新しいパッケージソースの名前を設定します。
- ［ソース］フィールドの横にある省略符ボタンをクリックして、NuGet パッケージファイルが保存されたフォルダを参照します。
- フォルダを選択したら、［更新］ボタンをクリックし、最後に［OK］をクリックします。
以上の手順で作成した「パッケージソース」を、「NuGet パッケージのインストール」の手順２の「パッケージソース」として指定すると、本製品の NuGet パッケージが参照できるようになります。
|
本製品を利用する場合は、依存パッケージとして |
