آرت ران تست

public class ArtRunTest
extends Object implements IAbiReceiver , IConfigurationReceiver , IRemoteTest , ITestCollector , ITestFilterReceiver

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

یک اجراکننده‌ی تست برای اجرای تست‌های ART.

خلاصه

کلاس‌های تو در تو

class ArtRunTest.AdbShellCommandException

یک کلاس استثنا برای گزارش خطایی که هنگام اجرای یک دستور پوسته ADB رخ داده است.

ثابت‌ها

String CHECKER_PAR_FILENAME

فیلدها

public static final Boolean RUN_CHECKER

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

ArtRunTest ()

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

void addAllExcludeFilters ( filters)

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

void addAllIncludeFilters ( filters)

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

void addExcludeFilter (String filter)

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

void addIncludeFilter (String filter)

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

void clearExcludeFilters ()

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

void clearIncludeFilters ()

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

IAbi getAbi ()
getExcludeFilters ()

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

getIncludeFilters ()

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

void run ( TestInformation testInfo, ITestInvocationListener listener)

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

void setAbi ( IAbi abi)

void setCollectTestsOnly (boolean shouldCollectTest)

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

void setConfiguration ( IConfiguration configuration)

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

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

checkExitCode (Integer exitCode)

کد خروج برگردانده شده توسط یک دستور test را بررسی کنید.

checkTestOutput ( TestInformation testInfo, String actualOutputText, String outputShortName, String outputPrettyName)

خروجی تولید شده توسط یک دستور test را بررسی کنید.

File createTestLocalTempDirectory ( TestInformation testInfo)

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

executeCheckerTest ( TestInformation testInfo, ITestInvocationListener listener)

یک تست Checker اجرا کنید و خروجی آن را بررسی کنید.

void extractSourcesFromJar (File tmpCheckerLocalDir, File jar)

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

File getCheckerBinaryPath ( TestInformation testInfo)

فایل باینری Checker (بایگانی پایتون) را پیدا کنید.

runChecker (String[] checkerCommandLine)

یک دستور Checker اجرا کنید و نتیجه آن را بررسی کنید.

ثابت‌ها

نام فایل بررسی‌کننده 

public static final String CHECKER_PAR_FILENAME

مقدار ثابت: "بررسی‌کننده‌ی تست-اجرای هنری"

فیلدها

بررسی کننده اجرا 

public static final Boolean RUN_CHECKER

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

آرت ران تست 

public ArtRunTest ()

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

فیلترهای addAllExclude 

public void addAllExcludeFilters ( filters)

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

پارامترها
filters

فیلترهای addAllInclude 

public void addAllIncludeFilters ( filters)

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

پارامترها
filters

فیلتر addExclude 

public void addExcludeFilter (String filter)

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

پارامترها
filter String

فیلتر addInclude 

public void addIncludeFilter (String filter)

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

پارامترها
filter String

فیلترهای clearExclude 

public void clearExcludeFilters ()

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

فیلترهای clearInclude 

public void clearIncludeFilters ()

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

دریافت ابی 

public IAbi getAbi ()

بازگشت‌ها
IAbi

فیلترهای getExclude 

public  getExcludeFilters ()

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

بازگشت‌ها

فیلترهای getInclude 

public  getIncludeFilters ()

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

بازگشت‌ها

دویدن 

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

پرتاب‌ها
DeviceNotAvailableException

ست ابی 

public void setAbi (IAbi abi)

پارامترها
abi IAbi

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

public void setCollectTestsOnly (boolean shouldCollectTest)

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

پیکربندی set 

public void setConfiguration (IConfiguration configuration)

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

پارامترها
configuration IConfiguration

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

کد خروج را بررسی کنید 

protected  checkExitCode (Integer exitCode)

کد خروج برگردانده شده توسط یک دستور test را بررسی کنید.

پارامترها
exitCode Integer : کد خروجی که توسط دستور test برگردانده می‌شود

بازگشت‌ها
یک پیام خطای اختیاری، اگر کد خروج آزمایشی موفقیت‌آمیز بود، خالی باشد.

بررسی خروجی تست 

protected  checkTestOutput (TestInformation testInfo, 
                String actualOutputText, 
                String outputShortName, 
                String outputPrettyName)

خروجی تولید شده توسط یک دستور test را بررسی کنید.

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

پارامترها
testInfo TestInformation : شیء TestInformation مرتبط با تست اجرا شده

actualOutputText String : خروجی تولید شده توسط تست

outputShortName String : نام کوتاه کانال خروجی

outputPrettyName String : نامی زیباتر برای کانال خروجی، که در پیام‌های خطا استفاده می‌شود

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

ایجادTestLocalTempDirectory 

protected File createTestLocalTempDirectory (TestInformation testInfo)

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

پارامترها
testInfo TestInformation : شیء TestInformation مرتبط با تست اجرا شده

بازگشت‌ها
File شیء ERROR(/File) که به دایرکتوری موقت ایجاد شده اشاره می‌کند.

پرتاب‌ها
اگر ایجاد دایرکتوری موقت ناموفق بود.

اجرا کردن بررسی‌کننده 

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

یک تست Checker اجرا کنید و خروجی آن را بررسی کنید.

تست‌های بررسی‌کننده، تست‌های اضافی هستند که در برخی از تست‌های اجرای ART گنجانده شده‌اند، به صورت حاشیه‌نویسی در نظرات فایل‌های منبع تست نوشته می‌شوند و برای تأیید کامپایلر ART استفاده می‌شوند.

پارامترها
testInfo TestInformation : شیء TestInformation مرتبط با تست اجرا شده

listener ITestInvocationListener : شیء ITestInvocationListener مرتبط با تست اجرا شده

بازگشت‌ها
یک پیام خطای اختیاری، در صورت موفقیت‌آمیز بودن تست Checker خالی است.

پرتاب‌ها
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException

استخراج منابع از Jar 

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

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

پارامترها
tmpCheckerLocalDir File

jar File

getCheckerBinaryPath 

protected File getCheckerBinaryPath (TestInformation testInfo)

فایل باینری Checker (بایگانی پایتون) را پیدا کنید.

پارامترها
testInfo TestInformation

بازگشت‌ها
File

runChecker 

protected  runChecker (String[] checkerCommandLine)

یک دستور Checker اجرا کنید و نتیجه آن را بررسی کنید.

پارامترها
checkerCommandLine String : خط فرمان Checker برای اجرا

بازگشت‌ها
یک پیام خطای اختیاری، در صورت موفقیت‌آمیز بودن فراخوانی Checker، خالی است.