mcpField
S
syncfusion-javascript-license

syncfusion-javascript-license

github.com/syncfusion开发076 次安装2 周前更新
代码仓库

关于 syncfusion-javascript-license

为使用 Syncfusion JavaScript 包的开发者提供授权指南，涵盖密钥生成、注册和错误排查。内容区分版本与平台对应的密钥，并说明离线验证方式。

主要功能

  1. 01生成版本及平台对应的密钥
  2. 02通过环境变量注册密钥
  3. 03使用 NPX 激活许可证
  4. 04排查密钥及试用错误

适用场景

  1. 01为 npm 项目配置许可证
  2. 02在 CI/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 天评估期，功能完整，可生成试用密钥，过期后会显示警告
  • 社区许可证： 符合条件的个人/组织可免费使用（营收低于 1 百万美元），功能与付费许可证相同，需每年续期
  • 付费许可证： 面向企业使用的商业许可证，可永久使用或按订阅方式购买，包含技术支持

按版本版型许可与按平台许可：

  • 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
  • **推荐：**选择全部 5 个版本以获取 Enterprise Edition 密钥
  • 点击“获取许可证密钥”

对于 v30.x.x 及更早版本（基于平台）：

  • 选择版本 30.x.x 或更早版本
  • 选择平台：JavaScript、React、Angular 等
  • 点击“获取许可证密钥”
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