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

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

void clearIncludeFilters()

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

int countTestCases()

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

IAbi getAbi()

Set<String> getClassNames()
ITestDevice getDevice()

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

Set<String> getExcludeAnnotations()

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

Set<String> getExcludeFilters()

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

Set<String> getIncludeAnnotations()

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

Set<String> getIncludeFilters()

הפונקציה מחזירה את 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, List<String> keyValueOptions)

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

void setTestInformation(TestInformation testInfo)
Collection<IRemoteTest> split(Integer shardCount, TestInformation testInfo)

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

שיטות מוגנות

HostTest createHostTest(Class<?> classObj)

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

IBuildInfo getBuild()

קבלת פרטי הגרסה שמתקבלים על ידי HostTest.

ClassLoader getClassLoader()

מחזירה את טוען המחלקות שמוגדר כברירת מחדל.

final List<Class<?>> getClasses()
File getJarFile(String jarName, TestInformation testInfo)

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

boolean hasJUnit4Annotation(Class<?> classObj)

כלי עזר לקביעה אם מדובר במחלקת בדיקה עם הערות Junit4.

Object loadObject(Class<?> classObj)

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

void setClassName(String className)

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

void setMethodName(String methodName)

מגדירים את שם השיטה להפעלה.

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

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

clearIncludeFilters

public void clearIncludeFilters ()

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

countTestCases

public int countTestCases ()

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

החזרות
int

getAbi

public IAbi getAbi ()

החזרות
IAbi

getClassNames

public Set<String> getClassNames ()

החזרות
Set<String>

getDevice

public ITestDevice getDevice ()

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

החזרות
ITestDevice ‫ITestDevice

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>

getRuntimeHint

public long getRuntimeHint ()

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

החזרות
long

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

פרמטרים
testInfo ‫TestInformation: אובייקט TestInformation שמכיל מידע שימושי להרצת בדיקות.
listener ‫ITestInvocationListener: ITestInvocationListener תוצאות הבדיקה
הקפצת הודעות שגיאה (throw)
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, 
                List<String> keyValueOptions)

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

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

setTestInformation

public void setTestInformation (TestInformation testInfo)

פרמטרים
testInfo TestInformation

פיצול

public Collection<IRemoteTest> split (Integer shardCount, 
                TestInformation testInfo)

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

פרמטרים
shardCount ‫Integer: מספר הרסיסים שהמערכת ניסתה ליצור.
testInfo TestInformation: ההורה TestInformation
החזרות
Collection<IRemoteTest> אוסף של בדיקות משנה שצריך להריץ בנפרד או null אם אי אפשר לפצל את הבדיקה כרגע

שיטות מוגנות

createHostTest

protected HostTest createHostTest (Class<?> classObj)

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

פרמטרים
classObj Class

החזרות
HostTest

getBuild

protected IBuildInfo getBuild ()

קבלת פרטי הגרסה שמתקבלים על ידי HostTest.

החזרות
IBuildInfo ‫IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

מחזירה את טוען המחלקות שמוגדר כברירת מחדל.

החזרות
ClassLoader

getClasses

protected final List<Class<?>> getClasses ()

החזרות
List<Class<?>>

הקפצת הודעות שגיאה (throw)
IllegalArgumentException

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

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

פרמטרים
jarName String

testInfo TestInformation

החזרות
File

הקפצת הודעות שגיאה (throw)
FileNotFoundException

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

setMethodName

protected void setMethodName (String methodName)

מגדירים את שם השיטה להפעלה.

הפרמטר הזה משמש להרצת שיטת בדיקה ספציפית ממחלקת בדיקה.

פרמטרים
methodName String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

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

החזרות
boolean ‫false אם לא רוצים להריץ את הבדיקה.