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

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

为测试运行程序配置设置

要运行自定义测试套件，测试运行程序必须根据要运行的测试套件来配置其设置。根据位于 <device-tester-extract-location>/configs/ 文件夹中的 JSON 配置文件模板指定设置。如果需要，测试运行程序还必须设置 IDT 用于连接到 AWS 云的 AWS 凭证。

作为测试编写者，您需要配置这些文件以调试您的测试套件。您必须提供测试运行程序的说明，以便它们可以根据需要配置以下设置来运行测试套件。

配置 device.json

文件包含有关运行测试的设备的信息（例如，IP 地址、登录信息、操作系统和 CPU 架构）。device.json

测试运行程序可以使用位于 device.json 文件夹中的以下模板 <device-tester-extract-location>/configs/ 文件提供此信息。

[
    {
        "id": "<pool-id>",
        "sku": "<pool-sku>",
        "features": [
            {
                "name": "<feature-name>",             
                "value": "<feature-value>",                
                "configs": [
                    {
                        "name": "<config-name>",                    
                        "value": "<config-value>"
                    }
                ],
            }
        ],     
        "devices": [
            {
                "id": "<device-id>",              
                "connectivity": {
                    "protocol": "ssh | uart | docker",                   
                    // ssh
                    "ip": "<ip-address>",
                    "port": <port-number>,
                    "auth": {
                        "method": "pki | password",
                        "credentials": {
                            "user": "<user-name>", 
                            // pki
                            "privKeyPath": "/path/to/private/key",
                                         
                            // password
                            "password": "<password>",
                        }
                    },
                    
                    // uart
                    "serialPort": "<serial-port>",
                    
                    // docker
                    "containerId": "<container-id>",
                    "containerUser": "<container-user-name>",
                }
            }
        ]
    }
]

包含值的所有字段都为必填字段，如下所述：

（可选）配置 userdata.json

文件包含测试套件所需的任何其他信息，但 userdata.json 文件中未指定这些信息。device.json此文件的格式取决于测试套件中定义的 userdata_scheme.json 文件。如果您是测试编写者，请确保向将运行您编写的测试套件的用户提供此信息。

（可选）配置 resource.json

文件包含有关将用作资源设备的任何设备的信息。resource.json资源设备是测试所测试设备的特定功能所需的设备。例如，要测试设备的蓝牙功能，您可以使用资源设备测试设备是否可以成功连接到设备。资源设备是可选的，您可以根据需要需要任意数量的资源设备。作为测试编写者，您可以使用 test.json 文件来定义测试所需的资源设备功能。然后，测试运行程序使用 resource.json 文件提供具有所需功能的资源设备池。确保您向将运行您编写的测试套件的用户提供此信息。

测试运行程序可以使用位于 resource.json 文件夹中的以下模板 <device-tester-extract-location>/configs/ 文件提供此信息。

[
    {
        "id": "<pool-id>",
        "features": [
            {
                "name": "<feature-name>",             
                "version": "<feature-value>",                
                "jobSlots": <job-slots>
            }
        ],     
        "devices": [
            {
                "id": "<device-id>",              
                "connectivity": {
                    "protocol": "ssh | uart | docker",                   
                    // ssh
                    "ip": "<ip-address>",
                    "port": <port-number>,
                    "auth": {
                        "method": "pki | password",
                        "credentials": {
                            "user": "<user-name>", 
                            // pki
                            "privKeyPath": "/path/to/private/key",
                                         
                            // password
                            "password": "<password>",
                        }
                    },
                    
                    // uart
                    "serialPort": "<serial-port>",
                    
                    // docker
                    "containerId": "<container-id>",
                    "containerUser": "<container-user-name>",
                }
            }
        ]
    }
]

包含值的所有字段都为必填字段，如下所述：

（可选）配置 config.json

文件包含 IDT 的配置信息。config.json通常，测试运行程序不需要修改此文件，除非为 IDT 和（可选）AWS 区域提供其 AWS 用户凭证。如果提供了具有所需权限的 AWS 凭证，AWS IoT Device Tester 会收集用量指标并将其提交到 AWS。这是一项选择加入的功能，用于改进 IDT 功能。有关更多信息，请参阅 IDT 用量指标.

测试运行程序可以通过以下方式之一配置其 AWS 凭证：

要为 IDT 配置 AWS 凭证，测试运行程序在位于 auth 文件夹的 config.json 文件中编辑 <device-tester-extract-location>/configs/ 部分。

{
    "log": {
        "location": "logs"
    },
    "configFiles": {
        "root": "configs",
        "device": "configs/device.json"
    },
    "testPath": "tests",
    "reportPath": "results",
    "awsRegion": "<region>",
    "auth": {
        "method": "file | environment",
        "credentials": {
            "profile": "<profile-name>"
        }
    }
}
]

包含值的所有字段都为必填字段，如下所述：