mcpField
S
syncfusion-javascript-license

syncfusion-javascript-license

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

syncfusion-javascript-license について

Syncfusion JavaScriptパッケージを使う開発者向けのライセンスガイドです。キーの生成と登録、エラー対応に加え、バージョンやプラットフォーム別のキーとオフライン検証を説明します。

主な機能

  1. 01バージョン・プラットフォーム別キーの生成
  2. 02環境変数によるキー登録
  3. 03NPXによるライセンス有効化
  4. 04キーや試用版エラーの調査

活用シーン

  1. 01npmプロジェクトのライセンス設定
  2. 02CI/CDでのキー登録
  3. 03バージョンやプラットフォームの不一致解消

インストール

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

$npx skills add https://github.com/syncfusion/javascript-ui-controls-skills --skill syncfusion-javascript-license

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

同梱ファイル

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

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

詳細

Syncfusion JavaScript ライセンス

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

目次

ライセンスの概要

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

ライセンスの主な詳細

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

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