Lệnh gọiThực thi

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 xuống bản dựng, target_prep, chạy thử nghiệm, dọn dẹp. Có thể được mở rộng để ghi đè hành vi mặc định của một số bước. Thứ tự các bước được điều khiển bởi TestInvocation .

Bản tóm tắt

Lĩnh vực

public static final String ADB_VERSION_KEY

public static final String JAVA_CLASSPATH_KEY

public static final String JAVA_VERSION_KEY

Nhà thầu xây dựng công cộng

InvocationExecution ()

Phương pháp công khai

void cleanUpBuilds ( IInvocationContext context, IConfiguration config)

Thực hiện bước dọn dẹp build_provider.

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

Thực hiện bước dọn dẹp target_preparer và multi_target_preparer.

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

Thực hiện bước thiết lập target_preparer và multi_target_preparer.

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

Thực hiện bước phân tích target_preparer và multi_target_preparer.

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

Thực hiện 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 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 thử nghiệm.

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 pháp đượ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 thử nghiệm.

IShardHelper createShardHelper ()

Tạo một trả lại IShardHelper sẽ được sử dụng.

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

Tạo cơ hội để tùy chỉnh một số thiết bị trước 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 các 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 các trình chuẩn bị mục tiêu để chạy trên thiết bị này.

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) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) 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 cài đặt thẻ kiểm tra trên thông tin bản dựng.

Lĩnh vực

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

Nhà thầu xây dựng công cộng

Lệnh gọiThực thi

public InvocationExecution ()

Phương pháp công khai

dọn dẹpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

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

Thông số
context IInvocationContext : IInvocationContext của lệnh gọi.

config IConfiguration : 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 dọn dẹp target_preparer và multi_target_preparer. Các thiết bị có dọn dẹp không.

Thông số
context IInvocationContext : IInvocationContext của lệnh gọi.

config IConfiguration : IConfiguration của lần chạy thử nghiệm này.

exception Throwable : ngoại lệ ban đầu do quá trình chạy thử đưa ra.

doSetup

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

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

Thông số
testInfo TestInformation : TestInformation của lệnh gọi.

config IConfiguration : IConfiguration của lần chạy thử nghiệm này.

listener ITestLogger : ITestLogger để báo cáo nhật ký lỗi thiết lập.

Ném
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown

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

Thực hiện bước phân tích target_preparer và multi_target_preparer. Các thiết bị có bị hỏng liên quan đến quá trình thiết lập hay không.

Thông số
testInfo TestInformation : TestInformation của lệnh gọi.

config IConfiguration : 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 do quá trình chạy thử đưa ra.

tìm nạpBuild

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

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

Thông số
testInfo TestInformation : TestInformation của lệnh gọi.

config IConfiguration : IConfiguration của lần chạy thử nghiệm này.

rescheduler IRescheduler : IRescheduler , để sắp xếp 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.

Trả lại
boolean Đúng nếu chúng tôi đã tải xuống bản dựng thành công, nếu không thì sai.

Ném
BuildRetrievalError
DeviceNotAvailableException

báo cáoNhật ký

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 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ý.

listener ITestLogger : Trình ghi 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ị của lệnh gọi.

Thông số
context IInvocationContext : IInvocationContext của lệnh gọi.

config IConfiguration : IConfiguration của lần chạy thử nghiệm này.

exception Throwable : ngoại lệ ban đầu do quá trình chạy thử nghiệm đưa 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ị của lệnh gọi.

Thông số
context IInvocationContext : IInvocationContext của lệnh gọi.

config IConfiguration : IConfiguration của lần chạy thử nghiệm này.

logger ITestLogger : ITestLogger để báo cáo nhật ký.

Ném
DeviceNotAvailableException
TargetSetupError

chạy thử nghiệm

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

Chạy thử nghiệm.

Thông số
info TestInformation : TestInformation để chạy thử nghiệm.

config IConfiguration : IConfiguration để chạy

listener ITestInvocationListener : ITestInvocationListener của kết quả kiểm tra

phân đoạnConfig

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, nó 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 cho chúng. Nếu số lượng phân đoạn không được đặt, nó sẽ chuyển sang IShardHelper#shardConfig .

Thông số
config IConfiguration : IConfiguration hiện tại.

testInfo TestInformation : TestInformation chứa thông tin của các bài kiểm tra.

rescheduler IRescheduler : IRescheduler .

logger ITestLogger : ITestLogger được sử dụng để ghi nhật ký tệp trong quá trình phân chia.

Trả lại
boolean đúng nếu bài kiểm tra bị phân chia. Ngược lại trả về false

Phương pháp được bảo vệ

thu thậpAutoInfo

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 thử nghiệm.

Thông số
config IConfiguration

info TestInformation

Ném
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Tạo một trả lại IShardHelper sẽ được sử dụng.

Trả lại
IShardHelper

tùy chỉnhThiết bịPreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Tạo cơ hội để tùy chỉnh một số thiết bị trước preInvocationSetup.

Thông số
config IConfiguration : Cấu hình của lệnh gọi.

context IInvocationContext : Bối cảnh gọi hiện tại.

getAdbPhiên bản

protected String getAdbVersion ()

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

Trả lại
String

getLabPreparersToRun

protected  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.

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

Thông số
config IConfiguration

deviceName String

Trả lại

getTargetPreparersToRun

protected  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.

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

Thông số
config IConfiguration

deviceName String

Trả lại

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

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

Thông số
config IConfiguration

logger ITestLogger

runPreparersTearDown

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

Thông số
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun

trackPreparersMap

Trả lại
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

Thông số
info IBuildInfo

config IConfiguration