public final class

PackagePrefixClasspathSuite

extends Suite

 java.lang.Object

↳Suite

↳androidx.test.runner.suites.PackagePrefixClasspathSuite

Gradle dependencies

compile group: 'androidx.test', name: 'runner', version: '1.5.0-alpha03'

  • groupId: androidx.test
  • artifactId: runner
  • version: 1.5.0-alpha03

Artifact androidx.test:runner:1.5.0-alpha03 it located at Google repository (https://maven.google.com/)

Androidx artifact mapping:

androidx.test:runner com.android.support.test:runner

Overview

An alternative to AndroidClasspathSuite that ignores classes whose java package is not within the current class's java package.

Example usage: * *

 package com.example.foo;

  @RunWith(PackagePrefixClasspathSuite.class)
 public class AllTests {
 }
 

This class was intended for large applications using AndroidClasspathSuite results in LinearAlloc errors (b/36936369) and performance overhead when scanning the entire classpath.

This API is currently experimental and subject to change in future releases.

Summary

Constructors
publicPackagePrefixClasspathSuite(java.lang.Class<java.lang.Object> klass, RunnerBuilder builder)

Only called reflectively.

Methods
from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors

public PackagePrefixClasspathSuite(java.lang.Class<java.lang.Object> klass, RunnerBuilder builder)

Only called reflectively. Do not use programmatically.

Source

/*
 * Copyright (C) 2021 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package androidx.test.runner.suites;

import static androidx.test.internal.runner.ClassPathScanner.getDefaultClasspaths;
import static androidx.test.platform.app.InstrumentationRegistry.getInstrumentation;

import androidx.annotation.RestrictTo;
import androidx.annotation.RestrictTo.Scope;
import androidx.test.annotation.ExperimentalTestApi;
import androidx.test.internal.runner.ClassPathScanner;
import androidx.test.internal.runner.ClassPathScanner.ChainedClassNameFilter;
import androidx.test.internal.runner.ClassPathScanner.ExternalClassNameFilter;
import androidx.test.internal.runner.ClassPathScanner.InclusivePackageNamesFilter;
import androidx.test.internal.runner.ErrorReportingRunner;
import androidx.test.internal.runner.TestLoader;
import java.io.IOException;
import java.util.Arrays;
import java.util.Collection;
import java.util.List;
import org.junit.runner.Runner;
import org.junit.runners.Suite;
import org.junit.runners.model.InitializationError;
import org.junit.runners.model.RunnerBuilder;

/**
 * An alternative to {@link AndroidClasspathSuite} that ignores classes whose java package is not
 * within the current class's java package.
 *
 * <p>Example usage: * *
 *
 * <pre>
 * package com.example.foo;
 *
 * {@literal @}RunWith(PackagePrefixClasspathSuite.class)
 * public class AllTests {
 * }
 * </pre>
 *
 * <p>This class was intended for large applications using {@link AndroidClasspathSuite} results in
 * LinearAlloc errors (b/36936369) and performance overhead when scanning the entire classpath.
 *
 * <p>This API is currently experimental and subject to change in future releases.
 */
@ExperimentalTestApi
public final class PackagePrefixClasspathSuite extends Suite {

  /**
   * Only called reflectively. Do not use programmatically.
   *
   * @hide
   */
  @RestrictTo(Scope.LIBRARY)
  public PackagePrefixClasspathSuite(Class<?> klass, RunnerBuilder builder)
      throws InitializationError {
    super(klass, getRunnersForClasses(klass, builder));
  }

  private static List<Runner> getRunnersForClasses(Class<?> klass, RunnerBuilder builder) {
    try {
      ChainedClassNameFilter filter = new ChainedClassNameFilter();
      filter.add(new InclusivePackageNamesFilter(Arrays.asList(klass.getPackage().getName())));
      filter.add(new ExternalClassNameFilter());
      Collection<String> classNames =
          new ClassPathScanner(getDefaultClasspaths(getInstrumentation()))
              .getClassPathEntries(filter);
      classNames.remove(klass.getName());
      return TestLoader.Factory.create(null, builder, true).getRunnersFor(classNames);
    } catch (IOException e) {
      return Arrays.asList(
          new ErrorReportingRunner(
              getInstrumentation().getContext().getPackageName(),
              new RuntimeException(
                  "Failed to perform classpath scanning to determine tests to run", e)));
    }
  }
}