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 xuống xây 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ủa 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
|
Các nhà 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 cleanUp target_preparer và multi_target_preparer. |
void | doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener) Thực hiện bước target_preparer và multi_target_preparer setUp. |
void | doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Thực hiện bước xé nhỏ 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ời 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 |
void | runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) Gọi ra |
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 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. |
Các 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 thử nghiệm. |
IShardHelper | createShardHelper () Tạo trả về |
void | customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) Cho 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 được sử dụng cho lời gọi. |
getLabPreparersToRun ( IConfiguration config, String deviceName) Truy xuất danh sách người 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 đặ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
Các nhà xây dựng công cộng
InvocationExecution
public InvocationExecution ()
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 listener)
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. |
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 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. |
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 | |
---|---|
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.
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ờ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 | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
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 |
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 cho 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 |
Các phương pháp đượ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 thử nghiệm.
Thông số | |
---|---|
config | IConfiguration |
info | TestInformation |
Ném | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
Tạo trả về IShardHelper
sẽ được sử dụng.
Lợi nhuận | |
---|---|
IShardHelper |
customDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Cho 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ờ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 được sử dụng cho lời gọi.
Lợi nhuận | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
Truy xuất danh sách người chuẩn bị phòng thí nghiệm để chạy trên thiết bị này.
Ghi đè trong các lớp hộp cát để hạn chế chạy trình chuẩn bị phòng thí nghiệm bên trong hộp cát con
Thông số | |
---|---|
config | IConfiguration |
deviceName | String |
Lợi nhuận | |
---|---|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (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.
Ghi đè trong các lớp hộp cát để hạn chế chạy trình chuẩn bị phòng thí nghiệm bên trong hộp cát con
Thông số | |
---|---|
config | IConfiguration |
deviceName | String |
Lợi nhuận | |
---|---|
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 |
Lợi nhuận | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
Xử lý việc đặt thẻ kiểm tra trên thông tin bản dựng.
Thông số | |
---|---|
info | IBuildInfo |
config | IConfiguration |