試用版からライセンスIgnite UI NPMパッケージへの移行

試用版からライセンスIgnite UI NPMパッケージへの移行

この記事では、6 月 2 日以降の 20.1 リリース (9.1 Angular) からデプロイされた NPM パッケージからの変更点について説明します。 このリリースより前の NPM パッケージは影響を受けません。

読書6分

購入および使用する製品に関する法的契約条件をすべて知っておくことが重要です。

​商用製品を構築している場合、またはライセンスの有効期限が切れている場合は、商用ライセンスを取得する必要があります。これにより、https://packages.infragistics.com/npm/js-licensed/ for developmentでホストされているプライベートnpmフィードを使用できるようになります。そこには、Ignite UI for Angularパッケージの最新バージョンがあります。有効な商用ライセンスをお持ちの場合は、このプライベートフィードを使用して、Ignite UI for Angularのフルバージョンにアクセスできます。

​非商用製品を構築している場合は、 当社にご連絡いただければ、適切なライセンスを提供します。

Ignite UI for Angular npm パッケージ – プライベート npm フィードの使用

npmは最も人気のあるパッケージマネージャーであり、ランタイム環境Node.jsのデフォルトでもあります。これは非常に採用されており、プロジェクトで依存するパッケージを管理するための最も速くて簡単な方法の1つです。npm の仕組みの詳細については、npm の公式ドキュメントをお読みください。

Infragistics Ignite UI for Angularは npm パッケージとして利用でき、いくつかの簡単な手順でプロジェクトに依存関係として追加できます。 この方法を選択するために、npm を構成する必要はありません。npmjs.com パッケージを介してIgnite UI for Angularをインストールすると、製品のIgnite UI for Angular試用版を使用することになります。

Infragistics Ignite UIドック マネージャー Web コンポーネントは個別の npm パッケージとして提供されており、インストールすると製品のIgnite UIドック マネージャー Web コンポーネント試用版の使用を開始できます。

Ignite UI for Angular npm パッケージの使用を開始する方法の詳細については、このトピックで、Web コンポーネントの詳細についてはIgnite UIドック マネージャーこちらを参照してください。

Angular Schematics またはIgnite UI CLI を使用したパッケージのアップグレード

​ng addを使ってプロジェクトに追加されたIgnite UI for Angular、または当社のSchematicsコレクションやIgnite UI CLIを通じて作成された場合は、当社のupgrade-packagesを使って自動的にライセンスパッケージにアップグレードできます。

注記

プロセスによってパッケージが変更されるため、切り替える前にまずプロジェクトを更新して、上位のバージョンのIgnite UI Angularを選択したり、潜在的な更新プログラムの移行で欠落したりしないようにすることをお勧めします。アップデートガイドに従ってください。

プロジェクトで次の回路図を実行します。

ng g @igniteui/angular-schematics:upgrade-packages

またはigniteui-cli​

ig upgrade-packages

回路図またはコマンドは、プロジェクトのパッケージ依存関係の切り替えとソース参照の更新を処理します。まだ設定されていない場合は、npmレジストリにログインするように求められます。

プライベート npm フィードを使用するように環境を設定する方法

まず、プライベート レジストリをセットアップし、このレジストリを Infragistics スコープに関連付ける必要があります。

これにより、パブリック npm レジストリと Infragistics プライベート レジストリのパッケージをシームレスに組み合わせて使用できるようになります。Infragisticsアカウントへのログインに使用するユーザー名とパスワードを入力するよう求められます。また、Infragistics プロフィールに登録されているメールアドレスも提供する必要があります。

注記

npmユーザー名内の"@"記号の使用を禁止しているため、「ネット上に安全でない」と見なされます。ユーザー名は実際にはインフラ情報のアカウントで使うメールアドレスなので、常にシンボルが含まれています"@"。だからこそ、この制限を回避するために、記号"@"を"!!"(2つの感嘆符)に置き換える必要があります。例えば、ユーザー名が"username@example.com"ユーザー名について尋ねられた場合、以下の入力を提示してください:"username!!example.com"。

ここで、npmを使用してプライベートフィードにログインするには、adduserコマンドを実行し、ユーザーアカウントとパスワードを指定します。

npm adduser --registry=https://packages.infragistics.com/npm/js-licensed/ --scope=@infragistics --always-auth

これが完了すると、ログインして、Ignite UIパッケージの最新バージョンをプロジェクトにインストールできるようになります。

npm uninstall igniteui-angular
npm install @infragistics/igniteui-angular

npm uninstall igniteui-dockmanager
npm install @infragistics/igniteui-dockmanager

Ignite UI for Angularパッケージをスコープ設定しているので、プライベートフィードと npmjs.org から同時にパッケージをインストールする場合は、レジストリを変更する必要がないことに注意してください。

プロジェクト ソースに追加の変更を加える必要がある場合があります。

試用版からライセンスパッケージにアップグレードし、自動化された CLI 移行を使用していない場合:

  • プロジェクトpathsマッピングを追加してくださいtsconfig.json。
{
  ...
  "compilerOptions": {
    "baseUrl": "./",
    "outDir": "./dist/out-tsc",
    ...
    "paths": {
      "igniteui-angular": ["./node_modules/@infragistics/igniteui-angular"],
      "igniteui-dockmanager": ["./node_modules/@infragistics/igniteui-dockmanager"],
      "igniteui-dockmanager/*": ["./node_modules/@infragistics/igniteui-dockmanager/*"],
    }
    ...
}
  • プロジェクトにstylePreprocessorOptionsマッピングを追加してくださいangular.json
{
  "projects": {
    ..
    "prefix": "app",
      "architect": {
        "build": {
          "builder": "@angular-devkit/build-angular:browser",
          "options": {
            ...
            "aot": true,
            "stylePreprocessorOptions": {
                "includePaths": [
                    "node_modules/@infragistics"
                ]
            }
            ...
},
  • あなたのプロジェクトから~signを削除sassimports forigniteui-angular/lib source:
@import "~igniteui-angular/lib/core/styles/themes/index";

// Should be changed to

@import "igniteui-angular/lib/core/styles/themes/index";

したがって、すでにnpmを採用しており、Ignite UI for Angularライセンスをお持ちの場合は、Infragisticsのプライベートフィードを設定して、Ignite UI for Angularの可能性を最大限に活用して生産性を向上させてください。

アクセストークン

トークンは、コマンドラインユーティリティで認証し、Infragistics製品(パッケージ)にアクセスするための別の方法として使用できます。生成されたトークンは、サブスクリプションが最新である限りアクティブなままです。 トークンには、https://account.infragistics.com/access-tokensのカスタマーポータルからアクセスできます。

ログインすると、この画面からトークンを生成できます。

[アクセス トークン] ページ

注:アクセストークンはパスワードのように秘密にしてください。新しいトークンは、ページが更新されるまで表示され、その後、トークンは難読化されます。

まとめ

この変更はあなたにとって簡単なはずです。 問題がある場合は、jasonb@infragistics.comまでご連絡いただくか、フォーラムを確認するか、サポートに直接お問い合わせください。

操作方法
デモを予約