

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

# Mengintegrasikan Instrumentasi Android dengan Device Farm

**catatan**  
Gunakan petunjuk berikut untuk mengintegrasikan pengujian instrumentasi Android dengan AWS Device Farm. Untuk informasi selengkapnya tentang menggunakan pengujian instrumentasi di Device Farm, lihat[Instrumentasi untuk Android dan AWS Device Farm](test-types-android-instrumentation.md). 

## Jalankan pengujian Instrumentasi Android (konsol)
<a name="test-types-android-instrumentation-upload"></a>

Gunakan konsol Device Farm untuk mengunggah pengujian Anda.

1. Masuk ke konsol Device Farm di [ https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).

1. Di panel navigasi, pilih ** Pengujian Perangkat Sel ** uler, lalu pilih ** Proyek**.

1. Dalam daftar proyek, pilih proyek yang ingin Anda unggah pengujian.
**Tip**  
Anda dapat menggunakan bilah pencarian untuk memfilter daftar proyek berdasarkan nama.  
Untuk membuat proyek, ikuti instruksi di[Membuat proyek di AWS Device Farm](how-to-create-project.md).

1. Pilih ** Buat lari**.

1. Di bawah ** Pilih aplikasi dan jenis jalankan**, di ** bagian ** Jalankan jenis, pilih aplikasi ** Android**.

1. Di bawah ** Pilih aplikasi**, di ** bagian Opsi pemilihan ** aplikasi, pilih ** Pilih contoh aplikasi yang disediakan oleh Dev ** ice Farm jika Anda tidak memiliki aplikasi. Jika Anda membawa aplikasi sendiri, pilih ** Unggah aplikasi sendiri**, lalu pilih APK Anda (format file.apk).

1. Di bawah ** Konfigurasi pengujian**, di ** bagian ** Pilih kerangka pengujian, pilih ** Instrumentasi**, lalu pilih ** Pilih File**. Jelajahi dan pilih file APK (format file.apk) yang berisi pengujian Anda.

1. Di bawah ** Pilih lingkungan eksekusi Anda**, pilih ** Jalankan pengujian Anda di lingkungan khusus ** atau J ** alankan pengujian Anda di lingkungan standar kami**. Untuk informasi selengkapnya, lihat [Menguji lingkungan di AWS Device Farm](test-environments.md).

1. Jika Anda memilih lingkungan khusus, Anda dapat menggunakan spesifikasi pengujian default yang diisi untuk pengujian instrumentasi, atau pilih ** Unggah spesifikasi pengujian sendiri ** untuk menyediakan spesifikasi pengujian Anda sendiri.

1. Di bawah ** Pilih perangkat**, pilih metode pemilihan perangkat. Pilih ** Gunakan Kumpulan Perangkat ** untuk memilih dari koleksi perangkat yang dikuratori atau kumpulan perangkat khusus yang Anda buat. Pilih Pilih perangkat ** secara manual ** untuk memilih perangkat individual untuk menjalankan pengujian Anda. **Bagian Kompatibilitas ** perangkat menunjukkan berapa banyak perangkat di kumpulan yang dipilih yang kompatibel dengan aplikasi Anda. Untuk informasi selengkapnya, lihat [Dukungan perangkat di AWS Device Farm](devices.md).

1. Untuk mengkonfigurasi properti run-level, perbarui bagian J ** alankan pengaturan**. Di sini Anda dapat melakukan hal berikut:

   1. (Opsional) Agar Device Farm membuat laporan pengujian setelah proses selesai, pilih ** Buat laporan pengujian**. Opsi ini hanya tersedia di lingkungan pengujian khusus. Device Farm menghasilkan laporan dari hasil instrumentasi yang disertakan dalam output spesifikasi pengujian Anda. Jika Anda mengunggah spesifikasi pengujian Anda sendiri, pastikan itu mengeluarkan hasil instrumentasi ke output spesifikasi pengujian Anda.

1. Selesaikan langkah-langkah yang tersisa, lalu mulai jalankan.

## Melihat laporan pengujian (konsol)
<a name="test-types-android-instrumentation-view-insights-console"></a>

1. Masuk ke konsol Device Farm di [ https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).

1. Di panel navigasi, pilih ** Pengujian Perangkat Sel ** uler, lalu pilih ** Proyek**.

1. Pilih proyek yang berisi proses yang ingin Anda periksa.

1. Pilih proses yang telah selesai untuk membuka detailnya.

