Windows Hardware Lab Kit 中的新增功能

HLK 控制器服务器 OS 支持表

25H2 HLK 中的新增功能

HLKX 格式更改

自 2025 年 7 月刷新版本 24H2 HLK 起，HLKX 包架构已更新为较新版本，该版本不会是 HLK Studio 的早期版本。 打开从此版本保存的 HLKX 将失败，并显示消息文本“无法打开包”。 当由旧版本的 HLK Studio 打开时，无法打开包：（hlkx 文件名）。 此版本的 HLK 将向后兼容，能够读取、合并和添加驱动程序到从 HLK 的当前和以前版本中保存的 .HLKX 项目中。 如果使用较新的发行版本保存 HLK，则需要安装匹配或更新版本的 HLK 以读取 HLKX，请注意，HLK 安装程序仅支持安装 HLK Studio 组件，前提是不需要 HLK 控制器功能，才能读取和写入 HLKX。

提交门户将继续接受较旧版本的 HLKX，但在切换后提交的任何 HLKX 将在请求时以新格式返回驱动程序更新可接受 （DUA） HLKX shell，而在切换之前提交的 HLKX 将以以前的格式返回。 如果没有更新的 HLK，则无法打开或更新采用较新格式的 DUA HLKX shell。

基于 HLK 对象模型的工具和自动化所需的生成和部署更改

使用 HLK 对象模型的自定义工具和应用程序可能需要在生成体系结构（它生成的 .Net Framework 版本）中进行更改。

• 使用 HLK 对象模型的代码需要针对 X64 体系结构进行生成和运行。 这是目前唯一受支持的体系结构。
• .Net Framework 4.7.2 现在是围绕 HLK 对象模型库生成代码所需的最低版本

修复了 HLK 早期版本中的问题

HLK 安装/重新安装失败，并出现错误“安装”Windows 硬件实验室工具包基础结构时出错”。 24H2 7月更新发布

安装此版本的 HLK 后，重新安装 HLK 可能会被以下错误阻止：在 HLK 安装程序界面中，会显示“安装未成功完成：安装‘Windows 硬件实验室工具包基础结构’时发生错误”。 此问题是由于 HLK 安装程序中缺少检查来检测是否已安装新支持的 SQL 版本导致的。 此问题已在 HLK 的 25H2 版本中修复。 卸载 6 月版本 24H2 的 HLK 控制器，然后安装 25H2 将成功。

在 24H2年7月的版本刷新中选择目标时，HLK Studio 出现 InvalidOperationException

在 HLK Studio 中启用分布式目标选择功能会导致 HLK Studio 崩溃并出现错误：“System.InvalidOperationException：TwoWay 或 OneWayToSource 绑定无法处理只读属性”RedistributeTests”。 在某些情况下选择目标时。 此问题已在 HLK 的 25H2 版本中修复。

Wi-Fi 测试失败，因为在 24H2 版本的七月更新中缺少文件依赖项。

文件依赖项已从 HLK 测试基础结构中删除，导致多个 Wi-Fi 测试因无法调用“testnetv2.0/ccrun.exe”而回归。 25H2 HLK 中缺少的依赖项已解决。 此问题受影响的测试列表为：

• Wi-Fi Direct 基本发现测试 - 功能
• Wi-Fi Direct 基本配对测试 - 功能
• Wi-Fi 直接基本重新连接测试 - 功能性
• Wi-Fi Direct 传统配对测试 - 功能
• Wi-Fi 直接服务发现测试 - 功能性
• Wi-Fi Direct 服务配对和重新连接测试 - 功能

2025 年 7 月 24H2 HLK 刷新版的新增功能

重大更改

HLKX 格式更改

HLKX 包架构已更新为较新版本，该版本不会是 HLK Studio 的早期版本。 打开从此版本保存的 HLKX 将失败，并显示消息文本“无法打开包”。 当由旧版本的 HLK Studio 打开时，无法打开包：（hlkx 文件名）。 此版本的 HLK 将向后兼容，能够读取、合并和添加驱动程序到从 HLK 的当前和以前版本中保存的 .HLKX 项目中。 如果使用较新的发行版本保存 HLK，则需要安装匹配或更新版本的 HLK 以读取 HLKX，请注意，HLK 安装程序仅支持安装 HLK Studio 组件，前提是不需要 HLK 控制器功能，才能读取和写入 HLKX。

