تست میزبان ایزوله

public class IsolatedHostTest
extends Object implements IBuildReceiver , IConfigurationReceiver , IRemoteTest , IShardableTest , ITestAnnotationFilterReceiver , ITestCollector , ITestFilterReceiver

شیء جاوا
↳ com.android.tradefed.testtype.IsolatedHostTest

یک اجراکننده TradeFed را پیاده‌سازی می‌کند که از یک زیرفرآیند برای اجرای تست‌ها در یک محیط با وابستگی کم به جای اجرای آنها در فرآیند اصلی استفاده می‌کند.

این اجراکننده فرض می‌کند که تمام jarهای پیکربندی‌شده در یک دایرکتوری آزمایشی قرار دارند و subprocess را در آن دایرکتوری اجرا می‌کند. از آنجایی که باید یک دایرکتوری کاری برای subprocess انتخاب کند و بسیاری از تست‌ها از آن دایرکتوری به عنوان دایرکتوری آزمایشی بهره‌مند می‌شوند، این بهترین راه حل موجود بود.

خلاصه

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

IsolatedHostTest ()

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

void addAllExcludeAnnotation ( notAnnotations)

یک ERROR(/Set) از حاشیه‌نویسی‌ها را اضافه می‌کند تا در صورت علامت‌گذاری تست‌ها با آن، آن‌ها را حذف کند.

void addAllExcludeFilters ( filters)

ERROR(/Set) فیلترهایی را که تست‌هایشان باید حذف شوند، اضافه می‌کند.

void addAllIncludeAnnotation ( annotations)

اگر تستی با این علامت مشخص شده باشد، یک ERROR(/Set) از حاشیه‌نویسی‌ها را اضافه می‌کند تا شامل شود.

void addAllIncludeFilters ( filters)

ERROR(/Set) فیلترهایی که تست‌هایشان باید لحاظ شوند را اضافه می‌کند.

void addExcludeAnnotation (String notAnnotation)

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

void addExcludeFilter (String filter)

فیلتری اضافه می‌کند که کدام تست‌ها باید حذف شوند.

void addIncludeAnnotation (String annotation)

اگر تستی با حاشیه‌نویسی علامت‌گذاری شده باشد، یک حاشیه‌نویسی اضافه می‌کند تا شامل آن شود.

void addIncludeFilter (String filter)

فیلتری اضافه می‌کند که کدام تست‌ها باید لحاظ شوند.

void clearExcludeAnnotations ()

تمام حاشیه‌نویسی‌های مستثنی که در حال حاضر ردیابی می‌شوند را حذف کنید.

void clearExcludeFilters ()

تمام فیلترهای حذف‌شده‌ای که در حال حاضر ردیابی می‌شوند را حذف کنید.

void clearIncludeAnnotations ()

تمام حاشیه‌نویسی‌های include که در حال حاضر ردیابی می‌شوند را حذف کنید.

void clearIncludeFilters ()

تمام فیلترهای موجود که در حال حاضر ردیابی می‌شوند را حذف کنید.

String compileClassPath ()

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

compileCommandArgs (String classpath, File artifactsDir)

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

void deleteTempFiles ()
File getCoverageExecFile ()
getExcludeAnnotations ()

مقدار ERROR(/Set) فعلی حاشیه‌نویسی‌هایی که باید حذف شوند را برمی‌گرداند.

getExcludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای مستثنی شده را برمی‌گرداند.

getIncludeAnnotations ()

مقدار ERROR(/Set) فعلی حاشیه‌نویسی‌هایی که باید لحاظ شوند را برمی‌گرداند.

getIncludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای include شده را برمی‌گرداند.

void run ( TestInformation testInfo, ITestInvocationListener listener)

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

void setBuild ( IBuildInfo build)

void setCollectTestsOnly (boolean shouldCollectTest)

حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند

void setConfiguration ( IConfiguration configuration)

IConfiguration مورد استفاده را تزریق می‌کند.

void setDebug (boolean debug)
split (int shardCount)

نسخه جایگزین split() که shardCount مورد نظر برای اجرا را نیز ارائه می‌دهد.

void uploadTestArtifacts (File logDir, ITestInvocationListener listener)
boolean useRavenwoodResources ()
boolean useRobolectricResources ()

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

String compileLdLibraryPathInner (String androidHostOut)

ما این نسخه را از تست واحد فراخوانی می‌کنیم و مستقیماً ANDROID_HOST_OUT را ارسال می‌کنیم.

File getJarFile (String jarName, TestInformation testInfo)

از HostTest کپی شده تا از مهار تست واحد آن تقلید کند.

void setServer (ServerSocket server)

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

تست میزبان ایزوله 

public IsolatedHostTest ()

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

حاشیه‌نویسی addAllExclude 

public void addAllExcludeAnnotation ( notAnnotations)

یک ERROR(/Set) از حاشیه‌نویسی‌ها را اضافه می‌کند تا در صورت علامت‌گذاری تست‌ها با آن، آن‌ها را حذف کند.

پارامترها
notAnnotations

فیلترهای addAllExclude 

public void addAllExcludeFilters ( filters)

ERROR(/Set) فیلترهایی را که تست‌هایشان باید حذف شوند، اضافه می‌کند.

پارامترها
filters

حاشیه‌نویسی addAllInclude 

public void addAllIncludeAnnotation ( annotations)

اگر تستی با این علامت مشخص شده باشد، یک ERROR(/Set) از حاشیه‌نویسی‌ها را اضافه می‌کند تا شامل شود.

پارامترها
annotations

فیلترهای addAllInclude 

public void addAllIncludeFilters ( filters)

ERROR(/Set) فیلترهایی که تست‌هایشان باید لحاظ شوند را اضافه می‌کند.

