InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

java.lang.Object
   ↳ com.android.tradefed.invoker.InvocationContext

تنفيذ عام للعلامة IInvocationContext

ملخّص

طُرق وضع التصميم العامة

InvocationContext()

تنشئ هذه الطريقة BuildInfo باستخدام قيم السمات التلقائية.

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

void addAllocatedDevice(Map<String, ITestDevice> deviceWithName)

تتبُّع خريطة لاسم جهاز الإعداد المرتبط بـ ITestDevice

void addAllocatedDevice(String devicename, ITestDevice testDevice)

أضِف ITestDevice ليتم تتبُّعه من خلال البيانات الوصفية عند تخصيص الجهاز.

void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

أضِف IBuildInfo ليتم تتبُّعه باستخدام اسم إعداد الجهاز.

void addInvocationAttribute(String attributeName, String attributeValue)

أضِف سمة Invocation.

void addInvocationAttributes(MultiMap<String, String> attributesMap)

إضافة عدّة سمات استدعاء في آنٍ واحد من خلال UniqueMultiMap

void addSerialsFromShard(Integer index, List<String> serials)

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

static InvocationContext fromProto(InvocationContext.Context protoContext)

العملية العكسية لـ InvocationContext.toProto() لاستعادة المثيل.

MultiMap<String, String> getAttributes()

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

IBuildInfo getBuildInfo(String deviceName)

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

IBuildInfo getBuildInfo(ITestDevice testDevice)

عرض IBuildInfo المرتبط بـ ITestDevice

String getBuildInfoName(IBuildInfo info)

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

List<IBuildInfo> getBuildInfos()

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

ConfigurationDescriptor getConfigurationDescriptor()

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

ITestDevice getDevice(String deviceName)

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

Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

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

ITestDevice getDeviceBySerial(String serial)

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

List<String> getDeviceConfigNames()

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

String getDeviceName(ITestDevice device)

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

List<ITestDevice> getDevices()

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

String getInvocationId()
IInvocationContext getModuleInvocationContext()

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

int getNumDevicesAllocated()

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

List<String> getSerials()

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

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

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

String getTestTag()

تعرض هذه السمة علامة الاختبار الخاصة باستدعاء الوظيفة.

static boolean isApiTrigger(IInvocationContext context)

تعرض هذه السمة ما إذا كنا نرصد استدعاء الاختبار المستند إلى واجهة برمجة التطبيقات استنادًا إلى نوع المشغّل.

static boolean isOnDemand(IInvocationContext context)

تعرض هذه السمة ما إذا رصدنا استدعاء اختبار عند الطلب استنادًا إلى نوع المشغّل.

static boolean isPresubmit(IInvocationContext context)

تعرض هذه السمة ما إذا كنا نرصد عمليات الإرسال المسبق استنادًا إلى نوع المشغّل.

void lockAttributes()

قفل السياق لمنع إضافة المزيد من سمات الاستدعاء

void logInvocationMetrics()

سجِّل سمات InvocationMetricLogger في عملية الاستدعاء.

void markReleasedEarly()

وضع علامة على الأجهزة التي سيتم طرحها قبل الموعد المحدد

void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

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

void setModuleInvocationContext(IInvocationContext invocationContext)

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

void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

تضبط هذه السمة RecoveryMode لجميع الأجهزة التي تشكّل جزءًا من السياق.

void setTestTag(String testTag)

تضبط هذه السمة علامة الاختبار الخاصة باستدعاء الدالة.

InvocationContext.Context toProto()

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

boolean wasReleasedEarly()

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

طُرق وضع التصميم العامة

InvocationContext

public InvocationContext ()

تنشئ هذه الطريقة BuildInfo باستخدام قيم السمات التلقائية.

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

addAllocatedDevice

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

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

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

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

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

المعلَمات
devicename ‫String: اسم إعدادات الجهاز المطلوب ربطها بـ ITestDevice
testDevice ITestDevice: ليتم إضافته إلى الأجهزة المخصّصة.

addDeviceBuildInfo

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

أضِف IBuildInfo ليتم تتبُّعه باستخدام اسم إعداد الجهاز.

المعلَمات
deviceName String: اسم إعدادات الجهاز
buildinfo ‫IBuildInfo: IBuildInfo مرتبط باسم إعدادات الجهاز

addInvocationAttribute

