IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Các lớp con gián tiếp đã biết DeleonedInvocationExecution , InvocationExecution , ParentSandboxInvocationExecution , RemoteInvocationExecution , SandboxedInvocationExecution DeleonedInvocationExecution InvocationExecution ủy quyền việc thực thi cho một tệp nhị phân Tradefed khác. InvocationExecution Lớp mô tả tất cả các bước gọi: tải xuống xây dựng, target_prep, chạy thử nghiệm, dọn dẹp. ParentSandboxInvocationExecution Phiên bản của InvocationExecution cho các hành động đặc biệt của lệnh gọi chính khi chạy hộp cát. RemoteInvocationExecution Triển khai InvocationExecution để thúc đẩy quá trình thực thi từ xa. SandboxedInvocationExecution Thực thi hộp cát đặc biệt của lời gọi: Đây là phần mời gọi khi chúng ta đang chạy lệnh bên trong hộp cát.

---

Giao diện mô tả các hành động sẽ được thực hiện như một phần của lời kêu gọi. Bản thân lệnh gọi TestInvocation đảm bảo thứ tự của các cuộc gọi.

Bản tóm tắt

Phương pháp công khai
default void	cleanUpBuilds ( IInvocationContext context, IConfiguration config) Thực hiện bước dọn dẹp build_provider.
default void	doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception) Thực hiện bước cleanUp target_preparer và multi_target_preparer.
default void	doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger logger) Thực hiện bước target_preparer và multi_target_preparer setUp.
default void	doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Thực hiện bước xé nhỏ target_preparer và multi_target_preparer.
default boolean	fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) Thực hiện bước build_provider của lời gọi.
abstract void	reportLogs ( ITestDevice device, ITestLogger logger, 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.
default void	runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception) Gọi ITestDevice#postInvocationTearDown(Throwable) cho mỗi phần thiết bị của lời gọi.
default void	runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) Gọi ra ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) cho mỗi phần thiết bị.
default void	runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener) Chạy thử nghiệm.
default boolean	shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) Cố gắng chia nhỏ cấu hình thành các cấu hình con, được lên lịch lại để chạy song song trên nhiều tài nguyên.

Phương pháp công khai

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Thực hiện bước dọn dẹp build_provider. Liên kết với tìm nạp bản dựng.

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

doCleanUp

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

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

Thông số
context	IInvocationContext : IInvocationContext của lời gọi.
config	IConfiguration : cấu hình 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 logger)

Thực hiện bước target_preparer và multi_target_preparer setUp. Có tất cả các thiết bị cần thiết để chạy thử nghiệm không.

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

Ném
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.targetprep.BuildError
DeviceNotAvailableException
BuildError
TargetSetupError

doTeardown

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

Thực hiện bước xé 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ời gọi.
config	IConfiguration : cấu hình 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.

Ném
Throwable

fetchBuild

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ời gọi.
config	IConfiguration : cấu hình 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ời 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.

Lợi nhuận
boolean	Đúng nếu chúng tôi tải xuống bản dựng thành công, ngược lại là sai.

Ném
	com.android.tradefed.build.BuildRetrievalError
DeviceNotAvailableException
BuildRetrievalError

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                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ý.
logger	ITestLogger : Trình ghi nhật ký.
stage	TestInvocation.Stage : Giai đoạn của lời kêu gọi mà chúng ta đang ở.

runDevicePostInvocationTearDown

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

Gọi ITestDevice#postInvocationTearDown(Throwable) cho mỗi 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 : cấu hình 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 nếu có.

runDevicePreInvocationSetup

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

Gọi ra ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) cho mỗi phần thiết bị.

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

Ném
	com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

runTests

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

Chạy thử nghiệm.

Thông số
info	TestInformation : TestInformation để chạy các thử nghiệm với.
config	IConfiguration : cấu hình IConfiguration để chạy
listener	ITestInvocationListener : ITestInvocationListener kết quả kiểm tra

Ném
Throwable

shardConfig

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

Cố gắng chia nhỏ cấu hình thành các cấu hình con, đượ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, nó sẽ chỉ cần 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 chúng. Nếu số lượng phân đoạn không được đặt, nó sẽ dự phòng cho IShardHelper#shardConfig .

Thông số
config	IConfiguration : cấu hình IConfiguration hiện tại.
testInfo	TestInformation : TestInformation nắm giữ thông tin của các bài kiểm tra.
rescheduler	IRescheduler : người lập lịch trình IRescheduler .
logger	ITestLogger : ITestLogger được sử dụng để ghi tệp trong quá trình sharding.

Lợi nhuận
boolean	đúng nếu thử nghiệm bị phân mảnh. Nếu không thì trả về false