InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

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

---

تنفيذ عام لعنصر IInvocationContext

ملخّص

وظائف الإنشاء العامة
InvocationContext() تُنشئ BuildInfo باستخدام قيم السمات التلقائية.

الطرق العامة
void	addAllocatedDevice( 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, 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
	getBuildInfos() عرض جميع IBuildInfo التي يتم تتبُّعها لهذا الطلب
ConfigurationDescriptor	getConfigurationDescriptor() لعرض الوصف المرتبط بإعدادات الاختبار التي بدأت عملية الاستدعاء
ITestDevice	getDevice(String deviceName) عرض القيمة ITestDevice المرتبطة باسم إعدادات الجهاز المقدَّمة
	getDeviceBuildMap() عرض خريطة ربط معلومات الجهاز/الإصدار
ITestDevice	getDeviceBySerial(String serial) تعرِض هذه الدالة ITestDevice المرتبط بالرقم التسلسلي المقدَّم.
	getDeviceConfigNames() عرض قائمة بأسماء إعدادات الجهاز الذي يتم تتبُّعه في عملية الاستدعاء هذه
String	getDeviceName(ITestDevice device) عرض اسم مجموعة الأجهزة في ملف الإعدادات بتنسيق XML من ITestDevice
	getDevices() عرض جميع الأجهزة المخصّصة التي يتم تتبُّعها لهذا الطلب
String	getInvocationId()
IInvocationContext	getModuleInvocationContext() لعرض سياق استدعاء الوحدة أثناء تنفيذها كجزء من مجموعة.
int	getNumDevicesAllocated() عرض عدد الأجهزة المخصّصة للطلب
	getSerials() عرض قائمة الأرقام التسلسلية للجهاز الذي يتم تتبُّعه في عملية الاستدعاء هذه
	getShardsSerials() عرض خريطة لجميع سلاسل الأرقام التسلسلية التي يتم تتبُّعها والشظايا المضمّنة في عملية التجزئة
String	getTestTag() لعرض علامة الاختبار التي يتمّ استدعاؤها.
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() تسلسل مثيل السياق إلى ملف protobuf
boolean	wasReleasedEarly() تعرِض هذه السمة ما إذا تم طرح الأجهزة مبكرًا ولن يتم استخدامها بعد ذلك أم لا.

وظائف الإنشاء العامة

InvocationContext

public InvocationContext ()

تُنشئ BuildInfo باستخدام قيم السمات التلقائية.

الطرق العامة

addAllocatedDevice

public void addAllocatedDevice ( deviceWithName)

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

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

addAllocatedDevice

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

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

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

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

المعلمات
index	Integer: فهرس الشريحة باستخدام الأرقام التسلسلية
serials	: قائمة الكتب التسلسلية التي سيتم تتبُّعها

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

عرض جميع IBuildInfo التي يتم تتبُّعها لهذا الطلب

المرتجعات

getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

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

المرتجعات
ConfigurationDescriptor

getDevice

public ITestDevice getDevice (String deviceName)

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

المعلمات
deviceName	String

المرتجعات
ITestDevice

getDeviceBuildMap

public  getDeviceBuildMap ()

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

المرتجعات

getDeviceBySerial

public ITestDevice getDeviceBySerial (String serial)

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

المعلمات
serial	String

المرتجعات
ITestDevice

getDeviceConfigNames

public  getDeviceConfigNames ()

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

المرتجعات

getDeviceName

public String getDeviceName (ITestDevice device)

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

المعلمات
device	ITestDevice

المرتجعات
String

getDevices

public  getDevices ()

عرض جميع الأجهزة المخصّصة التي يتم تتبُّعها لهذا الطلب

المرتجعات

getInvocationId

public String getInvocationId ()

المرتجعات
String

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

المرتجعات
IInvocationContext

getNumDevicesAllocated

public int getNumDevicesAllocated ()

عرض عدد الأجهزة المخصّصة للطلب

المرتجعات
int

getSerials

public  getSerials ()

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

المرتجعات

getShardsSerials

public  getShardsSerials ()

عرض خريطة لجميع سلاسل الأرقام التسلسلية التي يتم تتبُّعها والشظية المعنيّة بها في عملية التجزئة فارغ إذا لم يكن هناك طلب مجزأ.

المرتجعات

getTestTag

public String getTestTag ()

لعرض علامة الاختبار التي يتمّ استدعاؤها.

المرتجعات
String

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

تحويل مثيل السياق إلى ملف protobuf

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

wasReleasedEarly

public boolean wasReleasedEarly ()

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

المرتجعات
boolean