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

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

为测试运行器配置设置

要运行自定义测试套件，测试运行器必须根据要运行的测试套件配置其设置。设置是根据<device-tester-extract-location>/configs/文件夹中的配置文件模板指定的。如果需要，测试运行者还必须设置Amazon凭据，IDT 将使用该凭据连接到Amazon云端。

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

配置 device.json

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

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

[
    {
        "id": "<pool-id>",
        "sku": "<pool-sku>",
        "features": [
            {
                "name": "<feature-name>",             
                "value": "<feature-value>",                
                "configs": [
                    {
                        "name": "<config-name>",                    
                        "value": "<config-value>"
                    }
                ],
            }
        ],     
        "devices": [
            {
                "id": "<device-id>",    
                "pairedResource": "<device-id>", //used for no-op protocol
                "connectivity": {
                    "protocol": "ssh | uart | docker | no-op",                   
                    // ssh
                    "ip": "<ip-address>",
                    "port": <port-number>,
                    "publicKeyPath": "<public-key-path>",
                    "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文件。如果您是测试编写者，请确保将此信息提供给将运行您编写的测试套件的用户。

（可选）配置资源.json

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

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

[
    {
        "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>,
                    "publicKeyPath": "<public-key-path>",
                    "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

该config.json文件包含 IDT 的配置信息。通常，测试运行者无需修改此文件，除非提供他们的 IDTAmazon 用户凭证，也可以提供Amazon区域。如果提供了具有所需权限的Amazon证书，则Amazon IoT Device Tester收集使用情况指标并将其提交给Amazon。这是一项可选功能，用于改进 IDT 功能。有关更多信息，请参阅IDT 使用情况指标：

测试运行者可以通过以下方式配置其Amazon证书：

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

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

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