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(
تُضيف |
void
|
addAllIncludeFilters(
تُضيف |
void
|
addExcludeFilter(String filter)
تُضيف فلترًا للاختبارات المطلوب استبعادها. |
void
|
addIncludeFilter(String filter)
تُضيف فلترًا للاختبارات التي تريد تضمينها. |
void
|
clearExcludeFilters()
حذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا |
void
|
clearIncludeFilters()
حذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا |
IAbi
|
getAbi()
|
|
getExcludeFilters()
عرض |
|
getIncludeFilters()
عرض |
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
يُجري الاختبارات ويُبلغ المستمع بالنتيجة. |
void
|
setAbi(IAbi abi)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
تفعيل وضع جمع الاختبارات أو إيقافه |
void
|
setConfiguration(IConfiguration configuration)
تحقِّق من استخدام |
الطرق المحمية | |
---|---|
|
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 ()
حذف جميع فلاتر التضمين التي يتم تتبُّعها حاليًا
ضربة طويلة
public void run (TestInformation testInfo, ITestInvocationListener listener)
يُجري الاختبارات ويُبلغ المستمع بالنتيجة.
المعلمات | |
---|---|
testInfo |
TestInformation : عنصر TestInformation الذي يحتوي على معلومات مفيدة لإجراء
الاختبارات |
listener |
ITestInvocationListener : ITestInvocationListener من نتائج الفحص |
عمليات الرمي | |
---|---|
DeviceNotAvailableException |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
تفعيل وضع جمع الاختبارات أو إيقافه
setConfiguration
public void setConfiguration (IConfiguration configuration)
تحقِّق من استخدام IConfiguration
.
المعلمات | |
---|---|
configuration |
IConfiguration |
الطرق المحمية
checkExitCode
protectedcheckExitCode (Integer exitCode)
تحقَّق من رمز الخروج الذي يعرضه أحد أوامر الاختبار.
المعلمات | |
---|---|
exitCode |
Integer : رمز الخروج الذي يعرضه الأمر test |
المرتجعات | |
---|---|
|
رسالة خطأ اختيارية، تكون فارغة إذا كان رمز الخروج من الاختبار يشير إلى نجاح الاختبار |
checkTestOutput
protectedcheckTestOutput (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
protectedexecuteCheckerTest (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
protectedrunChecker (String[] checkerCommandLine)
شغِّل أحد أوامر "أداة التحقّق" وتحقّق من النتيجة.
المعلمات | |
---|---|
checkerCommandLine |
String : سطر أوامر "أداة التحقّق" المطلوب تنفيذه |
المرتجعات | |
---|---|
|
رسالة خطأ اختيارية، تكون فارغة إذا كان استدعاء "أداة التحقّق" ناجحًا |