IsolatedHostTest

public class IsolatedHostTest
extends Object implements IBuildReceiver, IConfigurationReceiver, IRemoteTest, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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


تنفيذ برنامج تشغيل TradeFed يستخدم عملية فرعية لتنفيذ الاختبارات في بيئة ذات تبعية منخفضة بدلاً من تنفيذها في العملية الرئيسية

يفترض هذا المشغّل أنّ جميع ملفات JAR التي تم ضبطها موجودة في دليل الاختبار نفسه، ويشغّل العملية الفرعية في هذا الدليل. وبما أنّه يجب اختيار دليل عمل للعملية الفرعية، وبما أنّ العديد من الاختبارات تستفيد من أن يكون هذا الدليل هو دليل الاختبار، كان هذا هو أفضل حل وسط متاح.

ملخّص

طُرق وضع التصميم العامة

IsolatedHostTest()

الإجراءات العامة

void addAllExcludeAnnotation(Set<String> notAnnotations)

تضيف هذه السمة Set من التعليقات التوضيحية التي سيتم استبعادها إذا تم وضع علامة عليها في الاختبارات.

void addAllExcludeFilters(Set<String> filters)

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

void addAllIncludeAnnotation(Set<String> annotations)

تضيف هذه السمة Set من التعليقات التوضيحية التي سيتم تضمينها إذا تم وضع علامة عليها في الاختبارات.

void addAllIncludeFilters(Set<String> filters)

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

void addExcludeAnnotation(String notAnnotation)

يضيف تعليقًا توضيحيًا لاستبعاده إذا تم وضع علامة عليه.

void addExcludeFilter(String filter)

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

void addIncludeAnnotation(String annotation)

يضيف تعليقًا توضيحيًا ليتم تضمينه إذا تم وضع علامة عليه في الاختبارات.

void addIncludeFilter(String filter)

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

void clearExcludeAnnotations()

حذف جميع التعليقات التوضيحية الخاصة بالاستبعاد التي يتم تتبُّعها حاليًا

void clearExcludeFilters()

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

void clearIncludeAnnotations()

حذف جميع التعليقات التوضيحية التي يتم تتبّعها حاليًا

void clearIncludeFilters()

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

String compileClassPath()

تنشئ هذه السمة مسار فئات للعملية الفرعية يتضمّن ملفات JAR اللازمة لتشغيل الاختبارات.

List<String> compileCommandArgs(String classpath, File artifactsDir)

تجميع وسيطات الأمر لتنفيذ برنامج تشغيل العمليات الفرعية

void deleteTempFiles()
File getCoverageExecFile()
Set<String> getExcludeAnnotations()

تعرض هذه السمة Set التعليقات التوضيحية المطلوب استبعادها.

Set<String> getExcludeFilters()

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

Set<String> getIncludeAnnotations()

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

Set<String> getIncludeFilters()

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

void run(TestInformation testInfo, ITestInvocationListener listener)

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

void setBuild(IBuildInfo build)

void setCollectTestsOnly(boolean shouldCollectTest)

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

void setConfiguration(IConfiguration configuration)

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

void setDebug(boolean debug)
Collection<IRemoteTest> split(int shardCount)

نسخة بديلة من split() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه.

void uploadTestArtifacts(File logDir, ITestInvocationListener listener)
boolean useRavenwoodResources()
boolean useRobolectricResources()

طُرق محمية

String compileLdLibraryPathInner(String androidHostOut)

نستدعي هذا الإصدار من اختبار الوحدة، ونمرِّر ANDROID_HOST_OUT مباشرةً.

File getJarFile(String jarName, TestInformation testInfo)

تم نسخها من HostTest لمحاكاة استخدام اختبار الوحدة.

void setServer(ServerSocket server)

طُرق وضع التصميم العامة

IsolatedHostTest

public IsolatedHostTest ()

الإجراءات العامة

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> notAnnotations)

