IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

اطلاعاتی در مورد فراخوانی را برای تست‌ها نگه می‌دارد تا در صورت نیاز به آنها دسترسی داشته باشند. تست‌ها نباید context موجود در اینجا را تغییر دهند، بنابراین فقط getterها در دسترس خواهند بود، به جز ویژگی‌های context برای اهداف گزارش‌دهی.

خلاصه

ثابت‌ها

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

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

abstract String getTestTag ()

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

abstract void markReleasedEarly ()

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

abstract void setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor)

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

abstract void setModuleInvocationContext ( IInvocationContext invocationContext)

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

abstract void setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode)

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

abstract void setTestTag (String testTag)

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

abstract InvocationContext.Context toProto ()

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

abstract boolean wasReleasedEarly ()

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

ثابت‌ها

شناسه فراخوان 

public static final String INVOCATION_ID

کلید مورد استفاده برای ذخیره شناسه فراخوانی مرتبط.

مقدار ثابت: "invocation-id"

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

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

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

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

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

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

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

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

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

testDevice ITestDevice : برای اضافه شدن به دستگاه‌های اختصاص داده شده.

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

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

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

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

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

ویژگی addInvocation 

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

تابع زمان‌بندی و فراخوانی addInvocation 

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

دریافت ویژگی 

public String getAttribute (String key)

روشی مناسب برای بازیابی ویژگی زمینه فراخوانی به عنوان یک جفت کلید-مقدار واحد. هرگز مقدار null برنمی‌گرداند.

پارامترها
key String

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

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

public abstract MultiMap<String, String> getAttributes ()

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

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

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

public abstract IBuildInfo getBuildInfo (String deviceName)

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

پارامترها
deviceName String

بازگشت‌ها
IBuildInfo

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

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

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

پارامترها
testDevice ITestDevice

بازگشت‌ها
IBuildInfo

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

public abstract String getBuildInfoName (IBuildInfo info)

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

پارامترها
info IBuildInfo

بازگشت‌ها
String

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

public abstract List<IBuildInfo> getBuildInfos ()

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

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

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

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

بازگشت‌ها
ConfigurationDescriptor

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

public abstract ITestDevice getDevice (String deviceName)

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

پارامترها
deviceName String

بازگشت‌ها
ITestDevice

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

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

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

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

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

public abstract ITestDevice getDeviceBySerial (String serial)

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

پارامترها
serial String

بازگشت‌ها
ITestDevice

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

public abstract List<String> getDeviceConfigNames ()

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

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

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

public abstract String getDeviceName (ITestDevice device)

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

پارامترها
device ITestDevice

بازگشت‌ها
String

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

public abstract List<ITestDevice> getDevices ()

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

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

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

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

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

public abstract List<String> getSerials ()

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

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

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

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

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

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

تگ getTest 

public abstract String getTestTag ()

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

بازگشت‌ها
String

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

public abstract void markReleasedEarly ()

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

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

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

پارامترها
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext 

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

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

پارامترها
invocationContext IInvocationContext

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

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

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

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

تنظیمTestTag 

public abstract void setTestTag (String testTag)

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

پارامترها
testTag String

توپروتو 

public abstract InvocationContext.Context toProto ()

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

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

زود منتشر شد 

public abstract boolean wasReleasedEarly ()

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

بازگشت‌ها
boolean