InvocationContext

public class InvocationContext
extends Object implements IInvocationContext

شیء جاوا
↳	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 () نقشه تمام سریال‌های ردیابی شده و شارد (shard) آنها که در شاردینگ (sharding) دخیل هستند را برمی‌گرداند.
String	getTestTag () تگ تست فراخوانی را برمی‌گرداند.
static boolean	isApiTrigger ( IInvocationContext context) برمی‌گرداند که آیا ما بر اساس نوع تریگر، فراخوانی تست مبتنی بر API را تشخیص می‌دهیم یا خیر.
static boolean	isOnDemand ( IInvocationContext context) برمی‌گرداند که آیا ما بر اساس نوع تریگر، فراخوانی تست بر اساس تقاضا را تشخیص می‌دهیم یا خیر.
static boolean	isPresubmit ( IInvocationContext context) برمی‌گرداند که آیا ما بر اساس نوع تریگر، presubmit را تشخیص داده‌ایم یا خیر.
void	lockAttributes () برای جلوگیری از افزودن ویژگی‌های فراخوانی بیشتر، زمینه را قفل کنید.
void	logInvocationMetrics () ویژگی‌های InvocationMetricLogger مربوط به فراخوانی را ثبت کنید.
void	markReleasedEarly () علامت بزنید که دستگاه‌ها زودتر عرضه می‌شوند.
void	setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor) توصیف‌گر مرتبط با پیکربندی آزمایشی که فراخوانی را آغاز کرده است، تنظیم می‌کند.
void	setModuleInvocationContext ( IInvocationContext invocationContext) زمینه فراخوانی ماژول را هنگام اجرا به عنوان بخشی از یک مجموعه تنظیم می‌کند.
void	setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode) حالت RecoveryMode تمام دستگاه‌های موجود در بخش زمینه (context) را تنظیم می‌کند.
void	setTestTag (String testTag) برچسب تست فراخوانی را تنظیم می‌کند.
InvocationContext.Context	toProto () یک نمونه از context را به یک protobuf سریالایز کنید.
boolean	wasReleasedEarly () برمی‌گرداند که آیا دستگاه‌ها زودتر از موعد عرضه شده‌اند و دیگر مورد استفاده قرار نخواهند گرفت یا خیر.

سازندگان عمومی

InvocationContext

public InvocationContext ()

با استفاده از مقادیر پیش‌فرض ویژگی‌ها، یک BuildInfo ایجاد می‌کند.

روش‌های عمومی

دستگاه اختصاص داده شده را اضافه کنید

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

نقشه‌ای از نام دستگاه پیکربندی مرتبط با یک ITestDevice را ردیابی می‌کند. ردیابی قبلی را قبل از اضافه کردن پاک نمی‌کند.

پارامترها
deviceWithName	Map : Map دستگاه اضافی برای ردیابی

دستگاه اختصاص داده شده را اضافه کنید

public void addAllocatedDevice (String devicename, 
                ITestDevice testDevice)

یک ITestDevice اضافه کنید تا هنگام تخصیص دستگاه، توسط متا دیتا ردیابی شود. اطلاعات ساخت را در نقشه روی null تنظیم می‌کند.

پارامترها
devicename	String : نام پیکربندی دستگاه برای ارتباط با ITestDevice
testDevice	ITestDevice : برای اضافه شدن به دستگاه‌های اختصاص داده شده.

اطلاعات ساخت دستگاه را اضافه کنید

public void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

یک IBuildInfo اضافه کنید تا با نام پیکربندی دستگاه ردیابی شود.

پارامترها
deviceName	String : نام پیکربندی دستگاه
buildinfo	IBuildInfo : یک IBuildInfo مرتبط با نام پیکربندی دستگاه.

ویژگی addInvocation

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 : فهرست سریال‌هایی که باید ردیابی شوند.

ازپروتو

public static InvocationContext fromProto (InvocationContext.Context protoContext)

عملیات معکوس InvocationContext.toProto() برای بازگرداندن نمونه.

پارامترها
protoContext	InvocationContext.Context

بازگشت‌ها
InvocationContext

دریافت ویژگی‌ها

public MultiMap<String, String> getAttributes ()

یک کپی از نقشه حاوی تمام ویژگی‌های فراخوانی را برمی‌گرداند.

بازگشت‌ها
MultiMap <String, String>

اطلاعات ساخت را دریافت کنید

public IBuildInfo getBuildInfo (String deviceName)

IBuildInfo مرتبط با نام پیکربندی دستگاه ارائه شده را برمی‌گرداند. در صورتی که نام دستگاه قابل تطبیق نباشد، مقدار null را برمی‌گرداند.

پارامترها
deviceName	String

بازگشت‌ها
IBuildInfo

اطلاعات ساخت را دریافت کنید

public IBuildInfo getBuildInfo (ITestDevice testDevice)

IBuildInfo مرتبط با ITestDevice را برمی‌گرداند

پارامترها
testDevice	ITestDevice

بازگشت‌ها
IBuildInfo

دریافت اطلاعات ساختنام

public String getBuildInfoName (IBuildInfo info)

نام دستگاه تنظیم شده در پیکربندی xml را از IBuildInfo برمی‌گرداند. در صورت عدم تطابق IBuildInfo، مقدار null را برمی‌گرداند.

پارامترها
info	IBuildInfo

بازگشت‌ها
String

اطلاعات ساخت را دریافت کنید

public List<IBuildInfo> getBuildInfos ()

تمام IBuildInfo ردیابی شده برای این فراخوانی را برمی‌گرداند.

بازگشت‌ها
List< IBuildInfo >

توصیفگر پیکربندی getConfigurationDescriptor

public ConfigurationDescriptor getConfigurationDescriptor ()

