syncfusion-vue-license について
Syncfusion Vueを使う開発者向けのライセンスガイドです。キーの生成と登録、バージョンごとの要件、検証エラーの対処方法を説明します。
主な機能
- 01ライセンスキーと解除キーの区別
- 02バージョン・プラットフォーム別要件
- 03環境変数とNPXによる登録
- 04一般的な検証エラーへの対処
活用シーン
- 01Vueアプリ用ライセンスキーの生成
- 02環境変数を使ったキー登録
- 03バージョンやプラットフォームの不一致解消
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ syncfusion/ vue-ui-components-skills --skill syncfusion-vue-licenseインストール後、Claude Code で/syncfusion-vue-licenseを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/license-generation.mdlicense-registration.mdlicensing-errors.md詳細
Syncfusion Vue のライセンス
このスキルでは、Syncfusion Vue のライセンス要件、ライセンスキーの生成、登録方法、検証エラーのトラブルシューティングについて説明します。
目次
ライセンスの概要
Essential JS2 プラットフォームでは、2022 Volume 1 リリース(v20.1.0.47)から Syncfusion ライセンスキーの検証が導入されました。npm、CDN、またはビルドから Syncfusion パッケージを参照するすべての Vue アプリケーションでは、検証警告を回避するために有効なライセンスキーを登録する必要があります。
ライセンスの主な詳細
ライセンスキーとアンロックキー:
- ライセンスキー: 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 以前(プラットフォーム別): Vue、JavaScript、Angular、React、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 以前): Vue、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 以前を選択します
- プラットフォームを選択します:Vue、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
Note: 別のライセンス登録方法については、Syncfusion ライセンスキー登録ドキュメントを参照してください。