public void addInvocationAttribute (String attributeName, 
                String attributeValue)

أضِف سمة Invocation.

المعلَمات
attributeName String

attributeValue String

addInvocationAttributes

public void addInvocationAttributes (MultiMap<String, String> attributesMap)

إضافة عدّة سمات استدعاء في آنٍ واحد من خلال UniqueMultiMap

المعلَمات
attributesMap MultiMap

addSerialsFromShard

public void addSerialsFromShard (Integer index, 
                List<String> serials)

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

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

fromProto

public static InvocationContext fromProto (InvocationContext.Context protoContext)

العملية العكسية لـ InvocationContext.toProto() لاستعادة المثيل.

المعلَمات
protoContext InvocationContext.Context

المرتجعات
InvocationContext

getAttributes

public MultiMap<String, String> getAttributes ()

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

المرتجعات
MultiMap<String, String>

getBuildInfo

public IBuildInfo getBuildInfo (String deviceName)

عرض IBuildInfo المرتبط باسم إعدادات الجهاز المقدَّمة تعرِض هذه السمة قيمة فارغة إذا تعذّر العثور على تطابق مع deviceName.

المعلَمات
deviceName String

المرتجعات
IBuildInfo

getBuildInfo

public IBuildInfo getBuildInfo (ITestDevice testDevice)

عرض IBuildInfo المرتبط بـ ITestDevice

المعلَمات
testDevice ITestDevice

المرتجعات
IBuildInfo

getBuildInfoName

public String getBuildInfoName (IBuildInfo info)

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

المعلَمات
info IBuildInfo

المرتجعات
String

getBuildInfos

public List<IBuildInfo> getBuildInfos ()

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

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

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

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

المرتجعات
ConfigurationDescriptor

getDevice

public ITestDevice getDevice (String deviceName)

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

المعلَمات
deviceName String

المرتجعات
ITestDevice

getDeviceBuildMap

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

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

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

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

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

المعلَمات
serial String

المرتجعات
ITestDevice

getDeviceConfigNames

public List<String> getDeviceConfigNames ()

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

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

getDeviceName

public String getDeviceName (ITestDevice device)

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

المعلَمات
device ITestDevice

المرتجعات
String

getDevices

public List<ITestDevice> getDevices ()

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

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

getInvocationId

public String getInvocationId ()

المرتجعات
String

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

المرتجعات
IInvocationContext

getNumDevicesAllocated

public int getNumDevicesAllocated ()

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

المرتجعات
int

getSerials

public List<String> getSerials ()

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

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

getShardsSerials

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

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

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

getTestTag

public String getTestTag ()

تعرض هذه السمة علامة الاختبار الخاصة باستدعاء الوظيفة.

المرتجعات
String

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

تعرض هذه السمة ما إذا كنا نرصد استدعاء الاختبار المستند إلى واجهة برمجة التطبيقات استنادًا إلى نوع المشغّل.

المعلَمات
context IInvocationContext

المرتجعات
boolean

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

تعرض هذه السمة ما إذا رصدنا استدعاء اختبار عند الطلب استنادًا إلى نوع المشغّل.

المعلَمات
context IInvocationContext

المرتجعات
boolean

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

تعرض هذه السمة ما إذا كنا نرصد عمليات الإرسال المسبق استنادًا إلى نوع المشغّل.

المعلَمات
context IInvocationContext

المرتجعات
boolean

lockAttributes

public void lockAttributes ()

قفل السياق لمنع إضافة المزيد من سمات الاستدعاء

logInvocationMetrics

public void logInvocationMetrics ()

سجِّل سمات InvocationMetricLogger في عملية الاستدعاء.

markReleasedEarly

public void markReleasedEarly ()

وضع علامة على الأجهزة التي سيتم طرحها قبل الموعد المحدد

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

المعلَمات
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

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

المعلَمات
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

تضبط هذه السمة RecoveryMode لجميع الأجهزة التي تشكّل جزءًا من السياق.

المعلَمات
mode ITestDevice.RecoveryMode

setTestTag

public void setTestTag (String testTag)

تضبط هذه السمة علامة الاختبار الخاصة باستدعاء الدالة.

المعلَمات
testTag String

toProto

public InvocationContext.Context toProto ()

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

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

wasReleasedEarly

public boolean wasReleasedEarly ()

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

المرتجعات
boolean