IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext


يحمل معلومات حول الاستدعاء للاختبارات للوصول إذا لزم الأمر. لا ينبغي أن تقوم الاختبارات بتعديل السياق المضمن هنا ، لذا لن يتوفر سوى المحاضرون ، باستثناء سمات السياق لغرض إعداد التقارير.

ملخص

الثوابت

String INVOCATION_ID

المفتاح المستخدم لتخزين معرف الاستدعاء المرتبط.

الأساليب العامة

abstract void addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName)

تعقب خريطة اسم جهاز التكوين المرتبط بجهاز ITestDevice .

abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)

أضف جهاز ITestDevice ليتم تعقبه بواسطة بيانات التعريف عند تخصيص الجهاز.

abstract void addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo)

أضف IBuildInfo ليتم تعقبه باستخدام اسم تكوين الجهاز.

abstract void addInvocationAttribute (String attributeName, String attributeValue)

أضف سمة الاستدعاء.

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

أضف العديد من سمات الاستدعاء مرة واحدة من خلال UniqueMultiMap .

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

أضف مقياس توقيت الاحتجاج.

abstract void addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials)

أضف مسلسلاً ليتم تعقبه كما تم تعيينه لأحد الأجزاء التي تقوم بإجراء بعض الاختبارات.

default String getAttribute (String key)

طريقة مناسبة لاسترداد سمة سياق الاستدعاء كزوج واحد من قيمة المفتاح.

abstract MultiMap <String, String> getAttributes ()

تُرجع نسخة من الخريطة تحتوي على جميع سمات الاستدعاء.

abstract IBuildInfo getBuildInfo (String deviceName)

قم بإعادة IBuildInfo المرتبط باسم تكوين الجهاز المقدم.

abstract IBuildInfo getBuildInfo ( ITestDevice testDevice)

قم بإعادة IBuildInfo المرتبط بجهاز ITestDevice

abstract String getBuildInfoName ( IBuildInfo info)

يُرجع اسم الجهاز الذي تم ضبطه في تكوين xml من IBuildInfo .

abstract getBuildInfos ()

أعد جميع معلومات IBuildInfo المتعقبة لهذا الطلب.

abstract ConfigurationDescriptor getConfigurationDescriptor ()

إرجاع الواصف المرتبط بتكوين الاختبار الذي أطلق الاستدعاء

abstract ITestDevice getDevice (String deviceName)

قم بإعادة ITestDevice المرتبط باسم تكوين الجهاز المقدم.

abstract getDeviceBuildMap ()

قم بإرجاع خريطة ارتباط معلومات الجهاز / البناء

abstract ITestDevice getDeviceBySerial (String serial)

إرجاع ITestDevice المرتبط بالتسلسل المقدم.

abstract getDeviceConfigNames ()

قم بإعادة قائمة أسماء تكوين الجهاز للجهاز المتتبع في هذا الاستدعاء

abstract String getDeviceName ( ITestDevice device)

تُرجع اسم الجهاز المعين في تكوين xml من ITestDevice .

abstract getDevices ()

إعادة جميع الأجهزة المخصصة التي تم تعقبها لهذا الاستدعاء.

abstract String getInvocationId ()
default getInvocationTimingMetrics ()

لعرض الخريطة التي تحتوي على مقاييس توقيت الاستدعاء.

abstract IInvocationContext getModuleInvocationContext ()

يُرجع سياق استدعاء الوحدة النمطية أثناء تنفيذه كجزء من مجموعة.

abstract int getNumDevicesAllocated ()

إرجاع عدد الأجهزة المخصصة للاستدعاء.

abstract getSerials ()

إعادة قائمة المسلسلات للجهاز المتعقب في هذا الاستدعاء

abstract getShardsSerials ()

لعرض خريطة جميع المسلسلات المتعقبة وشظاياها المتضمنة في التجزئة.

abstract String getTestTag ()

إرجاع علامة اختبار الاستدعاء.

abstract void markReleasedEarly ()

حدد إصدار الأجهزة مبكرًا.

abstract void setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor)

يعيّن الواصف المرتبط بتكوين الاختبار الذي أطلق الاستدعاء

abstract void setModuleInvocationContext ( IInvocationContext invocationContext)

يضبط سياق استدعاء الوحدة النمطية أثناء تنفيذه كجزء من مجموعة.

abstract void setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode)

يعين RecoveryMode لجميع الأجهزة جزء من السياق

abstract void setTestTag (String testTag)

يضبط استدعاء اختبار العلامة.

abstract InvocationContext.Context toProto ()

تسلسل مثيل السياق في ملف protobuf.

abstract boolean wasReleasedEarly ()

يُرجع ما إذا كان قد تم إصدار الأجهزة مبكرًا أم لا ولن يتم استخدامها بعد الآن.

الثوابت

INVOCATION_ID

public static final String INVOCATION_ID

المفتاح المستخدم لتخزين معرف الاستدعاء المرتبط.

القيمة الثابتة: "معرّف الاحتجاج"

الأساليب العامة

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

تعقب خريطة اسم جهاز التكوين المرتبط بجهاز ITestDevice . لا يمسح التتبع السابق قبل الإضافة.

حدود
deviceWithName : ERROR(/Map) الخاص بجهاز إضافي للتتبع

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

أضف جهاز ITestDevice ليتم تعقبه بواسطة بيانات التعريف عند تخصيص الجهاز. سيعمل على تعيين معلومات البناء على قيمة خالية في الخريطة.

