اجرای فراخوانی

public class InvocationExecution
extends Object implements IInvocationExecution

شیء جاوا
↳ com.android.tradefed.invoker.InvocationExecution

کلاسی که تمام مراحل فراخوانی را شرح می‌دهد: ساخت، دانلود، target_prep، اجرای تست‌ها، پاکسازی. می‌تواند برای لغو رفتار پیش‌فرض برخی از مراحل گسترش یابد. ترتیب مراحل توسط TestInvocation تعیین می‌شود.

خلاصه

ثابت‌ها

String ADB_VERSION_KEY

String JAVA_CLASSPATH_KEY

String JAVA_VERSION_KEY

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

InvocationExecution ()

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

void cleanUpBuilds ( IInvocationContext context, IConfiguration config)

مرحله پاکسازی build_provider را اجرا کنید.

void doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception)

مراحل پاکسازی target_preparer و multi_target_preparer را اجرا کنید.

void doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener)

مراحل راه‌اندازی target_preparer و multi_target_preparer را اجرا کنید.

void doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)

مراحل حذف target_preparer و multi_target_preparer را اجرا کنید.

boolean fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)

مرحله build_provider از فراخوانی را اجرا کنید.

void reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)

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

void runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception)

برای هر بخش دستگاه از فراخوانی ITestDevice.postInvocationTearDown(Throwable) را فراخوانی کنید.

void runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger)

برای هر بخش از دستگاه فراخوانی ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) را فراخوانی کنید.

void runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener)

آزمون را اجرا می‌کند.

boolean shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)

تلاش برای تقسیم پیکربندی به زیرپیکربندی‌ها، تا برای اجرا روی چندین منبع به صورت موازی، مجدداً زمان‌بندی شوند.

روش‌های محافظت‌شده

void collectAutoInfo ( IConfiguration config, TestInformation info)

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

IShardHelper createShardHelper ()

یک IShardHelper برای استفاده ایجاد کنید.

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

قبل از preInvocationSetup، فرصتی برای شخصی‌سازی برخی از دستگاه‌ها فراهم کنید.

String getAdbVersion ()

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

getLabPreparersToRun ( IConfiguration config, String deviceName)

فهرستی از آماده‌سازهای آزمایشگاهی برای اجرا روی این دستگاه را بازیابی کنید.

getTargetPreparersToRun ( IConfiguration config, String deviceName)

فهرستی از آماده‌سازهای هدف برای اجرا روی این دستگاه را بازیابی کنید.

void linkExternalDirs ( IBuildInfo info, TestInformation testInfo)
void logHostAdb ( IConfiguration config, ITestLogger logger)

گزارش‌ها را از $TMPDIR/adb.$UID.log جمع‌آوری کنید.

Throwable runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)
void setTestTag ( IBuildInfo info, IConfiguration config)

تنظیم برچسب آزمایشی روی اطلاعات ساخت را مدیریت کنید.

ثابت‌ها

کلید نسخه ADB 

public static final String ADB_VERSION_KEY

مقدار ثابت: "adb_version"

JAVA_CLASSPATH_KEY 

public static final String JAVA_CLASSPATH_KEY

مقدار ثابت: "java_classpath"

کلید نسخه جاوا 

public static final String JAVA_VERSION_KEY

مقدار ثابت: "java_version"

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

اجرای فراخوانی 

public InvocationExecution ()

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

cleanUpBuilds 

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

مرحله پاکسازی build_provider را اجرا کنید. این مرحله با دریافت فایل build مرتبط است.

پارامترها
context IInvocationContext : همان IInvocationContext مربوط به فراخوانی است.

config IConfiguration : IConfiguration مربوط به این اجرای آزمایشی.

انجام پاکسازی 

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

مراحل پاکسازی target_preparer و multi_target_preparer را اجرا کنید. آیا دستگاه‌ها پاکسازی می‌شوند؟

پارامترها
context IInvocationContext : همان IInvocationContext مربوط به فراخوانی است.

config IConfiguration : IConfiguration مربوط به این اجرای آزمایشی.

exception Throwable : استثنای اصلی که توسط اجرای آزمایشی ایجاد می‌شود.

راه‌اندازی 

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

مراحل راه‌اندازی target_preparer و multi_target_preparer را اجرا کنید. آیا تمام تنظیمات دستگاه‌های مورد نیاز برای اجرای تست انجام می‌شود؟

پارامترها
testInfo TestInformation : TestInformation مربوط به فراخوانی.

config IConfiguration : IConfiguration مربوط به این اجرای آزمایشی.

listener ITestLogger : ITestLogger برای گزارش گزارش‌های خرابی‌های راه‌اندازی.

پرتاب‌ها
BuildError
DeviceNotAvailableException
TargetSetupError

کالبدشکافی 

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

مراحل جداسازی target_preparer و multi_target_preparer را اجرا کنید. آیا دستگاه‌های مرتبط با راه‌اندازی، جداسازی می‌شوند؟

پارامترها
testInfo TestInformation : TestInformation مربوط به فراخوانی.

config IConfiguration : IConfiguration مربوط به این اجرای آزمایشی.

logger ITestLogger : ITestLogger برای گزارش لاگ‌ها.

exception Throwable : استثنای اصلی که توسط اجرای آزمایشی ایجاد می‌شود.

ساخت واکشی 

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

مرحله build_provider از فراخوانی را اجرا کنید.

پارامترها
testInfo TestInformation : TestInformation مربوط به فراخوانی.

config IConfiguration : IConfiguration مربوط به این اجرای آزمایشی.

