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) أضِف سمة الاستدعاء.
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	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

إضافة SerialsFromShard

public void addSerialsFromShard (Integer index, 
                 serials)

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

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

منProto

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

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

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

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

public IInvocationContext getModuleInvocationContext ()

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

المرتجعات
IInvocationContext

الحصول على عدد الأجهزة التي تم تخصيصها

public int getNumDevicesAllocated ()

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

المرتجعات
int

getSerials

public  getSerials ()

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

المرتجعات

getShardsSerials

public  getShardsSerials ()

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

المرتجعات

getTestTag

public String getTestTag ()

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

المرتجعات
String

isPresubmit

public static boolean isPresubmit (IInvocationContext context)

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

المعلمات
context	IInvocationContext

المرتجعات
boolean

lockAttributes

public void lockAttributes ()

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

logInvocationMetrics

public void logInvocationMetrics ()

سجِّل سمات InvocationMetricLogger في الطلب.

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

public void markReleasedEarly ()

ضَع علامة على الأجهزة التي سيتم طرحها مبكرًا.

setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

المعلمات
configurationDescriptor	ConfigurationDescriptor

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

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

المعلمات
invocationContext	IInvocationContext

setRecoveryModeForجميع الأجهزة

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