Thực thi lệnh gọi

public class InvocationExecution
extends Object implements IInvocationExecution

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

Các lớp con trực tiếp đã biết DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution Uỷ quyền thực thi lệnh gọi InvocationExecution uỷ quyền thực thi cho một tệp nhị phân Tradefeed khác.  parentSandboxInvocationExecution Phiên bản của InvocationExecution cho các thao tác đặc biệt của lệnh gọi mẹ khi chạy một hộp cát.  RemoteInvocationExecution Việc triển khai InvocationExecution giúp 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à InvocationExection khi chúng ta bên trong hộp cát 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 quyết định 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 target_preparer và multi_target_preparer làm sạch.
void	doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener) Thực thi bước target_preparer và multi_target_preparer setUp.
void	doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Thực thi bước phân tách 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ị ở giai đoạn khác của lệnh gọi.
void	runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception) Gọi ITestDevice#postInvocationTearDown(Throwable) cho từng phần của thiết bị 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 của thiết bị lời 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 chạy lại vào nhiều tài nguyên song song.

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 dữ liệu trả về IShardHelper sẽ được sử dụng.
void	customizeDevicePreInvocation(IConfiguration config, IInvocationContext context) Cho phép tuỳ chỉnh một số thiết bị trước khi preInvocationSetup.
String	getAdbVersion() Trả về phiên bản adb đang dùng cho lệnh gọi.
	getLabPreparersToRun(IConfiguration config, String deviceName) Truy xuất danh sách các trình chuẩn bị trong 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 thiết lập 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

Thực thi lệnh gọi

public InvocationExecution ()

Phương thức công khai

dọn dẹp bản dựng

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.

làm sạch

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

Thực thi bước target_preparer và multi_target_preparer làm sạch. Thiết bị có sạch không lên.

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 được gửi bởi hoạt động kiểm thử đang chạy.

doSetup

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

Thực thi bước target_preparer và multi_target_preparer setUp. Đã thiết lập xong tất cả các thiết bị cần thiết để chạy kiểm thử.

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

xé hình

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

Thực thi bước phân tách target_preparer và multi_target_preparer. Thiết bị có bị rách không liên quan đến quá trình thiết lập.

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 được gửi bởi hoạt động kiểm thử đang chạy.

tìm nạp bản dựng

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 cho thực thi trên(các) tài nguyên khác
listener	ITestInvocationListener: ITestInvocation để báo cáo lỗi tải bản dựng xuống.

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

Gửi
BuildRetrievalError
DeviceNotAvailableException

nhật ký báo cáo

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

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

Tham số
device	ITestDevice: Thiết bị dùng để 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 của thiết bị lời 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 chương trình kiểm thử chạy (nếu có) gửi.

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 của thiết bị lời 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

runTest

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 để chạy
listener	ITestInvocationListener: ITestInvocationListener của kết quả thử nghiệm

cấu hình phân đoạn

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 chạy lại vào nhiều tài nguyên song song.

Nếu số lượng phân đoạn lớn hơn 1, hệ thống sẽ chỉ tạo cấu hình cho mỗi phân đoạn bằng đặt chỉ mục phân đoạn và lập lịch lại. Nếu không đặt số lượng phân đoạn,giá trị dự phòng là IShardHelper#shardConfig.

Tham số
config	IConfiguration: IConfiguration hiện tại.
testInfo	TestInformation: TestInformation chứa thông tin của các phép 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ệ

thu thập thông tin tự động

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 (Trình trợ giúp)

protected IShardHelper createShardHelper ()

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

Giá trị trả về
IShardHelper

tuỳ chỉnh thiết bị trước khi gọi

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Cho phép 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 lệnh gọi hiện tại.

getAdbVersion

protected String getAdbVersion ()

Trả về phiên bản adb đang dùng cho lệnh gọi.

Giá trị trả về
String

getLab chuẩn bị để chạy

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

Tham số
config	IConfiguration
deviceName	String

Giá trị trả về

lấy mục tiêu chuẩn bị để chạy

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.

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

Tham số
config	IConfiguration
deviceName	String

Giá trị trả về

đường dẫn liên kết

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

RunChuẩn bịTearDown

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 thiết lập thẻ kiểm thử trên thông tin bản dựng.

Tham số
info	IBuildInfo
config	IConfiguration