NOTE: Breaking change for Android

The mockito-android artifact has a breaking change: tests now require a device or emulator based on API 28+ (Android P). This is to enable new support for mocking Kotlin classes. See #3788 for more details.

---

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.23.0

• 2026-03-11 - 6 commit(s) by Brice Dutheil, Joshua Selbo, Philippe Kernevez
• Replace mockito-android mock maker implementation with dexmaker-mockito-inline (#3792)
• Fix StackOverflowError with AbstractList after using mockSingleton (#3790)
• Mark parameters of Mockito.when @Nullable (#3503)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.22.0

• 2026-02-27 - 6 commit(s) by Joshua Selbo, NiMv1, Rafael Winterhalter, dependabot[bot], eunbin son
• Avoid mocking of internal static utilities (#3785)
• Bump graalvm/setup-graalvm from 1.4.4 to 1.4.5 (#3780)
• Static mocking of UUID.class corrupted under JDK 25 (#3778)
• Bump actions/upload-artifact from 5 to 6 (#3774)
• docs: clarify RETURNS_MOCKS behavior with sealed abstract enums (Java 15+) (#3773)
• Add tests for Sets utility class (#3771)
• Add core API to enable Kotlin singleton mocking (#3762)
• Stubbing Kotlin object singletons (#3652)
• Incorrect documentation for RETURNS_MOCKS (#3285)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.21.0

• 2025-12-09 - 17 commit(s) by Giulio Longfils, Joshua Selbo, Woongi9, Zylox, dependabot[bot]
• Bump graalvm/setup-graalvm from 1.4.3 to 1.4.4 (#3768)
• Bump graalvm/setup-graalvm from 1.4.2 to 1.4.3 (#3767)
• Bump actions/checkout from 5 to 6 (#3765)
• Adds output of matchers to potential mismatch; Fixes #2468 (#3760)
• Forbid mocking WeakReference with inline mock maker (#3759)
• StackOverflowError when mocking WeakReference (#3758)
• Bump actions/upload-artifact from 4 to 5 (#3756)
• Bump graalvm/setup-graalvm from 1.4.1 to 1.4.2 (#3755)
• Support primitives in GenericArrayReturnType. (#3753)
• ClassNotFoundException when stubbing array of primitive type on Android (#3752)
• Bump graalvm/setup-graalvm from 1.4.0 to 1.4.1 (#3744)
• Bump gradle/actions from 4 to 5 (#3743)
• Bump org.graalvm.buildtools.native from 0.11.0 to 0.11.1 (#3738)
• Bump com.diffplug.spotless:spotless-plugin-gradle from 7.2.1 to 8.0.0 (#3735)
• Bump graalvm/setup-graalvm from 1.3.7 to 1.4.0 (#3734)
• Bump org.assertj:assertj-core from 3.27.5 to 3.27.6 (#3733)
• Bump errorprone from 2.41.0 to 2.42.0 (#3732)
• Feat: automatically detect class to mock in mockStatic and mockConstruction (#3731)
• Return completed futures for unstubbed Future/CompletionStage in ReturnsEmptyValues (#3727)
• automatically detect class to mock (#2779)
• Incorrect "has following stubbing(s) with different arguments" message when using Argument Matchers (#2468)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.20.0

• 2025-09-20 - 11 commit(s) by Adrian-Kim, Giulio Longfils, Rafael Winterhalter, dependabot[bot]
• Bump org.assertj:assertj-core from 3.27.4 to 3.27.5 (#3730)
• Introducing the Ability to Mock Construction of Generic Types (#2401) (#3729)
• Bump com.gradle.develocity from 4.1.1 to 4.2 (#3726)
• Bump graalvm/setup-graalvm from 1.3.6 to 1.3.7 (#3725)
• Bump org.eclipse.platform:org.eclipse.osgi from 3.23.100 to 3.23.200 (#3720)
• Bump graalvm/setup-graalvm from 1.3.5 to 1.3.6 (#3719)
• Bump actions/setup-java from 4 to 5 (#3715)
• Bump com.gradle.develocity from 4.1 to 4.1.1 (#3713)
• Bump bytebuddy from 1.17.6 to 1.17.7 (#3712)
• test: Use Assume.assumeThat for SequencedCollection tests (#3711)
• Fix #3709 (#3710)
• feat: Add support for JDK21 Sequenced Collections. (#3708)
• Introducing the Ability to Mock Construction of Generic Types (#2401)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.19.0

• 2025-08-15 - 37 commit(s) by Adrian-Kim, Tim van der Lippe, Tran Ngoc Nhan, dependabot[bot], juyeop
• feat: Add support for JDK21 Sequenced Collections. (#3708)
• Bump actions/checkout from 4 to 5 (#3707)
• build: Allow overriding 'Created-By' for reproducible builds (#3704)
• Bump org.assertj:assertj-core from 3.27.3 to 3.27.4 (#3703)
• Bump androidx.test:runner from 1.6.2 to 1.7.0 (#3697)
• Bump org.junit.platform:junit-platform-launcher from 1.13.3 to 1.13.4 (#3694)
• Bump com.diffplug.spotless:spotless-plugin-gradle from 7.1.0 to 7.2.1 (#3693)
• Bump junit-jupiter from 5.13.3 to 5.13.4 (#3691)
• Bump com.gradle.develocity from 4.0.2 to 4.1 (#3689)
• Bump com.google.googlejavaformat:google-java-format from 1.27.0 to 1.28.0 (#3688)
• Bump com.google.googlejavaformat:google-java-format from 1.25.2 to 1.27.0 (#3686)
• Bump com.diffplug.spotless:spotless-plugin-gradle from 7.0.4 to 7.1.0 (#3685)
• Bump junit-jupiter from 5.13.2 to 5.13.3 (#3684)
• Bump org.shipkit:shipkit-auto-version from 2.1.0 to 2.1.2 (#3683)
• Bump com.diffplug.spotless:spotless-plugin-gradle from 7.0.2 to 7.0.4 (#3682)
• Only run release after both Java and Android tests have finished
  (#3681)
• Bump org.junit.platform:junit-platform-launcher from 1.12.2 to 1.13.3 (#3680)
• Bump org.codehaus.groovy:groovy from 3.0.24 to 3.0.25 (#3679)
• Bump org.eclipse.platform:org.eclipse.osgi from 3.23.0 to 3.23.100 (#3678)
• Can no longer publish snapshot releases (#3677)
• Update Gradle to 8.14.2 (#3676)
• Bump errorprone from 2.23.0 to 2.39.0 (#3674)
• Correct Junit docs link (#3672)
• Bump net.ltgt.gradle:gradle-errorprone-plugin from 4.1.0 to 4.3.0 (#3670)
• Bump junit-jupiter from 5.13.1 to 5.13.2 (#3669)
• Bump bytebuddy from 1.17.5 to 1.17.6 (#3668)
• Bump junit-jupiter from 5.12.2 to 5.13.1 (#3666)
• Bump org.jetbrains.kotlin:kotlin-stdlib from 2.0.21 to 2.2.0 (#3665)
• Bump org.gradle.toolchains.foojay-resolver-convention from 0.9.0 to 1.0.0 (#3661)
• Bump org.junit.platform:junit-platform-launcher from 1.11.4 to 1.12.2 (#3660)
• Add JDK21 sequenced collections for ReturnsEmptyValues (#3659)
• Bump com.gradle.develocity from 3.19.1 to 4.0.2 (#3658)
• Bump ru.vyarus:gradle-animalsniffer-plugin from 1.7.2 to 2.0.1 (#3657)
• Bump org.eclipse.platform:org.eclipse.osgi from 3.22.0 to 3.23.0 (#3656)
• Bump org.codehaus.groovy:groovy from 3.0.23 to 3.0.24 (#3655)
• Bump junit-jupiter from 5.11.4 to 5.12.2 (#3653)
• Reproducible Build: need to inject JDK distribution details to rebuild (#3563)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.18.0

• 2025-05-20 - 5 commit(s) by Eugene Platonov, Patrick Doyle, Tim van der Lippe, dependabot[bot]
• Make vararg checks Scala friendly (for mockito-scala) (#3651)
• For UnfinishedStubbingException, suggest the possibility of another thread (#3636)
• UnfinishedStubbingException ought to suggest the possibility of another thread (#3635)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.17.0

• 2025-04-04 - 7 commit(s) by Adrian Roos, Andre Kurait, Jan Ouwens, Rafael Winterhalter, Taeik Lim, Thach Le, Tim van der Lippe
• Fixes #3631: Fix broken banner image link (#3632)
• Banner image is broken (#3631)
• Update exception message with mockito-inline (#3628)
• Clarify structure of commit messages (#3626)
• Fixes #3622: MockitoExtension fails cleanup when aborted before setup (#3623)
• MockitoExtension fails cleanup when aborted before setup (#3622)
• Since mockito-inline has been removed, the exception messages with mockito-inline should be modified. (#3621)
• Fixes #3171: Fall back to Throwable Location strategy on Android (#3619)
• Fixes #3615 : broken links to javadoc.io (#3616)
• Broken links to javadoc.io (#3615)
• Mocks are not working on particular devices after update Android SDK from 33 to 34 (#3171)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.16.1

• 2025-03-15 - 3 commit(s) by Adrian Roos, Jérôme Prinet, Rafael Winterhalter
• Remove Arrays.asList from critical stubbing path in GenericMetadataSu… (#3610)
• Rework of injection strategy in the context of modules (#3608)
• Adjust inline mocking snippet to allow task relocatability (#3606)
• Inline mocking configuration snippet for Gradle should allow task relocatability (#3605)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.16.0

• 2025-03-03 - 10 commit(s) by Brice Dutheil, Rafael Winterhalter, TDL, dependabot[bot]
• Add support for including module-info in Mockito. (#3597)
• Bump com.gradle.develocity from 3.19 to 3.19.1 (#3579)
• Bump org.assertj:assertj-core from 3.27.2 to 3.27.3 (#3577)
• Bump com.diffplug.spotless:spotless-plugin-gradle from 7.0.1 to 7.0.2 (#3574)
• Bump com.diffplug.spotless:spotless-plugin-gradle from 6.25.0 to 7.0.1 (#3571)
• Bump org.assertj:assertj-core from 3.27.1 to 3.27.2 (#3569)
• Tweaks documentation on mockito agent config for maven (#3568)
• Adds --info to diagnose closeAndReleaseStagingRepositories issues (#3567)
• Refine reflection when calling management factory (#3566)
• Avoid warning when dynamic attach is enabled (#3551)

^{Changelog generated by Shipkit Changelog Gradle Plugin}

5.15.2

• 2025-01-02 - 2 commit(s) by Brice Dutheil, dependabot[bot]
• Fix javadoc publication (#3561)
• Bump org.assertj:assertj-core from 3.27.0 to 3.27.1 (#3560)
• The release job is failed again (#3542)