Kotest Android

Unofficial integration between the Kotest Framework and the Android Platform. This repository aims to contain the tools necessary to run Kotest in the complicated Android environment, with kotest-runner-android - a customized version of kotest-runner-junit4 - kotest-assertions-android containing matchers and assertions specific to Android

Kotest Runner Android

A custom version of kotest-runner-junit4 made specifically to run Android Integration Tests.

Adding the Runner to an Android Project

The SubProject kotest-runner-android-tests should provide a good sample if you need one.

Android Block Configuration

In the Android Block of your build.gradle.kts you need to ensure that the testInstrumentationRunner is set to "androidx.test.runner.AndroidJUnitRunner". Yes, the default runner is what we will leverage to run our tests.

android {
    defaultConfig {
        // ...
        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }
}

Dependencies Configuration

To androidTestImplementation we are going to add kotest-runner-android:

  androidTestImplementation("br.com.colman:kotest-runner-android:VERSION")

Kotest Extensions Android

Dependencies Configuration

To testImplementation we are going to add kotest-extensions-android:

  testImplementation("br.com.colman:kotest-extensions-android:VERSION")

Available Extensions

Robolectric Extension

The Robolectric Extension enables tests to operate under the Robolectric environment. To utilize this feature, adorn the unit tests that you wish to run with Robolectric with the @RobolectricTest annotation. Tests will be executed within the integrated Robolectric environment. @Config annotations can be used for Robolectric specific configurations.

Here is a Kotlin example of how to use the annotation:

@RobolectricTest(sdk = Build.VERSION_CODES.O)
class ContainedRobolectricRunnerMergeApiVersionTest {
  init {
    "Get the Build.VERSION_CODES.O" {
      Build.VERSION.SDK_INT shouldBe Build.VERSION_CODES.O
    }
  }
}

Kotest Assertions Android

Dependencies Configuration

To androidTestImplementation we are going to add kotest-assertions-android:

  androidTestImplementation("br.com.colman:kotest-assertions-android:VERSION")

Available Matchers

Documentation and format to be improved.