IInvocationContext

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)

أضِف سمة 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