提交门户将继续接受较旧版本的 HLKX，但在切换后提交的任何 HLKX 将在请求时以新格式返回驱动程序更新可接受 （DUA） HLKX shell，而在切换之前提交的 HLKX 将以以前的格式返回。 如果没有更新的 HLK，则无法打开或更新采用较新格式的 DUA HLKX shell。

基于 HLK 对象模型的工具和自动化所需的构建和部署更改

使用 HLK 对象模型的自定义工具和应用程序可能需要在生成体系结构（它生成的 .Net Framework 版本）中进行更改。

• 使用 HLK 对象模型的代码需要针对 X64 体系结构进行生成和运行。 这是目前唯一受支持的体系结构。
• .Net Framework 4.7.2 现在是围绕 HLK 对象模型库生成代码所需的最低版本

SQL 2022 支持

添加了对对 HLK 控制器角色使用 Microsoft SQL Server 2022 的支持。 从此 HLK 版本开始，如果在目标系统上找不到兼容版本的 SQL，HLK 将安装Microsoft SQL Server 2022 Express。

2025 年 7 月刷新版本的 24H2 HLK 中的已知问题

HLK 安装/重新安装失败，并出现错误“安装”Windows 硬件实验室工具包基础结构时出错”。

安装此版本的 HLK 后，重新安装 HLK 可能会被以下错误阻止：在 HLK 安装程序界面中，会显示“安装未成功完成：安装‘Windows 硬件实验室工具包基础结构’时发生错误”。 此问题可能是 HLK 安装程序中缺少检查，以检测是否已安装新支持的 SQL 版本。

解决方法：卸载 HLK 控制器系统上的硬件实验室工具包后：• 右键单击 Windows 任务栏上的“开始”按钮，然后选择“设置”菜单选项以启动 Windows 设置应用。 • 在 Windows 设置应用中，选择“应用”选项，然后选择“已安装的应用”•查找项“Microsoft SQL Server 2022（64 位）并卸载它。 • 尝试再次安装硬件实验室工具包，并确认它完成且不会出现错误。

此问题已在 25H2 硬件实验室工具包中修复。

HLK Studio 在选择目标时发生 InvalidOperationException

在 HLK Studio 中启用分布式目标选择功能可能会导致 HLK Studio 崩溃，并出现错误：“System.InvalidOperationException：TwoWay 或 OneWayToSource 绑定无法在只读属性”RedistributeTests“上运行。

解决方法：如果在 HLK Studio 中出现此问题，请禁用分布式目标选择功能。

1. 在 HLK Studio 中，选择“配置”菜单选项。
2. 选择用户界面左侧的“选项”项
3. 在“分布式测试”组框下，查找“找到多个匹配目标时显示分布式目标选择对话框”复选框，然后取消选中它。
4. 确认在 HLK Studio 中选择目标时未再抛出 InvalidOperationException。

此问题已在 25H2 硬件实验室工具包中修复。

保存 HLKX 时发生错误：“SQLite 错误 10：'disk I/O error'”， “SQLite 错误 11：'database disk image is malformed'”，或“SQLite 错误 13：'disk or database is full'”

当您保存非常大的 HLKX 文件或系统驱动器没有足够的工作空间来写入 HLKX 数据时，可能会显示以下消息：“SQLite 错误 10：‘磁盘 I/O 错误’”、“SQLite 错误 11：‘数据库磁盘映像已损坏’”或“SQLite 错误 13：‘磁盘或数据库已满’”。 打开和保存 HLKX 可能会占用比 HLKX 本身大数倍的磁盘空间。 Windows 中的“磁盘清理”工具可以帮助释放系统驱动器上的空间。

在单独的系统上，上一版本的 HLK Studio 实例无法读取生成的 HLKX

打开从当前版本保存的 HLKX 文件时，如果在安装了先前版本的 HLK Studio 实例中打开，可能会显示一个对话框，内容是“无法打开包”。 2025 年 7 月刷新的 24H2 HLK 更新了 HLKX 的格式，并且与以前的版本不兼容，包括之前的 24H2 版本。 若要打开和查看从此版本生成的 HLKX，需要此版本的 HLK Studio 或更高版本才能打开它。

