福昕开发者文档中心

试用与授权 ​

试用评估 ​

开发者可通过 福昕开发中心 申请试用或获取下载指引，下载 福昕 PDF SDK (Web) 版试用版本进行评估；亦可联系福昕技术支持团队与销售代表。试用版的核心能力与正式授权版保持一致，但通常存在以下限制：

  • 试用期为 30 天。
  • 生成、保存或导出的 PDF 文件可能带有试用水印。

试用期结束后，如果您希望继续在项目中使用福昕 PDF SDK (Web) 版，请联系福昕销售团队购买正式授权。

注意

未经福昕软件公司授权，用户不得将福昕 PDF SDK 包中的任何文档、示例代码或源代码分发给第三方机构。

配置授权信息 ​

在 Web 场景中，您只需在创建 PDFViewCtrl.PDFViewer 或 UIExtension.PDFUI 实例时，通过 jr 配置项传入有效的授权信息即可。

试用包或正式授权包中的授权信息通常位于 examples/license-key.js 文件中，包含以下两个字段：

  • licenseSN
  • licenseKey

您也可以根据项目部署方式，将这两个值放入单独的配置文件、环境变量或构建脚本中，再在页面加载时注入。

使用 PDFViewCtrl 配置授权 ​

html
<script src="./examples/license-key.js"></script>
<script src="./lib/PDFViewCtrl.full.js"></script>
<script>
  var pdfViewer = new PDFViewCtrl.PDFViewer({
    libPath: "./lib",
    jr: {
      licenseSN: licenseSN,
      licenseKey: licenseKey,
    },
  });

  pdfViewer.init("#pdf-viewer");
</script>

使用 UIExtension 配置授权 ​

html
<script src="./examples/license-key.js"></script>
<script src="./lib/UIExtension.full.js"></script>
<script>
  var pdfui = new UIExtension.PDFUI({
    viewerOptions: {
      libPath: "./lib",
      jr: {
        licenseSN: licenseSN,
        licenseKey: licenseKey,
      },
    },
    renderTo: "#pdf-ui",
  });
</script>

可选方式：使用保护后的前端授权 ​

为降低正式授权在前端直接暴露的风险，您可以使用 SDK 包中的 server/license-protect 工具，在服务端对正式的 licenseSN 和 licenseKey 进行加密，并生成一个供前端使用的保护授权字符串。

生成保护授权时，通常还可配置访问域白名单（hosts）以及有效期起止时间（begin / end，毫秒时间戳），以收紧前端可用范围。

生成后的保护授权可通过 jr.l 传入。使用 jr.l 时，无需再传入 jr.licenseSN 和 jr.licenseKey：

js
const pdfViewer = new PDFViewCtrl.PDFViewer({
  libPath: "./lib",
  jr: {
    l: "Protected license string",
  },
});

说明

  • 若授权信息不正确，Viewer 在加载文档或启用相关能力时可能出现授权校验失败。
  • 从 examples/license-key.js 读取授权信息适合本地试用和快速验证；正式项目建议通过受控配置方式注入，避免将正式授权直接提交到公开仓库。
  • 若您的授权包含按模块控制的高级能力，则实际可用功能以授权内容为准。