许可
概述
许可证格式
许可证以 JSON Web 令牌 (JWT) 格式生成,并下载到“License.lic”等文件中。
JWT 许可证包含三个部分: Header.Payload.VerifySignature
有关 JWT 格式的更多详细信息,请参阅https://jwt.io/introduction/ 。
许可证的 Payload 部分包含的字段值包括:
- 许可证类型 - 评估/商业/企业
- 到期日
- 应用ID
- SDK 支持的功能
许可证以文本字符串的形式提供,与本例类似:
JWT 许可证示例:
eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJMTVMiLCJleHAiOjE1MjUxMzI3OTksImlhdCI6MTUyMjMzMzkwNCwicmlnaHRzIjpbIkJBWFRFUl9BQ0NFU1MiLCJDRExfQUNDRVNTIiwiQ0RMX0xJVkVfU1RSRUFNSU5HIiwiQ0RMX1RISVJEUEFSVFlfUEVOUyIsIkNETF9QSFVfMTExIiwiU0lHX1NES19DT1JFIiwiU0lHQ0FQVFhfQUNDRVNTIl0sImRldmljZXMiOltdLCJ0eXBlIjoiZXZhbCIsImxpY19uYW1lIjoiV2Fjb20gRGVtbyBTYW1wbGUiLCJ3YWNvbV9pZCI6bnVsbCwibGljX3VpZCI6IjVjNGM2MmUyLTRiYzUtNGQ2My1hOWY5LTNkZGI4NzZlNTg3NyIsImFwcHNfd2luZG93cyI6W10sImFwcHNfaW9zIjpbXSwiYXBwc19hbmRyb2lkIjpbXSwibWFjaGluZV9pZHMiOltdfQ.iq4w04_Ip5wRobYGvmxHmIrq2KvoE13U8uDjkcncnHVbrENLnQKGVZGueDCfwMtlwhfAZ83u5W7S9wBIkA25xHfxrp969GI0C8PfaQfyGrgbAp4K1WonXdcIF6PU7A5SCjx6PhylUjEw-8SCp7K4Qe14r019ZxD7_dQUlKTjB2mYcrxoZelZ6oRFyPVgAzHZ0VaYcicPtWUGUFSqspos08B_5XjHmrqMAGBgoWeIDwCDKNuKKKRxWinXGYz3kUm8aiC66jlk-B9W8D587jEJ0nPG_bY3k0FCoViU3F5qNRTrRbXfmPnjjsrQfCygKJx1bJwWkJfs3jnT2gP0K-i9oQ
JWT 查看器可用于显示许可证字符串的内容,例如:
{
"iss": "461c26c04e0d4b4289523b470d6b52a1",
"exp": 1564531200,
"iat": 1534514357,
"rights": [
"CDL_PHU_111"
],
"devices": [],
"type": "production",
"lic_name": "enterpriseGenerated",
"wacom_id": "bc5c1c740c594c6ea9c6e414fbe2edb2",
"lic_uid": "435dc411-f08f-4b81-9ac6-779c8d1569a7",
"apps_windows": [
"WIN-APP-ID"
],
"apps_ios": [],
"apps_android": [],
"machine_ids": []
}
由于数据经过数字签名,因此可以查看但不能更改许可证内容。
APP ID
大多数许可证都需要一个应用程序 ID (App ID),在 LMS 上生成许可证或向 Wacom 销售部门申请许可证时都需要该ID。
APP ID 用于在线发布应用程序(例如 Apple Store 或 Google Play)。
相同的 ID 用于生成应用程序许可证。例如:
com.health.mycompany.registration
评估许可证不需要 App ID。
在应用程序的源代码中查找 App Id:
平台 | 应用编号 |
---|---|
Windows Classic | 此平台中不存在应用程序 ID,因此即使是生产也没有检查 |
Windows UWP | 应用程序 ID 应与 Windows.ApplicationModel.Package.Current.Id.Name 匹配 |
iOS | 应用程序 ID 应匹配“Bundle Identifier”,例如显示在:Xcode->Project->General->Identity |
Android | 应用程序 ID 应与 build.gradle 文件中的 android.defaultConfig.applicationId 相匹配。 |
许可证安装
许可证安装方法取决于应用程序。
通常许可证字符串会被复制到应用程序代码中,例如:
try {
InputStream license = assetManager.open("license.lic");
LicenseBootstrap.initLicense(this.getApplicationContext(), LicenseBootstrap.readFully(license));
}
为了处理许可证升级和到期日期问题,我们建议动态设置许可证,而不是在应用程序中进行硬编码。例如,在运行时从文件中读取 JWT 许可证字符串。
许可证到期
许可证因以下原因之一而过期失效:
- 超过评估有效期
- 超过许可证有效期
当许可证过期时,相关的 SDK 功能将停止运行,而是返回一个许可证错误代码。应用程序必须处理该错误条件。
此规则的一个例外是用于签名的 Wacom Ink SDK:
- 过期的生产许可证:当许可证过期后,SDK 仍保持完整功能,但签名将显示带有“评估”水印。
- 过期的评估许可证:当许可证过期后,签名捕获将返回错误。
使用许可证管理系统 (LMS)
目前仅限于评估许可证的管理。请注意,已知许可证生成和下载过程在使用 Edge 时会出现问题,因此最好使用其他浏览器。
- 打开开发人员仪表板。要打开该页面,您需要使用您的 Wacom ID 登录。
- 选择许可证以显示管理许可证密钥页面
- 点击<新评估许可证>:
•您现在可以为所需产品选择<Generate Evaluation License> :
- 消息框指示已创建许可证:
- 选择许可证以返回到“管理许可证密钥”页面。许可证密钥现在可供下载:
- 单击下载图标下载许可证。默认情况下,许可证将保存到名为“license.txt”的文件中。
您可以随时单击“更新许可证”链接,然后下载具有修改过期日期的新许可证:
要安装许可证,请按照相关 SDK 示例代码入门指南中提供的说明进行操作。
SDK 示例代码在 GitHub 中提供并在此处列出:GitHub 欢迎页面
如何获得生产许可证
Wacom Ink SDK for Signature for Windows(精简版)的生产许可证现已在 GitHub 上的 Signature SDK 示例中的 GETTING STARTED 文档中提供。目前,所有其他SDK生产许可证都必须向您所在地区的 Wacom 销售代表申请。如果您没有联系到 Wacom 销售代表,请在此处通知我们:
在https://developer.wacom.com中选择联系销售