سياق الاستدعاء

public interface IInvocationContext

com.android.tradefed.invoker.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)

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

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()

تسلسل أحد مثيلات السياق في نموذج أوّلي.

abstract boolean wasReleasedEarly()

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

الثوابت

INVOCATION_ID

public static final String INVOCATION_ID

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

القيمة الثابتة: معرّف "invocation-id" (معرّف الاستدعاء)

الطرق العامة

إضافة تخصيص جهاز

public abstract void addAllocatedDevice ( deviceWithName)

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

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

إضافة تخصيص جهاز

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

إضافة SerialsFromShard

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>

الحصول على معلومات

public abstract IBuildInfo getBuildInfo (String deviceName)

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

المعلمات
deviceName String

المرتجعات
IBuildInfo

الحصول على معلومات

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

إرجاع IBuildInfo المرتبطة بـ ITestDevice

المعلمات
testDevice ITestDevice

المرتجعات
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

تعرض هذه السمة اسم الجهاز المحدَّد في إعدادات XML من IBuildInfo. الركلات المردودة "خالية" إذا تعذرت مطابقة IBuildInfo

المعلمات
info IBuildInfo

المرتجعات
String

الحصول على معلومات الإصدار

public abstract  getBuildInfos ()

يُرجع كل IBuildInfo الذي تم تتبعه بسبب هذا الاستدعاء.

المرتجعات

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

عرض الواصف المرتبط بإعدادات الاختبار التي أطلقت الاستدعاء

المرتجعات
ConfigurationDescriptor

الحصول على جهاز

public abstract ITestDevice getDevice (String deviceName)

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

المعلمات
deviceName String

المرتجعات
ITestDevice

خريطة getDeviceBuildMap

public abstract  getDeviceBuildMap ()

عرض خريطة ارتباط معلومات الجهاز أو الإصدار

المرتجعات

الحصول على DeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

تعرض هذه السمة ITestDevice المرتبط بالتسلسل التسلسلي. تجنَّب استخدام الكثير منها لأنّها ليست أسرع عملية بحث.

المعلمات
serial String

المرتجعات
ITestDevice

طريقة getDeviceConfigNames

public abstract  getDeviceConfigNames ()

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

المرتجعات

الحصول على اسم الجهاز

public abstract String getDeviceName (ITestDevice device)

تعرض هذه السمة اسم الجهاز المحدَّد في إعدادات XML من ITestDevice. يتم عرض قيمة فارغة في حال تعذّر مطابقة ITestDevice.

المعلمات
device ITestDevice

المرتجعات
String

الحصول على أجهزة

public abstract  getDevices ()

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

المرتجعات

معرّف getInvocationId

public abstract String getInvocationId ()

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

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

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

المرتجعات

الحصول على وحدة استدعاء السياق

public abstract IInvocationContext getModuleInvocationContext ()

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

المرتجعات
IInvocationContext

الحصول على عدد الأجهزة الموزّعة

public abstract int getNumDevicesAllocated ()

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

المرتجعات
int

الطريقة getSerials

public abstract  getSerials ()

عرض قائمة السلاسل التسلسلية للجهاز الذي تم تتبُّعه في هذا الاستدعاء

المرتجعات

مسلسل getShardsSerials

public abstract  getShardsSerials ()

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

المرتجعات

الحصول على علامة اختبار

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

إلى Proto

public abstract InvocationContext.Context toProto ()

تسلسل أحد مثيلات السياق في نموذج أوّلي.

المرتجعات
InvocationContext.Context

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

public abstract boolean wasReleasedEarly ()

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

المرتجعات
boolean