本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定測試執行程式的設定

要運行自定義測試套件，測試運行者必須根據要運行的測試套件配置其設置。設定是根據位於<device-tester-extract-location>/configs/資料夾中的組態檔案樣板來指定。如果需要，測試運行程序還必須設置 IDT 將用於連接到AWS雲的AWS憑據。

作為測試編寫者，您將需要配置這些文件來調試您的測試套件。您必須提供測試運行程序的說明，以便他們可以根據需要配置以下設置以運行測試套件。

設定 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>",              
                "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>",
                }
            }
        ]
    }
]

如下所述，包含值的所有欄位皆為必要：

(選擇性) 設定使用者資料 .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-version>",                
                "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 的組態資訊。通常，測試運行者不需要修改此文件，除非為 IDT 提供AWS用戶憑據以及可選AWS地區提供用戶憑據。如果提供具有必要權限的AWS認證，則AWS IoT Device Tester會收集使用狀況測量結果並提交給。AWS這是一項選擇加入功能，用於改善 IDT 功能。如需詳細資訊，請參閱 IDT 使用量測量結果。

測試運行者可以通過以下方式之一配置其AWS憑據：

要配置 IDT 的AWS憑據，測試運行程序編輯文件<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>"
        }
    }
}
]

如下所述，包含值的所有欄位皆為必要：