IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

Menyimpan informasi tentang Pemanggilan agar dapat diakses oleh pengujian jika diperlukan. Pengujian tidak boleh mengubah konteks yang ada di sini, sehingga hanya getter yang akan tersedia, kecuali atribut konteks untuk tujuan pelaporan.

Ringkasan

Konstanta

String INVOCATION_ID

Kunci yang digunakan untuk menyimpan ID pemanggilan terkait.

Metode publik

abstract void addAllocatedDevice(Map<String, ITestDevice> deviceWithName)

Melacak peta nama perangkat konfigurasi yang terkait dengan ITestDevice.

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

Menambahkan ITestDevice yang akan dilacak oleh metadata saat perangkat dialokasikan.

abstract void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

Tambahkan IBuildInfo yang akan dilacak dengan nama konfigurasi perangkat.

abstract void addInvocationAttribute(String attributeName, String attributeValue)

Tambahkan atribut Invocation.

abstract void addInvocationAttributes(MultiMap<String, String> attributesMap)

Tambahkan beberapa atribut pemanggilan sekaligus melalui UniqueMultiMap.

default void addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)

Tambahkan metrik waktu pemanggilan.

abstract void addSerialsFromShard(Integer index, List<String> serials)

Tambahkan serial yang akan dilacak sebagai ditetapkan ke salah satu shard yang menjalankan beberapa pengujian.

default String getAttribute(String key)

Metode praktis untuk mengambil atribut konteks pemanggilan sebagai satu key-value pair.

abstract MultiMap<String, String> getAttributes()

Menampilkan salinan peta yang berisi semua atribut pemanggilan.

abstract IBuildInfo getBuildInfo(String deviceName)

Menampilkan IBuildInfo yang terkait dengan nama konfigurasi perangkat yang diberikan.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Menampilkan IBuildInfo yang terkait dengan ITestDevice

abstract String getBuildInfoName(IBuildInfo info)

Menampilkan nama set perangkat dalam konfigurasi xml dari IBuildInfo.

abstract List<IBuildInfo> getBuildInfos()

Menampilkan semua IBuildInfo yang dilacak untuk pemanggilan ini.

abstract ConfigurationDescriptor getConfigurationDescriptor()

Menampilkan deskriptor yang terkait dengan konfigurasi pengujian yang meluncurkan pemanggilan

abstract ITestDevice getDevice(String deviceName)

Menampilkan ITestDevice yang terkait dengan nama konfigurasi perangkat yang diberikan.

abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

Mengembalikan peta asosiasi info Perangkat/build

abstract ITestDevice getDeviceBySerial(String serial)

Menampilkan ITestDevice yang terkait dengan serial yang diberikan.

abstract List<String> getDeviceConfigNames()

Menampilkan daftar nama konfigurasi perangkat dari perangkat yang dilacak dalam pemanggilan ini

abstract String getDeviceName(ITestDevice device)

Menampilkan nama kumpulan perangkat dalam konfigurasi xml dari ITestDevice.

abstract List<ITestDevice> getDevices()

Menampilkan semua perangkat yang dialokasikan yang dilacak untuk pemanggilan ini.

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

Menampilkan peta yang berisi metrik waktu pemanggilan.

abstract IInvocationContext getModuleInvocationContext()

Menampilkan konteks pemanggilan modul saat dieksekusi sebagai bagian dari rangkaian pengujian.

abstract int getNumDevicesAllocated()

Menampilkan jumlah perangkat yang dialokasikan untuk pemanggilan.

abstract List<String> getSerials()

Menampilkan daftar serial perangkat yang dilacak dalam pemanggilan ini

abstract Map<Integer, List<String>> getShardsSerials()

Menampilkan Peta semua serial yang dilacak dan shard-nya yang terlibat dalam sharding.

abstract String getTestTag()

Menampilkan tag pengujian pemanggilan.

abstract void markReleasedEarly()

Mark akan merilis perangkat lebih awal.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

Menetapkan deskriptor yang terkait dengan konfigurasi pengujian yang meluncurkan pemanggilan

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

Menetapkan konteks pemanggilan modul saat dieksekusi sebagai bagian dari rangkaian pengujian.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

Menetapkan RecoveryMode semua perangkat yang merupakan bagian dari konteks

abstract void setTestTag(String testTag)

Menetapkan tag pengujian pemanggilan.

abstract InvocationContext.Context toProto()

Lakukan serialisasi instance konteks ke dalam protobuf.

abstract boolean wasReleasedEarly()

Menampilkan apakah perangkat dirilis lebih awal atau tidak dan tidak akan digunakan lagi.

Konstanta

INVOCATION_ID

public static final String INVOCATION_ID

Kunci yang digunakan untuk menyimpan ID pemanggilan terkait.

Nilai Konstanta: "invocation-id"

Metode publik

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

Melacak peta nama perangkat konfigurasi yang terkait dengan ITestDevice. Tidak menghapus pelacakan sebelumnya sebelum menambahkan.

