mcpField
S
syncfusion-vue-license

syncfusion-vue-license

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

关于 syncfusion-vue-license

为使用 Syncfusion Vue 的开发者提供许可流程指导，涵盖密钥生成、注册方式和验证错误排查，并说明不同版本的许可要求。

主要功能

  1. 01区分许可证密钥与安装解锁密钥
  2. 02说明版本及平台相关的密钥要求
  3. 03介绍环境变量与 NPX 注册
  4. 04排查常见许可验证错误

适用场景

  1. 01为 Vue 应用生成适用的许可证密钥
  2. 02通过环境变量注册密钥
  3. 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.md
license-registration.md
licensing-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 版本、Document SDK、PDF Viewer SDK、DOCX Editor SDK、Spreadsheet Editor SDK
  • **推荐：**选择全部 5 个版本以获取 Enterprise Edition 密钥
  • 点击“获取许可证密钥”

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

  • 选择 30.x.x 或更早版本
  • 选择平台：Vue、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