IRemoteAndroidTestRunner
public
interface
IRemoteAndroidTestRunner
| com.android.ddmlib.testrunner.IRemoteAndroidTestRunner |
ממשק להרצת פקודת בדיקה של Android מרחוק ולדיווח על התוצאה למאזין.
סיכום
methods ציבוריים | |
|---|---|
abstract
void
|
addBooleanArg(String name, boolean value)
מוסיף ארגומנט בוליאני שיש לכלול בפקודת האינסטרומנטציה. |
abstract
void
|
addInstrumentationArg(String name, String value)
מוסיף ארגומנט להכללה בפקודת האינסטרומנטציה. |
abstract
void
|
cancel()
בקשה לביטול של הרצת הבדיקה הזו. |
abstract
IRemoteAndroidTestRunner.CoverageOutput
|
getCoverageOutputType()
הפונקציה מחזירה את סוג כיסוי הבדיקה שנוצר על ידי הכלי להרצת בדיקות. |
abstract
String
|
getPackageName()
הפונקציה מחזירה את שם החבילה של האפליקציה. |
abstract
String
|
getRunnerName()
מחזירה את runnerName. |
abstract
void
|
removeInstrumentationArg(String name)
מסירה ארגומנט שנוסף קודם. |
abstract
void
|
run(ITestRunListener... listeners)
מריצים את הבדיקה הזו. |
abstract
void
|
run(
מריצים את הבדיקה הזו. |
abstract
void
|
setAdditionalTestOutputLocation(String additionalTestDataPath)
מגדיר את המיקום של פלט הבדיקה הנוסף שיועתק למארח לפני הסרת אפליקציית הבדיקה. |
abstract
void
|
setClassName(String className)
הגדרת הרצת בדיקות רק במחלקה הזו. צריך להפעיל את הפונקציה הזו לפני הפונקציה run. |
abstract
void
|
setClassNames(String[] classNames)
הגדרת הרצה רק של בדיקות בכיתות שצוינו. צריך להפעיל את הפקודה הזו לפני הפקודה run. |
abstract
void
|
setCoverage(boolean coverage)
ההגדרה הזו קובעת את מצב כיסוי הקוד של הרצת הבדיקה הזו. |
abstract
void
|
setCoverageReportLocation(String reportPath)
מגדיר את המיקום של דוחות הכיסוי שנוצרו. |
abstract
void
|
setDebug(boolean debug)
הגדרת מצב ניפוי הבאגים של הבדיקה הזו. |
abstract
void
|
setLogOnly(boolean logOnly)
ההגדרה הזו מעבירה את הרצת הבדיקה למצב של רישום ביומן בלבד – דילוג על ביצוע הבדיקה. |
abstract
void
|
setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)
הגדרת הזמן המקסימלי המותר בין הפלט של פקודת ה-Shell שמריצה את הבדיקות במכשירים. |
abstract
void
|
setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)
הגדרה של הזמן המקסימלי שמוקצב לסיום ההטמעה. |
abstract
void
|
setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
השיטה הזו הוצאה משימוש.
שימוש בחשבון |
abstract
void
|
setMethodName(String className, String testName)
הגדרת הרצה רק של שיטת בדיקה ספציפית. צריך להפעיל את הפונקציה הזו לפני הפונקציה run. |
abstract
void
|
setRunName(String runName)
הגדרת שם הפעלה בהתאמה אישית לדיווח אל אם לא מציינים שם, המערכת משתמשת בשם החבילה |
abstract
void
|
setTestCollection(boolean collection)
הגדרת הבדיקה הזו למצב איסוף נתונים. |
abstract
void
|
setTestPackageName(String packageName)
הגדרת חבילה להרצת כל הבדיקות שצוינו. צריך להפעיל את הפונקציה הזו לפני הפונקציה run. |
abstract
void
|
setTestSize(IRemoteAndroidTestRunner.TestSize size)
הגדרת הפעלה רק של בדיקות בגודל נתון. |
methods ציבוריים
addBooleanArg
public abstract void addBooleanArg (String name,
boolean value)מוסיף ארגומנט בוליאני שיש לכלול בפקודת האינסטרומנטציה.
| פרמטרים | |
|---|---|
name |
String: השם של הארגומנט של חבילת המכשירים |
value |
boolean: הערך של הארגומנט |
addInstrumentationArg
public abstract void addInstrumentationArg (String name,
String value)מוסיף ארגומנט להכללה בפקודת האינסטרומנטציה.
חובה להפעיל את הפונקציה לפני הפעלת הפקודה run. אם כבר צוין ארגומנט עם השם הנתון, הערך שלו יוחלף.
| פרמטרים | |
|---|---|
name |
String: השם של הארגומנט של חבילת המכשירים |
value |
String: הערך של הארגומנט |
ביטול
public abstract void cancel ()
בקשה לביטול של הרצת הבדיקה הזו.
getCoverageOutputType
public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()
הפונקציה מחזירה את סוג כיסוי הבדיקה שנוצר על ידי הכלי להרצת בדיקות. פרטים נוספים זמינים בCoverageOutput.
| החזרות | |
|---|---|
IRemoteAndroidTestRunner.CoverageOutput |
|
getPackageName
public abstract String getPackageName ()
הפונקציה מחזירה את שם החבילה של האפליקציה.
| החזרות | |
|---|---|
String |
|
getRunnerName
public abstract String getRunnerName ()
מחזירה את runnerName.
| החזרות | |
|---|---|
String |
|
removeInstrumentationArg
public abstract void removeInstrumentationArg (String name)
מסירה ארגומנט שנוסף קודם.
| פרמטרים | |
|---|---|
name |
String: השם של הארגומנט של חבילת כלי המדידה להסרה |
ראן
public abstract void run (ITestRunListener... listeners)
מריצים את הבדיקה הזו.
שיטה נוחה לשימוש ב-ERROR(/#run(Collection)).
| פרמטרים | |
|---|---|
listeners |
ITestRunListener: מאזין לתוצאות הבדיקה |
| זריקות | |
|---|---|
TimeoutException |
במקרה של פסק זמן בחיבור. |
AdbCommandRejectedException |
אם adb דוחה את הפקודה |
ShellCommandUnresponsiveException |
אם המכשיר לא הפיק תוצאה של בדיקה במשך תקופה ארוכה יותר מהזמן המקסימלי להפקת פלט. |
|
אם החיבור למכשיר נותק. |
מידע נוסף:
ראן
public abstract void run (listeners)
מריצים את הבדיקה הזו.
| פרמטרים | |
|---|---|
listeners |
|
| זריקות | |
|---|---|
TimeoutException |
במקרה של פסק זמן בחיבור. |
AdbCommandRejectedException |
אם adb דוחה את הפקודה |
ShellCommandUnresponsiveException |
אם המכשיר לא הפיק תוצאה של בדיקה במשך תקופה ארוכה יותר מהזמן המקסימלי להפקת פלט. |
|
אם החיבור למכשיר נותק. |
מידע נוסף:
setAdditionalTestOutputLocation
public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)
מגדיר את המיקום של פלט הבדיקה הנוסף שיועתק למארח לפני הסרת אפליקציית הבדיקה. לדוגמה, דוחות השוואה לשוק שהמערכת יוצרת.
| פרמטרים | |
|---|---|
additionalTestDataPath |
String |
setClassName
public abstract void setClassName (String className)
הגדרת הרצת בדיקות רק במחלקה הזו. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.
| פרמטרים | |
|---|---|
className |
String: שם המחלקה המלא (לדוגמה x.y.z) |
setClassNames
public abstract void setClassNames (String[] classNames)
הגדרת הרצה רק של בדיקות בכיתות שצוינו. צריך להפעיל את הפקודה הזו לפני הפקודה run.
אם מספקים יותר ממחלקה אחת, צריך להשתמש ב-InstrumentationTestRunner שתומך בתחביר של ארגומנטים של כמה מחלקות.
| פרמטרים | |
|---|---|
classNames |
String: מערך של שמות מחלקות מלאים (למשל x.y.z) |
setCoverage
public abstract void setCoverage (boolean coverage)
ההגדרה הזו קובעת את מצב כיסוי הקוד של הרצת הבדיקה הזו.
| פרמטרים | |
|---|---|
coverage |
boolean |
setCoverageReportLocation
public abstract void setCoverageReportLocation (String reportPath)
מגדיר את המיקום של דוחות הכיסוי שנוצרו.
| פרמטרים | |
|---|---|
reportPath |
String |
setDebug
public abstract void setDebug (boolean debug)
הגדרת מצב ניפוי הבאגים של הבדיקה הזו. אם הערך הוא true, כלי ההרצה של בדיקות ב-Android ימתין שמנפה הבאגים יצורף לפני שימשיך בהרצת הבדיקה.
| פרמטרים | |
|---|---|
debug |
boolean |
setLogOnly
public abstract void setLogOnly (boolean logOnly)
ההגדרה הזו מעבירה את הרצת הבדיקה למצב של רישום ביומן בלבד – דילוג על ביצוע הבדיקה.
| פרמטרים | |
|---|---|
logOnly |
boolean |
setMaxTimeToOutputResponse
public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse,
TimeUnit maxTimeUnits)הגדרת הזמן המקסימלי המותר בין הפלט של פקודת ה-Shell שמריצה את הבדיקות במכשירים.
ההגדרה הזו מאפשרת להגדיר פסק זמן למקרה שהבדיקות נתקעות ולא מסתיימות. הערך הזה שונה מהערך הרגיל של הזמן הקצוב לתפוגה של החיבור.
כברירת מחדל, לא יצוין זמן קצוב לתפוגה.
| פרמטרים | |
|---|---|
maxTimeToOutputResponse |
long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם. |
maxTimeUnits |
TimeUnit: יחידות לערכים שונים מאפס של maxTimeToOutputResponse ו-maxTimeout. |
setMaxTimeout
public abstract void setMaxTimeout (long maxTimeout,
TimeUnit maxTimeUnits)הגדרה של הזמן המקסימלי שמוקצב לסיום ההטמעה.
ההגדרה הזו מאפשרת להגדיר פסק זמן למקרה שהבדיקות נתקעות ולא מסתיימות. הערך הזה שונה מהערך הרגיל של הזמן הקצוב לתפוגה של החיבור.
כברירת מחדל, לא יצוין זמן קצוב לתפוגה.
| פרמטרים | |
|---|---|
maxTimeout |
long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם. |
maxTimeUnits |
TimeUnit: יחידות לערכים שונים מאפס של maxTimeToOutputResponse ו-maxTimeout. |
setMaxtimeToOutputResponse
public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)
השיטה הזו הוצאה משימוש.
אפשר להשתמש ב-ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).
| פרמטרים | |
|---|---|
maxTimeToOutputResponse |
int |
setMethodName
public abstract void setMethodName (String className,
String testName)הגדרת הרצה רק של שיטת בדיקה ספציפית. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.
| פרמטרים | |
|---|---|
className |
String: שם המחלקה המלא (לדוגמה x.y.z) |
testName |
String: שם השיטה |
setRunName
public abstract void setRunName (String runName)
הגדרת שם הפעלה בהתאמה אישית לדיווח אל ITestRunListener בתאריך run(
אם לא מציינים שם, המערכת משתמשת בשם החבילה
setTestCollection
public abstract void setTestCollection (boolean collection)
הגדרת הבדיקה הזו למצב איסוף נתונים. אם הערך הוא true, תתבצע דילוג על הרצת הבדיקה ויוגדרו כל הארגומנטים המתאימים של הרצת הבדיקה שנדרשים לאיסוף מוצלח של נתוני הבדיקה.
| פרמטרים | |
|---|---|
collection |
boolean |
setTestPackageName
public abstract void setTestPackageName (String packageName)
הגדרת חבילה להרצת כל הבדיקות שצוינו. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.
| פרמטרים | |
|---|---|
packageName |
String: שם החבילה המלא (למשל x.y.z) |
setTestSize
public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)
הגדרת הפעלה רק של בדיקות בגודל נתון. חובה להפעיל את הפונקציה לפני הפעלת הפקודה run.
| פרמטרים | |
|---|---|
size |
IRemoteAndroidTestRunner.TestSize: TestSize שצריך להריץ. |