public class

CoverageListener

extends InstrumentationRunListener

 java.lang.Object

↳RunListener

androidx.test.internal.runner.listener.InstrumentationRunListener

↳androidx.test.internal.runner.listener.CoverageListener

Gradle dependencies

compile group: 'androidx.test', name: 'runner', version: '1.6.2'

  • groupId: androidx.test
  • artifactId: runner
  • version: 1.6.2

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

Androidx artifact mapping:

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

Overview

A test that generates EMMA code coverage.

Summary

Constructors
publicCoverageListener(java.lang.String customCoverageFilePath)

Constructor.

publicCoverageListener(java.lang.String customCoverageFilePath, PlatformTestStorage runnerIO)

Constructor.

Methods
public voidinstrumentationRunFinished(java.io.PrintStream streamResult, Bundle resultBundle, Result junitResults)

Optional callback subclasses can implement.

public voidsetInstrumentation(Instrumentation instr)

Passes in the instrumentation instance, and initializes the test storage service if it's available on the device.

from InstrumentationRunListenergetInstrumentation, sendStatus, sendString
from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors

public CoverageListener(java.lang.String customCoverageFilePath)

Constructor.

By default, we assume that the test storage is not available.

Parameters:

customCoverageFilePath: an optional user specified path for the coverage file. Can be null.

public CoverageListener(java.lang.String customCoverageFilePath, PlatformTestStorage runnerIO)

Constructor.

Parameters:

customCoverageFilePath: an optional user specified path for the coverage file. Can be null.
runnerIO: the RunnerIO to dump coverage data onto the device.

Methods

public void setInstrumentation(Instrumentation instr)

Passes in the instrumentation instance, and initializes the test storage service if it's available on the device.

Parameters:

instr: the instrumentation instance. Must not be null.

public void instrumentationRunFinished(java.io.PrintStream streamResult, Bundle resultBundle, Result junitResults)

Optional callback subclasses can implement. Will be called when instrumentation run completes.

Parameters:

streamResult: the java.io.PrintStream to instrumentation out. Will be displayed even when instrumentation not run in -r mode
resultBundle: the instrumentation result bundle. Can be used to inject key-value pairs into the instrumentation output when run in -r/raw mode
junitResults: the test results

Source

/*
 * Copyright (C) 2012 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.internal.runner.listener;

import android.app.Instrumentation;
import android.os.Bundle;
import androidx.annotation.Nullable;
import androidx.annotation.VisibleForTesting;
import androidx.test.internal.runner.coverage.InstrumentationCoverageReporter;
import androidx.test.platform.io.PlatformTestStorage;
import androidx.test.platform.io.PlatformTestStorageRegistry;
import java.io.PrintStream;
import org.junit.runner.Result;

/** A test {@link org.junit.runner.notification.RunListener} that generates EMMA code coverage. */
public class CoverageListener extends InstrumentationRunListener {
  private final String coverageFilePath;
  private PlatformTestStorage runnerIO;
  private InstrumentationCoverageReporter coverageReporter;

  /**
   * If included in the status or final bundle sent to an IInstrumentationWatcher, this key
   * identifies the path to the generated code coverage file.
   */
  private static final String REPORT_KEY_COVERAGE_PATH = "coverageFilePath";

  /**
   * Constructor.
   *
   * <p>By default, we assume that the test storage is not available.
   *
   * @param customCoverageFilePath an optional user specified path for the coverage file. Can be
   *     {@code null}.
   */
  public CoverageListener(@Nullable String customCoverageFilePath) {
    this(customCoverageFilePath, PlatformTestStorageRegistry.getInstance());
  }

  /**
   * Constructor.
   *
   * @param customCoverageFilePath an optional user specified path for the coverage file. Can be
   *     {@code null}.
   * @param runnerIO the {@code RunnerIO} to dump coverage data onto the device.
   */
  public CoverageListener(@Nullable String customCoverageFilePath, PlatformTestStorage runnerIO) {
    coverageFilePath = customCoverageFilePath;
    this.runnerIO = runnerIO;
  }

  @VisibleForTesting
  CoverageListener(
      @Nullable String customCoverageFilePath, InstrumentationCoverageReporter coverageReporter) {
    this.coverageFilePath = customCoverageFilePath;
    this.coverageReporter = coverageReporter;
  }

  /**
   * Passes in the instrumentation instance, and initializes the test storage service if it's
   * available on the device.
   *
   * @param instr the instrumentation instance. Must not be {@code null}.
   */
  @Override
  public void setInstrumentation(Instrumentation instr) {
    super.setInstrumentation(instr);
    // Initializes the coverage reporter.
    coverageReporter = new InstrumentationCoverageReporter(getInstrumentation(), runnerIO);
  }

  @Override
  public void instrumentationRunFinished(
      PrintStream streamResult, Bundle resultBundle, Result junitResults) {
    String actualCoveragePath =
        coverageReporter.generateCoverageReport(coverageFilePath, streamResult);
    resultBundle.putString(REPORT_KEY_COVERAGE_PATH, actualCoveragePath);
  }
}