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. 03使用 NPX 命令激活许可
  4. 04排查常见验证错误

适用场景

  1. 01为 React 应用生成并注册许可密钥
  2. 02处理版本或平台不匹配错误
  3. 03在 CI/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 的许可要求、许可证密钥生成、注册方法以及验证错误排查。

目录

许可概览

Syncfusion 在 2022 Volume 1 版本（v20.1.0.47）中为 Essential JS2 平台引入了许可证密钥验证。所有从 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 版、Document SDK、PDF Viewer SDK、DOCX Editor SDK、Spreadsheet Editor SDK
  • **建议：**选择全部 5 个版本以获取 Enterprise Edition 密钥
  • 点击“获取许可证密钥”

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

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