mcpField
S
syncfusion-angular-license

syncfusion-angular-license

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

关于 syncfusion-angular-license

面向 Syncfusion Angular 项目维护者的许可技能，说明许可证密钥生成、注册及验证错误排查。内容涵盖不同版本的许可类型、环境变量注册和离线验证要求。

主要功能

  1. 01说明许可证密钥与解锁密钥区别
  2. 02生成版本和平台对应的密钥
  3. 03通过环境变量及 NPX 注册
  4. 04介绍 CI/CD 注册方式
  5. 05排查密钥与版本验证错误
  6. 06说明试用、社区及付费许可

适用场景

  1. 01为 Angular 项目生成适用的许可证密钥
  2. 02在 CI/CD 流程注册许可证
  3. 03排查无效或版本不匹配错误
  4. 04在离线环境验证 Syncfusion 许可

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/syncfusion/angular-ui-components-skills --skill syncfusion-angular-license

安装后在 Claude Code 中输入/syncfusion-angular-license确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

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

详细介绍

Syncfusion Angular 许可

本技能将指导你了解 Syncfusion Angular 许可要求、许可证密钥生成、注册方法以及验证错误排查。

目录

许可概览

Essential JS2 平台从 2022 Volume 1 版本（v20.1.0.47）开始引入 Syncfusion 许可证密钥验证。所有通过 npm、CDN 或构建流程引用 Syncfusion 包的 Angular 应用都必须注册有效的许可证密钥，以避免出现验证警告。

许可证密钥详情

许可证密钥与解锁密钥：

  • 许可证密钥： 在应用代码中注册的字符串，用于验证 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 及更早版本（基于平台）： Angular、React、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 及更早版本）： Angular、JavaScript、React 等
  • 在 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 或更早版本
  • 选择平台：Angular、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