本頁面由 Cloud Translation API 翻譯而成。

測試調用

public class TestInvocation
extends Object implements ITestInvocation

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

ITestInvocation的默認實現。

基於IConfiguration加載主要對象 - 檢索構建 - 準備目標 - 運行測試 - 報告結果

概括

字段
`public static final String`	`COMMAND_ARGS_KEY` 命令行 args 屬性的鍵
`public static final String`	`INVOCATION_EXTERNAL_DEPENDENCIES`
`public static final String`	`TRADEFED_CONFIG_NAME`
`public static final String`	`TRADEFED_END_HOST_LOG`
`public static final String`	`TRADEFED_INVOC_COMPLETE_HOST_LOG`
`public static final String`	`TRADEFED_LOG_NAME`

公共構造函數
`TestInvocation ()`

公共方法
`static IBuildInfo`	`backFillBuildInfoForReporting (String commandLine)` 使用命令行回填`IBuildInfo`以在下載失敗時報告的幫助程序。
`static FailureDescription`	`createFailureFromException (Throwable exception, TestRecordProto.FailureStatus defaultStatus)` 從調用異常創建`FailureDescription` 。
`IInvocationExecution`	`createInvocationExec ( TestInvocation.RunMode mode)` 創建應遵循的調用路徑。
`static String`	`getDeviceLogName ( TestInvocation.Stage stage)`
`static String`	`getEmulatorLogName ( TestInvocation.Stage stage)`
`ITestInvocation.ExitInformation`	`getExitInfo ()` 給定調用的退出信息。
`void`	`invoke ( IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` 執行測試調用。
`static boolean`	`isSubprocess ( IConfiguration config)` 如果調用當前在子流程範圍內，則返回 true。
`void`	`notifyInvocationForceStopped (String message, ErrorIdentifier errorId)` 通知`TestInvocation`已請求 TradeFed 停止。
`void`	`notifyInvocationStopped (String message)` 通知`TestInvocation` TradeFed 最終將關閉。
`static void`	`printStageDelimiter ( TestInvocation.Stage phase, boolean end)` 打印給定調用階段的分隔符。
`void`	`registerExecutionFiles ( ExecutionFiles executionFiles)`
`String`	`toString ()`

受保護的方法
`void`	`addInvocationMetric ( InvocationMetricLogger.InvocationMetricKey key, String value)`
`void`	`addInvocationMetric ( InvocationMetricLogger.InvocationMetricKey key, long value)`
`void`	`applyAutomatedReporters ( IConfiguration config)`
`void`	`setExitCode ( CommandRunner.ExitCode code, Throwable stack)` 幫助設置退出代碼。

字段

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

命令行 args 屬性的鍵

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

公共構造函數

測試調用

public TestInvocation ()

公共方法

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

使用命令行回填IBuildInfo以在下載失敗時報告的幫助程序。

參數
`commandLine`	`String`

退貨
`IBuildInfo`

createFailureFromException 異常

public static FailureDescription createFailureFromException (Throwable exception, 
                TestRecordProto.FailureStatus defaultStatus)

從調用異常創建FailureDescription 。

參數
`exception`	`Throwable` ：要轉換的異常
`defaultStatus`	`TestRecordProto.FailureStatus` ：如果異常不是`IHarnessException`則默認使用的狀態。

退貨
`FailureDescription`

創建InvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

創建應遵循的調用路徑。

參數
`mode`	`TestInvocation.RunMode` ：我們當前運行的模式。

退貨
`IInvocationExecution`	描述調用的`IInvocationExecution` 。

獲取設備日誌名稱

public static String getDeviceLogName (TestInvocation.Stage stage)

參數
`stage`	`TestInvocation.Stage`

退貨
`String`

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

參數
`stage`	`TestInvocation.Stage`

退貨
`String`

獲取退出信息

public ITestInvocation.ExitInformation getExitInfo ()

給定調用的退出信息。

退貨
`ITestInvocation.ExitInformation`

調用

public void invoke (IInvocationContext context, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener... extraListeners)

執行測試調用。

參數
`context`	`IInvocationContext` ：執行測試的`IInvocationContext` 。
`config`	`IConfiguration` ：本次測試運行的`IConfiguration` 。
`rescheduler`	`IRescheduler` ： `IRescheduler` ，用於重新安排調用的一部分以在另一個資源上執行
`extraListeners`	`ITestInvocationListener` ：要通知的`ITestInvocationListener` s，除了`config`中的那些

投擲
`DeviceNotAvailableException`

是子進程

public static boolean isSubprocess (IConfiguration config)

如果調用當前在子流程範圍內，則返回 true。

參數
`config`	`IConfiguration`

退貨
`boolean`

通知調用強制停止

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

通知TestInvocation已請求 TradeFed 停止。

參數
`message`	`String` ：與停止調用關聯的消息
`errorId`	`ErrorIdentifier` ：與強制停止關聯的標識符

通知調用停止

public void notifyInvocationStopped (String message)

通知TestInvocation TradeFed 最終將關閉。

參數
`message`	`String` ：與停止調用關聯的消息

打印階段定界符

public static void printStageDelimiter (TestInvocation.Stage phase, 
                boolean end)

打印給定調用階段的分隔符。

參數
`phase`	`TestInvocation.Stage`
`end`	`boolean`

註冊執行文件

public void registerExecutionFiles (ExecutionFiles executionFiles)

參數
`executionFiles`	`ExecutionFiles`

到字符串

public String toString ()

退貨
`String`

受保護的方法

添加調用指標

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                String value)

參數
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`String`

添加調用指標

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                long value)

參數
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`long`

申請自動記者

protected void applyAutomatedReporters (IConfiguration config)

參數
`config`	`IConfiguration`

設置退出代碼

protected void setExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

幫助設置退出代碼。暴露測試。

參數
`code`	`CommandRunner.ExitCode`
`stack`	`Throwable`