حدود
deviceName String : اسم تكوين الجهاز المراد ربطه بجهاز ITestDevice

testDevice ITestDevice : يتم إضافته إلى الأجهزة المخصصة.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

أضف IBuildInfo ليتم تعقبه باستخدام اسم تكوين الجهاز.

حدود
deviceName String : اسم تكوين الجهاز

buildinfo IBuildInfo : IBuildInfo مرتبط باسم تكوين الجهاز.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

أضف سمة الاستدعاء.

حدود
attributeName String

attributeValue String

addInvocationAttributes

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

أضف العديد من سمات الاستدعاء مرة واحدة من خلال UniqueMultiMap .

حدود
attributesMap MultiMap

addInvocationTimingMetric

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

أضف مقياس توقيت الاحتجاج.

حدود
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

أضف مسلسلاً ليتم تعقبه كما تم تعيينه لأحد الأجزاء التي تقوم بإجراء بعض الاختبارات.

حدود
index Integer : فهرس القشرة باستخدام المسلسلات

serials : قائمة المسلسلات المراد تتبعها.

getAttribute

public String getAttribute (String key)

طريقة مناسبة لاسترداد سمة سياق الاستدعاء كزوج واحد من قيمة المفتاح. لا تعد أبدا فارغة.

حدود
key String

عائدات
String سلسلة فارغة عندما لا يكون المفتاح موجودًا ، والقيمة بخلاف ذلك.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

تُرجع نسخة من الخريطة تحتوي على جميع سمات الاستدعاء.

عائدات
MultiMap <String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

قم بإعادة IBuildInfo المرتبط باسم تكوين الجهاز المقدم. إرجاع القيمة فارغة ، إذا تعذر مطابقة اسم الجهاز.

حدود
deviceName String

عائدات
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

قم بإعادة IBuildInfo المرتبط بجهاز ITestDevice

حدود
testDevice ITestDevice

عائدات
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

يُرجع اسم الجهاز الذي تم ضبطه في تكوين xml من IBuildInfo . إرجاع القيمة فارغة إذا تعذر مطابقة IBuildInfo

حدود
info IBuildInfo

عائدات
String

getBuildInfos

public abstract  getBuildInfos ()

أعد جميع معلومات IBuildInfo المتعقبة لهذا الطلب.

عائدات

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

إرجاع الواصف المرتبط بتكوين الاختبار الذي أطلق الاستدعاء

عائدات
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

قم بإعادة ITestDevice المرتبط باسم تكوين الجهاز المقدم.

حدود
deviceName String

عائدات
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

قم بإرجاع خريطة ارتباط معلومات الجهاز / البناء

عائدات

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

إرجاع ITestDevice المرتبط بالتسلسل المقدم. الامتناع عن استخدام الكثير لأنه ليس أسرع بحث.

حدود
serial String

عائدات
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

قم بإعادة قائمة أسماء تكوين الجهاز للجهاز المتتبع في هذا الاستدعاء

عائدات

getDeviceName

public abstract String getDeviceName (ITestDevice device)

تُرجع اسم الجهاز المعين في تكوين xml من ITestDevice . يُرجع فارغًا ، إذا تعذر مطابقة ITestDevice.

حدود
device ITestDevice

عائدات
String

getDevices

public abstract  getDevices ()

إعادة جميع الأجهزة المخصصة التي تم تعقبها لهذا الاستدعاء.

عائدات

getInvocationId

public abstract String getInvocationId ()

عائدات
String معرّف الاستدعاء المرتبط أو null إذا لم يكن مرتبطًا باستدعاء

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

لعرض الخريطة التي تحتوي على مقاييس توقيت الاستدعاء.

عائدات

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

يُرجع سياق استدعاء الوحدة النمطية أثناء تنفيذه كجزء من مجموعة.

عائدات
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

إرجاع عدد الأجهزة المخصصة للاستدعاء.

عائدات
int

getSerials

public abstract  getSerials ()

إعادة قائمة المسلسلات للجهاز المتعقب في هذا الاستدعاء

عائدات

getShardsSerials

public abstract  getShardsSerials ()

لعرض خريطة جميع المسلسلات المتعقبة وشظاياها المتضمنة في التجزئة. إفراغ إن لم يكن طلبًا مُقسَّمًا.

عائدات

getTestTag

public abstract String getTestTag ()

إرجاع علامة اختبار الاستدعاء.

عائدات
String

تم إصداره في وقت مبكر

public abstract void markReleasedEarly ()

حدد إصدار الأجهزة مبكرًا.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

يعيّن الواصف المرتبط بتكوين الاختبار الذي أطلق الاستدعاء

حدود
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

يضبط سياق استدعاء الوحدة النمطية أثناء تنفيذه كجزء من مجموعة.

حدود
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

يعين RecoveryMode لجميع الأجهزة جزء من السياق

حدود
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

يضبط استدعاء اختبار العلامة.

حدود
testTag String

toProto

public abstract InvocationContext.Context toProto ()

تسلسل مثيل السياق في ملف protobuf.

عائدات
InvocationContext.Context

تم إطلاقه في وقت مبكر

public abstract boolean wasReleasedEarly ()

يُرجع ما إذا كان قد تم إصدار الأجهزة مبكرًا أم لا ولن يتم استخدامها بعد الآن.

عائدات
boolean