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. 

الحقول

public static final String CHECKER_PAR_FILENAME

وظائف الإنشاء العامة

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)

نفِّذ اختبارًا في "أداة التحقّق" وتحقّق من النتيجة.

void extractSourcesFromJar(File tmpCheckerLocalDir, File jar)

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

File getCheckerBinaryPath(TestInformation testInfo)

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

runChecker(String[] checkerCommandLine)

شغِّل أحد أوامر "أداة التحقّق" وتحقّق من النتيجة.

الحقول

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

وظائف الإنشاء العامة

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: رمز الخروج الذي يعرضه الأمر test

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

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)

نفِّذ اختبارًا في "أداة التحقّق" وتحقّق من النتيجة.

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

المعلمات
testInfo TestInformation: عنصر TestInformation المرتبط بالاختبار الذي تم تنفيذه

listener ITestInvocationListener: عنصر ITestInvocationListener المرتبط بالاختبار الذي تم تنفيذه

المرتجعات
رسالة خطأ اختيارية، تكون فارغة إذا نجح اختبار "أداة التحقّق"

عمليات الرمي
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)

شغِّل أحد أوامر "أداة التحقّق" وتحقّق من النتيجة.

المعلمات
checkerCommandLine String: سطر أوامر "أداة التحقّق" المطلوب تنفيذه

المرتجعات
رسالة خطأ اختيارية، تكون فارغة إذا كان استدعاء "أداة التحقّق" ناجحًا