ทดสอบส่วนย่อย

หัวข้อนี้อธิบายวิธีรวม API ที่ได้จากเฟรมเวิร์กในการทดสอบ ที่ใช้ประเมินพฤติกรรมของแต่ละส่วนย่อย

Fragment จะทำหน้าที่เป็นคอนเทนเนอร์ที่ใช้ซ้ำได้ภายในแอปของคุณ ซึ่งช่วยให้คุณทำสิ่งต่อไปนี้ได้ นำเสนอเลย์เอาต์อินเทอร์เฟซผู้ใช้ชุดเดียวกันในหลายๆ กิจกรรมและ และการกำหนดค่าเลย์เอาต์ทั้งหมด เนื่องจากส่วนย่อยมีความอเนกประสงค์ จึงมีความสำคัญ เพื่อมอบประสบการณ์การใช้งานที่สม่ำเสมอและประหยัดทรัพยากร ข้อควรทราบ

  • ส่วนย่อยของคุณไม่ควรขึ้นอยู่กับกิจกรรมหลักที่เจาะจงหรือ ส่วนย่อย
  • คุณไม่ควรสร้างลำดับชั้นการดูของส่วนย่อยนอกเสียจากว่าส่วนย่อย แสดงต่อผู้ใช้

ในการช่วยกำหนดเงื่อนไขสำหรับการทดสอบเหล่านี้ AndroidX ไลบรารี fragment-testing ให้บริการ FragmentScenario เพื่อสร้างส่วนย่อยและเปลี่ยนส่วน Lifecycle.State

การประกาศทรัพยากร Dependency

หากต้องการใช้ FragmentScenario ให้กำหนดอาร์ติแฟกต์ fragment-testing-manifest ใน ไฟล์ build.gradle ของแอปที่ใช้ debugImplementation และอาร์ติแฟกต์ fragment-testing ที่ใช้ androidTestImplementation ตามที่แสดงใน ตัวอย่างต่อไปนี้

ดึงดูด

dependencies {
    def fragment_version = "1.8.3"

    debugImplementation "androidx.fragment:fragment-testing-manifest:$fragment_version"

    androidTestImplementation "androidx.fragment:fragment-testing:$fragment_version"
}

Kotlin

dependencies {
    val fragment_version = "1.8.3"

    debugImplementation("androidx.fragment:fragment-testing-manifest:$fragment_version")

    androidTestImplementation("androidx.fragment:fragment-testing:$fragment_version")
}

ตัวอย่างการทดสอบในหน้านี้ใช้การยืนยันจาก Espresso และ ไลบรารี Truth สำหรับข้อมูลเกี่ยวกับ ไลบรารีการทดสอบและการยืนยันอื่นๆ ที่มีอยู่ โปรดดู ตั้งค่าโปรเจ็กต์สำหรับ AndroidX Test

สร้างส่วนย่อย

FragmentScenario มีเมธอดต่อไปนี้สำหรับการเปิดใช้ Fragment ในการทดสอบ:

  • launchInContainer() เพื่อทดสอบอินเทอร์เฟซผู้ใช้ของ Fragment FragmentScenario แนบ ไปยังตัวควบคุมมุมมองรูทของกิจกรรม กิจกรรมนี้มีกิจกรรมอยู่ หรือว่างเปล่า
  • launch() สำหรับการทดสอบโดยไม่มีอินเทอร์เฟซผู้ใช้ของ Fragment FragmentScenario แนบส่วนย่อยประเภทนี้กับกิจกรรมเปล่าซึ่งไม่ มีมุมมองรูท

หลังจากเปิดใช้งานหนึ่งในประเภทส่วนย่อยเหล่านี้ FragmentScenario จะขับเคลื่อน ส่วนย่อยภายใต้การทดสอบเป็นสถานะที่ระบุ โดยค่าเริ่มต้น สถานะนี้คือ RESUMED แต่คุณสามารถลบล้างได้ด้วยอาร์กิวเมนต์ initialState รัฐRESUMED บ่งบอกว่าส่วนย่อยกำลังทำงานและแสดงต่อผู้ใช้ คุณสามารถประเมิน ข้อมูลเกี่ยวกับองค์ประกอบ UI โดยใช้ Espresso UI การทดสอบ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเปิดใช้งานส่วนย่อยโดยใช้แต่ละวิธี

ตัวอย่างlaunchInContainer()

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        // The "fragmentArgs" argument is optional.
        val fragmentArgs = bundleOf(selectedListItem to 0)
        val scenario = launchFragmentInContainer<EventFragment>(fragmentArgs)
        ...
    }
}

ตัวอย่างlaunch()

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        // The "fragmentArgs" arguments are optional.
        val fragmentArgs = bundleOf("numElements" to 0)
        val scenario = launchFragment<EventFragment>(fragmentArgs)
        ...
    }
}

ระบุทรัพยากร Dependency

หาก Fragment มีทรัพยากร Dependency คุณระบุเวอร์ชันทดสอบของ ทรัพยากร Dependency เหล่านี้ด้วยการระบุ FragmentFactory ที่กำหนดเองให้กับเมธอด launchInContainer() หรือ launch() เมธอด

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val someDependency = TestDependency()
        launchFragmentInContainer {
            EventFragment(someDependency)
        }
        ...
    }
}

หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับการใช้ FragmentFactory เพื่อให้ การอ้างอิงกับส่วนย่อย โปรดดู ตัวจัดการส่วนย่อย

ขับเคลื่อนส่วนย่อยไปยังสถานะใหม่

ในการทดสอบ UI ของแอป ตามปกติแล้วการเรียกใช้ Fragment ก็เพียงพอแล้ว อยู่ระหว่างทดสอบ และเริ่มทดสอบจากสถานะ RESUMED แบบละเอียด อย่างไรก็ดี คุณอาจประเมินลักษณะการทำงานของส่วนย่อยด้วย เมื่อเปลี่ยนจากวงจรหนึ่งไปเป็นอีกวงจรหนึ่ง คุณสามารถระบุ สถานะเริ่มต้นโดยการส่งอาร์กิวเมนต์ initialState ไปยัง launchFragment*() ฟังก์ชัน

หากต้องการขับเคลื่อนส่วนย่อยไปยังสถานะวงจรอื่น ให้เรียกใช้ moveToState() เมธอดนี้รองรับสถานะต่อไปนี้เป็นอาร์กิวเมนต์: CREATED, STARTED, RESUMED และ DESTROYED วิธีนี้จำลองสถานการณ์ ส่วนที่ส่วนย่อยหรือกิจกรรมที่มีส่วนย่อยเปลี่ยนแปลง ด้วยเหตุผลใดก็ตาม

ตัวอย่างต่อไปนี้จะเปิดส่วนย่อยการทดสอบในสถานะ INITIALIZED และ จากนั้นย้ายไปยังสถานะ RESUMED:

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val scenario = launchFragmentInContainer<EventFragment>(
            initialState = Lifecycle.State.INITIALIZED
        )
        // EventFragment has gone through onAttach(), but not onCreate().
        // Verify the initial state.
        scenario.moveToState(Lifecycle.State.RESUMED)
        // EventFragment moves to CREATED -> STARTED -> RESUMED.
        ...
    }
}

สร้างส่วนย่อยใหม่

หากแอปของคุณกำลังทำงานบนอุปกรณ์ที่มีทรัพยากรต่ำ ระบบจะ อาจทำลายกิจกรรมที่มีส่วนย่อยของคุณ สถานการณ์นี้ กำหนดให้แอปสร้างส่วนย่อยอีกครั้งเมื่อผู้ใช้ย้อนกลับ หากต้องการจำลองสถานการณ์นี้ โปรดโทรหา recreate():

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val scenario = launchFragmentInContainer<EventFragment>()
        scenario.recreate()
        ...
    }
}

FragmentScenario.recreate() ทำลายส่วนย่อยและโฮสต์ของส่วนนั้น แล้วจึงสร้างใหม่ เมื่อ คลาส FragmentScenario จะสร้างส่วนย่อยอีกครั้งภายใต้การทดสอบ ซึ่งก็คือส่วนย่อย จะกลับสู่สถานะของวงจรการใช้งานก่อนที่จะถูกทำลาย

การดำเนินการกับส่วนย่อยของ UI

หากต้องการทริกเกอร์การทำงานของ UI ในส่วนย่อยของคุณภายใต้การทดสอบ ให้ใช้ ตัวจับคู่มุมมองเอสเพรสโซ โต้ตอบกับองค์ประกอบในมุมมองของคุณ

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val scenario = launchFragmentInContainer<EventFragment>()
        onView(withId(R.id.refresh)).perform(click())
        // Assert some expected behavior
        ...
    }
}

ถ้าคุณต้องการเรียกเมธอดในส่วนนั้น เช่น การตอบกลับ ไปยังตัวเลือกในเมนูตัวเลือก คุณสามารถทำได้อย่างปลอดภัยโดย อ้างอิงไปยังส่วนย่อยโดยใช้ FragmentScenario.onFragment() และการผ่านใน FragmentAction:

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testEventFragment() {
        val scenario = launchFragmentInContainer<EventFragment>()
        scenario.onFragment { fragment ->
            fragment.myInstanceMethod()
        }
    }
}

ทดสอบการทำงานของกล่องโต้ตอบ

FragmentScenario ยังรองรับการทดสอบ ส่วนย่อยของกล่องโต้ตอบ แม้ว่าส่วนย่อยของกล่องโต้ตอบ มีองค์ประกอบ UI การจัดวางจะปรากฏในหน้าต่างแยกต่างหาก มากกว่าในตัวกิจกรรมเอง ด้วยเหตุนี้ ให้ใช้ FragmentScenario.launch() เพื่อทดสอบส่วนย่อยของกล่องโต้ตอบ

ตัวอย่างต่อไปนี้จะทดสอบกระบวนการปิดกล่องโต้ตอบ

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @Test fun testDismissDialogFragment() {
        // Assumes that "MyDialogFragment" extends the DialogFragment class.
        with(launchFragment<MyDialogFragment>()) {
            onFragment { fragment ->
                assertThat(fragment.dialog).isNotNull()
                assertThat(fragment.requireDialog().isShowing).isTrue()
                fragment.dismiss()
                fragment.parentFragmentManager.executePendingTransactions()
                assertThat(fragment.dialog).isNull()
            }
        }

        // Assumes that the dialog had a button
        // containing the text "Cancel".
        onView(withText("Cancel")).check(doesNotExist())
    }
}