1. Pilih salah satu pekerjaan yang telah selesai untuk membuka hasil untuk perangkat tersebut.

### Dengan wawasan pengujian diaktifkan
<a name="test-types-android-instrumentation-view-insights-console-with"></a>

Hasil pekerjaan termasuk ** tab ** Laporan uji. Pilih untuk melihat rincian per tes. Screenshot berikut menunjukkan ** tab Laporan ** uji dengan semua kolom terlihat.

![Kumpulan kolom pertama pada tab Laporan uji untuk pekerjaan instrumentasi yang selesai.](https://docs.aws.amazon.com/id_id/devicefarm/latest/developerguide/images/aws-device-farm-test-insights/console-instrumentation-insights-enabled-test-report-column-start.png)


![Kolom yang tersisa pada tab Laporan uji untuk pekerjaan instrumentasi yang telah selesai.](https://docs.aws.amazon.com/id_id/devicefarm/latest/developerguide/images/aws-device-farm-test-insights/console-instrumentation-insights-enabled-test-report-column-end.png)


Tab menunjukkan bidang berikut untuk setiap tes:

`testName`  
Nama metode pengujian.

`testClass`  
Nama kelas tes.

`result`  
Hasil Device Farm untuk pengujian.

`frameworkResult`  
Hasil yang dilaporkan oleh kerangka instrumentasi. Device Farm memetakan nilai ini ke `result` bidang yang dinormalisasi.

`durationSeconds`  
Durasi tes, dalam hitungan detik.

`startTimestamp`  
Waktu ketika tes dimulai.

`endTimestamp`  
Waktu ketika tes berakhir.

`current`  
Posisi tes dalam lari.

`numTests`  
Jumlah total tes yang sedang dijalankan.

`statusCode`  
Kode status instrumentasi yang dilaporkan pengujian.

`stream`  
Versi output instrumentasi yang dapat dibaca manusia untuk pengujian.

`stackTrace`  
Untuk pengujian yang gagal, tumpukan jejak kegagalan.

Untuk mengunduh laporan pengujian lengkap sebagai file JSON, pilih ** Unduh ringkasan lengkap ** di bagian atas detail pekerjaan.

Untuk memilih kolom mana yang muncul, pilih ikon roda gigi. Dalam pengaturan, Anda dapat memilih kolom untuk ditampilkan dan mengaktifkan atau menonaktifkan ** Grup ** berdasarkan kelas. **Kelompokkan ** berdasarkan kelas aktif secara default, yang mengelompokkan tes berdasarkan kelas pengujian mereka. Matikan untuk melihat daftar datar semua tes, seperti yang ditunjukkan pada tangkapan layar berikut.

![Tab Laporan uji dengan Grup berdasarkan kelas dimatikan, menampilkan daftar pengujian datar.](https://docs.aws.amazon.com/id_id/devicefarm/latest/developerguide/images/aws-device-farm-test-insights/console-instrumentation-insights-enabled-test-report-without-grouping.png)


### Tanpa wawasan pengujian diaktifkan
<a name="test-types-android-instrumentation-view-insights-console-without"></a>

Hasil pekerjaan menunjukkan output pengujian standar dan artefak, tetapi tidak ada ** tab Laporan ** pengujian. Untuk membuat laporan pengujian, jadwalkan proses baru dengan wawasan pengujian diaktifkan.

![Hasil pekerjaan untuk pekerjaan instrumentasi yang diselesaikan tanpa wawasan pengujian diaktifkan.](https://docs.aws.amazon.com/id_id/devicefarm/latest/developerguide/images/aws-device-farm-test-insights/console-instrumentation-insights-disabled-test-report.png)


## Lihat laporan pengujian (AWS CLI)
<a name="test-types-android-instrumentation-view-insights-cli"></a>

Jalan **get-job** kan dan tentukan pekerjaan ARN:

```
aws devicefarm get-job --arn {{arn:aws:devicefarm:us-west-2:123456789012:job:PROJECT_ID/RUN_ID/00000}}
```

### Tanpa wawasan pengujian diaktifkan
<a name="test-types-android-instrumentation-view-insights-cli-without"></a>

Jika Anda tidak mengaktifkan wawasan pengujian, respons berisi bidang pekerjaan standar, seperti status pekerjaan, hasil, penghitung, dan perangkat:

```
{
    "job": {
        "arn": "arn:aws:devicefarm:us-west-2:123456789012:job:EXAMPLE-PROJECT/EXAMPLE-RUN/00000",
        "name": "Example Android Phone",
        "created": "2026-08-05T14:26:56.959000-07:00",
        "status": "COMPLETED",
        "result": "PASSED",
        "counters": {
            "total": 3,
            "passed": 3,
            "failed": 0,
            "warned": 0,
            "errored": 0,
            "stopped": 0,
            "skipped": 0
        },
        "message": "Successful test lifecycle of Setup Test",
        "device": {
            "arn": "arn:aws:devicefarm:us-west-2::device:EXAMPLEDEVICEID",
            "name": "Example Android Phone",
            "platform": "ANDROID",
            "os": "16",
            "formFactor": "PHONE",
            "fleetType": "PUBLIC"
        },
        "deviceMinutes": {
            "total": 1.38,
            "metered": 0.0,
            "unmetered": 1.13
        },
        "videoCapture": true
    }
}
```

### Dengan wawasan pengujian diaktifkan
<a name="test-types-android-instrumentation-view-insights-cli-with"></a>

Jika Anda mengaktifkan wawasan pengujian, respons juga menyertakan `insights` objek. Objek ini berisi status laporan pengujian, metrik tingkat tinggi, dan URL yang telah ditandatangani sebelumnya ke laporan terperinci:

```
{
    "job": {
        "arn": "arn:aws:devicefarm:us-west-2:123456789012:job:EXAMPLE-PROJECT/EXAMPLE-RUN/00000",
        "status": "COMPLETED",
        "result": "PASSED",
        "counters": { ... },
        "device": { ... },
        "deviceMinutes": { ... },
        "videoCapture": true,
        "insights": {
            "status": "COMPLETED",
            "testReport": {
                "message": "Results: 2 Executed | 2 passed, Median test duration: 28.926 seconds.",
                "metrics": {
                    "testsTotal": 2,
                    "testsPassed": 2,
                    "testsFailed": 0,
                    "testsSkipped": 0,
                    "testsErrored": 0,
                    "testsOther": 0,
                    "testsPassedPercentage": 100.0
                },
                "testDetailsUrl": "https://EXAMPLE-PRESIGNED-URL"
            }
        }
    }
}
```

`testDetailsUrl`Bidang ini adalah URL yang telah ditandatangani sebelumnya ke laporan pengujian lengkap JSON. Unduh untuk mendapatkan rincian per tes:

```
curl -o test-report.json "{{PRESIGNED_URL}}"
```

Berikut ini adalah contoh laporan pengujian untuk pekerjaan instrumentasi:

```
{
  "version": "1.0",
  "jobArn": "arn:aws:devicefarm:us-west-2:123456789012:job:EXAMPLE-PROJECT/EXAMPLE-RUN/00000",
  "metrics": {
    "testsTotal": 3,
    "testsPassed": 2,
    "testsFailed": 1,
    "testsSkipped": 0,
    "testsErrored": 0,
    "testsOther": 0,
    "testsPassedPercentage": 66.67,
    "totalTestExecutionDurationSeconds": 26.004,
    "medianTestExecutionDurationSeconds": 1.598
  },
  "testDetails": [
    {
      "testName": "testConnect",
      "testClass": "com.example.myapp.GpsConnectInstrumentedTest",
      "frameworkResult": "PASSED",
      "result": "PASSED",
      "durationSeconds": 24.399,
      "startTimestamp": "2026-08-05T20:38:30.131514Z",
      "endTimestamp": "2026-08-05T20:38:54.530369Z",
      "statusCode": 0,
      "current": 1,
      "numTests": 3
    },
    {
      "testName": "testHistoryOff",
      "testClass": "com.example.myapp.NotificationHistoryInstrumentedTest",
      "frameworkResult": "PASSED",
      "result": "PASSED",
      "durationSeconds": 1.598,
      "startTimestamp": "2026-08-05T20:38:54.531765Z",
      "endTimestamp": "2026-08-05T20:38:56.130032Z",
      "statusCode": 0,
      "current": 2,
      "numTests": 3
    },
    {
      "testName": "testConnect",
      "testClass": "com.example.myapp.WifiConnectInstrumentedTest",
      "frameworkResult": "FAILED",
      "result": "FAILED",
      "durationSeconds": 0.002,
      "startTimestamp": "2026-08-05T20:38:56.131857Z",
      "endTimestamp": "2026-08-05T20:38:56.133770Z",
      "stackTrace": "java.lang.NullPointerException: Attempt to invoke virtual method 'boolean androidx.test.uiautomator.UiDevice.pressHome()' on a null object reference\n\tat com.example.myapp.WifiConnectInstrumentedTest.testConnect(WifiConnectInstrumentedTest.java:93)\n\t...",
      "stream": "\nError in testConnect(com.example.myapp.WifiConnectInstrumentedTest):\njava.lang.NullPointerException: Attempt to invoke virtual method 'boolean androidx.test.uiautomator.UiDevice.pressHome()' on a null object reference\n\t...",
      "statusCode": -2,
      "current": 3,
      "numTests": 3
    }
  ],
  "errorMessage": "There was 1 failure:\n1) testConnect(com.example.myapp.WifiConnectInstrumentedTest)\njava.lang.NullPointerException: Attempt to invoke virtual method 'boolean androidx.test.uiautomator.UiDevice.pressHome()' on a null object reference\n\t...\nFAILURES!!!\nTests run: 3,  Failures: 1",
  "instrumentationCode": -1
}
```

Laporan berisi bidang tingkat atas berikut:

`version`  
Versi skema laporan.

`jobArn`  
ARN pekerjaan itu.

`metrics`  
Hasil agregat untuk pekerjaan tersebut. Objek `metrics` berisi kolom-kolom berikut:    
`testsTotal`  
Jumlah total tes dalam pekerjaan.  
`testsPassed`  
Jumlah tes yang lulus.  
`testsFailed`  
Jumlah tes yang gagal.  
`testsSkipped`  
Jumlah tes yang dilewati.  
`testsErrored`  
Jumlah tes yang salah.  
`testsOther`  
Jumlah tes dengan hasil lain.  
`testsPassedPercentage`  
Persentase tes yang lulus.  
`totalTestExecutionDurationSeconds`  
Total durasi semua tes, dalam hitungan detik.  
`medianTestExecutionDurationSeconds`  
Durasi rata-rata tes, dalam detik.

`errorMessage`  
Jika proses mengalami kegagalan, pesan kesalahan yang merangkumnya.

`instrumentationCode`  
Kode keluar instrumentasi keseluruhan untuk pekerjaan tersebut.

`testDetails`  
Daftar hasil per tes. Setiap entri `testDetails` berisi bidang berikut:    
`testName`  
Nama metode pengujian.  
`testClass`  
Nama kelas tes.  
`result`  
Hasil Device Farm untuk pengujian.  
`frameworkResult`  
Hasil yang dilaporkan oleh kerangka instrumentasi. Device Farm memetakan nilai ini ke `result` bidang yang dinormalisasi.  
`durationSeconds`  
Durasi tes, dalam hitungan detik.  
`startTimestamp`  
Waktu ketika tes dimulai.  
`endTimestamp`  
Waktu ketika tes berakhir.  
`current`  
Posisi tes dalam lari.  
`numTests`  
Jumlah total tes yang sedang dijalankan.  
`statusCode`  
Kode status instrumentasi yang dilaporkan pengujian.  
`stream`  
Versi output instrumentasi yang dapat dibaca manusia untuk pengujian.  
`stackTrace`  
Untuk pengujian yang gagal, tumpukan jejak kegagalan.

## (Opsional) Ambil tangkapan layar dalam tes instrumentasi Android
<a name="test-types-android-instrumentation-screenshots"></a>

Anda dapat mengambil tangkapan layar sebagai bagian dari tes Instrumentasi Android Anda.

Untuk mengambil tangkapan layar, panggil salah satu metode berikut:
+ Untuk Robotium, panggil `takeScreenShot` metode (misalnya,`solo.takeScreenShot();`).
+ Untuk Spoon, panggil `screenshot` metode, misalnya:

  ```
  Spoon.screenshot(activity, "initial_state");
  /* Normal test code... */
  Spoon.screenshot(activity, "after_login");
  ```

Selama uji coba, Device Farm mendapatkan tangkapan layar dari lokasi berikut di perangkat, jika ada, dan kemudian menambahkannya ke laporan pengujian:
+ `/sdcard/robotium-screenshots`
+ `/sdcard/test-screenshots`
+ `/sdcard/Download/spoon-screenshots/{{test-class-name}}/{{test-method-name}}`
+ `/data/data/{{application-package-name}}/app_spoon-screenshots/{{test-class-name}}/{{test-method-name}}`