Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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

InvocationExecution

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

DelegatedInvocationExecution	`InvocationExecution` uỷ quyền thực thi cho một tệp nhị phân Tradefed khác.
ParentSandboxInvocationExecution	Phiên bản `InvocationExecution` cho các thao tác đặc biệt của lệnh gọi gốc khi chạy hộp cát.
RemoteInvocationExecution	Triển khai `InvocationExecution` để thực thi từ xa.
SandboxedInvocationExecution	Thực thi hộp cát đặc biệt của lệnh gọi: Đây là InvocationExection khi chúng ta ở bên trong hộp cát đang chạy lệnh.

Lớp mô tả tất cả các bước gọi: tải bản dựng xuống, target_prep, chạy kiểm thử, dọn dẹp. Có thể 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.

Tóm tắt

Trường
`public static final String`	`ADB_VERSION_KEY`
`public static final String`	`JAVA_CLASSPATH_KEY`
`public static final String`	`JAVA_VERSION_KEY`

Hàm khởi tạo công khai
`InvocationExecution()`

Phương thức công khai
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Thực thi bước dọn dẹp build_provider.
`void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Thực thi bước cleanUp của target_preparer và multi_target_preparer.
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` Thực thi bước setUp target_preparer và multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Thực thi bước tháo dỡ target_preparer và multi_target_preparer.
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Thực thi bước build_provider của lệnh 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ị trong lệnh 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ị trong lệnh gọi.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Chạy kiểm thử.
`boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Cố gắng phân đoạn 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 thức đượ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 đang được kiểm thử.
`IShardHelper`	`createShardHelper()` Tạo một hàm trả về `IShardHelper` để sử dụng.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Cung cấp cơ hội tuỳ chỉnh một số thiết bị trước khi preInvocationSetup.
`String`	`getAdbVersion()` Trả về phiên bản adb đang được sử dụng cho lệnh gọi.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Truy xuất danh sách trình 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 trình chuẩn bị mục tiêu để chạy trên thiết bị này.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`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)`
`void`	`setTestTag(IBuildInfo info, IConfiguration config)` Xử lý việc đặt thẻ kiểm thử trên thông tin bản dựng.

Trường

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

Hàm khởi tạo công khai

InvocationExecution

public InvocationExecution ()

Phương thức công khai

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

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

Tham số
`context`	`IInvocationContext`: `IInvocationContext` của lệnh gọi.
`config`	`IConfiguration`: `IConfiguration` của lần chạy kiểm thử này.

doCleanUp

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

Thực thi bước cleanUp của target_preparer và multi_target_preparer. Thiết bị có dọn dẹp không.

Tham số
`context`	`IInvocationContext`: `IInvocationContext` của lệnh gọi.
`config`	`IConfiguration`: `IConfiguration` của lần chạy kiểm thử này.
`exception`	`Throwable`: ngoại lệ ban đầu do quá trình kiểm thử đang chạy gửi.

doSetup

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

Thực thi bước setUp target_preparer và multi_target_preparer. Tất cả các thiết bị có được thiết lập theo yêu cầu để chạy kiểm thử không.

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

Gửi
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

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

Thực thi bước tháo dỡ target_preparer và multi_target_preparer. Các thiết bị có bị huỷ liên kết với chế độ thiết lập không.

Tham số
`testInfo`	`TestInformation`: `TestInformation` của lệnh gọi.
`config`	`IConfiguration`: `IConfiguration` của lần chạy kiểm thử này.
`logger`	`ITestLogger`: `ITestLogger` để báo cáo nhật ký.
`exception`	`Throwable`: ngoại lệ ban đầu do quá trình kiểm thử đang chạy gửi.

fetchBuild

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

Thực thi bước build_provider của lệnh gọi.

Tham số
`testInfo`	`TestInformation`: `TestInformation` của lệnh gọi.
`config`	`IConfiguration`: `IConfiguration` của lần chạy kiểm thử 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.

Giá trị trả về
`boolean`	True nếu chúng ta tải bản dựng xuống thành công, false nếu không.

Gửi
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

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.

Tham số
`device`	`ITestDevice`: Thiết bị báo cáo nhật ký.
`listener`	`ITestLogger`: Trình ghi nhật ký cho nhật ký.
`stage`	`TestInvocation.Stage`: Giai đoạn của lệnh 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ị trong lệnh gọi.

Tham số
`context`	`IInvocationContext`: `IInvocationContext` của lệnh gọi.
`config`	`IConfiguration`: `IConfiguration` của lần chạy kiểm thử này.
`exception`	`Throwable`: ngoại lệ ban đầu do quá trình kiểm thử đang chạy gửi ra (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ị trong lệnh gọi.

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

Gửi
`DeviceNotAvailableException`
`TargetSetupError`

runTests

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

Chạy kiểm thử.

Tham số
`info`	`TestInformation`: `TestInformation` để chạy kiểm thử.
`config`	`IConfiguration`: `IConfiguration` cần chạy
`listener`	`ITestInvocationListener`: `ITestInvocationListener` của kết quả kiểm thử

shardConfig

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

Cố gắng phân đoạn 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 mảnh lớn hơn 1, thì chỉ cần tạo cấu hình cho từng phân mảnh bằng cách đặt chỉ mục phân mảnh và lên lịch lại các phân mảnh đó. Nếu bạn không đặt số lượng phân đoạn,thì số lượng này sẽ được đặt về giá trị mặc định là IShardHelper.shardConfig.

Tham số
`config`	`IConfiguration`: `IConfiguration` hiện tại.
`testInfo`	`TestInformation`: `TestInformation` lưu giữ thông tin về các bài kiểm thử.
`rescheduler`	`IRescheduler`: `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` dùng để ghi nhật ký tệp trong quá trình phân đoạn.

Giá trị trả về
`boolean`	true nếu kiểm thử được phân đoạn. Nếu không, hãy trả về `false`

Phương thức được bảo vệ

collectAutoInfo

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 đang được kiểm thử.

Tham số
`config`	`IConfiguration`
`info`	`TestInformation`

Gửi
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Tạo một hàm trả về IShardHelper để sử dụng.

Giá trị trả về
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Cung cấp cơ hội tuỳ chỉnh một số thiết bị trước khi preInvocationSetup.

Tham số
`config`	`IConfiguration`: Cấu hình của lệnh gọi.
`context`	`IInvocationContext`: Ngữ cảnh gọi hiện tại.

getAdbVersion

protected String getAdbVersion ()

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

Giá trị trả về
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

Được ghi đè trong các lớp hộp cát để hạn chế việc chạy trình chuẩn bị phòng thí nghiệm bên trong hộp cát con

Tham số
`config`	`IConfiguration`
`deviceName`	`String`

Giá trị trả về

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

Được ghi đè trong các lớp hộp cát để hạn chế trình chuẩn bị phòng thí nghiệm chạy bên trong hộp cát con

Tham số
`config`	`IConfiguration`
`deviceName`	`String`

Giá trị trả về

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Tham số
`info`	`IBuildInfo`
`testInfo`	`TestInformation`

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

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

Tham số
`config`	`IConfiguration`
`logger`	`ITestLogger`

runPreparersTearDown

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

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

Giá trị trả về
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

Tham số
`info`	`IBuildInfo`
`config`	`IConfiguration`