تضيف هذه السمة Set من التعليقات التوضيحية التي سيتم استبعادها إذا تم وضع علامة عليها في الاختبارات.

المعلَمات
notAnnotations Set

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

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

المعلَمات
filters Set

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

تضيف هذه السمة Set من التعليقات التوضيحية التي سيتم تضمينها إذا تم وضع علامة عليها في الاختبارات.

المعلَمات
annotations Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

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

المعلَمات
filters Set

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

يضيف تعليقًا توضيحيًا لاستبعاده إذا تم وضع علامة عليه.

المعلَمات
notAnnotation String

addExcludeFilter

public void addExcludeFilter (String filter)

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

المعلَمات
filter String

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

يضيف تعليقًا توضيحيًا ليتم تضمينه إذا تم وضع علامة عليه في الاختبارات.

المعلَمات
annotation String

addIncludeFilter

public void addIncludeFilter (String filter)

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

المعلَمات
filter String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

حذف جميع التعليقات التوضيحية الخاصة بالاستبعاد التي يتم تتبُّعها حاليًا

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

حذف جميع التعليقات التوضيحية التي يتم تتبّعها حاليًا

clearIncludeFilters

public void clearIncludeFilters ()

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

compileClassPath

public String compileClassPath ()

تنشئ هذه السمة مسار فئات للعملية الفرعية يتضمّن ملفات JAR اللازمة لتشغيل الاختبارات.

المرتجعات
String سلسلة تحدّد مسار الفئة المفصول بنقطتين.

compileCommandArgs

public List<String> compileCommandArgs (String classpath, 
                File artifactsDir)

تجميع وسيطات الأمر لتنفيذ برنامج تشغيل العمليات الفرعية

المعلَمات
classpath String

artifactsDir File

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

deleteTempFiles

public void deleteTempFiles ()

getCoverageExecFile

public File getCoverageExecFile ()

المرتجعات
File

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

تعرض هذه السمة Set التعليقات التوضيحية المطلوب استبعادها.

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

getExcludeFilters

public Set<String> getExcludeFilters ()

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

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

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

تعرض هذه السمة 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

setBuild

public void setBuild (IBuildInfo build)

المعلَمات
build IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

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

المعلَمات
configuration IConfiguration

setDebug

public void setDebug (boolean debug)

المعلَمات
debug boolean

تقسيم

public Collection<IRemoteTest> split (int shardCount)

نسخة بديلة من split() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه. ويكون ذلك مفيدًا لبعض أدوات تشغيل الاختبار التي لا يمكنها اتخاذ قرار بشكل عشوائي في بعض الأحيان.

المعلَمات
shardCount int: عدد الأجزاء التي تمت محاولة إنشائها.

المرتجعات
Collection<IRemoteTest> مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتجزئة حاليًا

uploadTestArtifacts

public void uploadTestArtifacts (File logDir, 
                ITestInvocationListener listener)

المعلَمات
logDir File

listener ITestInvocationListener

useRavenwoodResources

public boolean useRavenwoodResources ()

المرتجعات
boolean

useRobolectricResources

public boolean useRobolectricResources ()

المرتجعات
boolean

طُرق محمية

compileLdLibraryPathInner

protected String compileLdLibraryPathInner (String androidHostOut)

نستدعي هذا الإصدار من اختبار الوحدة، ونمرِّر ANDROID_HOST_OUT مباشرةً. نحتاج إلى ذلك لأنّ Java لا تتضمّن واجهة برمجة تطبيقات لضبط متغيرات البيئة.

المعلَمات
androidHostOut String

المرتجعات
String

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

تم نسخها من HostTest لمحاكاة استخدام اختبار الوحدة.

افحص عدة مواقع جغرافية يتواجد فيها عادةً العنصر المستخرَج لحالات استخدام مختلفة للعثور على ملف JAR.

المعلَمات
jarName String

testInfo TestInformation

القيم المُعادة
File

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

setServer

protected void setServer (ServerSocket server)

المعلَمات
server ServerSocket