インフラジスティックス Ignite UI 製品の利用にあたり、ライセンス版の npm パッケージを使用するには、npm config set コマンドを実行して、事前にプライベート npm フィードを開発環境に設定しておく必要があります。
以下ではその手順を説明いたします。
システム要件
npm バージョン 9.0 以上
※npm のバージョンが 9 より前の場合については、末尾の補足を参照ください。
設定手順
準備 – 自分のインフラジスティックスアカウントのアクセストークンを取得する
1. インフラジスティックスのカスタマーポータル (https://account.infragistics.com/) にサインインします。
2. カスタマーポータル画面右上の自分のアカウント名のアイコンをクリックし、ドロップダウンリストから「アクセストークン」をクリックします (下図)。
3. 「アクセストークン」の画面になるので、画面右上の「トークンを生成する」ボタンをクリックします (下図)。
4. 「新しいトークンが生成されました!」と表示され、アクセストークン (英数字の羅列の文字列) が表示されます (下図)。
このアクセストークンを「クリップボードにコピーする」ボタンをクリックするなどして控えておきます。アクセストークンを控え終わったら「閉じる」ボタンをクリックして表示を閉じます。
なお、生成したアクセストークンは、いちど「アクセストークン」画面を離れると、二度と再表示されませんのでご注意ください。もしもアクセストークンを取得し損ねた場合は、もう一度「トークンを生成する」を実行して新たなアクセストークンを取得し、および、不要になったアクセストークンは、この「アクセストークン」画面上で削除してください。
プライベート npm フィードの登録作業
開発環境でターミナルを開き、以下のとおりコマンドを実行します。
npm config set "@infragistics:registry" "https://packages.infragistics.com/npm/js-licensed/"
npm config set "//packages.infragistics.com/npm/js-licensed/:username={ユーザー名}"
npm config set "//packages.infragistics.com/npm/js-licensed/:email={メールアドレス}"
npm config set "//packages.infragistics.com/npm/js-licensed/:_auth={アクセストークン}"
上記コマンド実行にあたっての各プレースホルダーは、具体的には以下を指定します。
- {ユーザー名}
ご自身のインフラジスティックスアカウント名 (インフラジスティックスのカスタマーポータルにサインインするときに指定するメールアドレス) のうち、”@” を “!!” に置き換えたものを指定
(例: インフラジスティックスアカウント名が “user@example.com” の場合は、”user!!example.com” を指定) - {メールアドレス}
ご自身のインフラジスティックスアカウント名
(インフラジスティックスのカスタマーポータルにサインインするときに指定するメールアドレス) を指定 - {アクセストークン}
先に説明した手順で取得した、ご自身のアクセストークン文字列を指定
インフラジスティックスアカウント名が user@example.com の場合の実行例は、下記のとおりです。
npm config set "@infragistics:registry" "https://packages.infragistics.com/npm/js-licensed/" npm config set "//packages.infragistics.com/npm/js-licensed/:username=user!!example.com" npm config set "//packages.infragistics.com/npm/js-licensed/:email=user@example.com" npm config set "//packages.infragistics.com/npm/js-licensed/:_auth=YXBpOjk2NjVxKG5vIGRlc2NyaXB0aW9uKTlkNTIwMjMwMzEzMDE1MTA5MWM2YjE0MjhmMjZl"
以上の手続きで、インフラジスティックスのプライベート npm フィードが登録され、ライセンス版の npm パッケージを使用できるようになります。
関連記事
npm config set ~ を実行時に //packages.infragistics.com/npm/js-licensed/ is not a valid npm option エラーが発生する
https://kb.jp.infragistics.com/?p=13143
補足: npm のバージョンが 9 より前の場合
お使いの開発環境にインストールされている npm のバージョンが 9 より前の場合は、下記リンク先の手順をご参照ください。
- Ignite UI for jQuery | npm パッケージの使用
- Ignite UI for Angular | プライベート npm フィードを使用するための環境設定方法
- Ignite UI for React | プライベート npm フィードを使用するための環境設定方法
- Ignite UI for Web Components | プライベート npm フィードを使用するための環境設定方法
なお、npm のバージョンが 9 以上である場合に、上記リンク先の手順に従って npm adduser ~ コマンドを実行時すると、“No credentials to set” エラーが発生します (下図)。
このようなエラーが出た場合は、お使いの開発環境における npm のバージョンが 9 以上であることにより発生する場合があります。その場合はこのナレッジベース記事の手順でプライベート npm フィードの登録をお試しください。
