ANDROID.md

title	description
MockK Android support	MockK supports regular unit tests, Android instrumented tests via subclassing(< Android P) and Android instrumented tests via inlining(≥ Android P)

Support

MockK supports:

• regular unit tests
• Android instrumented tests via subclassing(< Android P)
• Android instrumented tests via inlining(≥ Android P)

DexOpener

To open classes before Android P you can use DexOpener, example

Implementation

Implementation is based on dexmaker project. With Android P, instrumentation tests may use full power of inline instrumentation, so object mocks, static mocks and mocking of final classes are supported. Before Android P, only subclassing can be employed, so you will need the 'all-open' plugin.

Unfortunately, public CIs such as Travis and Circle are not supporting Android P emulation due to the absence of ARM Android P images. Hopefully, this will change soon.

Supported features

Feature	Unit tests	Instrumentation test
		< Android P	≥ Android P
annotations	✓	✓	✓
mocking final classes	✓	can use DexOpener	✓
pure Kotlin mocking DSL	✓	✓	✓
matchers partial specification	✓	✓	✓
chained calls	✓	✓	✓
matcher expressions	✓	✓	✓
mocking coroutines	✓	✓	✓
capturing lambdas	✓	✓	✓
object mocks	✓		✓
private function mocking	✓		✓
property backing field access	✓	✓	✓
extension function mocking (static mocks)	✓		✓
constructor mocking	✓		✓

Installation

All you need to get started is by adding a dependency to MockK library.

Unit tests

testImplementation "io.mockk:mockk:{version}"

Android instrumented tests

androidTestImplementation "io.mockk:mockk-android:{version}"

Documentation

Check full documentation here