MockK Android support

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

<table> <thead> <tr> <th>Feature</th> <th>Unit tests</th> <th colspan="2">Instrumentation test</th> </tr> <tr> <td></td> <td></td> <td>&lt; Android P</td> <td>≥ Android P</td> </tr> </thead> <tbody> <tr> <td>annotations</td> <td>✓</td> <td>✓</td> <td>✓</td> </tr> <tr> <td>mocking final classes</td> <td>✓</td> <td>can use DexOpener</td> <td>✓</td> </tr> <tr> <td>pure Kotlin mocking DSL</td> <td>✓</td> <td>✓</td> <td>✓</td> </tr> <tr> <td>matchers partial specification</td> <td>✓</td> <td>✓</td> <td>✓</td> </tr> <tr> <td>chained calls</td> <td>✓</td> <td>✓</td> <td>✓</td> </tr> <tr> <td>matcher expressions</td> <td>✓</td> <td>✓</td> <td>✓</td> </tr> <tr> <td>mocking coroutines</td> <td>✓</td> <td>✓</td> <td>✓</td> </tr> <tr> <td>capturing lambdas</td> <td>✓</td> <td>✓</td> <td>✓</td> </tr> <tr> <td>object mocks</td> <td>✓</td> <td></td> <td>✓</td> </tr> <tr> <td>private function mocking</td> <td>✓</td> <td></td> <td>✓</td> </tr> <tr> <td>property backing field access</td> <td>✓</td> <td>✓</td> <td>✓</td> </tr> <tr> <td>extension function mocking (static mocks)</td> <td>✓</td> <td></td> <td>✓</td> </tr> <tr> <td>constructor mocking</td> <td>✓</td> <td></td> <td>✓</td> </tr> </tbody> </table>

Installation

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

Unit tests

Android instrumented tests

Documentation

Check full documentation here