はじめに

皆さん、ごきげんよう！れぶです！

今回の記事ではNavigationで引数付きの画面遷移を行った場合、遷移先であるフラグメントのViewをテストする方法について整理しました。

遷移元から送られた値を遷移先で表示する処理について、UIテスト（Espresso）を行いたい方に特に参考になればと思います。それでは、参りましょう！！

開発環境

MacBook Air
Android Studio Chipmunk | 2021.2.1
Kotlin 1.6.10
compileSdkVersion 33
targetSdkVersion 33
minSdkVersion 21
Espresso 3.4.0

前提

処理内容

⑴　FirstFragmentのボタン（button1）をタップ
⑵　SecondFragmentに遷移
⑶　数字の10を送る
⑷　SecondFragmentのテキストビュー（textview1）に⑶を表示

※ 今回はあくまで内容を簡単にするために、複雑な処理なしでデータを受け渡します。

該当ソースコード

ナビゲーショングラフ

nav_graph.xml

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nav_graph"
    app:startDestination="@id/firstFragment">

    <fragment
        android:id="@+id/firstFragment"
        android:name="com.FirstFragment"
        android:label="fragment_first"
        tools:layout="@layout/fragment_first" >
        <action
            android:id="@+id/action_first_to_second"
            app:destination="@id/secondFragment" />
    </fragment>
    <fragment
        android:id="@+id/secondFragment"
        android:name="com.SecondFragment"
        android:label="fragment_second"
        tools:layout="@layout/fragment_second" >
        <argument
            android:name="number"
            app:argType="integer" />
    </fragment>
</navigation>

遷移元

FirstFragment.kt

private val navController: NavController get() = findNavController()
.....（省略）
view.findViewById<Button>(R.id.button1).setOnClickListener {
    val action = FirstFragmentDirections.actionFirstToSecond(10)
    navController.navigate(action)    
}

遷移先

SecondFragment.kt

private val args: ResultFragmentArgs by navArgs()
.....（省略）
val num = args.number
val textview1: TextView = findViewById(R.id.textview1)
textview1.text = "$num"

テスト内容

SecondFragmentのテキストビュー（textview1）に、FirstFragmentから送られた10が直接表示されるかをテストします。

テスト手順

ExampleInstrumentedTest.kt

@RunWith(AndroidJUnit4::class)
class ExampleInstrumentedTest {

    @get:Rule
    val activityScenarioRule: ActivityScenarioRule<MainActivity> = 
        ActivityScenarioRule(MainActivity::class.java)

    @Test
    fun testDisplayArguments() {

        //①TestNavHostControllerを作成
        val navController = 
            TestNavHostController(ApplicationProvider.getApplicationContext())

        //②遷移元のFragmentを起動
        launchFragmentInContainer<FirstFragment>().onFragment { firstFragment ->
            navController.setGraph(R.navigation.nav_graph)
            //navController.setCurrentDestination(R.id.firstFragment)
            Navigation.setViewNavController(
                firstFragment.requireView(),navController)
        }
        onView(withId(R.id.button1)).perform(click())

        //③遷移先のFragmentを起動
        val currentDestinationArg = navController.backStack.last().arguments
        launchFragmentInContainer<SecondFragment>(currentDestinationArg)

        //④遷移先のFragmentのViewをテスト
        onView(withId(R.id.textview1)).check(matches(withText("10")))
    }
}

①TestNavHostControllerを作成

Navigationの遷移テスト時に便利
今回FirstFragmentに割り当てるために作成

②遷移元のFragmentを起動

FirstFragmentのFragmentScenarioを作成
FirstFragmentにTestNavHostControllerのプロパティをセット
setCurrentDestination()を使うことで現在地を設定できる（今回はFirstFragmentをstartDestinationに設定しているため不要）
SecondFragmentに遷移するため、ボタンをタップ

③遷移先のFragmentを起動

TestNavHostControllerの変数.backStack.last().argumentsで、FirstFragmentから送られた値（Bundle?型）を取得
取得した値を引数にSecondFragmentのFragmentScenarioを作成
ナビゲーショングラフで遷移先に引数を設定した場合、launchFragmentInContainerに引数を設定していないと、null argumentsのエラーが出るため注意

④遷移先のFragmentのViewをテスト

FirstFragmentから送られた値がSecondFragmentのViewに適切に表示されるかをテスト
今回テキストビューは「10」と表示されるため、テスト成功

サンプルコード

因みに自身が作成したブラックジャックができるサンプルアプリ内で、上記の方法を使ったテストコード（displayResultメソッド）を書いているので、もし良かったら参照してみてください。

おわりに

今回は、Navigationで引数が絡む処理のUIテスト方法を超簡単にまとめました。4ステップで実現できるので、意外と簡単だと感じた方も少なくないと思います。

大体はユーザーによる操作をもとにデータの受け渡しをするケースが多いと思うので、上記のやり方が少しでも役立つと嬉しいです。以上です。ありがとうございました！

参考サイト