README.md

Gradle plugin to deploys apks to Testdroid's online devices

A typical project build.gradle will look like this:

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:0.4.2'
        classpath 'com.testdroid:gradle:1.0'
    }
}

apply plugin: 'android'
apply plugin: 'testdroid'

android {
    //...
}

testdroid {
    username '[email protected]'
    password 'testdroid'
    deviceGroup 'My Devices'
}

With above configuration your application and instrumentation package are uploaded into Testdroid and test run is launched using device from group 'My Devices'

To launch test run from command line use testdroidUpload task:

./gradlew testdroidUpload

You can fully control your testrun using the same configurations options which are available via Testdroid web UI.

Below is listed all the supported configurations parameters:

testdroid {
    username  "demo@localhost"
    password "password"
    deviceGroup "test group"

    cloudUrl = 'https://cloud.testdroid.com'  //optional - default live
    projectName "Project 1"  //optional - default: create a new project
    mode "FULL_RUN" //FULL_RUN / APP_CRAWLER / UI_AUTOMATOR


    deviceLanguageCode "en-US"    //optional - locale <ISO 63>_<ISO 3166> default: en-US

    hookUrl "http://localhost:9080"   //optional - call back URL after test run has finished default: empty

    scheduler "PARALLEL" // optional - PARALLEL or SERIAL default: PARALLEL

    testScreenshotDir = "/sdcard/abc"  //optional - custom screenshot folder  default: /sdcard/test-screenshots

    // AppCrawler configuration - set application credentials
    appCrawlerConfig{
        applicationPassword = "appPassword2"
        applicationUserName = "appUsername2"
    }

    // optional - Custom settings for test execution
    fullRunConfig {
        instrumentationRunner =  "com.android.testRunner"
        withAnnotation = "com.my.annotation"
        withOutAnnotation = "com.my.not.annotation"
        limitationType = "CLASS"
        limitationValue = "foo.bar"
    }

      //optional
    uiAutomatorTestConfig {
        uiAutomatorTestClasses = "foo.class"
        uiAutomatorJarPath = "tmp/uitests.jar"
    }
    
}