2d86c7a4c7
Bug: 30188076 Test: m -j20 RUN_ERROR_PRONE=true android.test.base android.test.runner Change-Id: I735e3fbfcc710f1dc1b96e04f91b9feda8727b6c
72 lines
2.5 KiB
Java
72 lines
2.5 KiB
Java
/*
|
|
* Copyright (C) 2006 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 android.test;
|
|
|
|
/**
|
|
* More complex interface performance for test cases.
|
|
*
|
|
* If you want your test to be used as a performance test, you must
|
|
* implement this interface.
|
|
*
|
|
* @deprecated Use
|
|
* <a href="{@docRoot}reference/android/support/test/runner/AndroidJUnitRunner.html">
|
|
* AndroidJUnitRunner</a> instead. New tests should be written using the
|
|
* <a href="{@docRoot}tools/testing-support-library/index.html">Android Testing Support Library</a>.
|
|
*/
|
|
@Deprecated
|
|
public interface PerformanceTestCase
|
|
{
|
|
/**
|
|
* Callbacks for {@link PerformanceTestCase}.
|
|
*/
|
|
public interface Intermediates
|
|
{
|
|
void setInternalIterations(int count);
|
|
void startTiming(boolean realTime);
|
|
void addIntermediate(String name);
|
|
void addIntermediate(String name, long timeInNS);
|
|
void finishTiming(boolean realTime);
|
|
}
|
|
|
|
/**
|
|
* Set up to begin performance tests. The 'intermediates' is a
|
|
* communication channel to send back intermediate performance numbers --
|
|
* if you use it, you will probably want to ensure your test is only
|
|
* executed once by returning 1. Otherwise, return 0 to allow the test
|
|
* harness to decide the number of iterations.
|
|
*
|
|
* <p>If you return a non-zero iteration count, you should call
|
|
* {@link Intermediates#startTiming intermediates.startTiming} and
|
|
* {@link Intermediates#finishTiming intermediates.endTiming} to report the
|
|
* duration of the test whose performance should actually be measured.
|
|
*
|
|
* @param intermediates Callback for sending intermediate results.
|
|
*
|
|
* @return int Maximum number of iterations to run, or 0 to let the caller
|
|
* decide.
|
|
*/
|
|
int startPerformance(Intermediates intermediates);
|
|
|
|
/**
|
|
* This method is used to determine what modes this test case can run in.
|
|
*
|
|
* @return true if this test case can only be run in performance mode.
|
|
*/
|
|
boolean isPerformanceOnly();
|
|
}
|
|
|