ライセンス FAQ とインストール

使用許諾契約

購入して使用する製品に関するすべての使用条件を知っておくことが重要です。

Note

2020 年第 2 四半期にライセンス条件およびサブスクリプションモデルを更新しました。

トライアル期間が終了した場合、またはサブスクリプションの有効期限が切れた場合、Ignite UI を使用するチームの各開発者はサブスクリプションを購入する必要があります。これにより、https://packages.infragistics.com/npm/js-licensed/ でホストされるプライベート npm フィードを開発に使用できます。ここには、Ignite UI for Angular パッケージの最新バージョンがあります。現在のサブスクリプションがある場合、Ignite UI for Angular の製品版をプライベートフィードによりアクセスできます。

Ignite UI 使用許諾契約と利用規約の詳細については、ここをクリックを参照してください。

インフラジスティックスは、以下の無料の非営利および再販禁止 (NFR) ライセンスを提供しています。

Microsoft MVP、Microsoft Regional Director、Google Developer Expert などの開発者プログラムに参加している場合。
小学生、中学生、大学生、または教育機関、または教授である場合。

無料の非営利および再販禁止 (NFR) ライセンスの資格がある場合、またはライセンスに関する質問がある場合は、お問い合わせください。

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

Npm は Node.js ランタイム環境で使用する一般的なデフォルトパッケージマネージャーです。広く採用されており、プロジェクトに依存するパッケージをすばやく簡単に処理できます。npm の使用方法の詳細については、npm ヘルプを参照してください。

Infragistics Ignite UI for Angular は npm パッケージとして提供され、Ignite UI CLI または Ignite UI for Angular Schematics でプロジェクトに依存関係として追加できます。このパッケージをインストールすると、製品の Ignite UI for Angular トライアル版の使用が開始されます。

Note

トライアル版の使用を開始するとはどういう意味ですか? これは、Web ビューのウォーターマーク部分を含む製品バージョンを使用することを意味します。ライセンスパッケージを有効期限が切れる前に一定期間 (たとえば、1 か月間) 使用するという意味ではありません。

Infragistics Ignite UI Dock Manager Web コンポーネントは、別の npm パッケージとして利用できます。インストールすると、製品の Ignite UI Dock Manager Web コンポーネントトライアル版の使用が開始されます。

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

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

Ignite UI for Angular が ng add を使用してプロジェクトに追加された場合、またはプロジェクトが schematic コレクションまたは Ignite UI CLI を使用して作成された場合、upgrade-packages を使用して、ライセンスパッケージを使用するようにアプリを自動的にアップグレードできます。プロジェクトパッケージの依存関係には、@igniteui/angular-schematics または igniteui-cli が含まれ、どちらも upgrade コマンドをサポートします。

Note

パッケージが変更されるため、切り替える前にプロジェクトを更新することをお勧めします。このように、Ignite UI Angular の高いバージョンを使用せず、更新の移行のトラブルを防止します。アップデートガイドを参照してください。

プロジェクトのセットアップに応じて、プロジェクトで以下の schematic を実行します。

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

または igniteui-cli を使用します:

ig upgrade-packages

schematic またはコマンドはプロジェクトのパッケージの依存関係を切り替え、ソース参照を更新します。まだセットアップされていない場合、NPM レジストリへのログインが要求されます。

Note

プロジェクトが yarn を使用している場合は、--skip-install フラグを指定して upgrade-packages を実行します。その後、yarn install (現在 upgrade コマンドはインストールに npm を使用します) を実行して yarn.lock を適切に更新します。

プライベート npm フィードを使用するための環境設定方法 (ステップバイステップガイド)

最初にプライベートレジストリを構成し、レジストリを Infragistics スコープと関連付けます。

これにより公開用の npm レジストリおよびプライベート Infragistics レジストリからのパッケージを同時に使用できます。

Note

アカウントのライセンスがない場合 (トライアル版アカウントを使用している場合)、プライベートパッケージフィードにアクセスできません (たとえば、404 または 403 エラーメッセージが返されます)。ライセンスされているアカウントのみが packages.infragistics プライベートフィードにアクセスできます。

npm を使用してプライベートフィードにログインするには、次のようにします。

npm version 9+

プライベートフィードは現在、npm v9 で login/adduser コマンドをサポートしていないため、必要な認証フィールドを構成に追加する代わりに、次の手順をお勧めします。

npm config set @infragistics:registry https://packages.infragistics.com/npm/js-licensed/
npm config set //packages.infragistics.com/npm/js-licensed/:username=YOUR_USERNAME
npm config set //packages.infragistics.com/npm/js-licensed/:email=YOUR_IG_EMAIL
npm config set //packages.infragistics.com/npm/js-licensed/:_auth=YOUR_IG_AUTH_TOKEN

Infragistics プロファイルからアクセストークンを生成できます。

このアプローチは、以前のすべてのバージョンの npm に適用できます。

v8 までの npm バージョン

adduser コマンドを実行し、ユーザーアカウントとパスワードを指定します。

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

Infragistics アカウントにログインするユーザー名およびパスワードを入力する必要があります。Infragistics プロファイルに登録されるメールも入力してください。

Note

npm はユーザー名で "@" の使用を許可しません。ユーザー名が Infragistics アカウントのメールアドレスであるため、"@" 記号を含みます。この制限を回避するには、"@" 記号の代わりに "!!" (2 つの感嘆符) を使用します。たとえば、ユーザー名が "username@example.com" の場合、"username!!example.com" と入力します。

