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(Set<String> filters)

تضيف هذه السمة Set الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.

void addAllIncludeFilters(Set<String> filters)

تضيف هذه السمة Set فلاتر الاختبارات التي سيتم تضمينها.

void addExcludeFilter(String filter)

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

void addIncludeFilter(String filter)

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

void clearExcludeFilters()

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

void clearIncludeFilters()

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

IAbi getAbi()
Set<String> getExcludeFilters()

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

Set<String> getIncludeFilters()

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

void run(TestInformation testInfo, ITestInvocationListener listener)

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

void setAbi(IAbi abi)

void setCollectTestsOnly(boolean shouldCollectTest)

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

void setConfiguration(IConfiguration configuration)

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

طُرق محمية

Optional<String> checkExitCode(Integer exitCode)

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

Optional<String> checkTestOutput(TestInformation testInfo, String actualOutputText, String outputShortName, String outputPrettyName)

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

File createTestLocalTempDirectory(TestInformation testInfo)

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

Optional<String> executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener)

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

void extractSourcesFromJar(File tmpCheckerLocalDir, File jar)

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

File getCheckerBinaryPath(TestInformation testInfo)

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

Optional<String> 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 (Set<String> filters)

تضيف هذه السمة Set الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.

المعلَمات
filters Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

تضيف هذه السمة Set فلاتر الاختبارات التي سيتم تضمينها.

المعلَمات
filters Set

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 Set<String> getExcludeFilters ()

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

المرتجعات
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

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

المرتجعات
Set<String>

ضربة طويلة

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 Optional<String> checkExitCode (Integer exitCode)

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

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

checkTestOutput

protected Optional<String> checkTestOutput (TestInformation testInfo, 
                String actualOutputText, 
                String outputShortName, 
                String outputPrettyName)

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

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

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

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

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

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

executeCheckerTest

protected Optional<String> executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

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

المعلَمات
tmpCheckerLocalDir File

jar File

عمليات الطرح
IOException

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

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

المعلَمات
testInfo TestInformation

المرتجعات
File

runChecker

protected Optional<String> runChecker (String[] checkerCommandLine)

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

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