# Print output for @column tags ?> TestSuiteBuilder - Android SDK | Android Developers

Most visited

Recently visited

TestSuiteBuilder

public class TestSuiteBuilder
extends Object

java.lang.Object
   ↳ android.test.suitebuilder.TestSuiteBuilder


This class is deprecated.
New tests should be written using the Android Testing Support Library.

Build suites based on a combination of included packages, excluded packages, and predicates that must be satisfied.

Summary

Nested classes

class TestSuiteBuilder.FailedToCreateTests

This class is deprecated. New tests should be written using the Android Testing Support Library. 

Public constructors

TestSuiteBuilder(Class clazz)

The given name is automatically prefixed with the package containing the tests to be run.

TestSuiteBuilder(String name, ClassLoader classLoader)

Public methods

final TestSuite build()

Call this method once you've configured your builder as desired.

TestSuiteBuilder excludePackages(String... packageNames)

Exclude all tests in the given packages and all sub-packages, unless otherwise specified.

final TestSuiteBuilder includeAllPackagesUnderHere()

Include all junit tests that satisfy the requirements in the calling class' package and all sub-packages.

TestSuiteBuilder includePackages(String... packageNames)

Include all tests that satisfy the requirements in the given packages and all sub-packages, unless otherwise specified.

TestSuiteBuilder named(String newSuiteName)

Override the default name for the suite being built.

Protected methods

String getSuiteName()

Subclasses use this method to determine the name of the suite.

Inherited methods

Public constructors

TestSuiteBuilder

public TestSuiteBuilder (Class clazz)

The given name is automatically prefixed with the package containing the tests to be run. If more than one package is specified, the first is used.

Parameters
clazz Class: Use the class from your .apk. Use the class name for the test suite name. Use the class' classloader in order to load classes for testing. This is needed when running in the emulator.

TestSuiteBuilder

public TestSuiteBuilder (String name, 
                ClassLoader classLoader)

Parameters
name String

classLoader ClassLoader

Public methods

build

public final TestSuite build ()

Call this method once you've configured your builder as desired.

Returns
TestSuite The suite containing the requested tests.

excludePackages

public TestSuiteBuilder excludePackages (String... packageNames)

Exclude all tests in the given packages and all sub-packages, unless otherwise specified.

Parameters
packageNames String: Names of packages to remove.

Returns
TestSuiteBuilder The builder for method chaining.

includeAllPackagesUnderHere

public final TestSuiteBuilder includeAllPackagesUnderHere ()

Include all junit tests that satisfy the requirements in the calling class' package and all sub-packages.

Returns
TestSuiteBuilder The builder for method chaining.

includePackages

public TestSuiteBuilder includePackages (String... packageNames)

Include all tests that satisfy the requirements in the given packages and all sub-packages, unless otherwise specified.

Parameters
packageNames String: Names of packages to add.

Returns
TestSuiteBuilder The builder for method chaining.

named

public TestSuiteBuilder named (String newSuiteName)

Override the default name for the suite being built. This should generally be called if you call addRequirements(com.android.internal.util.Predicate[]) to make it clear which tests will be included. The name you specify is automatically prefixed with the package containing the tests to be run. If more than one package is specified, the first is used.

Parameters
newSuiteName String: Prefix of name to give the suite being built.

Returns
TestSuiteBuilder The builder for method chaining.

Protected methods

getSuiteName

protected String getSuiteName ()

Subclasses use this method to determine the name of the suite.

Returns
String The package and suite name combined.