ViewModelの単体テストを作成する

[KaitoMuraoka]

URL

https://developer.android.com/codelabs/basic-android-kotlin-compose-test-viewmodel?hl=ja#2

[KaitoMuraoka]

テストの依存関係を追加する

このCodelabでは、JUnitフレームワークを使用して単体テストを作成する。このフレームワークを使用するのには、アプリのモジュールのbuild.gradleファイルに依存関係として追加する必要がある。

implementation構成を使用して、アプリに必要な依存関係を指定する。 例えば、ViewModelライブラリを使用するには、次のコードスニペットに示すように、依存関係をandroidx.lifecycle:lifecycle-viewmodel-composeに追加する必要がある。

dependencies {

    ...
    implementation "androidx.lifecycle:lifecycle-viewmodel-compose:2.5.1"
}

これで、このライブラリをアプリのソースコードで使用できるようになりました。Android Studioで、生成されたアプリパッケージ(APK)ファイルにライブラリを追加できます。しかし、単体テストコードをAPKファイルの一部にすることは望ましくない。 なぜなら、テストコードはユーザーが使用する機能を追加するものではないからである。また、APKのサイズにも影響する。 テストコードに必要な依存関係についても同様であり、それぞれ別にしておく必要があります。そのためには、testImplementation 構成を使用します。こうすることで、構成がアプリコードではなくローカルのテスト ソースコードに適用されることを示します。

プロジェクトに依存関係を追加するには、build.gradleファイルのdependenciesブロックで、implementationやtestImplementationなどの依存関係構成を指定する。それぞれの依存関係構成は、依存関係の使用方法についてGradleにさまざまな指示を与えます。

依存関係を追加するには、

1. [Project]ペインのappディレクトリにある、appモジュールのbuild.gradleファイルを開きます。

2. ファイル内で、dependencies{}ブロックが見つかるまで下にスクロールします。testImplementation構成を使用して依存関係をjunitに追加します。

plugins {
    ...
}

android {
    ...
}

dependencies {
    ...
    testImplementation 'junit:junit:4.13.2'
}

3. 次のスクリーンショットに示すように、build.gradleファイルの上部にある通知バーで[Sync Now]をクリックし、インポートとビルドを終了します。

備品構成表(BOM)の作成

TBD

[KaitoMuraoka]

テスト戦略

適切なテスト戦略は、コードのさまざまなパスと教会をカバーすることを中心に展開されます。非常に基本的なレベルでは、成功パス、エラーパス、境界ケースという3つのシナリオにテストを分類できます。

• 成功パス: 成功パスのテストは、ポジティブフローの機能のテストに重点を置きます。ポジティブフローとは、例外またはエラー状態がないフローのことです。エラーパスや境界ケースのシナリオとは異なり、成功パスのシナリオは、アプリの想定通りの動作に重点を置くため、シナリオの網羅的なリストを簡単に作成できます。
• エラーパス: エラーパスのテストは、ネガティブフローの機能テストに重点を置きます。つまり、エラー状態や無効なユーザー入力にアプリがどのように応答するかチェックします。想定通りの動作が達成されなかった時に生じる可能性のある結果は数多くあるため、考えられる全てのエラーフローを判断することは非常に困難です。

一般的に、考えられる全てのエラーパスを列挙し、それらに対するテストを作成して、さまざまなシナリオを発見しながら単体テストを進化させ続けることをおすすめします。

• 境界ケース：境界ケースは、アプリの境界条件のテストに重点を置きます。 アプリの読み込むと時のUI状態と、ユーザーが最大数、プレイした後の　UI状態を確認します。

これらのカテゴリに関するテストシナリオを作成し、テスト計画のガイドラインとして使用できます。

テストを作成する

一般的に、適切な単体テストには次の4つの特定があります。

• 範囲が限定的：コードの一部など、特定のユニットをテストすることに重点が置かれています。コードの1部とは多くの場合、クラスまたはメソッドです。テストは範囲を狭くし、コードの複数の部分を同時に検証するのではなく、コードの各部分の正確さを検証することに重点を置くべきです。
• 理解しやすい：簡潔で、コードを読んだ時に理解しやすいものにします。ディベロッパーがひと目で、テストの背後にある意図をすぐに理解できるものにしましょう。
• 確定的：合格か不合格かの判定に一貫性があります。コードを変更せずに何度テストを実行しても、同じ結果が得られる必要があります。コードを変更していないにも関わらず、ある時は不合格になり、またある時は合格になるなど、テストが不安定であってはなりません。
• 自己完結：人間による操作もセットアップも必要とせず、単独で動作します。

成功パス

成功パスの単体テストを作成するには、GameViewModelのインスタンスが初期化されている前提で、updateUserGuess()メソッドが正しい推測単語で呼び出された後にcheckUserGuess()メソッドが呼び出されたとき、次のようになることをアサートする必要があります。