用途:整理 Syncfusion 从 16.2.0.x 起引入的许可机制,说明许可证密钥的生成、注册与故障排查流程,覆盖 WPF、Blazor、React、Angular、Vue、MAUI、ASP.NET Core 等平台。
主要能力:区分许可证密钥与解锁密钥;说明何时必须注册(nuget.org 的 NuGet 包与试用安装器需要,已授权安装器随附的程序集不需要);按平台给出注册代码位置,如 WPF 在 App.xaml.cs 构造函数、Blazor 在 Program.cs、前端框架在入口调用 registerLicense();提供“未注册”“密钥无效”“试用过期”“平台不匹配”“版本不匹配”“无法加载 Syncfusion.Licensing.dll”等错误的排查方向。
必要用法:先按版本与平台在账户的 License & Downloads 或 Trial & Downloads 生成密钥,再在初始化任何组件之前调用 SyncfusionLicenseProvider.RegisterLicense(licenseKey) 或 registerLicense(licenseKey);密钥需与所用包版本和平台一致;校验为离线进行,运行时不需联网;CI/CD 可用 ValidateLicense() 等方法做程序化校验,避免在流水线下载或执行未经验证的外部二进制。
适用场景与限制:适用于试用、已授权、NuGet 用户、构建服务器与从试用升级到授权的场景。许可证密钥是机密,不应硬编码,应使用环境变量或配置系统存储,并将含密钥的文件加入 .gitignore;密钥按版本和平台特定,不同版本或平台需分别生成。
其他细节(如具体价格、更多平台支持范围)暂未提供。