Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon IoT Greengrass Version 1在 2023 年 6 月 30 日之前，将不再接收功能更新，并且将仅收到安全补丁和错误修复。有关更多信息，请参阅Amazon IoT Greengrass V1维护时段。我们强烈建议您迁移到Amazon IoT Greengrass Version 2，这增加了重要的新功能并支持其他平台。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

教程：构建并运行示例 IDT 测试套件

这些区域有：Amazon IoT设备测试器下载包括示例测试套件的源代码。你可以完成本教程来构建和运行示例测试套件，以了解如何使用Amazon IoT适用于 的 Device TesterAmazon IoT Greengrass运行自定义测试套件。

先决条件

要完成本教程，您需要：

为 IDT 配置设备信息

为 IDT 配置设备信息以运行测试。您必须更新device.json模板位于<device-tester-extract-location>/configs包含以下信息的文件夹。

[
  {
    "id": "pool",
    "sku": "N/A",
    "devices": [
      {
        "id": "<device-id>",
        "connectivity": {
          "protocol": "ssh",
          "ip": "<ip-address>",
          "port": "<port>",
          "auth": {
            "method": "pki | password",
            "credentials": {
              "user": "<user-name>",
              "privKeyPath": "/path/to/private/key",
              "password": "<password>"
            }
          }
        }
      }
    ]
  }
]

在devices对象，请提供以下信息：

构建示例测试套件

这些区域有：<device-tester-extract-location>/samples/python文件夹中包含示例配置文件、源代码和 IDT Client SDK，您可以使用提供的构建脚本将这些文件组合到测试套件中。以下目录树显示了这些示例文件的位置：

<device-tester-extract-location>
├── ...
├── tests
├── samples
│   ├── ...
│   └── python
│       ├── configuration
│       ├── src
│       └── build-scripts
│           ├── build.sh
│           └── build.ps1
└── sdks
    ├── ...
    └── python
        └── idt_client

要构建测试套件，请在主机上运行以下命令：

Windows

cd <device-tester-extract-location>/samples/python/build-scripts
./build.ps1

Linux, macOS, or UNIX

cd <device-tester-extract-location>/samples/python/build-scripts
./build.sh

这将在IDTSampleSuitePython_1.0.0中的文件夹<device-tester-extract-location>/testsfolder。查看中的文件IDTSampleSuitePython_1.0.0文件夹以了解示例测试套件的结构方式，并查看测试用例可执行文件和测试配置 JSON 文件的各种示例。

下一步: 使用 IDT 可以运行示例测试套件那是你创造的。

使用 IDT 运行示例测试套件

要运行示例测试套件，请在主机上运行以下命令：

cd <device-tester-extract-location>/bin
./devicetester_[linux | mac | win_x86-64] run-suite --suite-id IDTSampleSuitePython

IDT 运行示例测试套件并将结果流式传输到控制台。测试结束运行后，您会看到以下信息：

========== Test Summary ==========
Execution Time:         5s
Tests Completed:        4
Tests Passed:           4
Tests Failed:           0
Tests Skipped:          0
----------------------------------
Test Groups:
    sample_group:       PASSED
----------------------------------
Path to IoT Device Tester Report: /path/to/devicetester/results/87e673c6-1226-11eb-9269-8c8590419f30/awsiotdevicetester_report.xml
Path to Test Execution Logs: /path/to/devicetester/results/87e673c6-1226-11eb-9269-8c8590419f30/logs
Path to Aggregated JUnit Report: /path/to/devicetester/results/87e673c6-1226-11eb-9269-8c8590419f30/IDTSampleSuitePython_Report.xml

问题排查

在完成教程中，请使用以下信息帮助解决所有问题。

测试用例未成功运行

如果测试未成功运行，IDT 会将错误日志流式传输到控制台，以帮助您对测试运行进行故障排除。确保您满足所有先决条件在本教程中。