IInvocationBối cảnh
public interface IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
Giữ thông tin về Yêu cầu để các bài kiểm tra truy cập nếu cần. Các thử nghiệm không nên sửa đổi ngữ cảnh có ở đây để chỉ có các getters, ngoại trừ các thuộc tính ngữ cảnh cho mục đích báo cáo.
Bản tóm tắt
hằng số | |
---|---|
String | INVOCATION_ID Khóa được sử dụng để lưu trữ ID lệnh gọi được liên kết. |
Phương thức công khai | |
---|---|
abstract void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) Theo dõi bản đồ tên thiết bị cấu hình được liên kết với |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) Thêm một ITestDevice để được theo dõi bởi siêu dữ liệu khi thiết bị được phân bổ. |
abstract void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) Thêm một |
abstract void | addInvocationAttribute (String attributeName, String attributeValue) Thêm một thuộc tính Yêu cầu. |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) Thêm một số thuộc tính gọi cùng một lúc thông qua |
default void | addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis) Thêm một số liệu thời gian gọi. |
abstract void | addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials) Thêm một sê-ri để được theo dõi khi được gán cho một trong các phân đoạn đang chạy một số thử nghiệm. |
default String | getAttribute (String key) Một phương pháp thuận tiện để truy xuất thuộc tính ngữ cảnh gọi dưới dạng một cặp khóa-giá trị. |
abstract MultiMap <String, String> | getAttributes () Trả về một bản sao của bản đồ chứa tất cả các thuộc tính gọi. |
abstract IBuildInfo | getBuildInfo (String deviceName) Trả lại |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) Trả lại |
abstract String | getBuildInfoName ( IBuildInfo info) Trả về tên của thiết bị được đặt trong cấu hình xml từ |
abstract | getBuildInfos () Trả lại tất cả |
abstract ConfigurationDescriptor | getConfigurationDescriptor () Trả về bộ mô tả được liên kết với cấu hình thử nghiệm đã khởi chạy lệnh gọi |
abstract ITestDevice | getDevice (String deviceName) Trả lại |
abstract | getDeviceBuildMap () Trả lại bản đồ của Liên kết thông tin thiết bị/xây dựng |
abstract ITestDevice | getDeviceBySerial (String serial) Trả về |
abstract | getDeviceConfigNames () Trả về danh sách tên cấu hình thiết bị của thiết bị được theo dõi trong lời gọi này |
abstract String | getDeviceName ( ITestDevice device) Trả về tên của thiết bị được đặt trong cấu hình xml từ |
abstract | getDevices () Trả lại tất cả thiết bị được phân bổ được theo dõi cho lệnh gọi này. |
abstract String | getInvocationId () |
default | getInvocationTimingMetrics () Trả về bản đồ chứa các số liệu về thời gian gọi. |
abstract IInvocationContext | getModuleInvocationContext () Trả về ngữ cảnh gọi của mô-đun trong khi được thực thi như một phần của bộ. |
abstract int | getNumDevicesAllocated () Trả về số lượng thiết bị được phân bổ cho lệnh gọi. |
abstract | getSerials () Trả về danh sách sê-ri của thiết bị được theo dõi trong lệnh gọi này |
abstract | getShardsSerials () Trả về Bản đồ của tất cả các sê-ri được theo dõi và phân đoạn của chúng liên quan đến phân đoạn. |
abstract String | getTestTag () Trả về thẻ kiểm tra yêu cầu. |
abstract void | markReleasedEarly () Đánh dấu các thiết bị sẽ được phát hành sớm. |
abstract void | setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor) Đặt bộ mô tả được liên kết với cấu hình thử nghiệm đã khởi chạy lệnh gọi |
abstract void | setModuleInvocationContext ( IInvocationContext invocationContext) Đặt bối cảnh gọi của mô-đun trong khi được thực thi như một phần của bộ. |
abstract void | setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode) Đặt |
abstract void | setTestTag (String testTag) Đặt thẻ kiểm tra lệnh gọi. |
abstract InvocationContext.Context | toProto () Tuần tự hóa một thể hiện bối cảnh thành một protobuf. |
abstract boolean | wasReleasedEarly () Trả về việc thiết bị có được phát hành sớm hay không và sẽ không được sử dụng nữa. |
hằng số
IVOCATION_ID
public static final String INVOCATION_ID
Khóa được sử dụng để lưu trữ ID lệnh gọi được liên kết.
Giá trị không đổi: "id gọi"
Phương thức công khai
thêm thiết bị được cấp phát
public abstract void addAllocatedDevice (deviceWithName)
Theo dõi bản đồ tên thiết bị cấu hình được liên kết với ITestDevice
. Không xóa theo dõi trước đó trước khi thêm.
Thông số | |
---|---|
deviceWithName | ERROR(/Map) của thiết bị bổ sung để theo dõi |
thêm thiết bị được cấp phát
public abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)
Thêm một ITestDevice để được theo dõi bởi siêu dữ liệu khi thiết bị được phân bổ. sẽ đặt thông tin bản dựng thành null trong bản đồ.
Thông số | |
---|---|
deviceName | String : tên cấu hình thiết bị để liên kết với ITestDevice |
testDevice | ITestDevice : được thêm vào các thiết bị được phân bổ. |
thêmDeviceBuildInfo
public abstract void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)
Thêm một IBuildInfo
để được theo dõi với tên cấu hình thiết bị.
Thông số | |
---|---|
deviceName | String : tên cấu hình thiết bị |
buildinfo | IBuildInfo : một IBuildInfo được liên kết với tên cấu hình thiết bị. |
addInvocationAttribute
public abstract void addInvocationAttribute (String attributeName, String attributeValue)
Thêm một thuộc tính Yêu cầu.
Thông số | |
---|---|
attributeName | String |
attributeValue | String |
addInvocationAttributes
public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)
Thêm một số thuộc tính gọi cùng một lúc thông qua UniqueMultiMap
.
Thông số | |
---|---|
attributesMap | MultiMap |
addInvocationTimingMetric
public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Thêm một số liệu thời gian gọi.
Thông số | |
---|---|
timingEvent | IInvocationContext.TimingEvent |
durationMillis | Long |
addSerialsFromShard
public abstract void addSerialsFromShard (Integer index,serials)
Thêm một sê-ri để được theo dõi khi được gán cho một trong các phân đoạn đang chạy một số thử nghiệm.
Thông số | |
---|---|
index | Integer : chỉ mục của phân đoạn sử dụng sê-ri |
serials |
getAttribute
public String getAttribute (String key)
Một phương pháp thuận tiện để truy xuất thuộc tính ngữ cảnh gọi dưới dạng một cặp khóa-giá trị. Không bao giờ trả về null.
Thông số | |
---|---|
key | String |
trả lại | |
---|---|
String | chuỗi trống khi khóa không tồn tại, giá trị khác. |
getAttributes
public abstract MultiMap<String, String> getAttributes ()
Trả về một bản sao của bản đồ chứa tất cả các thuộc tính gọi.
trả lại | |
---|---|
MultiMap <String, String> |
getBuildInfo
public abstract IBuildInfo getBuildInfo (String deviceName)
Trả lại IBuildInfo
được liên kết với tên cấu hình thiết bị được cung cấp. Trả về null, nếu tên thiết bị không khớp.
Thông số | |
---|---|
deviceName | String |
trả lại | |
---|---|
IBuildInfo |
getBuildInfo
public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)
Trả lại IBuildInfo
được liên kết với ITestDevice
Thông số | |
---|---|
testDevice | ITestDevice |
trả lại | |
---|---|
IBuildInfo |
getBuildInfoName
public abstract String getBuildInfoName (IBuildInfo info)
Trả về tên của thiết bị được đặt trong cấu hình xml từ IBuildInfo
. Trả về null nếu IBuildInfo không khớp
Thông số | |
---|---|
info | IBuildInfo |
trả lại | |
---|---|
String |
getBuildInfos
public abstractgetBuildInfos ()
Trả lại tất cả IBuildInfo
được theo dõi cho lời gọi này.
trả lại | |
---|---|
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
Trả về bộ mô tả được liên kết với cấu hình thử nghiệm đã khởi chạy lệnh gọi
trả lại | |
---|---|
ConfigurationDescriptor |
getDevice
public abstract ITestDevice getDevice (String deviceName)
Trả lại ITestDevice
được liên kết với tên cấu hình thiết bị được cung cấp.
Thông số | |
---|---|
deviceName | String |
trả lại | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
Trả lại bản đồ của Liên kết thông tin thiết bị/xây dựng
trả lại | |
---|---|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Trả về ITestDevice
được liên kết với sê-ri được cung cấp. Không sử dụng quá nhiều vì đây không phải là cách tra cứu nhanh nhất.
Thông số | |
---|---|
serial | String |
trả lại | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
Trả về danh sách tên cấu hình thiết bị của thiết bị được theo dõi trong lời gọi này
trả lại | |
---|---|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
Trả về tên của thiết bị được đặt trong cấu hình xml từ ITestDevice
. Trả về null, nếu ITestDevice không khớp.
Thông số | |
---|---|
device | ITestDevice |
trả lại | |
---|---|
String |
getDevices
public abstractgetDevices ()
Trả lại tất cả thiết bị được phân bổ được theo dõi cho lệnh gọi này.
trả lại | |
---|---|
getInvocationId
public abstract String getInvocationId ()
trả lại | |
---|---|
String | ID lời gọi được liên kết hoặc null nếu không được liên kết với lời gọi |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
Trả về bản đồ chứa các số liệu về thời gian gọi.
trả lại | |
---|---|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
Trả về ngữ cảnh gọi của mô-đun trong khi được thực thi như một phần của bộ.
trả lại | |
---|---|
IInvocationContext |
getNumDevicesĐược phân bổ
public abstract int getNumDevicesAllocated ()
Trả về số lượng thiết bị được phân bổ cho lệnh gọi.
trả lại | |
---|---|
int |
getSerials
public abstractgetSerials ()
Trả về danh sách sê-ri của thiết bị được theo dõi trong lệnh gọi này
trả lại | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
Trả về Bản đồ của tất cả các sê-ri được theo dõi và phân đoạn của chúng liên quan đến phân đoạn. Làm trống nếu không phải là một lệnh gọi được phân đoạn.
trả lại | |
---|---|
getTestTag
public abstract String getTestTag ()
Trả về thẻ kiểm tra yêu cầu.
trả lại | |
---|---|
String |
đánh dấuPhát hành sớm
public abstract void markReleasedEarly ()
Đánh dấu các thiết bị sẽ được phát hành sớm.
setConfigurationDescriptor
public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)
Đặt bộ mô tả được liên kết với cấu hình thử nghiệm đã khởi chạy lệnh gọi
Thông số | |
---|---|
configurationDescriptor | ConfigurationDescriptor |
setModuleInvocationContext
public abstract void setModuleInvocationContext (IInvocationContext invocationContext)
Đặt bối cảnh gọi của mô-đun trong khi được thực thi như một phần của bộ.
Thông số | |
---|---|
invocationContext | IInvocationContext |
setRecoveryModeForAllDevices
public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)
Đặt RecoveryMode
của tất cả các thiết bị một phần của ngữ cảnh
Thông số | |
---|---|
mode | ITestDevice.RecoveryMode |
setTestTag
public abstract void setTestTag (String testTag)
Đặt thẻ kiểm tra lệnh gọi.
Thông số | |
---|---|
testTag | String |
toProto
public abstract InvocationContext.Context toProto ()
Tuần tự hóa một thể hiện bối cảnh thành một protobuf.
trả lại | |
---|---|
InvocationContext.Context |
đã được phát hành sớm
public abstract boolean wasReleasedEarly ()
Trả về việc thiết bị có được phát hành sớm hay không và sẽ không được sử dụng nữa.
trả lại | |
---|---|
boolean |