Pengujian unit dengan Glance

Dengan Glance unit test API, Anda dapat menguji kode Glance tanpa mem-inflate tampilan atau memerlukan UI Automator. Misalnya, API pengujian unit memungkinkan Anda memverifikasi kondisi, seperti apakah elemen ada dalam daftar atau apakah kotak telah dicentang, menggunakan pencocok seperti hasContentDescriptionEqualTo atau isChecked.

API ini ringan dan memerlukan lebih sedikit penyiapan, sehingga Anda dapat melakukan pengembangan berbasis pengujian saat mengembangkan setiap bagian widget dan menyusunnya untuk meningkatkan penggunaan kembali kode.

Penyiapan

Dependensi yang diperlukan untuk menggunakan library pengujian unit ditampilkan dalam contoh berikut:

// Other Glance and Compose runtime dependencies.
...
testImplementation 'androidx.glance:glance-testing:1.1.1'
testImplementation 'androidx.glance:glance-appwidget-testing:1.1.1'
testImplementation 'org.robolectric:robolectric:4.11.1'
...
// You may include additional dependencies, such as Robolectric, if your test
// needs to set a LocalContext.

Struktur pengujian

Atur fungsi composable di luar class GlanceAppWidget untuk memungkinkan penggunaan kembali kode dan pengujian unit. Kurangi kompleksitas unit yang diuji sebanyak mungkin.

class MyGlanceComposableTest {
    @Test
    fun myNewsItemComposable_largeSize_hasAuthorAsSubtitle() = runGlanceAppWidgetUnitTest {
        // Prepare inputs and state
        setAppWidgetSize(100.dp, 100.dp)

        // Set the composable under test
        provideComposable {
            MyNewsItemComposable(TEST_NEWS_ITEM)
        }

        // Perform assertions
        onNode(hasTestTag("subTitle"))
            .assertHasText(TEST_NEWS_ITEM.authorName)
    }
}

Menetapkan konteks dan ukuran untuk pengujian

Jika fungsi composable Anda membaca konteks menggunakan metode LocalContext.current(), Anda harus menyetel konteks menggunakan setContext(). Jika tidak, langkah ini bersifat opsional.

Anda dapat menggunakan framework pengujian unit Android berbasis JVM apa pun, seperti Robolectric, untuk memberikan konteks.

Jika fungsi composable Anda mengakses LocalSize, tetapkan ukuran yang diinginkan untuk pengujian sebelum memberikan composable dalam pengujian. Ukuran defaultnya adalah 349.dp x 455.dp, yang setara dengan widget 5x4 yang ditampilkan di perangkat Pixel 4 dalam mode potret.

• Jika AppWidget Anda menggunakan sizeMode == Single, Anda dapat menyetelnya ke minWidth dan minHeight dalam file info.xml widget Anda.
• Jika AppWidget Anda menggunakan sizeMode == Exact, Anda dapat mengidentifikasi ukuran yang akan diuji dengan cara yang serupa dengan cara Anda menentukan ukuran untuk widget dan mengidentifikasi ukuran lanskap dan potret yang mungkin ditampilkan widget Anda dan mengujinya.
• Jika AppWidget Anda menggunakan sizeMode == Responsive, Anda dapat menyetelnya ke salah satu ukuran dari daftar yang Anda berikan saat menentukan sizeMode.

Durasi default untuk waktu tunggu pengujian adalah 1 detik, tetapi Anda dapat meneruskan durasi kustom sebagai argumen ke metode runGlanceAppWidgetUnitTest jika infrastruktur pengujian Anda menerapkan waktu tunggu yang berbeda.

Untuk mengetahui informasi dan contoh kode selengkapnya, lihat dokumentasi referensi untuk runGlanceAppWidgetUnitTest.