IsolatedHostTest

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

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

הטמעה של TradeFed runner שמשתמש בתהליך משנה כדי להריץ את הבדיקות בסביבה עם תלות נמוכה, במקום להריץ אותן בתהליך הראשי.

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

סיכום

‫constructors ציבוריים

IsolatedHostTest()

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

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

String compileClassPath()

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

compileCommandArgs(String classpath, File artifactsDir)

מרכיב את ארגומנטי הפקודה להפעלת רץ תהליכי המשנה.

void deleteTempFiles()
File getCoverageExecFile()
getExcludeAnnotations()

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

getExcludeFilters()

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

getIncludeAnnotations()

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

getIncludeFilters()

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

void run(TestInformation testInfo, ITestInvocationListener listener)

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

void setBuild(IBuildInfo build)

void setCollectTestsOnly(boolean shouldCollectTest)

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

void setConfiguration(IConfiguration configuration)

הוספת IConfiguration בשימוש.

void setDebug(boolean debug)
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)

Constructors ציבוריים

IsolatedHostTest

public IsolatedHostTest ()

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

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

compileClassPath

public String compileClassPath ()

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

החזרות
String מחרוזת שמציינת את נתיב המחלקות (classpath) עם הפרדה באמצעות נקודתיים.

compileCommandArgs

public  compileCommandArgs (String classpath, 
                File artifactsDir)

מרכיב את ארגומנטי הפקודה להפעלת רץ תהליכי המשנה.

פרמטרים
classpath String

artifactsDir File

החזרות

deleteTempFiles

public void deleteTempFiles ()

getCoverageExecFile

public File getCoverageExecFile ()

החזרות
File

getExcludeAnnotations

public  getExcludeAnnotations ()

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

החזרות

getExcludeFilters

public  getExcludeFilters ()

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

החזרות

getIncludeAnnotations

public  getIncludeAnnotations ()

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

החזרות

getIncludeFilters

public  getIncludeFilters ()

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

החזרות

ראן

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  split (int shardCount)

גרסה חלופית של split() שמספקת גם את shardCount שהניסיון להפעיל אותו מתבצע. האפשרות הזו שימושית לחלק מהכלים להרצת בדיקות שלא יכולים להחליט באופן שרירותי לפעמים.

פרמטרים
shardCount ‫int: מספר הרסיסים שהמערכת ניסתה ליצור.
החזרות
אוסף של בדיקות משנה שצריך להריץ בנפרד או 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‏ API להגדרת משתני סביבה.

פרמטרים
androidHostOut String

החזרות
String

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

הועתק מ-HostTest כדי לחקות את מערכת הבדיקות שלו.

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

פרמטרים
jarName String

testInfo TestInformation

החזרות
File

setServer

protected void setServer (ServerSocket server)

פרמטרים
server ServerSocket