完了した後に、ログイン済みの状態で、プロジェクトで 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 移行を使用していない場合:

プロジェクトの tsconfig.json に paths マッピングを追加します。

{
  /* ... */
  "compilerOptions": {
    "baseUrl": "./",
    "outDir": "./dist/out-tsc",
    /* ... */
    "paths": {
      "igniteui-dockmanager": ["./node_modules/@infragistics/igniteui-dockmanager"],
      "igniteui-dockmanager/*": ["./node_modules/@infragistics/igniteui-dockmanager/*"],
    }
  }
}

プロジェクトの angular.json に stylePreprocessorOptions マッピングを追加します。

{
  "projects": {
    ..
    "prefix": "app",
      "architect": {
        "build": {
          "builder": "@angular-devkit/build-angular:browser",
          "options": {
            ...
            "aot": true,
            "stylePreprocessorOptions": {
                "includePaths": [
                    "node_modules/@infragistics"
                ]
            }
            ...
},

igniteui-angular/lib ソースのプロジェクト sass インポートから ~ 記号を削除します。

@use "~igniteui-angular/lib/core/styles/themes/index" as *;

// Should be changed to
@use "igniteui-angular/lib/core/styles/themes/index" as *;

npm を既に使用していて、Ignite UI for Angular ライセンスがある場合、Infragistics プライベートフィードを構成してください。

アクセストークンの使用

アクセストークンを使用してプライベート npm フィードの認証を受けることもできます。アクセストークンは infragistics.com ユーザーアカウントで取得できます。アクセストークン認証は、CI プロセスを Ignite UI for Angular ライセンスパッケージを使用する公開アクセス可能なリポジトリに統合する場合に推奨される代替方法です。

以下は、ローカル構成でアクセストークンを使用してプライベート npm レジストリへの認証を設定する方法、Azure Pipelines のビルド手順、および Travis CI のビルドプロセスです。

https://account.infragistics.com/package-feeds からトークンを生成します。

Note

各トークンは Base64 エンコードです。

以下を .npmrc ファイルに追加します。

@infragistics:registry=https://packages.infragistics.com/npm/js-licensed/
//packages.infragistics.com/npm/js-licensed/:_auth=YOUR_ACCESS_TOKEN
//packages.infragistics.com/npm/js-licensed/:username=YOUR_USERNAME

Azure Pipelines の構成

以下の手順で azure-pipelines.yml を更新します。

手順:

- script: npm config set @infragistics:registry $(npmRegistry)
  displayName: 'Npm add registry'
- script: npm config set $(igScope):_auth=$(token)
  displayName: 'Npm config auth'

次に、npm registry、scope および token の変数を追加する必要があります。2 つの方法があります。

パイプラインのライブラリページで変数グループを定義する方法

この記事は、変数グループを使用して複数のパイプラインで制御および利用できる値を保存する方法を説明します。

パイプラインの設定 UI で変数を定義し、YAML ファイルで参照する方法

最も一般的なケースでは、変数を設定して YAML ファイル内で使用します。

Travis CI の構成

ここではほとんど同じ方法を使用しますが、構成は before_install に設定されます。

before_install:
- echo "@infragistics:registry=https://packages.infragistics.com/npm/js-licensed/" >> ~/.npmrc
- echo "//packages.infragistics.com/npm/js-licensed/:_auth=$TOKEN" >> ~/.npmrc

環境変数を定義する最良の方法は、含まれる情報のタイプによって異なるため、2 つのオプションがあります。

暗号化して .travis.yml に追加します。
リポジトリ設定に追加します。

GitHub Actions の構成

npm i(ci) 手順の前に以下のスクリプトを CI ワークフロー構成に追加します:

- run: echo "@infragistics:registry=https://packages.infragistics.com/npm/js-licensed/" >> ~/.npmrc
- run: echo "//packages.infragistics.com/npm/js-licensed/:_auth=${{ secrets.NPM_TOKEN }}" >> ~/.npmrc

シークレット (暗号化された環境変数) を定義してアクセストークンなどの機密情報に対して GitHub Actions ワークフローでそれらを使用します。

ライセンス FAQ とインストール

使用許諾契約

Note

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

Note

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

Note

Note

プライベート npm フィードを使用するための環境設定方法 (ステップバイステップ ガイド)

最初にプライベート レジストリを構成し、レジストリを Infragistics スコープと関連付けます。

Note

npm を使用してプライベート フィードにログインするには、次のようにします。

npm version 9+

v8 までの npm バージョン

Note

完了した後に、ログイン済みの状態で、プロジェクトで Ignite UI の最新バージョンをインストールできます。

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

アクセス トークンの使用

Note

Azure Pipelines の構成

パイプラインのライブラリ ページで変数グループを定義する方法

パイプラインの設定 UI で変数を定義し、YAML ファイルで参照する方法

Travis CI の構成

GitHub Actions の構成

テーマ設定

プライベート npm フィードを使用するための環境設定方法 (ステップバイステップガイド)

最初にプライベートレジストリを構成し、レジストリを Infragistics スコープと関連付けます。

npm を使用してプライベートフィードにログインするには、次のようにします。

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

アクセストークンの使用

パイプラインのライブラリページで変数グループを定義する方法