Trang này được dịch bởi Cloud Translation API.

Yêu cầuThực hiện

public class InvocationExecution
extends Object implements IInvocationExecution

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

Các lớp con trực tiếp đã biết

DelegatedInvocationExecution , ParentSandboxInvocationExecution , RemoteInvocationExecution , SandboxedInvocationExecution

Thực thi yêu cầu được ủy quyền	`InvocationExecution` ủy thác việc thực thi cho một mã nhị phân Tradefed khác.
ParentSandboxInvocationExecution	Phiên bản của `InvocationExecution` cho các hành động đặc biệt của lệnh gọi gốc khi chạy hộp cát.
Gọi từ xaThực thi	Triển khai `InvocationExecution` thúc đẩy thực thi từ xa.
SandboxedYêu cầuThực thi	Thực thi lệnh gọi trong hộp cát đặc biệt: Đây là Lệnh gọi được thực hiện khi chúng ta ở trong hộp cát chạy lệnh.

Lớp mô tả tất cả các bước gọi: tải xuống bản dựng, target_prep, chạy thử nghiệm, dọn dẹp. Có thể được mở rộng để ghi đè hành vi mặc định của một số bước. Thứ tự của các bước được điều khiển bởi TestInvocation .

Bản tóm tắt

Lĩnh vực
`public static final String`	`ADB_VERSION_KEY`
`public static final String`	`JAVA_CLASSPATH_KEY`
`public static final String`	`JAVA_VERSION_KEY`

nhà thầu công cộng
`InvocationExecution ()`

