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<ITestDeviceIBuildInfo> 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