由于缺少文件依赖项，Wi-Fi 测试失败

文件依赖项已从 HLK 测试基础结构中删除，导致多个 Wi-Fi 测试因无法调用“testnetv2.0/ccrun.exe”而回归。 受影响的测试列表为：

• Wi-Fi Direct 基本发现测试 - 功能
• Wi-Fi Direct 基本配对测试 - 功能
• Wi-Fi 直接基本重新连接测试 - 功能性
• Wi-Fi Direct 传统配对测试 - 功能
• Wi-Fi 直接服务发现测试 - 功能性
• Wi-Fi Direct 服务配对和重新连接测试 - 功能

25H2 硬件实验室工具包中已修复此问题

先前版本中的新增功能

HLK 安装失败并出现与数据库相关的错误

卸载然后重新安装 HLK 时可能会出现此错误。 在安装 HLK 的新实例时，在安装和回滚时出现以下错误消息之一

• 数据库中已有一个名为 DSLinkType 的对象。
• 数据库 database_name 已存在。
• 无法创建 SQL 数据库。

解决方法：卸载 HLK 时，如果数据库被另一个进程锁定，则 HLK 数据库删除可能会失败。 HLK 卸载报告成功，但未卸载数据库。 若要恢复，请执行以下步骤：

1. 在提升的命令提示符处，运行 SQLCMD -E
2. 在 SQL Shell 命令行中，输入以下内容：
3. ALTER DATABASE WTTIdentity SET SINGLE_USER WITH ROLLBACK IMMEDIATE
4. DROP DATABASE WTTIdentity
5. GO
6. ALTER DATABASE HLKJobs SET SINGLE_USER WITH ROLLBACK IMMEDIATE
7. DROP DATABASE HLKJobs
8. GO
9. 确保 C:\Program Files\Microsoft SQL Server\MSSQL(sql version).MSSQLSERVER\MSSQL\DATA 不包含以 WTTIdentity 或 HLKJobs 开头的文件
10. 安装 HLK

HLK 不使用最新的安全修补程序更新现有 SQL 数据库

如果未修补现有 SQL Server 数据库，则安装 HLK 时不会使用最新安全修补程序更新数据库。

若要修补 SQL Server：选项 1：在安装 HLK 之前卸载 SQL Server。 HLK 将安装 SQL Server 和 RTM 的最新修补程序。 此时，你可以使用 Windows 更新使 SQL Server 实例保持最新。 选项 2：在安装 HLK 之前手动修补现有 SQL Server。

虚拟硬件实验室工具包 （VHLK）

1809 年新增功能！ Microsoft Virtual Hardware Lab Kit (VHLK) 是在 VHDX 上预先安装并预先配置的完整 Hardware Lab Kit，随时可以启动。 使用 VHLK 可以节省设置时间，可以快速地作为控制器启动，并且可以从虚拟机运行 Windows 硬件认证。 有关更多详细信息，请参阅 VHLK 入门指南。

• 已准备就绪，可以启动和使用
• 将 HLK 控制器作为虚拟机运行
• 在开发人员计算机上托管 HLK 控制器虚拟机，而不是专用控制器硬件

改进的播放列表支持

加载和使用播放列表的过程经过了改进和简化。 有关详细信息，请参阅入门指南中的步骤 6：选择和运行测试

支持 Arm64 桌面

HLK 测试现在可以面向 Arm64 桌面计算机，并为 HLK 客户端角色提供基于 ARM64 MSI 的安装程序。

Nano Server 测试

HLK 现在包括 Nano Server 的测试。

改进了失败的 HLK 测试的诊断

“结果”选项卡现在显示由于系统崩溃而导致的测试失败。 该选项卡还显示关联的 bug 检查的信息，以及指向帮助文档的链接，可以让用户获取进一步的信息。

有关详细信息，请参阅以下文主题：

• 步骤 7：查看测试结果和日志文件（入门指南）
• HLK Studio - “结果”选项卡
• 排除 Windows HLK 测试失败（系统崩溃）问题

导出失败的 HLK 作业

