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()
הפונקציה מחזירה את סוג כיסוי הבדיקה שנוצר על ידי ה-runner. |
abstract
String
|
getPackageName()
הפונקציה מחזירה את שם החבילה של האפליקציה. |
abstract
String
|
getRunnerName()
מחזירה את runnerName. |
abstract
void
|
removeInstrumentationArg(String name)
הסרת ארגומנט שנוסף קודם. |
abstract
void
|
run(Collection<ITestRunListener> listeners)
מריצים את הבדיקה הזו. |
abstract
void
|
run(ITestRunListener... listeners)
מריצים את הבדיקה הזו. |
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 ()
הפונקציה מחזירה את סוג כיסוי הבדיקה שנוצר על ידי ה-runner. מומלץ לקרוא את 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 (Collection<ITestRunListener> listeners)
מריצים את הבדיקה הזו.
| פרמטרים | |
|---|---|
listeners |
Collection: אוסף של פונקציות מסוג listener לתוצאות הבדיקה |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
AdbCommandRejectedException |
אם adb דוחה את הפקודה |
ShellCommandUnresponsiveException |
אם המכשיר לא הפיק תוצאות בדיקה במשך תקופה ארוכה יותר מהזמן המקסימלי להפקת פלט. |
TimeoutException |
במקרה של פסק זמן בחיבור. |
IOException |
אם החיבור למכשיר נותק. |
מידע נוסף:
ראן
public abstract void run (ITestRunListener... listeners)
מריצים את הבדיקה הזו.
שיטה נוחה ל-run(Collection).
| פרמטרים | |
|---|---|
listeners |
ITestRunListener: האפליקציה מאזינה לתוצאות הבדיקה |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
AdbCommandRejectedException |
אם adb דוחה את הפקודה |
ShellCommandUnresponsiveException |
אם המכשיר לא הפיק תוצאות בדיקה במשך תקופה ארוכה יותר מהזמן המקסימלי להפקת פלט. |
TimeoutException |
במקרה של פסק זמן בחיבור. |
IOException |
אם החיבור למכשיר נותק. |
מידע נוסף:
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)
השיטה הזו הוצאה משימוש.
אפשר להשתמש ב-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(ITestRunListener)
אם לא צוין, ייעשה שימוש בשם החבילה
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 שרוצים להריץ. |