

Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Debug dan jalankan rangkaian tes kustom
<a name="run-tests-custom"></a>

Setelah [konfigurasi yang diperlukan](set-config-custom.md) diatur, IDT dapat menjalankan rangkaian tes Anda. Waktu aktif dari rangkaian tes penuh akan tergantung pada perangkat keras dan komposisi rangkaian tes. Untuk referensi, dibutuhkan sekitar 30 menit untuk menyelesaikan rangkaian tes AWS IoT Greengrass kualifikasi lengkap pada Raspberry Pi 3B.

Ketika Anda menyusun rangkaian tes Anda, Anda dapat menggunakan IDT untuk menjalankan rangkaian tes dalam mode debug untuk memeriksa kode Anda sebelum Anda menjalankannya atau memberikannya kepada test runner.

## Jalankan IDT dalam mode debug
<a name="idt-debug-mode"></a>

Karena rangkaian tes tergantung pada IDT untuk berinteraksi dengan perangkat, menyediakan konteks, dan menerima hasil, Anda tidak bisa hanya men-debug rangkaian tes Anda di IDE tanpa berinteraksi dengan IDT. Untuk melakukannya, IDT CLI menyediakan perintah `debug-test-suite` yang memungkinkan Anda menjalankan IDT dalam mode debug. Jalankan perintah berikut untuk menampilkan opsi yang tersedia untuk `debug-test-suite`:

```
devicetester_[linux | mac | win_x86-64] debug-test-suite -h
```

Ketika Anda menjalankan IDT dalam mode debug, IDT tidak benar-benar meluncurkan rangkaian tes atau menjalankan state machine; sebaliknya, IDT berinteraksi dengan IDE Anda untuk menanggapi permintaan yang dibuat dari rangkaian tes yang berjalan di IDE dan mencetak log ke konsol. IDT tidak melakukan timeout dan menunggu untuk keluar hingga secara manual terinterupsi. Dalam mode debug, IDT juga tidak menjalankan state machine dan tidak akan menghasilkan file laporan. Untuk men-debug rangkaian tes Anda, Anda harus menggunakan IDE Anda untuk memberikan beberapa informasi yang biasanya diperoleh IDT dari file JSON konfigurasi. Pastikan Anda memberikan informasi berikut:
+ Variabel lingkungan dan argumen untuk setiap tes. IDT tidak akan membaca informasi ini dari `test.json` atau `suite.json`.
+ Argumen untuk memilih perangkat sumber daya. IDT tidak akan membaca informasi ini dari `test.json`.

Untuk men-debug rangkaian tes Anda, selesaikan langkah berikut:

1.  Buat file konfigurasi pengaturan yang diperlukan untuk menjalankan rangkaian tes. Misalnya, jika rangkaian tes Anda memerlukan `device.json`, `resource.json`, dan `user data.json`, pastikan Anda mengonfigurasi semuanya sesuai kebutuhan. 

1. Jalankan perintah berikut untuk menempatkan IDT dalam mode debug dan pilih perangkat yang diperlukan untuk menjalankan tes.

   ```
   devicetester_[linux | mac | win_x86-64] debug-test-suite [options]
   ```

   Setelah Anda menjalankan perintah ini, IDT akan menunggu permintaan dari rangkaian tes dan kemudian menanggapinya. IDT juga akan menghasilkan variabel lingkungan yang diperlukan untuk proses kasus untuk IDT Client SDK. 

1. Dalam IDE Anda, gunakan konfigurasi `run` atau `debug` untuk melakukan hal berikut:

   1. Menetapkan nilai-nilai variabel lingkungan yang dihasilkan IDT.

   1. Tetapkan nilai dari setiap variabel lingkungan atau argumen yang Anda tentukan dalam file `test.json` dan `suite.json` Anda.

   1. Menetapkan breakpoint sesuai kebutuhan.

1. Menjalankan rangkaian tes di IDE Anda. 

   Anda dapat men-debug dan kembali menjalankan rangkaain tes sebanyak mungkin yang diperlukan. IDT tidak melakukan timeout dalam mode debug.

1.  Setelah Anda menyelesaikan debugging, interupsi IDT untuk keluar dari mode debug.

## Perintah IDT CLI untuk menjalankan percobaan
<a name="idt-cli-commands"></a>

Bagian berikut menjelaskan perintah IDT CLI:

------
#### [ IDT v4.0.0 ]

`help`  <a name="idt-command-help"></a>
Mendaftar informasi tentang perintah yang ditentukan.

`list-groups`  <a name="idt-command-list-groups"></a>
Mendaftar grup dalam rangkaian tes yang diberikan.

`list-suites`  <a name="idt-command-list-suites"></a>
Mencantumkan rangkaian tes yang tersedia.

`list-supported-products`  
Daftar produk yang didukung untuk versi IDT Anda, dalam hal ini AWS IoT Greengrass versi, dan versi rangkaian pengujian AWS IoT Greengrass kualifikasi yang tersedia untuk versi IDT saat ini.

`list-test-cases`  
Mencantumkan uji kasus dalam grup uji yang diberikan. Opsi berikut didukung:  
+ `group-id`. Grup uji yang harus dicari. Opsi ini diperlukan dan harus menentukan satu grup.

`run-suite`  
Menjalankan serangkaian tes pada kolam perangkat. Berikut ini adalah beberapa opsi yang umum digunakan:  
+ `suite-id`. Versi rangkaian tes yang akan dijalankan. Jika tidak ditentukan, IDT akan menggunakan versi terbaru dalam folder `tests`.
+ `group-id`. Grup uji yang akan jalankan, sebagai daftar yang dipisahkan koma. Jika tidak ditentukan, IDT akan menjalankan semua grup uji di rangkaian tes.
+ `test-id`. Uji kasus yang akan dijalankan, sebagai daftar yang dipisahkan koma. Ketika ditentukan, `group-id` harus menentukan satu grup.
+ `pool-id`. Kolam perangkat yang akan diuji. Test runner harus menentukan kolam jika memiliki beberapa perangkat kolam yang ditentukan dalam file `device.json`.
+ `timeout-multiplier`. Mengkonfigurasi IDT untuk mengubah batas waktu eksekusi tes yang ditentukan dalam file `test.json` untuk tes dengan pengganda yang ditetapkan pengguna.
+ `stop-on-first-failure`. Mengkonfigurasi IDT untuk menghentikan eksekusi pada kegagalan pertama. Pilihan ini harus digunakan dengan `group-id` untuk men-debug grup uji yang ditentukan.
+ `userdata`. Menetapkan file yang berisi informasi data pengguna yang diperlukan untuk menjalankan rangkaian tes. Hal ini hanya diperlukan jika `userdataRequired` diatur ke BETUL di file `suite.json`untuk rangkaian uji itu.
Untuk informasi lebih lanjut tentang opsi `run-suite`, gunakan opsi `help`:  

```
devicetester_[linux | mac | win_x86-64] run-suite -h
```

`debug-test-suite`  
Jalankan rangkaian tes dalam mode debug. Untuk informasi selengkapnya, lihat [Jalankan IDT dalam mode debug](#idt-debug-mode).

------