com.google.api.services.testing.model

Class AndroidInstrumentationTest

java.lang.Object

java.util.AbstractMap<String,Object>

com.google.api.client.util.GenericData

com.google.api.client.json.GenericJson

com.google.api.services.testing.model.AndroidInstrumentationTest

All Implemented Interfaces:

Cloneable, Map<String,Object>

public final class AndroidInstrumentationTest
extends com.google.api.client.json.GenericJson

A test of an Android application that can control an Android component independently of its normal lifecycle. Android instrumentation tests run an application APK and test APK inside the same process on a virtual or physical AndroidDevice. They also specify a test runner class, such as com.google.GoogleTestRunner, which can vary on the specific instrumentation framework chosen. See for more information on types of Android tests.

This is the Java data model class that specifies how to parse/serialize into the JSON that is transmitted over HTTP when working with the Cloud Testing API. For a detailed explanation see: https://developers.google.com/api-client-library/java/google-http-java-client/json

Author:

Google, Inc.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

com.google.api.client.util.GenericData.Flags

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
AndroidInstrumentationTest()

Method Summary

Modifier and Type	Method and Description
AndroidInstrumentationTest	clone()
FileReference	getAppApk() The APK for the application under test.
AppBundle	getAppBundle() A multi-apk app bundle for the application under test.
String	getAppPackageId() The java package for the application under test.
String	getOrchestratorOption() The option of whether running each test within its own invocation of instrumentation with Android Test Orchestrator or not.
FileReference	getTestApk() Required.
String	getTestPackageId() The java package for the test to be executed.
String	getTestRunnerClass() The InstrumentationTestRunner class.
List<String>	getTestTargets() Each target must be fully qualified with the package name or class name, in one of these formats: - "package package_name" - "class package_name.class_name" - "class package_name.class_name#method_name" If empty, all targets in the module will be run.
AndroidInstrumentationTest	set(String fieldName, Object value)
AndroidInstrumentationTest	setAppApk(FileReference appApk) The APK for the application under test.
AndroidInstrumentationTest	setAppBundle(AppBundle appBundle) A multi-apk app bundle for the application under test.
AndroidInstrumentationTest	setAppPackageId(String appPackageId) The java package for the application under test.
AndroidInstrumentationTest	setOrchestratorOption(String orchestratorOption) The option of whether running each test within its own invocation of instrumentation with Android Test Orchestrator or not.
AndroidInstrumentationTest	setTestApk(FileReference testApk) Required.
AndroidInstrumentationTest	setTestPackageId(String testPackageId) The java package for the test to be executed.
AndroidInstrumentationTest	setTestRunnerClass(String testRunnerClass) The InstrumentationTestRunner class.
AndroidInstrumentationTest	setTestTargets(List<String> testTargets) Each target must be fully qualified with the package name or class name, in one of these formats: - "package package_name" - "class package_name.class_name" - "class package_name.class_name#method_name" If empty, all targets in the module will be run.

Methods inherited from class com.google.api.client.json.GenericJson

getFactory, setFactory, toPrettyString, toString

Methods inherited from class com.google.api.client.util.GenericData

entrySet, get, getClassInfo, getUnknownKeys, put, putAll, remove, setUnknownKeys

Methods inherited from class java.util.AbstractMap

clear, containsKey, containsValue, equals, hashCode, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

AndroidInstrumentationTest

public AndroidInstrumentationTest()

Method Detail

getAppApk

public FileReference getAppApk()

The APK for the application under test.

Returns:

value or null for none

setAppApk

public AndroidInstrumentationTest setAppApk(FileReference appApk)

The APK for the application under test.

Parameters:

appApk - appApk or null for none

getAppBundle

public AppBundle getAppBundle()

A multi-apk app bundle for the application under test.

Returns:

value or null for none

setAppBundle

public AndroidInstrumentationTest setAppBundle(AppBundle appBundle)

A multi-apk app bundle for the application under test.

Parameters:

appBundle - appBundle or null for none

getAppPackageId

public String getAppPackageId()

The java package for the application under test. The default value is determined by examining the application's manifest.

Returns:

value or null for none

setAppPackageId

public AndroidInstrumentationTest setAppPackageId(String appPackageId)

The java package for the application under test. The default value is determined by examining the application's manifest.

Parameters:

appPackageId - appPackageId or null for none

getOrchestratorOption

public String getOrchestratorOption()

The option of whether running each test within its own invocation of instrumentation with Android Test Orchestrator or not. ** Orchestrator is only compatible with AndroidJUnitRunner version 1.0 or higher! ** Orchestrator offers the following benefits: - No shared state - Crashes are isolated - Logs are scoped per test See for more information about Android Test Orchestrator. If not set, the test will be run without the orchestrator.

Returns:

value or null for none

setOrchestratorOption

public AndroidInstrumentationTest setOrchestratorOption(String orchestratorOption)

The option of whether running each test within its own invocation of instrumentation with Android Test Orchestrator or not. ** Orchestrator is only compatible with AndroidJUnitRunner version 1.0 or higher! ** Orchestrator offers the following benefits: - No shared state - Crashes are isolated - Logs are scoped per test See for more information about Android Test Orchestrator. If not set, the test will be run without the orchestrator.

Parameters:

orchestratorOption - orchestratorOption or null for none

getTestApk

public FileReference getTestApk()

Required. The APK containing the test code to be executed.

Returns:

value or null for none

setTestApk

public AndroidInstrumentationTest setTestApk(FileReference testApk)

Required. The APK containing the test code to be executed.

Parameters:

testApk - testApk or null for none

getTestPackageId

public String getTestPackageId()

The java package for the test to be executed. The default value is determined by examining the application's manifest.

Returns:

value or null for none

setTestPackageId

public AndroidInstrumentationTest setTestPackageId(String testPackageId)

The java package for the test to be executed. The default value is determined by examining the application's manifest.

Parameters:

testPackageId - testPackageId or null for none

getTestRunnerClass

public String getTestRunnerClass()

The InstrumentationTestRunner class. The default value is determined by examining the application's manifest.

Returns:

value or null for none

setTestRunnerClass

public AndroidInstrumentationTest setTestRunnerClass(String testRunnerClass)

The InstrumentationTestRunner class. The default value is determined by examining the application's manifest.

Parameters:

testRunnerClass - testRunnerClass or null for none

getTestTargets

public List<String> getTestTargets()

Each target must be fully qualified with the package name or class name, in one of these formats: - "package package_name" - "class package_name.class_name" - "class package_name.class_name#method_name" If empty, all targets in the module will be run.

Returns:

value or null for none

setTestTargets

public AndroidInstrumentationTest setTestTargets(List<String> testTargets)

Each target must be fully qualified with the package name or class name, in one of these formats: - "package package_name" - "class package_name.class_name" - "class package_name.class_name#method_name" If empty, all targets in the module will be run.

Parameters:

testTargets - testTargets or null for none

set

public AndroidInstrumentationTest set(String fieldName,
                                      Object value)

Overrides:

set in class com.google.api.client.json.GenericJson

clone

public AndroidInstrumentationTest clone()

Overrides:

clone in class com.google.api.client.json.GenericJson