تست واحد اندروید

public class AndroidJUnitTest
extends InstrumentationTest implements IRuntimeHintProvider , IShardableTest , ITestAnnotationFilterReceiver , ITestFileFilterReceiver , ITestFilterReceiver

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

آزمایشی که با استفاده از android.support.test.runner.AndroidJUnitRunner، یک بسته تست ابزار دقیق را روی دستگاه مورد نظر اجرا می‌کند.

خلاصه

ثابت‌ها

String EXCLUDE_COLLECTOR_FILTER_KEY

String INCLUDE_COLLECTOR_FILTER_KEY

گزینه‌هایی از کتابخانه کمکی سمت جمع‌کننده.

String NEW_RUN_LISTENER_ORDER_KEY

آرگومان اجراکننده‌ی تست instrumentation که برای فعال کردن دستور RunListener جدید در سمت دستگاه استفاده می‌شود.

String USE_TEST_STORAGE_SERVICE

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

AndroidJUnitTest ()

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

void addAllExcludeAnnotation ( excludeAnnotations)

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

void addAllExcludeFilters ( filters)

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

void addAllIncludeAnnotation ( annotations)

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

void addAllIncludeFilters ( filters)

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

void addExcludeAnnotation (String excludeAnnotation)

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

void addExcludeFilter (String filter)

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

void addIncludeAnnotation (String annotation)

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

void addIncludeFilter (String filter)

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

void clearExcludeAnnotations ()

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

void clearExcludeFilters ()

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

void clearIncludeAnnotations ()

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

void clearIncludeFilters ()

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

getExcludeAnnotations ()

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

getExcludeFilters ()

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

File getExcludeTestFile ()

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

getIncludeAnnotations ()

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

getIncludeFilters ()

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

File getIncludeTestFile ()

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

long getRuntimeHint ()

زمان اجرای مورد انتظار تست را بر حسب میلی ثانیه برگردانید.

boolean isClassOrMethod (String filter)

اگر رشته، نام یک کلاس یا یک متد باشد، آن را برمی‌گرداند.

boolean isParameterizedTest (String filter)

اگر یک رشته، یک تست پارامتری باشد، آن را برمی‌گرداند.

boolean isRegex (String filter)

اگر رشته‌ای با عبارت منظم (regex) برای فیلتر باشد، آن را برمی‌گرداند.

void run ( TestInformation testInfo, ITestInvocationListener listener)

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

void setExcludeTestFile (File testFile)

فایل آزمایشی موارد مستثنی را تنظیم می‌کند.

void setIncludeTestFile (File testFile)

فایل آزمایشی includes را تنظیم می‌کند.

split (int shardCount)

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

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

void setRunnerArgs ( IRemoteAndroidTestRunner runner)

ثابت‌ها

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

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

مقدار ثابت: "exclude-filter-group"

کلید فیلتر را شامل کنید 

public static final String INCLUDE_COLLECTOR_FILTER_KEY

گزینه‌هایی از کتابخانه کمکی سمت جمع‌کننده.

مقدار ثابت: "include-filter-group"

کلید دستور اجرای جدید 

public static final String NEW_RUN_LISTENER_ORDER_KEY

آرگومان اجراکننده‌ی تست instrumentation که برای فعال کردن دستور RunListener جدید در سمت دستگاه استفاده می‌شود.

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

استفاده از سرویس ذخیره‌سازی آزمایشی 

public static final String USE_TEST_STORAGE_SERVICE

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

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

تست واحد اندروید 

public AndroidJUnitTest ()

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

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

public void addAllExcludeAnnotation ( excludeAnnotations)

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

پارامترها
excludeAnnotations

فیلترهای 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 excludeAnnotation)

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

پارامترها
excludeAnnotation 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 ()

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

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

public  getExcludeAnnotations ()

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

بازگشت‌ها

فیلترهای getExclude 

public  getExcludeFilters ()

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

بازگشت‌ها

getExcludeTestFile 

public File getExcludeTestFile ()

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

بازگشت‌ها
File

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

public  getIncludeAnnotations ()

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

بازگشت‌ها

فیلترهای getInclude 

public  getIncludeFilters ()

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

بازگشت‌ها

دریافت فایل شامل تست 

public File getIncludeTestFile ()

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

بازگشت‌ها
File

getRuntimeHint 

public long getRuntimeHint ()

زمان اجرای مورد انتظار تست را بر حسب میلی‌ثانیه برمی‌گرداند. این زمان برای بارگذاری تعادل اجرای تکه‌تکه شده استفاده می‌شود.

بازگشت‌ها
long

isClassOrMethod 

public boolean isClassOrMethod (String filter)

اگر رشته، نام یک کلاس یا یک متد باشد، آن را برمی‌گرداند.

پارامترها
filter String

بازگشت‌ها
boolean

isParameterizedTest 

public boolean isParameterizedTest (String filter)

اگر یک رشته، یک تست پارامتری باشد، آن را برمی‌گرداند.

پارامترها
filter String

بازگشت‌ها
boolean

ایس‌رجکس 

public boolean isRegex (String filter)

اگر رشته‌ای با عبارت منظم (regex) برای فیلتر باشد، آن را برمی‌گرداند.

پارامترها
filter String

بازگشت‌ها
boolean

دویدن 

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

پرتاب‌ها
DeviceNotAvailableException

setExcludeTestFile 

public void setExcludeTestFile (File testFile)

فایل آزمایشیِ موارد استثنا را تنظیم می‌کند. تضمین نمی‌کند که testFile وجود دارد یا یک فایل است.

پارامترها
testFile File

setIncludeTestFile 

public void setIncludeTestFile (File testFile)

فایل آزمایشی includes را تنظیم می‌کند. تضمین نمی‌کند که testFile وجود دارد یا یک فایل است.

پارامترها
testFile File

تقسیم شده 

public  split (int shardCount)

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

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

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

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

setRunnerArgs 

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

پارامترها
runner IRemoteAndroidTestRunner