HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

מפעיל בדיקות לבדיקות מבוססות-מארח של JUnit. אם הבדיקה שתופעל מיישמת את IDeviceTest, ה-Runner הזה יעביר הפניה למכשיר.

סיכום

שדות

public static final String SET_OPTION_DESC

public static final String SET_OPTION_NAME

קונסטרוקטורים גלויים לכולם

HostTest()

שיטות ציבוריות

void addAllExcludeAnnotation( notAnnotations)

הוספת ERROR(/Set) של הערות להחרגה אם בדיקה מסוימת מסומנת בה.

void addAllExcludeFilters( filters)

הוספת ERROR(/Set) של מסננים של בדיקות שרוצים להחריג.

void addAllIncludeAnnotation( annotations)

הוספת ERROR(/Set) של הערות שצריך לכלול אם בדיקה מסוימת מסומנת בהן.

void addAllIncludeFilters( filters)

הוספת ERROR(/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()

מחיקה של כל מסנני ההכללה שבהם מתבצע מעקב כרגע.

int countTestCases()

החזרת מספר תרחישי הבדיקה בכל הכיתות שנכללות בבדיקות

IAbi getAbi()

getClassNames()
ITestDevice getDevice()

מקבלים את המכשיר לבדיקה.

getExcludeAnnotations()

הפונקציה מחזירה את הערך הנוכחי של ERROR(/Set) של ההערות להחרגה.

getExcludeFilters()

הפונקציה מחזירה את הערך הנוכחי של ERROR(/Set) של מסנני החרגה.

getIncludeAnnotations()

הפונקציה מחזירה את הערך הנוכחי של ERROR(/Set) של ההערות שרוצים לכלול.

getIncludeFilters()

הפונקציה מחזירה את הערך הנוכחי של ERROR(/Set) של מסנני ההכללה.

long getRuntimeHint()

הפונקציה מחזירה את זמן הריצה הצפוי של הבדיקה באלפיות שנייה.

void run(TestInformation testInfo, ITestInvocationListener listener)

מפעיל את הבדיקות ומדווח על התוצאות למאזין.

void setAbi(IAbi abi)

void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

הפעלה או השבתה של מצב אוסף הבדיקות

void setConfiguration(IConfiguration configuration)

הזרקת IConfiguration בשימוש.

void setDevice(ITestDevice device)

מזריקים את המכשיר שנבדק.

static void setOptionToLoadedObject(Object testObj, keyValueOptions)

כלי עזר ל-Device Runners, שמאפשר להגדיר אפשרויות באותו אופן כמו HostTest, באמצעות set-option.

void setTestInformation(TestInformation testInfo)
split(Integer shardCount, TestInformation testInfo)

אנחנו מחלקים לפי אדם פרטי לפי סוג הבדיקה או השיטה.

שיטות מוגנות

HostTest createHostTest(Class<?> classObj)

כלי עזר ליצירת מכונה של HostTest במהלך חלוקה למחיצות.

IBuildInfo getBuild()

קבלת פרטי ה-build שהתקבלו על ידי HostTest.

ClassLoader getClassLoader()

הפונקציה מחזירה את מעבד העל של הכיתות שמוגדר כברירת מחדל.

final getClasses()
File getJarFile(String jarName, TestInformation testInfo)

בודקים כמה מיקומים שבהם הארטיפקט נמצא בדרך כלל בתרחישי שימוש שונים כדי למצוא את קובץ ה-jar.

boolean hasJUnit4Annotation(Class<?> classObj)

פונקציית עזרה שבעזרתה אפשר לקבוע אם מדובר בכיתה של בדיקה עם הערות של Junit4.

Object loadObject(Class<?> classObj)

טוענים את אובייקט הכיתה ומגדירים את פרטי הבדיקה (מכשיר, build).

void setClassName(String className)

מוחקים את השם ומגדירים שם של כיתה להרצה.

boolean shouldTestRun(AnnotatedElement annotatedElement)

בדיקה אם רכיבים עם הערה עוברים את הסינון.

שדות

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

קונסטרוקטורים גלויים לכולם

HostTest

public HostTest ()

שיטות ציבוריות

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

הוספת ERROR(/Set) של הערות להחרגה אם בדיקה מסוימת מסומנת בה.

פרמטרים
notAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

הוספת ERROR(/Set) של מסננים של בדיקות שרוצים להחריג.

פרמטרים
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

הוספת ERROR(/Set) של הערות שצריך לכלול אם בדיקה מסוימת מסומנת בהן.

פרמטרים
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

הוספת ERROR(/Set) של מסננים של בדיקות שרוצים לכלול.

פרמטרים
filters

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 ()

מחיקה של כל מסנני ההכללה שבהם מתבצע מעקב כרגע.

countTestCases

public int countTestCases ()

החזרת מספר תרחישי הבדיקה בכל הכיתות שנכללות בבדיקות

החזרות
int

getAbi

public IAbi getAbi ()

החזרות
IAbi

getClassNames

public  getClassNames ()

החזרות

getDevice

public ITestDevice getDevice ()

מקבלים את המכשיר לבדיקה.

החזרות
ITestDevice ITestDevice

getExcludeAnnotations

public  getExcludeAnnotations ()

הפונקציה מחזירה את הערך הנוכחי של ERROR(/Set) של ההערות להחרגה.

החזרות

getExcludeFilters

public  getExcludeFilters ()

הפונקציה מחזירה את הערך הנוכחי של ERROR(/Set) של מסנני החרגה.

החזרות

getIncludeAnnotations

public  getIncludeAnnotations ()

הפונקציה מחזירה את הערך הנוכחי של ERROR(/Set) של ההערות שרוצים לכלול.

החזרות

getIncludeFilters

public  getIncludeFilters ()

הפונקציה מחזירה את הערך הנוכחי של ERROR(/Set) של מסנני ההכללה.

החזרות

getRuntimeHint

public long getRuntimeHint ()

הפונקציה מחזירה את זמן הריצה הצפוי של הבדיקה באלפיות שנייה. הזמן משמש לאיזון העומסים בביצוע המפוצל.

החזרות
long

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

מפעיל את הבדיקות ומדווח על התוצאות למאזין.

פרמטרים
testInfo TestInformation: האובייקט TestInformation שמכיל מידע שימושי להרצת בדיקות.
listener ITestInvocationListener: ITestInvocationListener של תוצאות הבדיקה
זריקות
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

פרמטרים
abi IAbi

setBuild

public void setBuild (IBuildInfo buildInfo)

פרמטרים
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

הפעלה או השבתה של מצב אוסף הבדיקות

setConfiguration

public void setConfiguration (IConfiguration configuration)

הזרקת IConfiguration בשימוש.

פרמטרים
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

מזריקים את המכשיר שנבדק.

פרמטרים
device ITestDevice: ה-ITestDevice לשימוש

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

כלי עזר ל-Device Runners, שמשמש להגדרת אפשרויות באותו אופן כמו HostTest, באמצעות set-option.

פרמטרים
testObj Object: האובייקט שיקבל את האפשרויות.
keyValueOptions : רשימת האפשרויות בפורמט הנדרש לפקודה HostTest set-option.

setTestInformation

public void setTestInformation (TestInformation testInfo)

פרמטרים
testInfo TestInformation

פיצול

public  split (Integer shardCount, 
                TestInformation testInfo)

אנחנו מחלקים לפי אדם פרטי לפי סוג הבדיקה או השיטה.

פרמטרים
shardCount Integer: מספר הניסיונות ליצירת שבר.
testInfo TestInformation: ההורה TestInformation
החזרות
אוסף של בדיקות משנה שיופעלו בנפרד, או null אם אי אפשר לפצל את הבדיקה כרגע

שיטות מוגנות

createHostTest

protected HostTest createHostTest (Class<?> classObj)

פונקציית עזר ליצירת מכונה של HostTest במהלך חלוקה למחיצות. שינוי מברירת המחדל כדי להחזיר כל צאצא מ-HostTest.

פרמטרים
classObj Class

החזרות
HostTest

getBuild

protected IBuildInfo getBuild ()

קבלת פרטי ה-build שהתקבלו על ידי HostTest.

החזרות
IBuildInfo IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

הפונקציה מחזירה את מעבד העל של הכיתות שמוגדר כברירת מחדל.

החזרות
ClassLoader

getClasses

protected final  getClasses ()

החזרות

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

בודקים כמה מיקומים שבהם הארטיפקט נמצא בדרך כלל בתרחישי שימוש שונים כדי למצוא את קובץ ה-jar.

פרמטרים
jarName String

testInfo TestInformation

החזרות
File

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

פונקציית עזרה שבעזרתה אפשר לקבוע אם מדובר בכיתה של בדיקה עם הערות של Junit4.

פרמטרים
classObj Class

החזרות
boolean

loadObject

protected Object loadObject (Class<?> classObj)

טוענים את אובייקט הכיתה ומגדירים את פרטי הבדיקה (מכשיר, build).

פרמטרים
classObj Class

החזרות
Object

setClassName

protected void setClassName (String className)

מוחקים את השם ומגדירים שם של כיתה להרצה.

פרמטרים
className String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

בדיקה אם רכיבים עם הערה עוברים את הסינון. חשוף לבדיקות יחידה.

החזרות
boolean false אם הבדיקה לא אמורה לפעול.