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)

כדי לטעון את אובייקט הכיתה ולהגדיר את פרטי הבדיקה (device, 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

יוצרים ציבוריים

בדיקת מארח

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

הסרת הערות

public void clearExcludeAnnotations ()

מחיקת כל ההערות להחרגה שעליהן מתבצע מעקב כרגע.

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

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

ניקוי פילטרים

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)

עוזר להרצת מכשירים להשתמש בו כדי להגדיר אפשרויות באותו אופן כמו HostTest, ממצב מוגדר.

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

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

אובייקט טעינה

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 אם הבדיקה לא אמורה לפעול.