InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
   ↳ com.android.tradefed.invoker.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 xác định bởi TestInvocation.

Tóm tắt

Hằng số

String ADB_VERSION_KEY

String JAVA_CLASSPATH_KEY

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 hiện bước target_preparer và multi_target_preparer cleanUp.

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

Thực hiện bước setUp target_preparer và multi_target_preparer.

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

Thực hiện bước tháo rời 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ị của 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ị của 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 chia cấu hình thành các cấu hình phụ để 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 và trả về IShardHelper sẽ được dùng.

void customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)

Cho phép tuỳ chỉnh một số thành phần của thiết bị trước preInvocationSetup.

String getAdbVersion()

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

List<ITargetPreparer> getLabPreparersToRun(IConfiguration config, String deviceName)

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

List<ITargetPreparer> getTargetPreparersToRun(IConfiguration config, String deviceName)

Truy xuất danh sách các 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, List<ITargetPreparer> preparersToRun, Map<String, Set<ITargetPreparer>> 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.

Hằng số

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

Giá trị không đổi: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Giá trị không đổi: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Giá trị không đổi: "java_version"

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 quan đến việc tìm nạp bản dựng.

Tham số
context IInvocationContext: IInvocationContext của lời 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 hiện bước target_preparer và multi_target_preparer cleanUp. Thiết bị có dọn dẹp không.

Tham số
context IInvocationContext: IInvocationContext của lời 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 chạy kiểm thử khai báo.

doSetup

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

Thực hiện bước setUp target_preparer và multi_target_preparer. Thiết lập 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ời 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 hiện bước tháo rời target_preparer và multi_target_preparer. Thiết bị có bị tháo rời liên quan đến quá trình thiết lập không.

Tham số
testInfo TestInformation: TestInformation của lời 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 chạy kiểm thử khai báo.
Gửi
Throwable

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ời 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ờ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.
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ời 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ệnh gọi.

Tham số
context IInvocationContext: IInvocationContext của lời 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 đi (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.

Tham số
context IInvocationContext: IInvocationContext của lời 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 kết quả kiểm thử
Gửi
Throwable

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

Tham số
config IConfiguration: IConfiguration hiện tại.
testInfo TestInformation: TestInformation lưu giữ thông tin về các kiểm thử.
rescheduler IRescheduler: IRescheduler.
logger ITestLogger: ITestLogger dùng để ghi tệp nhật ký trong quá trình phân đoạn.
Giá trị trả về
boolean true nếu thử nghiệm đượ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 và trả về IShardHelper sẽ được dùng.

Giá trị trả về
IShardHelper

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Cho phép tuỳ chỉnh một số thành phần của thiết bị trước preInvocationSetup.

Tham số
config IConfiguration: Cấu hình của lời 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 dùng cho lệnh gọi.

Giá trị trả về
String

getLabPreparersToRun

protected List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Truy xuất danh sách các trình chuẩn bị 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ế 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ề
List<ITargetPreparer>

getTargetPreparersToRun

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Truy xuất danh sách các 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ế 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ề
List<ITargetPreparer>

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, 
                List<ITargetPreparer> preparersToRun, 
                Map<String, Set<ITargetPreparer>> trackPreparersMap)

Tham số
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun List

trackPreparersMap Map

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