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