IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

الفئات الفرعية غير المباشرة المعروفة InvocationContext InvocationContext التنفيذ العام لـ 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