rescheduler IRescheduler : IRescheduler ، برای زمان‌بندی مجدد بخش‌هایی از فراخوانی برای اجرا در منبع(های) دیگر

listener ITestInvocationListener : ITestInvocation برای گزارش خطاهای دانلود build.

بازگشت‌ها
boolean اگر با موفقیت نسخهٔ نهایی را دانلود کرده باشیم، مقدار درست (true) و در غیر این صورت مقدار نادرست (false) خواهد بود.

پرتاب‌ها
BuildRetrievalError
DeviceNotAvailableException

گزارش‌ها 

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

گزارش برخی از گزارش‌های دستگاه در مراحل مختلف فراخوانی. به عنوان مثال: logcat.

پارامترها
device ITestDevice : دستگاهی که گزارش‌های لاگ از آن گرفته می‌شود.

listener ITestLogger : ثبت‌کننده‌ی گزارش‌ها.

stage TestInvocation.Stage : مرحله‌ای از فراخوانی که در آن هستیم.

runDevicePostInvocationقطع ارتباط 

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

برای هر بخش دستگاه از فراخوانی ITestDevice.postInvocationTearDown(Throwable) را فراخوانی کنید.

پارامترها
context IInvocationContext : همان IInvocationContext مربوط به فراخوانی است.

config IConfiguration : IConfiguration مربوط به این اجرای آزمایشی.

exception Throwable : استثنای اصلی که توسط تست در حال اجرا در صورت وجود، ایجاد می‌شود.

اجرای تنظیمات پیش از فراخوانی دستگاه 

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

برای هر بخش از دستگاه فراخوانی ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) را فراخوانی کنید.

پارامترها
context IInvocationContext : همان IInvocationContext مربوط به فراخوانی است.

config IConfiguration : IConfiguration مربوط به این اجرای آزمایشی.

logger ITestLogger : ITestLogger برای گزارش لاگ‌ها.

پرتاب‌ها
DeviceNotAvailableException
TargetSetupError

تست‌های اجرا 

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

آزمون را اجرا می‌کند.

پارامترها
info TestInformation : TestInformation که تست‌ها با آن اجرا می‌شوند.

config IConfiguration : IConfiguration که قرار است اجرا شود

listener ITestInvocationListener : ITestInvocationListener از نتایج تست

shardConfig 

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

تلاش برای تقسیم پیکربندی به زیرپیکربندی‌ها، تا برای اجرا روی چندین منبع به صورت موازی، مجدداً زمان‌بندی شوند.

اگر تعداد قطعات بیشتر از ۱ باشد، به سادگی با تنظیم شاخص‌های قطعات، پیکربندی‌هایی برای هر قطعه ایجاد کرده و آنها را مجدداً زمان‌بندی می‌کند. اگر تعداد قطعات تنظیم نشده باشد، به IShardHelper.shardConfig رجوع می‌شود.

پارامترها
config IConfiguration : IConfiguration فعلی.

testInfo TestInformation : TestInformation اطلاعات تست‌ها را در خود نگه می‌دارد.

rescheduler IRescheduler : IRescheduler .

logger ITestLogger : ITestLogger برای ثبت فایل در طول فرآیند شاردینگ استفاده می‌شود.

بازگشت‌ها
boolean اگر تست تکه تکه شده باشد، درست است. در غیر این صورت، false برمی‌گرداند.

روش‌های محافظت‌شده

اطلاعات خودکار را جمع‌آوری کنید 

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

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

پارامترها
config IConfiguration

info TestInformation

پرتاب‌ها
DeviceNotAvailableException

ایجادShardHelper 

protected IShardHelper createShardHelper ()

یک IShardHelper برای استفاده ایجاد کنید.

بازگشت‌ها
IShardHelper

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

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

قبل از preInvocationSetup، فرصتی برای شخصی‌سازی برخی از دستگاه‌ها فراهم کنید.

پارامترها
config IConfiguration : پیکربندی فراخوانی.

context IInvocationContext : زمینه‌ی فراخوانی فعلی.

دریافت نسخه Adb 

protected String getAdbVersion ()

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

بازگشت‌ها
String

آماده‌سازان برای اجرای آزمایشگاه 

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

فهرستی از آماده‌سازهای آزمایشگاهی برای اجرا روی این دستگاه را بازیابی کنید.

در کلاس‌های sandbox لغو شده است تا مانع از اجرای آماده‌کننده‌های آزمایشگاهی در داخل کلاس فرزند sandbox شود.

پارامترها
config IConfiguration

deviceName String

بازگشت‌ها

دریافت هدفآماده‌کنندگانبرایاجرا 

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

فهرستی از آماده‌سازهای هدف برای اجرا روی این دستگاه را بازیابی کنید.

در کلاس‌های sandbox لغو شده است تا مانع از اجرای آماده‌کننده‌های آزمایشگاهی در داخل کلاس فرزند sandbox شود.

پارامترها
config IConfiguration

deviceName String

بازگشت‌ها

لینک‌های خارجی 

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

پارامترها
info IBuildInfo

testInfo TestInformation

logHostAdb 

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

گزارش‌ها را از $TMPDIR/adb.$UID.log جمع‌آوری کنید.

پارامترها
config IConfiguration

logger ITestLogger

آماده‌کننده‌های اجراTearDown 

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

پارامترها
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun

trackPreparersMap

بازگشت‌ها
Throwable

تنظیمTestTag 

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

تنظیم برچسب آزمایشی روی اطلاعات ساخت را مدیریت کنید.

پارامترها
info IBuildInfo

config IConfiguration