注意
2024年7月現在は、以下のナレッジベース記事で説明している、(INFRAGISTICS アカウントのパスワードではなく) アクセストークンを使った方法が推奨されます。
アクセストークンを使ってライセンス付き NuGet フィードを追加する方法 – INFRAGISTICS ナレッジ ベース
Ignite UI for Blazor などのインフラジスティックス製品の NuGet パッケージをプロジェクトにインストール可能にするには、事前に、インフラジスティックスのライセンス付き NuGet フィードを、開発環境のパッケージソースとして追加登録しておく必要があります。
インフラジスティックスのライセンス付き NuGet フィードから NuGet パッケージを取得するには、有効な製品ライセンス情報に基づいて、その利用者の認証情報と併せてパッケージソースに登録する必要があります。
具体的な手順は、インフラジスティックスのヘルプドキュメントサイト (下記リンク先) に手順が掲載されています。
Ignite UI for Blazor ライセンス付き NuGet フィードの追加
上記リンク先では、Visual Studio の NuGet パッケージマネージャ GUI 画面からの追加手順と、および、NuGet CLI をダウンロード・インストールしての追加手順が記されています。
他にも、.NET SDK がインストールされており dotnet CLI (dotnet コマンド) が利用できる環境であれば、dotnet CLI を使っても、インフラジスティックスのライセンス付き NuGet フィードを追加登録することが可能です。(多くの場合、Visual Studio をインストールされている場合は、dotnet CLI もインストール済みです)
以下でその方法を具体的に説明します。
dotnet CLI を使ったインフラジスティックスのライセンス付き NuGet フィードを追加する方法
Visual Studio や .NET SDK をインストール済みの環境にて、ターミナル (コマンドプロンプト) を開き、以下のコマンドを実行します。
dotnet nuget add source "https://packages.infragistics.com/nuget/licensed" -n Infragistics -u {ユーザー名} -p {パスワード}
コマンドライン引数の指定内容は以下のとおりです。
- -n {パッケージソース名}
パッケージソースの名前を指定します。任意の名前を指定できますが、インフラジスティックスのライセンス付き NuGet フィードについては、慣例的に “Infragistics” を指定します。 - -u {ユーザー名}
パッケージソースにアクセスするための認証情報のうち、ユーザー名を指定します。これはインフラジスティックスのカスタマーポータル (https://account.infragistics.com/) にサインインするときのインフラジスティックスアカウントの ID (e-mail アドレス) を指定します。 - -p {パスワード}
パッケージソースにアクセスするための認証情報のうち、パスワードを指定します。これはインフラジスティックスのカスタマーポータル (https://account.infragistics.com/) にサインインするときのインフラジスティックスアカウントのパスワードを指定します。
以上で、”Infragistics” のパッケージソース名で、インフラジスティックスのライセンス付き NuGet フィードが追加され、このフィードから Ignite UI for Blazor などの製品版 NuGet パッケージをプロジェクトに追加可能になります。
エラー「error: The name specified has already been added…」が発生したら
もしも既に “Infragistics” のパッケージソース名で既に登録済みの場合は、「error: The name specified has already been added to the list of available package sources. Provide a unique name.」というエラーになります。その場合は、いちど下記コマンドを実行して、”Infragistics” のパッケージソースを削除してから、もう一度試行してみてください。
dotnet nuget remove source Infragistics
エラー「error: Password encryption is not supported…」が発生したら
Linux 環境など一部のプラットフォームでは「error: Password encryption is not supported on .NET Core for this platform. The following feed try to use an encrypted password: ‘Infragistics’. You can use a clear text password as a workaround. error: Encryption is not supported on non-Windows platforms.」といったエラーが発生する場合があります。これは、このプラットフォームでは NuGet の構成ファイルに記載されるパスワード (今回はアクセストークン) が暗号化できないことを知らせています。
この場合はやむを得ませんので、暗号化せずに平文のままパッケージソース情報を保存する、「–store-password-in-clear-text」スイッチを付加して「dotnet nuget add … 」コマンドを実行してください (下記例)。
dotnet nuget add source "https://packages.infragistics.com/nuget/licensed" -n Infragistics -u {ユーザー名} -p {パスワード} --store-password-in-clear-text