Phương thức công khai
`void`	`cleanUpBuilds ( IInvocationContext context, IConfiguration config)` Thực hiện bước dọn dẹp build_provider.
`void`	`doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception)` Thực hiện bước dọn dẹp target_preparer và multi_target_preparer.
`void`	`doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener)` Thực hiện bước thiết lập target_preparer và multi_target_preparer.
`void`	`doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Thực hiện bước chia nhỏ target_preparer và multi_target_preparer.
`boolean`	`fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Thực hiện bước build_provider của lời gọi.
`void`	`reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` Báo cáo một số nhật ký thiết bị ở các giai đoạn khác nhau của lệnh gọi.
`void`	`runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception)` Gọi `ITestDevice#postInvocationTearDown(Throwable)` cho từng phần thiết bị của lời gọi.
`void`	`runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger)` Gọi `ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo))` cho từng phần thiết bị của lệnh gọi.
`void`	`runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener)` Chạy thử nghiệm.
`boolean`	`shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Cố gắng phân chia cấu hình thành các cấu hình phụ, được lên lịch lại để chạy song song trên nhiều tài nguyên.

phương pháp được bảo vệ
`void`	`collectAutoInfo ( IConfiguration config, TestInformation info)` Tự động thu thập một số thông tin trên thiết bị chính được kiểm tra.
`IShardHelper`	`createShardHelper ()` Tạo một `IShardHelper` trả về sẽ được sử dụng.
`void`	`customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)` Tạo cơ hội tùy chỉnh một số thiết bị trước khi cài đặt trước.
`String`	`getAdbVersion ()` Trả về phiên bản adb được sử dụng cho lời gọi.
	`getLabPreparersToRun ( IConfiguration config, String deviceName)` Truy xuất danh sách người chuẩn bị phòng thí nghiệm để chạy trên thiết bị này.
	`getTargetPreparersToRun ( IConfiguration config, String deviceName)` Truy xuất danh sách người chuẩn bị mục tiêu để chạy trên thiết bị này.
`void`	`logHostAdb ( IConfiguration config, ITestLogger logger)` Thu thập nhật ký từ $TMPDIR/adb.$UID.log.
`Throwable`	`runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)` `runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)` `runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)`
`void`	`setTestTag ( IBuildInfo info, IConfiguration config)` Xử lý cài đặt thẻ kiểm tra trên thông tin bản dựng.

Lĩnh vực

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

Java_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Java_VERSION_KEY

public static final String JAVA_VERSION_KEY

nhà thầu công cộng

Yêu cầuThực hiện

public InvocationExecution ()

Phương thức công khai

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Thực hiện bước dọn dẹp build_provider. Được liên kết với quá trình tìm nạp bản dựng.

Thông số
`context`	`IInvocationContext` : `IInvocationContext` của lời gọi.
`config`	`IConfiguration` : `IConfiguration` của lần chạy thử nghiệm này.

làmCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Thực hiện bước dọn dẹp target_preparer và multi_target_preparer. Các thiết bị có dọn dẹp không.

Thông số
`context`	`IInvocationContext` : `IInvocationContext` của lời gọi.
`config`	`IConfiguration` : `IConfiguration` của lần chạy thử nghiệm này.
`exception`	`Throwable` : ngoại lệ ban đầu được ném ra bởi quá trình chạy thử nghiệm.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

Thực hiện bước thiết lập target_preparer và multi_target_preparer. Tất cả thiết lập thiết bị cần thiết để chạy thử nghiệm.

Thông số
`testInfo`	`TestInformation` : `TestInformation` của lệnh gọi.
`config`	`IConfiguration` : `IConfiguration` của lần chạy thử nghiệm này.
`listener`	`ITestLogger` : `ITestLogger` để báo cáo nhật ký lỗi thiết lập.

ném
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Thực hiện bước chia nhỏ target_preparer và multi_target_preparer. Các thiết bị có bị hỏng liên quan đến thiết lập không.

Thông số
`testInfo`	`TestInformation` : `TestInformation` của lệnh gọi.
`config`	`IConfiguration` : `IConfiguration` của lần chạy thử nghiệm này.
`logger`	`ITestLogger` : `ITestLogger` để báo cáo nhật ký.
`exception`	`Throwable` : ngoại lệ ban đầu được ném ra bởi quá trình chạy thử nghiệm.

tìm nạpBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Thực hiện bước build_provider của lời gọi.

Thông số
`testInfo`	`TestInformation` : `TestInformation` của lệnh gọi.
`config`	`IConfiguration` : `IConfiguration` của lần chạy thử nghiệm này.
`rescheduler`	`IRescheduler` : `IRescheduler` , để lên lịch lại các phần của lệnh gọi để thực thi trên (các) tài nguyên khác
`listener`	`ITestInvocationListener` : `ITestInvocation` để báo cáo lỗi tải xuống bản dựng.

trả lại
`boolean`	Đúng nếu chúng tôi đã tải xuống bản dựng thành công, sai nếu không.

ném
`BuildRetrievalError`
`DeviceNotAvailableException`

báo cáoNhật ký

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

Báo cáo một số nhật ký thiết bị ở các giai đoạn khác nhau của lệnh gọi. Ví dụ: logcat.

Thông số
`device`	`ITestDevice` : Thiết bị để báo cáo nhật ký.
`listener`	`ITestLogger` : Trình ghi nhật ký.
`stage`	`TestInvocation.Stage` : Giai đoạn gọi mà chúng ta đang ở.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Gọi ITestDevice#postInvocationTearDown(Throwable) cho từng phần thiết bị của lời gọi.

Thông số
`context`	`IInvocationContext` : `IInvocationContext` của lời gọi.
`config`	`IConfiguration` : `IConfiguration` của lần chạy thử nghiệm này.
`exception`	`Throwable` : ngoại lệ ban đầu được đưa ra bởi thử nghiệm đang chạy nếu có.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Gọi ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) cho từng phần thiết bị của lệnh gọi.

Thông số
`context`	`IInvocationContext` : `IInvocationContext` của lời gọi.
`config`	`IConfiguration` : `IConfiguration` của lần chạy thử nghiệm này.
`logger`	`ITestLogger` : `ITestLogger` để báo cáo nhật ký.

ném
`DeviceNotAvailableException`
`TargetSetupError`

chạy thử nghiệm

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Chạy thử nghiệm.

Thông số
`info`	`TestInformation` : `TestInformation` để chạy thử nghiệm.
`config`	`IConfiguration` : `IConfiguration` để chạy
`listener`	`ITestInvocationListener` : `ITestInvocationListener` của kết quả kiểm tra

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Cố gắng phân chia cấu hình thành các cấu hình phụ, được lên lịch lại để chạy song song trên nhiều tài nguyên.

Nếu số lượng phân đoạn lớn hơn 1, thì nó sẽ chỉ tạo cấu hình cho từng phân đoạn bằng cách đặt các chỉ số phân đoạn và lên lịch lại cho chúng. Nếu số lượng phân đoạn không được đặt, nó sẽ dự phòng thành IShardHelper#shardConfig .

Thông số
`config`	`IConfiguration` : `IConfiguration` hiện tại .
`testInfo`	`TestInformation` : `TestInformation` chứa thông tin của các bài kiểm tra.
`rescheduler`	`IRescheduler` : `IRescheduler` .
`logger`	`ITestLogger` : `ITestLogger` được sử dụng để ghi nhật ký tệp trong quá trình bảo vệ.

trả lại
`boolean`	đúng nếu thử nghiệm đã được phân mảnh. Nếu không thì trả về `false`

phương pháp được bảo vệ

thu thậpAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Tự động thu thập một số thông tin trên thiết bị chính được kiểm tra.

Thông số
`config`	`IConfiguration`
`info`	`TestInformation`

ném
`DeviceNotAvailableException`

tạoShardHelper

protected IShardHelper createShardHelper ()

Tạo một IShardHelper trả về sẽ được sử dụng.

trả lại
`IShardHelper`

tùy chỉnhDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Tạo cơ hội tùy chỉnh một số thiết bị trước khi cài đặt trước.

Thông số
`config`	`IConfiguration` : Cấu hình của lời gọi.
`context`	`IInvocationContext` : Bối cảnh gọi hiện tại.

getAdbVersion

protected String getAdbVersion ()

Trả về phiên bản adb được sử dụng cho lời gọi.

trả lại
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Truy xuất danh sách người chuẩn bị phòng thí nghiệm để chạy trên thiết bị này.

Ghi đè trong các lớp hộp cát để hạn chế người chuẩn bị phòng thí nghiệm chạy bên trong hộp cát con

Thông số
`config`	`IConfiguration`
`deviceName`	`String`

trả lại

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Truy xuất danh sách người chuẩn bị mục tiêu để chạy trên thiết bị này.

Ghi đè trong các lớp hộp cát để hạn chế người chuẩn bị phòng thí nghiệm chạy bên trong hộp cát con

Thông số
`config`	`IConfiguration`
`deviceName`	`String`

trả lại

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Thu thập nhật ký từ $TMPDIR/adb.$UID.log.

Thông số
`config`	`IConfiguration`
`logger`	`ITestLogger`

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

Thông số
`testInfo`	`TestInformation`
`device`	`ITestDevice`
`deviceName`	`String`
`deviceIndex`	`int`
`logger`	`ITestLogger`
`exception`	`Throwable`
`preparersToRun`
`trackPreparersMap`

trả lại
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Xử lý cài đặt thẻ kiểm tra trên thông tin bản dựng.

Thông số
`info`	`IBuildInfo`
`config`	`IConfiguration`