IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

الفئات الفرعية غير المباشرة المعروفة InvocationContext InvocationContext تنفيذ عام لعنصر IInvocationContext

---

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

ملخّص

الثابتات
String	INVOCATION_ID المفتاح المستخدَم لتخزين معرّف الطلب المرتبط.

الطرق العامة
abstract void	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) أضِف سمة Invocation.
abstract void	addInvocationAttributes(MultiMap<String, String> attributesMap) أضِف عدة سمات استدعاء في آنٍ واحد من خلال UniqueMultiMap.
default void	addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis) أضِف مقياسًا لتوقيت الاستدعاء.
abstract void	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

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

القيمة الثابتة: "invocation-id"

الطرق العامة

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

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

المعلمات
deviceWithName	: ERROR(/Map) الجهاز الإضافي المطلوب تتبُّعه

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

أضِف عنصر ITestDevice ليتم تتبُّعه من خلال البيانات الوصفية عند تخصيص الجهاز. سيؤدي ذلك إلى ضبط معلومات الإصدار على القيمة null في الخريطة.

المعلمات
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)

أضِف سمة Invocation.

المعلمات
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.

المعلمات
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

markReleasedEarly

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

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

عرض ما إذا تم طرح الأجهزة مبكرًا ولن يتم استخدامها بعد ذلك

المرتجعات
boolean