TestInformation

public class TestInformation
extends Object

java.lang.Object
   ↳ com.android.tradefed.invoker.TestInformation

包含测试运行程序或测试可能需要正确执行的所有信息和依赖项的 Holder 对象。

摘要

嵌套类

class TestInformation.Builder

用于创建 TestInformation 实例的构建器。 

公共方法

static TestInformation createCopyTestInfo(TestInformation invocationInfo, IInvocationContext context)

创建具有复制的 ExecutionFiles 的 TestInformation。

static TestInformation createModuleTestInfo(TestInformation invocationInfo, IInvocationContext moduleContext)

创建表示模块而非调用的 TestInformation。

File dependenciesFolder()

返回存储调用的所有依赖项的文件夹。

ExecutionFiles executionFiles()

返回在调用执行期间生成的文件。

IBuildInfo getBuildInfo()

返回主设备 build 信息。

IInvocationContext getContext()

返回当前调用上下文，如果这是模块，则返回模块上下文。

File getDependencyFile(String fileName, boolean targetFirst)

根据依赖项/制品文件的名称以及它是目标文件还是宿主文件（以便更快地搜索）来搜索该文件。

ITestDevice getDevice()

返回被测主设备。

List<ITestDevice> getDevices()

返回调用中包含的设备列表。

boolean isTestTimedOut()

返回测试是否已获知超时。

static TestInformation.Builder newBuilder()

创建用于创建 TestInformation 实例的构建器。

void notifyTimeout()

通知已针对相应测试触发测试阶段超时。

ExecutionProperties properties()

返回在调用执行期间生成的属性。

final void setActiveDeviceIndex(int index)

自动化测试框架内部方法，用于切换 getDevice() 默认返回的设备。

公共方法

createCopyTestInfo

public static TestInformation createCopyTestInfo (TestInformation invocationInfo, 
                IInvocationContext context)

创建具有复制的 ExecutionFiles 的 TestInformation。

参数
invocationInfo TestInformation

context IInvocationContext

返回
TestInformation

createModuleTestInfo

public static TestInformation createModuleTestInfo (TestInformation invocationInfo, 
                IInvocationContext moduleContext)

创建表示模块（而非调用）的 TestInformation。

参数
invocationInfo TestInformation

moduleContext IInvocationContext

返回
TestInformation

dependenciesFolder

public File dependenciesFolder ()

返回存储调用的所有依赖项的文件夹。

返回
File

执行文件

public ExecutionFiles executionFiles ()

返回在调用执行期间生成的文件。建议通过 ExecutionFiles 传递文件，以便在 target_preparer 和测试之间提供文件。

返回
ExecutionFiles

getBuildInfo

public IBuildInfo getBuildInfo ()

返回主设备 build 信息。

返回
IBuildInfo

getContext

public IInvocationContext getContext ()

返回当前调用上下文，如果这是模块，则返回模块上下文。

返回
IInvocationContext

getDependencyFile

public File getDependencyFile (String fileName, 
                boolean targetFirst)

根据依赖项/制品文件的名称以及它是目标文件还是宿主文件（以便更快地搜索）来搜索该文件。

参数
fileName String：我们要查找的文件的名称。
targetFirst boolean：在搜索时，我们是否倾向于使用目标端文件而非宿主端文件。
返回
File 找到的制品文件。
抛出
FileNotFoundException 如果找不到文件。

getDevice

public ITestDevice getDevice ()

返回被测主设备。

返回
ITestDevice

getDevices

public List<ITestDevice> getDevices ()

返回调用中包含的设备列表。

返回
List<ITestDevice>

isTestTimedOut

public boolean isTestTimedOut ()

返回测试是否已获知超时。

返回
boolean

newBuilder

public static TestInformation.Builder newBuilder ()

创建用于创建 TestInformation 实例的构建器。

返回
TestInformation.Builder

notifyTimeout

public void notifyTimeout ()

通知相应测试的测试阶段超时已触发。

属性

public ExecutionProperties properties ()

返回在调用执行期间生成的属性。建议通过 ExecutionProperties 传递值和信息，以在 target_preparer 和测试之间交换信息。

返回
ExecutionProperties

setActiveDeviceIndex

public final void setActiveDeviceIndex (int index)

自动化测试框架内部方法，用于切换 getDevice() 默认返回的设备。始终重置为 0。

参数
index int