跳到主要内容
版本：Next

3.3.4：ZPKG 如何使用

1：zpkg 是什么？​

zpkg 为 pkg （package） 文件的二次封装，在pkg 文件的基础上，封装 更多的信息 为独立的一个文件，通过此文件，开发者可以直接将 zpkg文件通过邮件或者其他途径，发送给最终用户或者烧录厂家，除打包此文件的开发者之外，其他成员将无法看到此文件的任何数据，在一定程度上可以满足特殊的需求，zpkg 支持以下特性：

  • （推介）zpkg 文件支持设置密码：包含密码信息的zpkg 加载到设备后，从设备读回工程文件需要密码验证才能打开。
  • （推介）zpkg 文件支持禁止回读：禁止回读后，将无法从设备读回工程文件。
  • （推介）zpkg 文件支持绑定到特定设备机器码：绑定机器码之后的zpkg 仅允许单次加载到特定设备，未授权的设备或重复加载均将无法完成，适用于一对一场景。
  • （按需）zpkg 文件支持绑定到设备 UUID（多个设备可以设置同一个UUID），绑定之后，仅允许UUID 一致的设备进行加载，适用于多对多场景。

zpkg 虽然在某些特殊的使用场景下有一定的用途，但是仍然存在某些局限，需要特别的注意，具体汇总如下：

警告
  • 因 密码和项目文件被整体 打包：意味着存在一定被攻击的风险，PowerWriter® 将尽可能的防止zpkg 文件被攻击而导致密码泄露，除了某些特殊的场景必须使用zpkg 格式之外，大部分通用的场景，仍然推介使用pkg 文件 + ICWorkshop 平台进行项目交付。
  • 请严格知晓以上缺陷，如不清楚，请不要使用此功能。
提示

绑定zpkg 到认证码、绑定设备UUID等模式目前仅限 PWX1 设备支持，设备购买链接请参考本页面右上角商城入口。

2：如何保存为zpkg？​

2.1：项目保存和加载​

image-20260424171628951

  1. 项目文件密码：最长为16个字符，最短可以不设置。
  2. 随机生成：点击后将会随机生成16位的强密码，并将密码复制到系统剪贴板。
  3. 密码可见图标：鼠标左键点击将可以看到密码原文，释放点击后将会隐藏，防偷窥。
  4. 项目文件路径：设置项目文件保存或者加载的路径，如果不设置，将会缓存到系统临时目录，并生成随机密码和随机文件名。
  5. 设置文件编号：给保存的文件自动附加编号到文件名的初始为止，格式如：xxxx_filename.pkg(zpkg)。
  6. （仅ZPKG项目文件格式）仅允许工程文件加载到认证设备：开启后，zpkg 工程文件使用 设备通道认证码进行绑定，或者通过设备UUID进行绑定的方式进行绑定，当工程文件加载时，必须验证通过才能加载成功。
  7. 选择ZPKG 文件的认证方式：仅允许单次下载（认证码绑定方式）和 仅允许下载到特定设备（设备标识符绑定方式）。
  8. 认证码绑定方式：通过设备通道认证码绑定，请查阅2.3 节的内容。
  9. 标识符绑定方式：通过设备标识符进行绑定，请查阅2.4 节的内容。
  10. 禁止从设备回读工程：开启后，无法通过读取功能直接从设备中回读工程文件。
警告

强烈建议给工程文件设置密码，未设置密码的工程文件，容易引发安全问题。

2.2：基础用法​

保存zpkg 文件的方法和 保存pkg 文件的方法一致，动画演示如下：

1

提示

上述演示中，导出工程文件为 zpkg（pkg 格式功能一致） ，并且设置禁止从设备回读工程选项。

2.3：机器码绑定​

绑定zpkg 到特定 PowerWriter 设备的机器码，可实现zpkg 单次下载，通过显示工程文件的编程次数，实现脱机交付能力，PowerWriter 设备支持 8个通道的机器码，如下图所示：

image-20260109135304504

  • 认证码：PowerWriter 设备的机器认证码（唯一码）,认证码只能通过更新的方式进行生成，设备将自动生成认证码。
  • 校验码：通道数据的校验信息，仅展示。
  • 状态：当前认证码是否有效，有效的认证码才可以执行复制，并绑定到zpkg 文件，无效的认证码绑定到zpkg 文件将无法加载。
  • 更新：更新当前通道的认证码。
  • 复制：复制认证码到剪贴板。

2.3.1：认证码生成​

在设备端生成认证码之前，需要连接设备到PowerWriter 应用软件，操作方式如下所示：

zpkg_1

提示

生成认证码之后，将认证码复制到剪贴板，并提供给 zpkg 的发布者，进行设备与zpkg 文件进行绑定。

2.3.2：认证码绑定​

zpkg 项目发布方，将用户提供的设备认证码与zpkg 进行绑定，操作方式如下所示：

1

提示

绑定设备认证码的zpkg 文件发回给生产方加载到设备进行生产，加载时设备只允许加载一次，加载完成后认证码将失效，无法重复加载同一个zpkg 文件。

2.3.3：设备标识符绑定(UUID)​

认证码绑定为单次有效，当设备收到指定的工程文件之后，设备端认证码则会变为无效，使用场景适用于一对一场景，而UUID 的绑定方式，则更加灵活，允许多个zpkg 工程文件，同时绑定到多个设备，只需要工程文件和对应的设备，设置相同的 UUID 即可，形成多对多的使用场景。UUID 的生成和配置方法请参考：4.1.2.4 设置(S) | PowerWriter文档中心 中关于UUID的生成和配置章节。

1

3：如何加载zpkg到Writer？​

加载zpkg 文件到烧录器的流程和加载pkg 到烧录器的流程，动画演示如下：

zpkg_1

4：补充说明​

  • 绑定认证码的 zpkg 文件，一般也需要同步设置脱机编程次数限制，否则无法达到次数控制的效果。
  • 绑定认证码的 zpkg 文件，使用工厂模式进行在线烧录时：
    • 如开启了编程次数限制，工厂模式在线编程将会被禁用，只能进行脱机下载。
    • 如未开启编程次数限制，工厂模式在线编程将会验证设备的认证码，验证失败的设备将无法进行在线编程。