现在可以导出失败的作业，并在未安装 HLK 客户端的计算机上重新运行它。 有关详细信息，请参阅导出失败的 HLK 作业>。

对移动测试的支持

运行测试和运行状况映像的移动设备现在支持使用 HLK 进行测试。 有关详细信息，请参阅 HLK 代理客户端入门指南。

场景测试

测试级别已被开发阶段所取代，这样可以更好地配合硬件和系统的开发周期。 在引入、开发和集成、可靠性以及优化和验证过程中，将按其适用性来安排测试。

播放列表

播放列表描述了测试的集合，可以从 HLK Studio 和对象模型创建以定义自定义测试通过。

有关播放列表的详细信息，请参阅入门指南。

此外，还可以以 zip 文件的形式下载 Windows 硬件兼容性播放列表。

Windows 硬件兼容性计划

不再需要硬件认证。 相反，Windows 硬件兼容性计划是你可以参与的一个可选计划。 有关详细信息，请参阅 Windows 硬件兼容性计划。

• 兼容性播放列表 - 级别不再用于确定兼容性计划所需的测试。 若要创建兼容性计划测试通过，请下载官方的硬件兼容性计划播放列表，并将其应用于 HLK 项目。
• Windows 硬件认证博客 - 此博客提供有关 Windows 兼容性计划的最新资讯。 其中包括兼容性播放列表的更新公告。

OS 支持

Hardware Lab Kit 仅支持 Windows 10 和 Windows 11 测试。 使用硬件认证工具包来测试低级别的操作系统。

合并 .hckx 包

为了支持统一的驱动程序提交，可以使用 HLK Studio 将 HCK 和 HLK 项目中的结果合并在一起。 合并时，请先打开 HLK 项目或包，然后再合并 HCK 包。

虚拟机支持

HLK 控制器现在支持在虚拟机中安装和执行。 配置虚拟机时，请确保虚拟机满足 HLK 控制器的最低要求。

部分打包

现在可以在 HLK 项目中打包一部分测试结果，为关键场景定制打包体验。 这使你能够捕获、共享和诊断测试失败，而不必在新项目中单独运行测试。

要使用此功能，请从“测试”选项卡中选择一个或多个测试，右键单击所选内容，然后选择“创建突出显示的测试的部分包”。 请注意，此包将另存为一个部分包 (.hlkp)。 此扩展将在以后的 HLK 版本中被弃用。

为测试评分

现在可以在 HLK 中提供有关测试的反馈。 若要为测试评分，必须选择加入 CEIP。 若要为测试评分，请在“结果”窗格中右键单击所需的测试，然后选择“为此测试评分”。

“预览”窗格

文件资源管理器中的“预览”窗格提供了项目和包信息，包括名称、创建日期、目标和类型。

若要在文件资源管理器中使用“预览”窗格，请选择“视图”菜单组，然后选择“预览”窗格。 然后，可以选择任何 .hlkx 文件来查看包的详细信息。

64 位 SQL

HLK 现在仅支持 64 位 SQL 版本。 以前，HCK 仅支持 32 位 SQL 版本。

SQL 2019 支持

自21H2版本起的HLK发布版本将支持HLK控制器角色使用SQL Server 2019。 对于这些 HLK 版本，如果在目标系统上找不到兼容版本的 SQL，HLK 将安装 SQL Server 2019 Express。

Windows Server 2019 支持

21H2 或更高版本的 HLK 版本将支持将 HLK 控制器角色安装到 Windows Server 2019。 这些版本将不再支持 Windows Server 2012 R2 及更低版本。

Windows Server 2022 支持

24H2 或更高版本的 HLK 版本将支持将 HLK 控制器角色安装到 Windows Server 2022。

Windows Server 2025 支持

“Windows HLK 24H2（2025 年 1 月更新）”或更高版本的 HLK 版本将支持将 HLK 控制器角色安装到 Windows Server 2025。

ARM64 MSI 客户端安装程序支持

从 23H2 或更高版本发布的 HLK 版本将通过为 ARM64 体系结构添加 MSI 安装程序，在 AMD64 和 ARM64 之间提供统一的 HLK 客户端安装体验。 ARM64 上的安装位置和工作流程将与 AMD64 上这些版本的安装位置和工作流程一致。