Skip to content

athena-oss/plugin-gradle

Repository files navigation

Gradle Plugin Build Status

This plugin allows you to execute gradle tasks in a configurable environment, reproduceable in different set-ups, such as: a development machine or a CI server. It also supports out of the box integration with an Android environment (e.g. Android Virtual Devices, etc); you can use it with local or remote devices.

To find out more about on how to manage Android devices using Athena refer to Athena AVD Plugin or how to use Appium for running functional tests Athena Appium Plugin for Android projects.

HINT: With this plugin you can use tools such as Espresso and Robotium.

How to Install ?

On Linux

  • Using apt-get :
$ sudo add-apt-repository ppa:athena-oss/athena
$ sudo apt-get update
$ sudo apt-get install athena-plugin-gradle

On MAC OSX

$ brew tap athena-oss/tap
$ brew install plugin-gradle

Alternative

$ athena plugins install gradle https://github.com/athena-oss/plugin-gradle.git

Read the Documentation on using Athena.

How to Use ?

This plugin provides the following commands :

cleanup - Cleanup all caches generated by the plugin

$ athena gradle cleanup

exec - Execute a gradle task

$ athena gradle exec <project_dir> [<opts>...] [<tasks>...]

$ # e.g. execute unit tests
$ athena gradle exec my-project/ runUnitTests

$ # e.g. execute functional tests
$ athena gradle exec my-project/ runAndroidUITests --athena-env=my-android.env --with-avd=192.168.99.101:5555

Contributing

Checkout our guidelines on how to contribute in CONTRIBUTING.md.

Versioning

Releases are managed using github's release feature. We use Semantic Versioning for all the releases. Every change made to the code base will be referred to in the release notes (except for cleanups and refactorings).

License

Licensed under the Apache License Version 2.0 (APLv2).