Spoon Gradle Plugin

Gradle plugin for Spoon. Allows you to run spoon with almost no effort under new Android build system.

Plugin generates spoon${TEST_VARIANT} tasks for every test variation in your application project.

Usage

buildscript {
  repositories {
    mavenCentral()
  }

  dependencies {
    classpath 'com.stanfy.spoon:spoon-gradle-plugin:1.2.2'
  }
}

apply plugin: 'spoon'

// This section is optional
spoon {
  // for debug output
  debug = true

  // To run a single test class
  className = 'fully.qualified.TestCase'

  // To run a single method in TestCase
  methodName = 'testMyApp'

  // To execute the tests device by device */
  sequential = true

  // To grant permissions to Android M >= devices */
  grantAllPermissions = true
}

After applying the plugin you'll find spoon${TEST_VARIANT} tasks in your project.

You may run all the test variations with

gradle spoon

Generated reports are available at build/spoon/${TEST_VARIANT} folder.

For making screenshots add spoon-client dependency to your tests compile configuration:

dependencies {
  androidTestCompile 'com.squareup.spoon:spoon-client:1.6.4'
}

By default the plugin runs tests on all the connected devices. In order to run them on some concrete devices instead, you may specify their serial numbers:

spoon {
  devices = ['333236E9AE5800EC']
  skipDevices = ['serial-you-want-to-skip']
}

It is also allowed to specify specify size of tests that should be run. You may run all the tests annotated as @SmallTest with the following line:

gradle spoonSmall

Run gradle tasks for details about size rules.

You may also setup your project to take parameters for class/method to be run from command line. E.g.:

gradle spoon -PspoonClassName=fully.qualified.TestCase

And project configuration:

spoon {
  if (project.hasProperty('spoonClassName')) {
    className = project.spoonClassName  
  }
}

Test Sharding

You can configure test sharding using the numShards and shardIndex properties (documentation):

spoon {
  numShards = 4
  shardIndex = 0
}

If you are specifying sharding for multiple devices, you may use spoon's built in auto-sharding by specifying:

spoon {
  shard = true
}

This will automatically shard across all specified serials, and merge the results.

Custom instrumentation arguments

Use the instrumentationArgs property on spoon extension to pass custom parameters to your tests:

spoon {
  instrumentationArgs = ["foo=bar", "name=value"]
}

Code Coverage

You can configure spoon to calculate code coverage by using codeCoverage property on spoon extension:

spoon {
  codeCoverage = true
}

This option requires your app to have the WRITE_EXTERNAL_STORAGE permission.

Known issues

If you have troubles with running Android Lint after this plugin is applied, try the following workaround

buildscript {
  // ...
  dependencies {
    classpath('com.stanfy.spoon:spoon-gradle-plugin:1.2.2') {
      exclude module: 'guava'
    }
    classpath 'com.google.guava:guava:17.0'
  }
}

You can find details in the related issue.

Testing

After making editions, run

./gradlew integrationTest

This will install the plugin to local maven repo and run spoon task in the example project.

License

Copyright 2013-2016 Stanfy Corp.

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.