ArtRunTest

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

java.lang.Object
   ↳ com.android.tradefed.testtype.ArtRunTest

أداة لتشغيل اختبارات ART.

ملخّص

الفئات المتداخلة

class ArtRunTest.AdbShellCommandException

فئة استثناء للإبلاغ عن خطأ حدث أثناء تنفيذ أمر ADB shell. 

الثوابت

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) فلاتر التضمين الحالية.

void run(TestInformation testInfo, ITestInvocationListener listener)

يُجري الاختبارات ويُبلغ المستمع بالنتيجة.

void setAbi(IAbi abi)

void setCollectTestsOnly(boolean shouldCollectTest)

تفعيل وضع جمع الاختبارات أو إيقافه

void setConfiguration(IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

الطُرق المحمية

checkExitCode(Integer exitCode)

تحقَّق من رمز الخروج الذي تعرضه إحدى أوامر الاختبار.

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

التحقّق من الناتج الذي تم إنشاؤه بواسطة أمر اختباري

File createTestLocalTempDirectory(TestInformation testInfo)

أنشِئ دليلاً مؤقتًا محليًا ضمن مجلد التبعيات الخاص بالاختبار، وذلك لجمع نواتج الاختبار التي تم استردادها من الجهاز قيد الاختبار.

executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener)

نفِّذ اختبار Checker وتحقّق من نتيجته.

void extractSourcesFromJar(File tmpCheckerLocalDir, File jar)

استخراج دليل src من ملف jar معيّن إلى دليل معيّن

File getCheckerBinaryPath(TestInformation testInfo)

ابحث عن ملف Checker الثنائي (أرشيف Python).

runChecker(String[] checkerCommandLine)

نفِّذ أمر Checker وتحقّق من نتيجته.

الثوابت

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

Constant Value: "art-run-test-checker"

الحقول

RUN_CHECKER

public static final Boolean RUN_CHECKER

الإنشاءات العامة

ArtRunTest

public ArtRunTest ()

الطُرق العامة

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

تضيف هذه السمة ERROR(/Set) الفلاتر التي يجب استبعاد الاختبارات التي تتطابق معها.

المعلمات
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

تضيف هذه السمة ERROR(/Set) الفلاتر التي يجب تضمين الاختبارات فيها.

المعلمات
filters

addExcludeFilter

public void addExcludeFilter (String filter)

تضيف هذه السمة فلترًا لتحديد الاختبارات التي يجب استبعادها.

المعلمات
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

تضيف هذه السمة فلترًا لتحديد الاختبارات التي يجب تضمينها.

المعلمات
filter String

clearExcludeFilters

public void clearExcludeFilters ()

حذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا

clearIncludeFilters

public void clearIncludeFilters ()

احذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا.

getAbi

public IAbi getAbi ()

المرتجعات
IAbi

getExcludeFilters

public  getExcludeFilters ()

تعرِض هذه السمة ERROR(/Set) فلاتر الاستبعاد الحالية.

المرتجعات

getIncludeFilters

public  getIncludeFilters ()

تعرِض هذه السمة ERROR(/Set) فلاتر التضمين الحالية.

المرتجعات

ضربة طويلة

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

تُجري الاختبارات وتُبلغ المستمع بالنتيجة.

المعلمات
testInfo TestInformation: عنصر TestInformation يحتوي على معلومات مفيدة لتنفيذ الاختبارات.
listener ITestInvocationListener: ITestInvocationListener نتائج الاختبار
الرميات
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

المعلمات
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

تفعيل وضع جمع الاختبارات أو إيقافه

setConfiguration

public void setConfiguration (IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

المعلمات
configuration IConfiguration

الطُرق المحمية

checkExitCode

protected  checkExitCode (Integer exitCode)

تحقَّق من رمز الخروج الذي تم إرجاعه بواسطة أمر اختبار.

المعلمات
exitCode ‫Integer: رمز الخروج الذي يعرضه أمر الاختبار
المرتجعات
رسالة خطأ اختيارية، تكون فارغة إذا أشار رمز الخروج من الاختبار إلى النجاح

checkTestOutput

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

التحقّق من الناتج الذي تم إنشاؤه بواسطة أمر اختباري

يُستخدَم للتحقّق من المخرجات القياسية والأخطاء القياسية في الاختبار.

المعلمات
testInfo TestInformation: عنصر TestInformation المرتبط بالاختبار الذي تم تنفيذه
actualOutputText ‫String: الناتج الذي تم إنشاؤه بواسطة الاختبار
outputShortName ‫String: الاسم المختصر لقناة الإخراج
outputPrettyName ‫String: اسم أكثر جاذبية لقناة الإخراج، ويُستخدم في رسائل الخطأ
المرتجعات
رسالة خطأ اختيارية، تكون فارغة إذا كانت النتيجة التي تم التحقّق منها صالحة

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

أنشِئ دليلاً مؤقتًا محليًا ضمن مجلد التبعيات الخاص بالاختبار، وذلك لجمع نواتج الاختبار التي تم استردادها من الجهاز قيد الاختبار.

المعلمات
testInfo TestInformation: عنصر TestInformation المرتبط بالاختبار الذي تم تنفيذه
المرتجعات
File كائن ERROR(/File) يشير إلى الدليل المؤقت الذي تم إنشاؤه.
الرميات
إذا تعذّر إنشاء الدليل المؤقت

executeCheckerTest

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

نفِّذ اختبار Checker وتحقّق من نتيجته.

اختبارات المدقّق هي اختبارات إضافية مضمّنة في بعض اختبارات وقت التشغيل في ART، وهي مكتوبة كتعليقات توضيحية في تعليقات الملفات المصدر للاختبار، وتُستخدم للتحقّق من صحة برنامج التجميع في ART.

المعلمات
testInfo TestInformation: عنصر TestInformation المرتبط بالاختبار الذي تم تنفيذه
listener ITestInvocationListener: عنصر ITestInvocationListener المرتبط بالاختبار الذي تم تنفيذه
المرتجعات
رسالة خطأ اختيارية، تكون فارغة إذا نجح اختبار Checker
الرميات
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

استخرِج دليل src من ملف jar معيّن إلى دليل معيّن.

المعلمات
tmpCheckerLocalDir File

jar File

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

ابحث عن ملف Checker الثنائي (أرشيف Python).

المعلمات
testInfo TestInformation

المرتجعات
File

runChecker

protected  runChecker (String[] checkerCommandLine)

نفِّذ أمر Checker وتحقّق من نتيجته.

المعلمات
checkerCommandLine String: سطر أوامر "أداة التدقيق" المطلوب تنفيذه
المرتجعات
رسالة خطأ اختيارية، تكون فارغة إذا تم استدعاء Checker بنجاح