Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/stanfy/spoon-gradle-plugin

Gradle plugin for Spoon.
https://github.com/stanfy/spoon-gradle-plugin

Last synced: about 1 month ago
JSON representation

Gradle plugin for Spoon.

Awesome Lists containing this project

README

        

Spoon Gradle Plugin
===================

Gradle plugin for [Spoon](https://github.com/square/spoon).
Allows you to run spoon with almost no effort under new Android build system.

[![Build Status](https://travis-ci.org/stanfy/spoon-gradle-plugin.png?branch=master)](https://travis-ci.org/stanfy/spoon-gradle-plugin)

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

Usage
-----
```groovy
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:
```groovy
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:
```groovy
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:
```bash
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.:

```bash
gradle spoon -PspoonClassName=fully.qualified.TestCase
```

And project configuration:

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

Test Sharding
-------------
You can configure test sharding using the `numShards` and `shardIndex` properties
([documentation](https://developer.android.com/tools/testing-support-library/index.html#ajur-sharding)):
```groovy
spoon {
numShards = 4
shardIndex = 0
}
```
If you are specifying sharding for multiple devices, you may use spoon's built in auto-sharding by specifying:
```groovy
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:
```groovy
spoon {
instrumentationArgs = ["foo=bar", "name=value"]
}
```

Code Coverage
--------------------------------
You can configure spoon to calculate code coverage by using `codeCoverage` property on `spoon` extension:
```groovy
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
```groovy
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](https://github.com/stanfy/spoon-gradle-plugin/issues/33).

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.