IInvocationContext
public interface IInvocationContext
com.android.tradefed.invoker.IInvocationContext |
يحمل معلومات حول الاستدعاء للاختبارات للوصول إذا لزم الأمر. لا ينبغي أن تقوم الاختبارات بتعديل السياق المضمن هنا ، لذا لن يتوفر سوى المحاضرون ، باستثناء سمات السياق لغرض إعداد التقارير.
ملخص
الثوابت | |
---|---|
String | INVOCATION_ID المفتاح المستخدم لتخزين معرف الاستدعاء المرتبط. |
الأساليب العامة | |
---|---|
abstract void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) تعقب خريطة اسم جهاز التكوين المرتبط بجهاز |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) أضف جهاز ITestDevice ليتم تعقبه بواسطة بيانات التعريف عند تخصيص الجهاز. |
abstract void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) أضف |
abstract void | addInvocationAttribute (String attributeName, String attributeValue) أضف سمة الاستدعاء. |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) أضف العديد من سمات الاستدعاء مرة واحدة من خلال |
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) قم بإعادة |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) قم بإعادة |
abstract String | getBuildInfoName ( IBuildInfo info) يُرجع اسم الجهاز الذي تم ضبطه في تكوين xml من |
abstract | getBuildInfos () أعد جميع معلومات |
abstract ConfigurationDescriptor | getConfigurationDescriptor () إرجاع الواصف المرتبط بتكوين الاختبار الذي أطلق الاستدعاء |
abstract ITestDevice | getDevice (String deviceName) قم بإعادة |
abstract | getDeviceBuildMap () قم بإرجاع خريطة ارتباط معلومات الجهاز / البناء |
abstract ITestDevice | getDeviceBySerial (String serial) إرجاع |
abstract | getDeviceConfigNames () قم بإعادة قائمة أسماء تكوين الجهاز للجهاز المتتبع في هذا الاستدعاء |
abstract String | getDeviceName ( ITestDevice device) تُرجع اسم الجهاز المعين في تكوين xml من |
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) يعين |
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 abstractgetBuildInfos ()
أعد جميع معلومات IBuildInfo
المتعقبة لهذا الطلب.
عائدات | |
---|---|
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
إرجاع الواصف المرتبط بتكوين الاختبار الذي أطلق الاستدعاء
عائدات | |
---|---|
ConfigurationDescriptor |
getDevice
public abstract ITestDevice getDevice (String deviceName)
قم بإعادة ITestDevice
المرتبط باسم تكوين الجهاز المقدم.
حدود | |
---|---|
deviceName | String |
عائدات | |
---|---|
ITestDevice |
getDeviceBuildMap
public abstractgetDeviceBuildMap ()
قم بإرجاع خريطة ارتباط معلومات الجهاز / البناء
عائدات | |
---|---|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
إرجاع ITestDevice
المرتبط بالتسلسل المقدم. الامتناع عن استخدام الكثير لأنه ليس أسرع بحث.
حدود | |
---|---|
serial | String |
عائدات | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
قم بإعادة قائمة أسماء تكوين الجهاز للجهاز المتتبع في هذا الاستدعاء
عائدات | |
---|---|
getDeviceName
public abstract String getDeviceName (ITestDevice device)
تُرجع اسم الجهاز المعين في تكوين xml من ITestDevice
. يُرجع فارغًا ، إذا تعذر مطابقة ITestDevice.
حدود | |
---|---|
device | ITestDevice |
عائدات | |
---|---|
String |
getDevices
public abstractgetDevices ()
إعادة جميع الأجهزة المخصصة التي تم تعقبها لهذا الاستدعاء.
عائدات | |
---|---|
getInvocationId
public abstract String getInvocationId ()
عائدات | |
---|---|
String | معرّف الاستدعاء المرتبط أو null إذا لم يكن مرتبطًا باستدعاء |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
لعرض الخريطة التي تحتوي على مقاييس توقيت الاستدعاء.
عائدات | |
---|---|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
يُرجع سياق استدعاء الوحدة النمطية أثناء تنفيذه كجزء من مجموعة.
عائدات | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
إرجاع عدد الأجهزة المخصصة للاستدعاء.
عائدات | |
---|---|
int |
getSerials
public abstractgetSerials ()
إعادة قائمة المسلسلات للجهاز المتعقب في هذا الاستدعاء
عائدات | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
لعرض خريطة جميع المسلسلات المتعقبة وشظاياها المتضمنة في التجزئة. إفراغ إن لم يكن طلبًا مُقسَّمًا.
عائدات | |
---|---|
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 |