Parameter
deviceWithName Map: Map perangkat tambahan yang akan dilacak

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Menambahkan ITestDevice yang akan dilacak oleh metadata saat perangkat dialokasikan. akan menyetel info build ke null di peta.

Parameter
deviceName String: nama konfigurasi perangkat yang akan dikaitkan dengan ITestDevice
testDevice ITestDevice: untuk ditambahkan ke perangkat yang dialokasikan.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Tambahkan IBuildInfo yang akan dilacak dengan nama konfigurasi perangkat.

Parameter
deviceName String: nama konfigurasi perangkat
buildinfo IBuildInfo: IBuildInfo yang terkait dengan nama konfigurasi perangkat.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Tambahkan atribut Invocation.

Parameter
attributeName String

attributeValue String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

Tambahkan beberapa atribut pemanggilan sekaligus melalui UniqueMultiMap.

Parameter
attributesMap MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

Tambahkan metrik waktu pemanggilan.

Parameter
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                List<String> serials)

Tambahkan serial yang akan dilacak sebagai ditetapkan ke salah satu shard yang menjalankan beberapa pengujian.

Parameter
index Integer: indeks shard menggunakan serial
serials List: Daftar serial yang akan dilacak.

getAttribute

public String getAttribute (String key)

Metode praktis untuk mengambil atribut konteks pemanggilan sebagai satu key-value pair. Jangan pernah menampilkan null.

Parameter
key String

Hasil
String string kosong jika kunci tidak ada, nilai jika sebaliknya.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Menampilkan salinan peta yang berisi semua atribut pemanggilan.

Hasil
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Menampilkan IBuildInfo yang terkait dengan nama konfigurasi perangkat yang diberikan. Menampilkan null, jika deviceName tidak dapat dicocokkan.

Parameter
deviceName String

Hasil
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Menampilkan IBuildInfo yang terkait dengan ITestDevice

Parameter
testDevice ITestDevice

Hasil
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Menampilkan nama set perangkat dalam konfigurasi xml dari IBuildInfo. Menampilkan null jika IBuildInfo tidak dapat dicocokkan

Parameter
info IBuildInfo

Hasil
String

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Menampilkan semua IBuildInfo yang dilacak untuk pemanggilan ini.

Hasil
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Menampilkan deskriptor yang terkait dengan konfigurasi pengujian yang meluncurkan pemanggilan

Hasil
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Menampilkan ITestDevice yang terkait dengan nama konfigurasi perangkat yang diberikan.

Parameter
deviceName String

Hasil
ITestDevice

getDeviceBuildMap

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Mengembalikan peta asosiasi info Perangkat/build

Hasil
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Menampilkan ITestDevice yang terkait dengan serial yang diberikan. Jangan terlalu banyak menggunakannya karena ini bukan cara pencarian tercepat.

Parameter
serial String

Hasil
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

Menampilkan daftar nama konfigurasi perangkat dari perangkat yang dilacak dalam pemanggilan ini

Hasil
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Menampilkan nama kumpulan perangkat dalam konfigurasi xml dari ITestDevice. Menampilkan null, jika ITestDevice tidak dapat dicocokkan.

Parameter
device ITestDevice

Hasil
String

getDevices

public abstract List<ITestDevice> getDevices ()

Menampilkan semua perangkat yang dialokasikan yang dilacak untuk pemanggilan ini.

Hasil
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

Hasil
String ID pemanggilan terkait atau null jika tidak ditautkan ke pemanggilan

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

Menampilkan peta yang berisi metrik waktu pemanggilan.

Hasil
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Menampilkan konteks pemanggilan modul saat dijalankan sebagai bagian dari rangkaian pengujian.

Hasil
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

Menampilkan jumlah perangkat yang dialokasikan untuk pemanggilan.

Hasil
int

getSerials

public abstract List<String> getSerials ()

Menampilkan daftar serial perangkat yang dilacak dalam pemanggilan ini

Hasil
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

Menampilkan Peta semua serial yang dilacak dan shard-nya yang terlibat dalam sharding. Kosong jika bukan pemanggilan yang di-shard.

Hasil
Map<Integer, List<String>>

getTestTag

public abstract String getTestTag ()

Menampilkan tag pengujian pemanggilan.

Hasil
String

markReleasedEarly

public abstract void markReleasedEarly ()

Mark akan merilis perangkat lebih awal.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Menetapkan deskriptor yang terkait dengan konfigurasi pengujian yang meluncurkan pemanggilan

Parameter
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Menetapkan konteks pemanggilan modul saat dieksekusi sebagai bagian dari rangkaian pengujian.

Parameter
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Menetapkan RecoveryMode semua perangkat yang merupakan bagian dari konteks

Parameter
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Menetapkan tag pengujian pemanggilan.

Parameter
testTag String

toProto

public abstract InvocationContext.Context toProto ()

Lakukan serialisasi instance konteks ke dalam protobuf.

Hasil
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Menampilkan apakah perangkat dirilis lebih awal atau tidak dan tidak akan digunakan lagi.

Hasil
boolean