mcpField
S
syncfusion-react-license

syncfusion-react-license

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

syncfusion-react-license について

Syncfusion React のライセンスキー生成、登録、検証エラーの対処方法を案内するスキルです。Syncfusion の npm パッケージやトライアルインストーラーを使う開発者向けです。

主な機能

  1. 01バージョン・プラットフォーム別キーの生成
  2. 02環境変数によるキー登録
  3. 03NPX コマンドでのライセンス有効化
  4. 04検証エラーのトラブルシューティング

活用シーン

  1. 01React アプリのキー生成と登録
  2. 02バージョンやプラットフォーム不一致への対処
  3. 03CI/CD 環境でのライセンス設定

インストール

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

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

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

同梱ファイル

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

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

詳細

Syncfusion React ライセンス

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

目次

ライセンスの概要

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

ライセンスの主な詳細

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

  • ライセンスキー： 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 以前（プラットフォームベース）： React、Angular、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 以前）： React、JavaScript、Angular など
  • 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 以前を選択します
  • プラットフォームを選択します：React、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 対応