پارامترها
filters

حاشیه‌نویسی addExclude 

public void addExcludeAnnotation (String notAnnotation)

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

پارامترها
notAnnotation String

فیلتر addExclude 

public void addExcludeFilter (String filter)

فیلتری اضافه می‌کند که کدام تست‌ها باید حذف شوند.

پارامترها
filter String

حاشیه‌نویسی addInclude 

public void addIncludeAnnotation (String annotation)

اگر تستی با حاشیه‌نویسی علامت‌گذاری شده باشد، یک حاشیه‌نویسی اضافه می‌کند تا شامل آن شود.

پارامترها
annotation String

فیلتر addInclude 

public void addIncludeFilter (String filter)

فیلتری اضافه می‌کند که کدام تست‌ها باید لحاظ شوند.

پارامترها
filter String

حاشیه‌نویسی‌های clearExclude 

public void clearExcludeAnnotations ()

تمام حاشیه‌نویسی‌های مستثنی که در حال حاضر ردیابی می‌شوند را حذف کنید.

فیلترهای clearExclude 

public void clearExcludeFilters ()

تمام فیلترهای حذف‌شده‌ای که در حال حاضر ردیابی می‌شوند را حذف کنید.

حاشیه‌نویسی‌های clearInclude 

public void clearIncludeAnnotations ()

تمام حاشیه‌نویسی‌های include که در حال حاضر ردیابی می‌شوند را حذف کنید.

فیلترهای clearInclude 

public void clearIncludeFilters ()

تمام فیلترهای موجود که در حال حاضر ردیابی می‌شوند را حذف کنید.

کامپایل کلاس‌پَچ 

public String compileClassPath ()

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

بازگشت‌ها
String رشته‌ای که مسیر کلاس (classpath) را که با علامت دونقطه از هم جدا شده است، مشخص می‌کند.

کامپایل آرگ‌های دستوری 

public  compileCommandArgs (String classpath, 
                File artifactsDir)

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

پارامترها
classpath String

artifactsDir File

بازگشت‌ها

حذف فایل‌های موقت 

public void deleteTempFiles ()

دریافت فایل اجرایی پوشش 

public File getCoverageExecFile ()

بازگشت‌ها
File

حاشیه‌نویسی‌های getExclude 

public  getExcludeAnnotations ()

مقدار ERROR(/Set) فعلی حاشیه‌نویسی‌هایی که باید حذف شوند را برمی‌گرداند.

بازگشت‌ها

فیلترهای getExclude 

public  getExcludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای مستثنی شده را برمی‌گرداند.

بازگشت‌ها

حاشیه‌نویسی‌های getInclude 

public  getIncludeAnnotations ()

مقدار ERROR(/Set) فعلی حاشیه‌نویسی‌هایی که باید لحاظ شوند را برمی‌گرداند.

بازگشت‌ها

فیلترهای getInclude 

public  getIncludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای include شده را برمی‌گرداند.

بازگشت‌ها

دویدن 

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

پارامترها
testInfo TestInformation : شیء TestInformation که حاوی اطلاعات مفیدی برای اجرای تست‌ها است.

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

پرتاب‌ها
DeviceNotAvailableException

مجموعه ساخت 

public void setBuild (IBuildInfo build)

پارامترها
build IBuildInfo

فقط تست‌های جمع‌آوری‌شده 

public void setCollectTestsOnly (boolean shouldCollectTest)

حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند

پیکربندی set 

public void setConfiguration (IConfiguration configuration)

IConfiguration مورد استفاده را تزریق می‌کند.

پارامترها
configuration IConfiguration

اشکال‌زدایی تنظیم‌شده 

public void setDebug (boolean debug)

پارامترها
debug boolean

تقسیم شده 

public  split (int shardCount)

نسخه جایگزین split() که shardCount مورد نظر برای اجرا را نیز ارائه می‌دهد. این برای برخی از اجراکنندگان تست که گاهی اوقات نمی‌توانند به طور دلخواه تصمیم بگیرند، مفید است.

پارامترها
shardCount int : تعداد تکه‌های تلاش‌شده.

بازگشت‌ها
مجموعه‌ای از زیرآزمون‌ها که باید جداگانه اجرا شوند یا اگر آزمون در حال حاضر قابل تقسیم‌بندی نیست، null

آپلودتست‌آرتیفکت‌ها 

public void uploadTestArtifacts (File logDir, 
                ITestInvocationListener listener)

پارامترها
logDir File

listener ITestInvocationListener

منابع useRavenwood 

public boolean useRavenwoodResources ()

بازگشت‌ها
boolean

منابع روبولکتریک 

public boolean useRobolectricResources ()

بازگشت‌ها
boolean

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

compileLdLibraryPathInner 

protected String compileLdLibraryPathInner (String androidHostOut)

ما این نسخه را از تست واحد فراخوانی می‌کنیم و مستقیماً ANDROID_HOST_OUT را ارسال می‌کنیم. ما به آن نیاز داریم زیرا جاوا هیچ API برای تنظیم متغیرهای محیطی ندارد.

پارامترها
androidHostOut String

بازگشت‌ها
String

دریافت فایل Jar 

protected File getJarFile (String jarName, 
                TestInformation testInfo)

از HostTest کپی شده تا از مهار تست واحد آن تقلید کند.

برای یافتن شیشه مورد نظر، چندین مکان را که معمولاً مصنوعات در آنها قرار دارند، برای موارد استفاده مختلف بررسی کنید.

پارامترها
jarName String

testInfo TestInformation

بازگشت‌ها
File

تنظیم سرور 

protected void setServer (ServerSocket server)

پارامترها
server ServerSocket