Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfigurieren von Einstellungen für Test Runner

Um benutzerdefinierte Testsuiten auszuführen, müssen Test Runner ihre Einstellungen basierend auf der Testsuite konfigurieren, die sie ausführen möchten. Die Einstellungen werden basierend auf Konfigurationsdateivorlagen im <device-tester-extract-location>/configs/ Ordner angegeben. Falls erforderlich, müssen Test Runner auch AWS Anmeldeinformationen einrichten, die IDT für die Verbindung mit der AWS Cloud verwendet.

Als Test-Writer müssen Sie diese Dateien konfigurieren, um Ihre Testsuite zu debuggen. Sie müssen Anweisungen zum Testen von Runnern bereitstellen, damit diese die folgenden Einstellungen nach Bedarf konfigurieren können, um Ihre Testsuiten auszuführen.

Konfigurieren von device.json

Die device.json Datei enthält Informationen zu den Geräten, auf denen Tests ausgeführt werden (z. B. IP-Adresse, Anmeldeinformationen, Betriebssystem und CPU-Architektur).

Test Runner können diese Informationen mithilfe der folgenden device.json Vorlagendatei bereitstellen, die sich im <device-tester-extract-location>/configs/ Ordner befindet.

[
    {
        "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>",
                }
            }
        ]
    }
]

Nachfolgend sind alle Pflichtfelder beschrieben:

(Optional) Konfigurieren von userdata.json

Die userdata.json Datei enthält alle zusätzlichen Informationen, die von einer Testsuite benötigt werden, aber nicht in der device.json Datei angegeben sind. Das Format dieser Datei hängt von der userdata_scheme.json Datei ab, die in der Testsuite definiert ist. Wenn Sie ein Test-Writer sind, stellen Sie sicher, dass Sie diese Informationen Benutzern bereitstellen, die die von Ihnen geschriebenen Testsuiten ausführen.

(Optional) Konfigurieren von resource.json

Die resource.json Datei enthält Informationen zu allen Geräten, die als Ressourcengeräte verwendet werden. Ressourcengeräte sind Geräte, die erforderlich sind, um bestimmte Funktionen eines getesteten Geräts zu testen. Um beispielsweise die Bluetooth-Fähigkeit eines Geräts zu testen, können Sie ein Ressourcengerät verwenden, um zu testen, ob Ihr Gerät erfolgreich eine Verbindung herstellen kann. Ressourcengeräte sind optional und Sie können so viele Ressourcengeräte benötigen, wie Sie benötigen. Als Test-Writer verwenden Sie die Datei test.json, um die Features des Ressourcengeräts zu definieren, die für einen Test erforderlich sind. Test-Runner verwenden dann die -resource.jsonDatei, um einen Pool von Ressourcengeräten bereitzustellen, die über die erforderlichen Funktionen verfügen. Stellen Sie sicher, dass Sie diese Informationen Benutzern bereitstellen, die die von Ihnen geschriebenen Testsuiten ausführen.

Test Runner können diese Informationen mithilfe der folgenden resource.json Vorlagendatei bereitstellen, die sich im <device-tester-extract-location>/configs/ Ordner befindet.

[
    {
        "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>",
                }
            }
        ]
    }
]

Nachfolgend sind alle Pflichtfelder beschrieben:

(Optional) Konfigurieren von config.json

Die config.json Datei enthält Konfigurationsinformationen für IDT. In der Regel müssen Test-Runner diese Datei nicht ändern, es sei denn, sie geben ihre AWS Benutzeranmeldeinformationen für IDT und optional für eine -AWSRegion an. Wenn AWS Anmeldeinformationen mit den erforderlichen Berechtigungen bereitgestellt werden, werden Nutzungsmetriken AWS IoT Device Tester erfasst und an übermitteltAWS. Dies ist eine Opt-In-Funktion und wird zur Verbesserung der IDT-Funktionalität verwendet. Weitere Informationen finden Sie unter IDT-Nutzungsmetriken.

Test Runner können ihre AWS Anmeldeinformationen auf eine der folgenden Arten konfigurieren:

Um AWS Anmeldeinformationen für IDT zu konfigurieren, bearbeiten Test-Runner den -authAbschnitt in der config.json Datei im <device-tester-extract-location>/configs/ Ordner .

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

Nachfolgend sind alle Pflichtfelder beschrieben: