com.simpligility.maven.plugins.android.standalonemojos

Class UIAutomatorMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

com.simpligility.maven.plugins.android.AbstractAndroidMojo

com.simpligility.maven.plugins.android.standalonemojos.UIAutomatorMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

@Mojo(name="uiautomator",
      requiresProject=false)
public class UIAutomatorMojo
extends AbstractAndroidMojo

Can execute tests using ui uiautomator.
Implements parsing parameters from pom or command line arguments and sets useful defaults as well. This goal is meant to execute a special java project dedicated to UI testing via UIAutomator. It will build the jar of the project, dex it and send it to dalvik cache of a rooted device or to an emulator. If you use a rooted device, refer to this thread on stack over flow.

The tests are executed via ui automator. A surefire compatible test report can be generated and its location will be logged during build.

To use this goal, you will need to place the uiautomator.jar file (part of the Android SDK >= 16) on a nexus repository.

A typical usage of this goal can be found at Quality tools for Android project.

Author:

Stéphane Nicolas - snicolas@octo.com

See Also:

Android UI testing doc, UI Automator manual page

Field Summary

Fields inherited from class com.simpligility.maven.plugins.android.AbstractAndroidMojo

aaptExtraArgs, aaptVerbose, adbConnectionTimeout, androidManifestFile, assetsDirectory, attachJar, attachSources, combinedAssets, configurations, customPackage, dependencyGraphBuilder, destinationManifestFile, device, devices, deviceThreads, ENV_ANDROID_HOME, ENV_ANDROID_NDK_HOME, execution, extractedDependenciesDirectory, extractedDependenciesJavaResources, extractedDependenciesJavaSources, finalName, genDirectory, generateApk, ips, nativeLibrariesDirectory, ndkOutputDirectory, proguardFile, project, projectHelper, projectOutputDirectory, release, renameManifestPackage, resourceDirectory, resourceOverlayDirectories, resourceOverlayDirectory, resources, session, sourceDirectory, sourceEncoding, SUPPORTED_PACKAGING_TYPES, targetDirectory, undeployBeforeDeploy

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor and Description
UIAutomatorMojo()

Method Summary

Modifier and Type	Method and Description
protected static String	buildSpaceSeparatedString(String[] lines) Helper method to build a comma separated string from a list.
void	execute()
protected boolean	isEnableIntegrationTest() Whether or not tests are enabled.
protected boolean	isIgnoreTestFailures() Whether or not test failures should be ignored.
protected void	playTests() Actually plays tests.

Methods inherited from class com.simpligility.maven.plugins.android.AbstractAndroidMojo

copyFolder, deployApk, deployBuiltApk, deployDependencies, doWithDevices, extractInstrumentationRunnerFromAndroidManifest, extractPackageNameFromAndroidArtifact, extractPackageNameFromAndroidManifest, extractPackageNameFromAndroidManifestXmlTree, extractPackageNameFromApk, getAndroidManifestPackageName, getAndroidNdk, getAndroidSdk, getArtifactResolverHelper, getDependencyResolver, getDirectDependencyArtifacts, getJack, getLibraryUnpackDirectory, getNativeHelper, getRelevantCompileArtifacts, getResourceOverlayDirectories, getTransitiveDependencyArtifacts, getTransitiveDependencyArtifacts, getUnpackedAarClassesJar, getUnpackedApkLibSourceFolder, getUnpackedLibAssetsFolder, getUnpackedLibFolder, getUnpackedLibHelper, getUnpackedLibNativesFolder, getUnpackedLibResourceFolder, getUnpackedLibsDirectory, initAndroidDebugBridge, isAPKBuild, isInstrumentationTest, resolveArtifactToFile, undeployApk, undeployApk, waitForInitialDeviceList

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UIAutomatorMojo

public UIAutomatorMojo()

Method Detail

execute

public void execute()
             throws org.apache.maven.plugin.MojoExecutionException,
                    org.apache.maven.plugin.MojoFailureException

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

isEnableIntegrationTest

protected boolean isEnableIntegrationTest()

Whether or not tests are enabled.

Returns:

a boolean indicating whether or not tests are enabled.

isIgnoreTestFailures

protected boolean isIgnoreTestFailures()

Whether or not test failures should be ignored.

Returns:

a boolean indicating whether or not test failures should be ignored.

playTests

protected void playTests()
                  throws org.apache.maven.plugin.MojoExecutionException,
                         org.apache.maven.plugin.MojoFailureException

Actually plays tests.

Throws:

org.apache.maven.plugin.MojoExecutionException - if at least a test threw an exception and isIgnoreTestFailures is false..

org.apache.maven.plugin.MojoFailureException - if at least a test failed and isIgnoreTestFailures is false.

buildSpaceSeparatedString

protected static String buildSpaceSeparatedString(String[] lines)

Helper method to build a comma separated string from a list. Blank strings are filtered out

Parameters:

lines - A list of strings

Returns:

Comma separated String from given list