HostTest

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

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

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

סיכום

ערכים קבועים

String SET_OPTION_DESC

String SET_OPTION_NAME

Constructors ציבוריים

HostTest()

‫methods ציבוריים

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

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

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

קבלת פרטי הגרסה שמתקבלים על ידי 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

ערך קבוע: "אפשרויות להעברה למחלקה שנבדקת, המפתח והערך צריכים להיות מופרדים בנקודתיים ':'; לדוגמה, אם המחלקה שנבדקת תומכת ב-‎'--iteration 1' משורת פקודה, צריך להעביר אותה כ-‎'--set-option iteration:1' או כ-‎'--set-option iteration:key=value' כדי להעביר אפשרויות למיפוי. אפשר להוסיף לערכים שמכילים את התווים ':' או '=' קו נטוי הפוך כדי לבטל את המשמעות שלהם. אפשר לטרגט כיתה מסוימת על ידי ציון שלה. ‪" --set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

ערך קבוע: "set-option"

Constructors ציבוריים

HostTest

public HostTest ()

‫methods ציבוריים

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

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

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 כשמבצעים חלוקה לשברים. ‫Override to return any child from HostTest.

פרמטרים
classObj Class

החזרות
HostTest

getBuild

protected IBuildInfo getBuild ()

קבלת פרטי הגרסה שמתקבלים על ידי 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 אם לא רוצים להריץ את הבדיקה.