Skip to content

Gradle plugin to be used in combination with the new unit testing feature of the Gradle Plugin / Android Studio to use real classes for e.g. SparseArray.

License

Notifications You must be signed in to change notification settings

bjoernQ/unmock-plugin

Repository files navigation

Maven Central Apache License

Android Unmock Gradle Plugin

Purpose

This is a super simple plugin to be used in combination with the new unit testing feature of the Gradle Plugin / Android Studio. ( http://tools.android.com/tech-docs/unit-testing-support )

It tries to solve the problem that you have to mock each and every Android SDK class (even SparseArray, TextUtils etc.) by allowing you to use selected classes from a real Android-Jarfile.

How to use

Add the plugin to your buildscript dependencies and make sure to use the maven central repository:

buildscript {
    repositories {
        mavenCentral()
    }
    
    dependencies {
        classpath "com.github.bjoernq:unmockplugin:${unmockpluginVersion}"
    }
}

Please note: Versions prior to 0.7.6 are not available on Maven Central.

And this to the module's build script:

apply plugin: 'de.mobilej.unmock'

Additionally you have to configure which classes to use and where to get the real Android.jar from. e.g:

unMock {
    keep "android.widget.BaseAdapter"
    keep "android.widget.ArrayAdapter"
    keep "android.os.Bundle"
    keepStartingWith "android.database.MatrixCursor"
    keep "android.database.AbstractCursor"
    keep "android.database.CrossProcessCursor"
    keepStartingWith "android.text.TextUtils"
    keepStartingWith "android.util."
    keepStartingWith "android.text."
    keepStartingWith "android.content.ContentValues"
    keepStartingWith "android.content.ComponentName"
    keepStartingWith "android.content.ContentUris"
    keepStartingWith "android.content.ContentProviderOperation"
    keepStartingWith "android.content.ContentProviderResult"
    keepStartingWith "android.content.UriMatcher"
    keepStartingWith "android.content.Intent"
    keep "android.location.Location"
    keepStartingWith "android.content.res.Configuration"
    keepStartingWith "org."
    keepStartingWith "libcore."
    keepStartingWith "com.android.internal.R"
    keepStartingWith "com.android.internal.util."
    keep "android.net.Uri"

    keepAndRename "java.nio.charset.Charsets" to "xjava.nio.charset.Charsets"
}

dependencies {
    // dependency to android-all to use
    unmock 'org.robolectric:android-all:4.3_r2-robolectric-0'
}
Statement Description
keep keeps the specified class (and it's possibly present inner classes)
keepStartingWith keeps every class which FQN starts with the given string
keepAndRename let you keep a class while renaming it (e.g. needed for classes in the "java" top-level package since these are only allowed to be loaded from the boot classpath)
delegateClass every method (and constructor) in the given class is delegated to de.mobilej.ABridge. Makes it easier to mock things in a framework class you inherit from

That's it!

Have a look at the example contained in this repository for more details.

Starting from version 0.3.5 you can leave out the configuration closure which will result using defaults (which are shown in the example above).

If you use any of the keep statements the default configuration will be cleared. (So your own configuration is not adding but replaces the default).

If you don't configure the unmock dependency the plugin will use org.robolectric:android-all:4.3_r2-robolectric-0

Versions

Version Description
0.1.0 initial public release
0.1.1 added the '-' matching
0.1.2 fixed a bug preventing the plugin to work correctly on Windows systems
0.1.3 the binary is targeting Java 1.7, again
0.2.0 support class renaming, rebuild jar if build file changed
0.3.0 use Gradle way of upToDate check, have a DSL for the configuration
0.3.1 compile with Gradle 2.4
0.3.2 lib-sample and some bugfixes (frozen class problem)
0.3.3 Android Gradle Plugin 1.3.0 compatibility
0.3.5 Use default config if no configuration closure is given
0.3.6 Optionally you can specify a directory to download the all-android.jar to
0.4.0 Support for "delegateClass" added
0.5.0 ABridge now includes callByte, callDouble and callFloat, this might break tests that rely on ABrdige.callObject to be called in these cases
0.5.1 Unique names for unmocked-android.jar to workaround an Android Studio problem
0.6.0 Use Gradle's dependency management to get the android-all.jar, more magic to workaround issues using unmocked Android-6.0+ classes
0.6.1 Make it work with Gradle 4.0-milestone and Android Gradle plugin to 3.0.0.-alpha1 while keep it working on previous versions
0.6.2 Make it work with activated Kotlin plugin
0.6.3 Make it possible to use Gradle 4 with Android Gradle plugin < 3.0
0.6.4 Works with kapt3
0.6.5 Also copy non-class files when they are matched by keepStartingWith
0.7.0 Using downloadFrom will make your build fail - use unmock scoped dependency now
0.7.1 Add support for proper Gradle up-to-date checks (thanks to @drewhannay)
0.7.2 Enable relocatable Gradle build cache support (thanks to @drewhannay)
0.7.3 Several internal improvements (PR 52, 53) contributed by @drewhannay and @stephanenicolas
0.7.4 Bump Javassist version
0.7.5 Allow unmocked classes in any variant (PR 62)
0.7.6 Bump Javassist version to 3.27.0-GA
0.7.7 ---
0.7.8 Gradle 7.0 compatability, contributed by @calvarez-ov
0.7.9 Fix #77, contributed by @matejdro
0.8.0 #83, contributed by @matejdro

License

Copyright 2015-2024 Björn Quentin

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

Gradle plugin to be used in combination with the new unit testing feature of the Gradle Plugin / Android Studio to use real classes for e.g. SparseArray.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published