mcpField
S
syncfusion-angular-license

syncfusion-angular-license

github.com/syncfusion開発0326 回インストール2 週間前に更新
リポジトリ

syncfusion-angular-license について

Syncfusion Angularプロジェクトの管理者向けライセンススキルです。ライセンスキーの生成と登録、検証エラーの解決を扱います。バージョンごとのライセンス形態、環境変数による登録、オフライン検証の要件も説明します。

主な機能

  1. 01ライセンスキーと解除キーの違いの説明
  2. 02バージョンとプラットフォームに応じたキー生成
  3. 03環境変数とNPXによる登録
  4. 04CI/CDでの登録方法の案内
  5. 05キーやバージョン検証エラーの解決
  6. 06トライアル、コミュニティ、商用ライセンスの説明

活用シーン

  1. 01Angularプロジェクト用のライセンスキーを生成
  2. 02CI/CDパイプラインでライセンスを登録
  3. 03無効またはバージョン不一致のエラーを解決
  4. 04オフライン環境でSyncfusionライセンスを検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/syncfusion/angular-ui-components-skills --skill syncfusion-angular-license

インストール後、Claude Code で/syncfusion-angular-licenseを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
license-generation.md
license-registration.md
licensing-errors.md

詳細

Syncfusion Angular のライセンス

このスキルでは、Syncfusion Angular のライセンス要件、ライセンスキーの生成方法、登録方法、検証エラーのトラブルシューティングについて説明します。

目次

ライセンスの概要

Essential JS2 プラットフォームでは、2022 Volume 1 リリース（v20.1.0.47）から Syncfusion ライセンスキーの検証が導入されました。npm、CDN、またはビルドから Syncfusion パッケージを参照するすべての Angular アプリケーションでは、検証警告を回避するため、有効なライセンスキーを登録する必要があります。

ライセンスの主な詳細

ライセンスキーとアンロックキー：

  • ライセンスキー： Syncfusion パッケージの使用を検証するために、アプリケーションコードに登録する文字列です
  • アンロックキー： Syncfusion インストーラーの実行時にのみ使用します
  • ⚠️ 重要： ライセンスキーはインストーラーのアンロックキーとは異なります

主な要件：

  • ライセンスキーの検証は v20.1.0.47 以降（2022 Volume 1）で導入されました
  • ライセンスキーはバージョンおよびプラットフォーム／エディションごとに異なります
  • 検証はオフラインで行われます（実行時にインターネット接続は不要です）
  • npm パッケージまたはトライアル版インストーラーを使用する場合に必要です
  • ライセンス版インストーラーを使用する場合は不要です

ライセンスの種類：

  • トライアルライセンス： 30 日間の評価期間があり、すべての機能を利用できます。トライアルキーが生成され、期限切れ後に警告が表示されます
  • コミュニティライセンス： 条件を満たす個人／組織（収益が 100 万米ドル未満）向けの無料ライセンスです。有料ライセンスと同じ機能を利用でき、年次更新が必要です
  • 有料ライセンス： エンタープライズ利用向けの商用ライセンスです。永続ライセンスまたはサブスクリプション形式で、テクニカルサポートが含まれます

エディションベースとプラットフォームベース：

  • v31.1.17 以降（エディションベース）： UI Edition、Document SDK、PDF Viewer SDK、DOCX Editor SDK、Spreadsheet Editor SDK、Enterprise Edition（すべてのエディションを統合）
  • v30.x.x 以前（プラットフォームベース）： Angular、React、Vue、JavaScript、Blazor など

ビルドサーバーでのシナリオ：

  • npm パッケージを使用する場合： ライセンスキーが必要です。NPX コマンドを使用して登録してください
  • トライアル版インストーラーを使用する場合： ライセンスキーが必要です。30 日後にトライアルの警告が表示されます
  • ライセンス版インストーラーを使用する場合： ライセンスキーは不要です。ライセンス検証が組み込まれています

オフライン検証：

  • アプリケーションの実行時にインターネット接続は不要です
  • 起動時に、パッケージのメタデータに基づいてローカルでライセンスを検証します
  • インターネットから隔離された環境やオフライン開発でも動作します
  • 外部 API 呼び出しやパフォーマンスへの影響はありません

ドキュメントとナビゲーションガイド

ライセンスキーの生成

📄 参照： references/license-generation.md

  • エディションベースのライセンス（v31.1.17 以降）： UI Edition、Document SDK、PDF Viewer SDK、DOCX Editor SDK、Spreadsheet Editor SDK、Enterprise Edition
  • プラットフォームベースのライセンス（v30.x.x 以前）： Angular、JavaScript、React など
  • License & Downloads ページでのキーの生成
  • Claim License Key ページの使用方法
  • バージョンおよびプラットフォームごとのライセンスキー
ライセンスキーの登録

📄 参照： references/license-registration.md

  • 環境変数の方法：SYNCFUSION_LICENSE
  • CI/CD との統合：GitHub Actions、Azure Pipelines
  • 有効なライセンス、有効なトライアル、期限切れのライセンスのシナリオ
ライセンスエラーのトラブルシューティング

📄 参照： references/licensing-errors.md

  • ライセンスキーが登録されていないエラー
  • 無効なキーのエラー
  • トライアル期限切れのエラー（30 日）
  • プラットフォーム不一致のエラー
  • バージョン不一致のエラー
  • NPX コマンドの検証エラー

クイックスタート

1. ライセンスキーを生成する

ライセンスとダウンロードページにアクセスします。

v31.1.17+（エディションベース）の場合：

  • バージョン 31.x.x 以降を選択します
  • 必要なエディションを選択します：UI Edition、Document SDK、PDF Viewer SDK、DOCX Editor SDK、Spreadsheet Editor SDK
  • 推奨： Enterprise Edition キーの場合は、5 つすべてのエディションを選択します
  • 「Get License Key」をクリックします

v30.x.x 以前（プラットフォームベース）の場合：

  • バージョン 30.x.x 以前を選択します
  • プラットフォームを選択します：Angular、JavaScript など
  • 「Get License Key」をクリックします
2. アプリケーションにライセンスキーを登録する

推奨方法： 環境変数を使用してライセンスキーを登録します。これにより、ライセンスキーを誤ってソース管理にコミットするのを防げます。

手順 1： 環境変数を設定します。

# Windows
setx SYNCFUSION_LICENSE "Your_License_Key_Here"

# Mac/Linux
export SYNCFUSION_LICENSE='Your_License_Key_Here'

手順 2： NPX コマンドを使用してライセンスを有効にします。

npx syncfusion-license activate

手順 3： キャッシュをクリアします。

# Windows PowerShell
Remove-Item -Recurse -Force node_modules\.cache

# macOS/Linux
rm -rf node_modules/.cache

注： ほかのライセンス登録方法については、Syncfusion ライセンスキー登録ドキュメントを参照してください。

コメント

Markdown 対応