Thực thi lệnh gọi

public class InvocationExecution
extends Object implements IInvocationExecution

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

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