ITestFilterReceiver

public interface ITestFilterReceiver

com.android.tradefed.testtype.ITestFilterReceiver

Known indirect subclasses AndroidJUnitTest, ArtGTest, ArtRunTest, ArtTest, DeviceTestCase, ExecutableBaseTest, ExecutableHostTest, ExecutableTargetTest, GTest, GTestBase, GoogleBenchmarkTest, HostGTest, HostTest, IsolatedHostTest, JarHostTest, and 9 others. AndroidJUnitTest A Test that runs an instrumentation test package on given device using the android.support.test.runner.AndroidJUnitRunner.  ArtGTest   ArtRunTest A test runner to run ART run-tests.  ArtTest   DeviceTestCase Helper JUnit test case that provides the IRemoteTest and IDeviceTest services.  ExecutableBaseTest Base class for executable style of tests.  ExecutableHostTest Test runner for executable running on the host.  ExecutableTargetTest Test runner for executable running on the target.  GTest A Test that runs a native test package on given device.  GTestBase The base class of gTest  GoogleBenchmarkTest A Test that runs a Google benchmark test package on given device.  HostGTest A Test that runs a native test package.  HostTest A test runner for JUnit host based tests.  IsolatedHostTest Implements a TradeFed runner that uses a subprocess to execute the tests in a low-dependency environment instead of executing them on the main process.  JarHostTest Test runner for host-side JUnit tests.  KUnitModuleTest Test runner for running KUnit test modules on device.  KernelTargetTest Test runner for executable running on the target and parsing tesult of kernel test.  MoblyBinaryHostTest Host test meant to run a mobly python binary file from the Android Build system (Soong)  PtsBotTest Run PTS-bot tests.  PythonBinaryHostTest Host test meant to run a python binary file from the Android Build system (Soong) The test runner supports include-filter and exclude-filter.  RustBinaryHostTest Host test meant to run a rust binary file from the Android Build system (Soong)  RustBinaryTest A Test that runs a rust binary on given device.  RustTestBase Base class of RustBinaryHostTest and RustBinaryTest  UiAutomatorTest

---

A runner that can filter which tests to run.

A test will be run IFF it matches one or more of the include filters AND does not match any of the exclude filters. If no include filters are given all tests should be run as long as they do not match any of the exclude filters.

The format of the filters is defined by the runner, and could be structured as <package>, <package>.<class>, <package>.<class>#<method> or <native_name>. They can even be regexes.

Summary

Public methods
abstract void	addAllExcludeFilters(Set<String> filters) Adds the Set of filters of which tests to exclude.
abstract void	addAllIncludeFilters(Set<String> filters) Adds the Set of filters of which tests to include.
abstract void	addExcludeFilter(String filter) Adds a filter of which tests to exclude.
abstract void	addIncludeFilter(String filter) Adds a filter of which tests to include.
abstract void	clearExcludeFilters() Delete all the exclude filters currently tracked.
abstract void	clearIncludeFilters() Delete all the include filters currently tracked.
abstract Set<String>	getExcludeFilters() Returns the current Set of exclude filters.
abstract Set<String>	getIncludeFilters() Returns the current Set of include filters.

Public methods

addAllExcludeFilters

public abstract void addAllExcludeFilters (Set<String> filters)

Adds the Set of filters of which tests to exclude.

Parameters
filters	Set

addAllIncludeFilters

public abstract void addAllIncludeFilters (Set<String> filters)

Adds the Set of filters of which tests to include.

Parameters
filters	Set

addExcludeFilter

public abstract void addExcludeFilter (String filter)

Adds a filter of which tests to exclude.

Parameters
filter	String

addIncludeFilter

public abstract void addIncludeFilter (String filter)

Adds a filter of which tests to include.

Parameters
filter	String

clearExcludeFilters

public abstract void clearExcludeFilters ()

Delete all the exclude filters currently tracked.

clearIncludeFilters

public abstract void clearIncludeFilters ()

Delete all the include filters currently tracked.

getExcludeFilters

public abstract Set<String> getExcludeFilters ()

Returns the current Set of exclude filters.

Returns
Set<String>

getIncludeFilters

public abstract Set<String> getIncludeFilters ()

Returns the current Set of include filters.

Returns
Set<String>