ArtRunTest

public class ArtRunTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, ITestCollector, ITestFilterReceiver

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

כלי להרצת בדיקות כדי להריץ בדיקות של ART.

סיכום

כיתות מוטמעות

class ArtRunTest.AdbShellCommandException

מחלקת חריגים לדיווח על שגיאה שהתרחשה במהלך הביצוע של פקודת ADB shell. 

ערכים קבועים

String CHECKER_PAR_FILENAME

שדות

public static final Boolean RUN_CHECKER

‫constructors ציבוריים

ArtRunTest()

‫methods ציבוריים

void addAllExcludeFilters(Set<String> filters)

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

void addAllIncludeFilters(Set<String> filters)

הוספה של Set של פילטרים של בדיקות שרוצים לכלול.

void addExcludeFilter(String filter)

הוספת מסנן להחרגת בדיקות מסוימות.

void addIncludeFilter(String filter)

הוספת מסנן של הבדיקות שרוצים לכלול.

void clearExcludeFilters()

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

void clearIncludeFilters()

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

IAbi getAbi()
Set<String> getExcludeFilters()

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

Set<String> getIncludeFilters()

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

void run(TestInformation testInfo, ITestInvocationListener listener)

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

void setAbi(IAbi abi)

void setCollectTestsOnly(boolean shouldCollectTest)

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

void setConfiguration(IConfiguration configuration)

הוספת ה-IConfiguration שנמצא בשימוש.

שיטות מוגנות

Optional<String> checkExitCode(Integer exitCode)

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

Optional<String> checkTestOutput(TestInformation testInfo, String actualOutputText, String outputShortName, String outputPrettyName)

בודקים פלט שנוצר על ידי פקודת בדיקה.

File createTestLocalTempDirectory(TestInformation testInfo)

יוצרים ספרייה מקומית זמנית בתוך תיקיית התלות של הבדיקה, כדי לאסוף את פלט הבדיקה שנמשך מהמכשיר שנבדק.

Optional<String> executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener)

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

void extractSourcesFromJar(File tmpCheckerLocalDir, File jar)

חילוץ ספריית src מקובץ jar נתון לספרייה נתונה.

File getCheckerBinaryPath(TestInformation testInfo)

מאתרים את קובץ ההפעלה של הכלי לבדיקה (ארכיון Python).

Optional<String> runChecker(String[] checkerCommandLine)

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

ערכים קבועים

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

ערך קבוע: "art-run-test-checker"

שדות

RUN_CHECKER

public static final Boolean RUN_CHECKER

‫constructors ציבוריים

ArtRunTest

public ArtRunTest ()

‫methods ציבוריים

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

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

פרמטרים
filters Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

הוספה של Set של פילטרים של בדיקות שרוצים לכלול.

פרמטרים
filters Set

addExcludeFilter

public void addExcludeFilter (String filter)

הוספת מסנן להחרגת בדיקות מסוימות.

פרמטרים
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

הוספת מסנן של הבדיקות שרוצים לכלול.

פרמטרים
filter String

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

getAbi

public IAbi getAbi ()

החזרות
IAbi

getExcludeFilters

public Set<String> getExcludeFilters ()

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

החזרות
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

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

החזרות
Set<String>

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

setAbi

public void setAbi (IAbi abi)

פרמטרים
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

הוספת ה-IConfiguration שנמצא בשימוש.

פרמטרים
configuration IConfiguration

שיטות מוגנות

checkExitCode

protected Optional<String> checkExitCode (Integer exitCode)

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

פרמטרים
exitCode ‫Integer: קוד היציאה שמוחזר על ידי פקודת הבדיקה
החזרות
Optional<String> הודעת שגיאה אופציונלית, ריקה אם קוד היציאה של הבדיקה מציין הצלחה

checkTestOutput

protected Optional<String> checkTestOutput (TestInformation testInfo, 
                String actualOutputText, 
                String outputShortName, 
                String outputPrettyName)

בודקים פלט שנוצר על ידי פקודת בדיקה.

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

פרמטרים
testInfo ‫TestInformation: אובייקט TestInformation שמשויך לבדיקה שהופעלה
actualOutputText ‫String: הפלט שנוצר מהבדיקה
outputShortName ‫String: השם המקוצר של ערוץ הפלט
outputPrettyName ‫String: שם יפה יותר לערוץ הפלט, שמשמש בהודעות שגיאה
החזרות
Optional<String> הודעת שגיאה אופציונלית, ריקה אם הפלט שנבדק תקין

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

יוצרים ספרייה מקומית זמנית בתוך תיקיית התלות של הבדיקה, כדי לאסוף את פלט הבדיקה שנמשך מהמכשיר שנבדק.

פרמטרים
testInfo ‫TestInformation: אובייקט TestInformation שמשויך לבדיקה שהופעלה
החזרות
File אובייקט File שמצביע על הספרייה הזמנית שנוצרה.
הקפצת הודעות שגיאה (throw)
IOException אם יצירת הספרייה הזמנית נכשלה.

executeCheckerTest

protected Optional<String> executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

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

בדיקות Checker הן בדיקות נוספות שכלולות בחלק מהבדיקות של ART run. הן נכתבות כהערות בקובצי המקור של הבדיקה, ומשמשות לאימות של הקומפיילר של ART.

פרמטרים
testInfo ‫TestInformation: אובייקט TestInformation שמשויך לבדיקה שהופעלה
listener ‫ITestInvocationListener: אובייקט ITestInvocationListener שמשויך לבדיקה שהופעלה
החזרות
Optional<String> הודעת שגיאה אופציונלית, ריקה אם הבדיקה של הכלי לבדיקת תאימות הצליחה
הקפצת הודעות שגיאה (throw)
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException
IOException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

חילוץ ספריית src מקובץ jar נתון לספרייה נתונה.

פרמטרים
tmpCheckerLocalDir File

jar File

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

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

מאתרים את קובץ ההפעלה של הכלי לבדיקה (ארכיון Python).

פרמטרים
testInfo TestInformation

החזרות
File

runChecker

protected Optional<String> runChecker (String[] checkerCommandLine)

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

פרמטרים
checkerCommandLine ‫String: שורת הפקודה של הכלי לבדיקה שרוצים להריץ
החזרות
Optional<String> הודעת שגיאה אופציונלית, ריקה אם ההפעלה של הכלי לבדיקה הצליחה