Google Home Developer Console 提供了一个测试页面,您可以在其中使用 Google Home Test Suite 针对 Matter 集成配置和运行测试。Test Suite 是内置于 Developer Console 中的独立应用,可处理所有集成测试。
集成的供应商 ID 和产品 ID 的设备必须经过调试,且在 Google Home app (GHA) 中用于与 Developer Console 配合使用的帐号,才能接受测试。如需了解详情,请参阅配对 Matter 设备。
Test Suite 可以在属于特定 Matter 项目配置的一组设备上运行。请务必在集成上运行 Test Suite,以确保一切正常。
在测试页面上,已完成且可供测试的 Matter 集成会列在可供测试中。
已经过测试的 Matter 集成会列在已测试部分中。
测试计划的类型
测试计划分为两种类型:
开发测试计划用于测试使用 Matter 控制设备的情况。它们可修改,但无法提交以进行 Matter 认证。
认证测试计划专门用于 Matter 认证,不可修改。 选择此选项将创建 Matter 集成的新版本。
集成版本
当您针对认证创建测试计划时,系统会创建新版集成。从“测试”标签页开始,此编号版本会列在 Developer Console 的所有集成列表中。
绝不会基于其他编号版本创建新版本。例如,您为集成创建的第一个测试计划将为该集成创建版本 v.1。创建另一个测试计划将为该集成创建版本 v.2,但此版本并非基于 v.1。相反,此版本基于集成的无版本控制实例,与 v.1 相同。
集成的“不适用”版本表示集成的无版本控制实例,由开发标签页进行管理。
也就是说,在 Developer Console 中的 Matter > Test 上:
- 如果您针对集成的版本不适用点击测试,则系统会创建新版本。版本号将比任何现有的编号版本高 1。
- 如果不存在编号版本,则会创建版本 v.1。
- 如果存在版本 v.1,则会创建版本 v.2。如果存在版本 v.2,则创建版本 v.3,以此类推。
- 如果您点击集成的编号版本(例如 v.1)的测试,则系统不会创建新版本。而是会再次测试版本 v.1。
如需了解详情,请参阅集成版本控制。
创建测试计划
集成版本是无版本控制集成的快照。这意味着,当您为认证(进而创建集成版本)创建测试计划时,与该集成相关的所有元数据都必须是您希望用于已发布集成的信息。
在为认证创建测试计划之前,请确保您已完成以下操作:
如果您尚未针对集成完成上述所有操作,则为认证测试而创建的集成版本无法获得认证。您必须创建一个新版本,这意味着重新执行测试、现场试验和认证步骤。
如果您想在集成版本认证之前更新品牌信息,则还必须创建一个新版本并重新开始。
如需创建测试计划,请执行以下操作:
在项目列表中,点击要处理的项目旁边的打开。
在页面左侧的导航菜单中,前往 Matter > Test。
对于您要测试的集成的版本不适用,请点击测试。此操作会创建新的集成版本。
选择“开发测试”或“认证测试”作为测试类型。
- 如果您正在准备在 Google 生态系统中进行认证,请选择认证测试。
- 开发测试不能用于认证。
点击测试。如果您看到 No device found 错误屏幕,则表示此集成的设备尚未调试到该生态系统。如需了解详情,请参阅排查配对问题。
在 Configure your test 屏幕上,为测试提供一个名称,并从设备列表中选择要测试的设备。
点击 Next: Test plan 按钮。
在创建测试计划页面的测试套件部分中,选择要运行的测试套件。
如果您想退出 Test Suite,请点击 返回开发者中心。
运行测试方案
在 Test Suite 的创建测试计划页面中,点击运行测试。系统随即会显示测试环境页面,其中包含所有测试的状态和日志。
测试完成后,测试结果即会显示。每个测试套件执行作业的旁边都会显示其状态(“通过”“失败”)。
日志窗格会显示每个测试作业的状态。
如需在测试环境页面中重新测试测试计划,请在测试执行完成后点击顶部的
重新测试。完成后:
- 点击完成以转到测试记录页面,或
- 点击 Submit(提交)提交测试结果以供认证。
查看和解读测试结果
在 Test Suite 的测试历史记录页面上,您可以查看开发方案或未提交的认证测试计划的既往测试结果,方法是在测试计划部分中点击所需测试计划的重新测试。您会进入测试环境页面,其中会显示该测试的结果。
对于已提交的认证方案,请点击已保存供认证使用部分中的结果,以查看测试结果报告。
您还可以通过 Developer Console 中的测试标签页查看集成版本的测试结果。点击该页面上所列任何集成版本的测试记录的查看,以转到 Test Suite 中的测试历史记录页面。
控制台状态
在测试阶段,会出现以下控制台状态:
Section | 状态 | 说明 | 要求 | 可采取的措施 |
---|---|---|---|---|
可供测试 | 准备就绪 | 此版本的 integration 现已可供测试。 | 不适用 | 测试此版本的 integration。 |
已验证 | 准备就绪 | 此版本的 integration 已经过测试,可以提交进行现场试验或认证。 |
版本已经过测试并保存。 所有失败的测试用例都包含 Google 进行审核的理由。 |
如果需要,请重新测试。 |
问题排查
测试套件中未显示调试的设备
如果您已将设备与测试供应商 ID (VID) 和产品 ID (PID) 配对,但当您尝试在 Developer Console 中使用测试套件测试设备时,它未显示,这可能是由于跨多个集成使用相同的测试 VID 和 PID 组合而导致的。
如需排查问题,请从 Developer Console 中移除所有测试设备,并配对您想要重新测试的设备。
如需验证您已配对正确的设备,您可以将设备的制造商和型号信息(CHIP_DEVICE_CONFIG_DEVICE_*
值)设置为测试固件中的唯一值。
如需了解详情,请参阅设备信息。
验证设备的 VID/PID
如果您想开始开发与 Google 的集成,则必须在 Google Home 控制台上创建项目和集成。
您的设备用于信标的 VID/PID 值应与在 Developer Console 项目中输入的 VID/PID 一致。
使用蓝牙工程应用(如 nRF Connect for Mobile),您可以在 Service Data 字段中查看信标设备的 VID/PID。
在 Android 版 nRF Connect 的屏幕截图中,您会看到从 Service Data 字段的第四个字节开始,VID/PID 被列为 5A23FFFE
。这表示 VID 为 5A23
,PID 为 FFFE
,二者均采用小端字节序格式。
BLE 应用以小端字节序显示值,但您输入 Developer Console 项目的 VID/PID 值则采用大端字节序。
根据蓝牙嗅探器显示的内容,验证是否已在您的 Actions 控制台项目中输入正确的值和格式。
对于示例屏幕截图中的值,Developer Console 中的 VID 和 PID 分别为 235A
和 FEFF
。