توصیف‌گر مرتبط با پیکربندی آزمایشی که فراخوانی را آغاز کرده است را برمی‌گرداند.

بازگشت‌ها
ConfigurationDescriptor

دریافت دستگاه

public ITestDevice getDevice (String deviceName)

ITestDevice مرتبط با نام پیکربندی دستگاه ارائه شده را برمی‌گرداند.

پارامترها
deviceName	String

بازگشت‌ها
ITestDevice

دریافت نقشه ساخت دستگاه

public Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

نقشه ارتباط اطلاعات دستگاه/ساخت را برمی‌گرداند

بازگشت‌ها
Map< ITestDevice , IBuildInfo >

دریافت دستگاه توسط سریال

public ITestDevice getDeviceBySerial (String serial)

ITestDevice مرتبط با سریال ارائه شده را برمی‌گرداند. از استفاده بیش از حد خودداری کنید زیرا سریع‌ترین روش جستجو نیست.

پارامترها
serial	String

بازگشت‌ها
ITestDevice

نام‌های پیکربندی دستگاه را دریافت کنید

public List<String> getDeviceConfigNames ()

لیست نام‌های پیکربندی دستگاه ردیابی شده در این فراخوانی را برمی‌گرداند

بازگشت‌ها
List<String>

دریافت نام دستگاه

public String getDeviceName (ITestDevice device)

نام دستگاه تنظیم شده در پیکربندی xml از ITestDevice را برمی‌گرداند. اگر ITestDevice قابل تطبیق نباشد، null را برمی‌گرداند.

پارامترها
device	ITestDevice

بازگشت‌ها
String

دریافت دستگاه‌ها

public List<ITestDevice> getDevices ()

تمام دستگاه‌های اختصاص داده شده ردیابی شده برای این فراخوانی را برمی‌گرداند.

بازگشت‌ها
List< ITestDevice >

دریافت شناسه فراخوانی

public String getInvocationId ()

بازگشت‌ها
String

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

زمینه فراخوانی ماژول را هنگام اجرا به عنوان بخشی از یک مجموعه برمی‌گرداند.

بازگشت‌ها
IInvocationContext

getNumDevicesAllocated

public int getNumDevicesAllocated ()

تعداد دستگاه‌های اختصاص داده شده برای فراخوانی را برمی‌گرداند.

بازگشت‌ها
int

دریافت سریال‌ها

public List<String> getSerials ()

لیست سریال‌های دستگاه ردیابی شده در این فراخوانی را برمی‌گرداند

بازگشت‌ها
List<String>

سریال‌های دریافت‌شده

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

نقشه تمام سریال‌های ردیابی شده و شارد (shard) آنها که در شاردینگ (sharding) دخیل هستند را برمی‌گرداند. اگر فراخوانی شارد شده نباشد، خالی است.

بازگشت‌ها
Map<Integer, List<String>>

تگ getTest

public String getTestTag ()

تگ تست فراخوانی را برمی‌گرداند.

بازگشت‌ها
String

isApiTrigger

public static boolean isApiTrigger (IInvocationContext context)

برمی‌گرداند که آیا ما بر اساس نوع تریگر، فراخوانی تست مبتنی بر API را تشخیص می‌دهیم یا خیر.

پارامترها
context	IInvocationContext

بازگشت‌ها
boolean

isOnDemand

public static boolean isOnDemand (IInvocationContext context)

برمی‌گرداند که آیا ما بر اساس نوع تریگر، فراخوانی تست بر اساس تقاضا را تشخیص می‌دهیم یا خیر.

پارامترها
context	IInvocationContext

بازگشت‌ها
boolean

ارسال از پیش

public static boolean isPresubmit (IInvocationContext context)

برمی‌گرداند که آیا ما بر اساس نوع تریگر، presubmit را تشخیص داده‌ایم یا خیر.

پارامترها
context	IInvocationContext

بازگشت‌ها
boolean

lockAttributes

public void lockAttributes ()

برای جلوگیری از افزودن ویژگی‌های فراخوانی بیشتر، زمینه را قفل کنید.

معیارهای فراخوانی log

public void logInvocationMetrics ()

ویژگی‌های InvocationMetricLogger مربوط به فراخوانی را ثبت کنید.

علامت گذاری شده در اوایل

public void markReleasedEarly ()

علامت بزنید که دستگاه‌ها زودتر عرضه می‌شوند.

توصیفگر پیکربندی setConfigurationDescriptor

public void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

توصیف‌گر مرتبط با پیکربندی آزمایشی که فراخوانی را آغاز کرده است، تنظیم می‌کند.

پارامترها
configurationDescriptor	ConfigurationDescriptor

setModuleInvocationContext

public void setModuleInvocationContext (IInvocationContext invocationContext)

زمینه فراخوانی ماژول را هنگام اجرا به عنوان بخشی از یک مجموعه تنظیم می‌کند.

پارامترها
invocationContext	IInvocationContext

تنظیم حالت بازیابی برای همه دستگاه‌ها

public void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

حالت RecoveryMode تمام دستگاه‌های موجود در بخش زمینه (context) را تنظیم می‌کند.

پارامترها
mode	ITestDevice.RecoveryMode

تنظیمTestTag

public void setTestTag (String testTag)

برچسب تست فراخوانی را تنظیم می‌کند.

پارامترها
testTag	String

توپروتو

public InvocationContext.Context toProto ()

یک نمونه از context را به یک protobuf سریالایز کنید.

بازگشت‌ها
InvocationContext.Context

زود منتشر شد

public boolean wasReleasedEarly ()

برمی‌گرداند که آیا دستگاه‌ها زودتر از موعد عرضه شده‌اند و دیگر مورد استفاده قرار نخواهند گرفت یا خیر.

بازگشت‌ها
boolean