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

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

رابطی که اقداماتی را که به عنوان بخشی از یک فراخوانی انجام خواهد شد، توصیف می‌کند. فراخوانی TestInvocation خود ترتیب فراخوانی‌ها را تضمین می‌کند.

خلاصه

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

default void cleanUpBuilds ( IInvocationContext context, IConfiguration config)

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

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

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

default void doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger logger)

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

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

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

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

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

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

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

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

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

default 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)) را فراخوانی کنید.

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

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

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

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

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

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

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

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

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

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

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.BuildError
خطای com.android.tradefed.targetprep.TargetSetupError
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 : استثنای اصلی که توسط اجرای آزمایشی ایجاد می‌شود.

پرتاب‌ها
جاوا.زبان.قابل پرتاب
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) خواهد بود.

پرتاب‌ها
خطای بازیابی ساخت در com.android.tradefed.build.Build
com.android.tradefed.device.DeviceNotAvailableException
BuildRetrievalError
DeviceNotAvailableException

گزارش‌ها 

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

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

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

logger 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 برای گزارش لاگ‌ها.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
خطای com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

تست‌های اجرا 

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

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

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

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

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

پرتاب‌ها
جاوا.زبان.قابل پرتاب
Throwable

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 برمی‌گرداند.