IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

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

ملخّص

الثوابت

String INVOCATION_ID

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

الإجراءات العامة

abstract void addAllocatedDevice(Map<String, ITestDevice> 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, List<String> 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 List<IBuildInfo> getBuildInfos()

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

abstract ConfigurationDescriptor getConfigurationDescriptor()

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

abstract ITestDevice getDevice(String deviceName)

عرض ITestDevice المرتبط باسم إعدادات الجهاز المقدَّمة

abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

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

abstract ITestDevice getDeviceBySerial(String serial)

تعرض هذه السمة ITestDevice المرتبط بالرقم التسلسلي المقدَّم.

abstract List<String> getDeviceConfigNames()

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

abstract String getDeviceName(ITestDevice device)

تعرض هذه السمة اسم مجموعة الأجهزة في إعدادات XML من ITestDevice.

abstract List<ITestDevice> getDevices()

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

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

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

abstract IInvocationContext getModuleInvocationContext()

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

abstract int getNumDevicesAllocated()

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

abstract List<String> getSerials()

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

abstract Map<Integer, List<String>> 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()

تسلسل مثيل السياق إلى بروتوكول buffer.

abstract boolean wasReleasedEarly()

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

الثوابت

INVOCATION_ID

public static final String INVOCATION_ID

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

Constant Value: "invocation-id"

الإجراءات العامة

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

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

المعلَمات
deviceWithName Map: 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)

أضِف سمة 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, 
                List<String> serials)

أضِف رقمًا تسلسليًا ليتم تتبُّعه على أنّه تم تعيينه لأحد الأجزاء التي تُجري بعض الاختبارات.

المعلَمات
index ‫Integer: فهرس الجزء باستخدام الأرقام التسلسلية
serials List: قائمة بالمسلسلات التي يجب تتبُّعها

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 List<IBuildInfo> getBuildInfos ()

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

المرتجعات
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

المرتجعات
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

عرض ITestDevice المرتبط باسم إعدادات الجهاز المقدَّمة

المعلَمات
deviceName String

المرتجعات
ITestDevice

getDeviceBuildMap

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

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

المرتجعات
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

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

المعلَمات
serial String

المرتجعات
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

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

المرتجعات
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

تعرض هذه السمة اسم مجموعة الأجهزة في إعدادات XML من ITestDevice. تعرِض قيمة فارغة إذا تعذّر العثور على تطابق مع ITestDevice.

المعلَمات
device ITestDevice

المرتجعات
String

getDevices

public abstract List<ITestDevice> getDevices ()

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

المرتجعات
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

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

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

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

المرتجعات
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

المرتجعات
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

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

المرتجعات
int

getSerials

public abstract List<String> getSerials ()

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

المرتجعات
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

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

المرتجعات
Map<Integer, List<String>>

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

تسلسل مثيل السياق إلى بروتوكول buffer.

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

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

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

المرتجعات
boolean