RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

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

סיכום

Constructors ציבוריים

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Constructor חלופי.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Constructor חלופי.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

יוצרת כלי להרצת בדיקות מרחוק ב-Android.

‫methods ציבוריים

void addBooleanArg(String name, boolean value)

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

void addInstrumentationArg(String name, String value)

מוסיף ארגומנט להכללה בפקודת האינסטרומנטציה.

void cancel()

בקשה לביטול של הרצת הבדיקה הזו.

IInstrumentationResultParser createParser(String runName, listeners)

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

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

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

String getRunOptions()

מחזירה אפשרויות לפקודה am instrument.

String getRunnerName()

מחזירה את runnerName.

void removeInstrumentationArg(String name)

מסירה ארגומנט שנוסף קודם.

void run(ITestRunListener... listeners)

מריצים את הבדיקה הזו.

void run( listeners)

מריצים את הבדיקה הזו.

void setAdditionalTestOutputLocation(String additionalTestDataPath)

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

void setClassName(String className)

הגדרת הרצת בדיקות רק במחלקה הזו. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.

void setClassNames(String[] classNames)

הגדרת הרצה רק של בדיקות בכיתות שצוינו. צריך להפעיל את הפקודה הזו לפני הפקודה run.

void setCoverage(boolean coverage)

ההגדרה הזו קובעת את מצב כיסוי הקוד של הרצת הבדיקה הזו.

void setCoverageReportLocation(String reportPath)

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

void setDebug(boolean debug)

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

void setLogOnly(boolean logOnly)

ההגדרה הזו מעבירה את הרצת הבדיקה למצב של רישום ביומן בלבד – דילוג על ביצוע הבדיקה.

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

הגדרת הזמן המקסימלי המותר בין הפלט של פקודת ה-Shell שמריצה את הבדיקות במכשירים.

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

הגדרה של הזמן המקסימלי שמוקצב לסיום ההטמעה.

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void setMethodName(String className, String testName)

הגדרת הרצה רק של שיטת בדיקה ספציפית. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.

void setRunName(String runName)

הגדרת שם הפעלה בהתאמה אישית לדיווח אל ITestRunListener בתאריך run()

אם לא מציינים שם, המערכת משתמשת בשם החבילה

void setRunOptions(String options)

הגדרת אפשרויות לפקודה am instrument.

void setTestCollection(boolean collect)

הגדרת הבדיקה הזו למצב איסוף נתונים.

void setTestPackageName(String packageName)

הגדרת חבילה להרצת כל הבדיקות שצוינו. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

הגדרת הפעלה רק של בדיקות בגודל נתון.

שיטות מוגנות

String getArgsCommand()

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

String getRunnerPath()

מחזירה את הנתיב המלא של רכיב המדידה.

Constructors ציבוריים

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Constructor חלופי. משתמש ב-runner ברירת המחדל של מכשור.

פרמטרים
packageName ‫String: חבילת האפליקציה ל-Android שמכילה את הבדיקות להרצה
remoteDevice ‫IShellEnabledDevice: מכשיר Android להרצת בדיקות

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Constructor חלופי. נעשה שימוש בברירת המחדל statusReporterMode.

פרמטרים
packageName ‫String: חבילת האפליקציה ל-Android שמכילה את הבדיקות להרצה
runnerName ‫String: כלי להרצת בדיקות אינסטרומנטציה לביצוע. אם הערך הוא null, המערכת תשתמש ב-runner שמוגדר כברירת מחדל
remoteDevice ‫IShellEnabledDevice: מכשיר Android להרצת בדיקות

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

יוצרת כלי להרצת בדיקות מרחוק ב-Android.

פרמטרים
packageName ‫String: חבילת האפליקציה ל-Android שמכילה את הבדיקות להרצה
runnerName ‫String: כלי להרצת בדיקות אינסטרומנטציה לביצוע. אם הערך הוא null, המערכת תשתמש ב-runner שמוגדר כברירת מחדל
remoteDevice ‫IShellEnabledDevice: מכשיר Android להרצת בדיקות
statusReporterMode ‫RemoteAndroidTestRunner.StatusReporterMode: מצב הדיווח על הסטטוס שבו יש להשתמש עבור פקודה של מכשיר

‫methods ציבוריים

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

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

פרמטרים
name ‫String: השם של הארגומנט של חבילת המכשירים
value ‫boolean: הערך של הארגומנט

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

מוסיף ארגומנט להכללה בפקודת האינסטרומנטציה.

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

פרמטרים
name ‫String: השם של הארגומנט של חבילת המכשירים
value ‫String: הערך של הארגומנט

ביטול

public void cancel ()

בקשה לביטול של הרצת הבדיקה הזו.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

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

פרמטרים
runName ‫String: השם של ההרצה שרוצים להשתמש בה.
listeners : הפונקציות מסוג listener שאליהן ידווחו התוצאות.
החזרות
IInstrumentationResultParser מופע של InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

החזרות
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

החזרות
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

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

החזרות
String

getRunOptions

public String getRunOptions ()

מחזירה אפשרויות לפקודה am instrument.

החזרות
String

getRunnerName

public String getRunnerName ()

מחזירה את runnerName.

החזרות
String

removeInstrumentationArg

public void removeInstrumentationArg (String name)

מסירה ארגומנט שנוסף קודם.

פרמטרים
name ‫String: השם של הארגומנט של חבילת כלי המדידה להסרה

ראן

public void run (ITestRunListener... listeners)

מריצים את הבדיקה הזו.

שיטה נוחה לשימוש ב-ERROR(/#run(Collection)).

פרמטרים
listeners ‫ITestRunListener: מאזין לתוצאות הבדיקה
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

ראן

public void run ( listeners)

מריצים את הבדיקה הזו.

פרמטרים
listeners ‫: אוסף של פונקציות מסוג listener לתוצאות הבדיקה
זריקות
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

פרמטרים
additionalTestDataPath String

setClassName

public void setClassName (String className)

הגדרת הרצת בדיקות רק במחלקה הזו. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.

פרמטרים
className ‫String: שם המחלקה המלא (לדוגמה x.y.z)

setClassNames

public void setClassNames (String[] classNames)

הגדרת הרצה רק של בדיקות בכיתות שצוינו. צריך להפעיל את הפקודה הזו לפני הפקודה run.

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

פרמטרים
classNames ‫String: מערך של שמות מחלקות מלאים (למשל x.y.z)

setCoverage

public void setCoverage (boolean coverage)

ההגדרה הזו קובעת את מצב כיסוי הקוד של הרצת הבדיקה הזו.

פרמטרים
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

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

פרמטרים
reportPath String

setDebug

public void setDebug (boolean debug)

הגדרת מצב ניפוי הבאגים של הבדיקה הזו. אם הערך הוא true, כלי ההרצה של בדיקות ב-Android ימתין שמנפה הבאגים יצורף לפני שימשיך בהרצת הבדיקה.

פרמטרים
debug boolean

setLogOnly

public void setLogOnly (boolean logOnly)

ההגדרה הזו מעבירה את הרצת הבדיקה למצב של רישום ביומן בלבד – דילוג על ביצוע הבדיקה.

פרמטרים
logOnly boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

הגדרת הזמן המקסימלי המותר בין הפלט של פקודת ה-Shell שמריצה את הבדיקות במכשירים.

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

כברירת מחדל, לא יצוין זמן קצוב לתפוגה.

פרמטרים
maxTimeToOutputResponse ‫long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם.
maxTimeUnits ‫TimeUnit: יחידות לערכים שונים מאפס של maxTimeToOutputResponse ו-maxTimeout.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

הגדרה של הזמן המקסימלי שמוקצב לסיום ההטמעה.

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

כברירת מחדל, לא יצוין זמן קצוב לתפוגה.

פרמטרים
maxTimeout ‫long: משך הזמן המקסימלי שבו הפקודה יכולה לא להפיק תגובה. הערך 0 מציין שהשיטה תחכה לנצח (עד ש-receiver יבטל את ההפעלה) לפלט של הפקודה, ולא תזרוק שגיאה לעולם.
maxTimeUnits ‫TimeUnit: יחידות לערכים שונים מאפס של maxTimeToOutputResponse ו-maxTimeout.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

פרמטרים
maxTimeToOutputResponse int

setMethodName

public void setMethodName (String className, 
                String testName)

הגדרת הרצה רק של שיטת בדיקה ספציפית. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.

פרמטרים
className ‫String: שם המחלקה המלא (לדוגמה x.y.z)
testName ‫String: שם השיטה

setRunName

public void setRunName (String runName)

הגדרת שם הפעלה בהתאמה אישית לדיווח אל ITestRunListener בתאריך run()

אם לא מציינים שם, המערכת משתמשת בשם החבילה

setRunOptions

public void setRunOptions (String options)

הגדרת אפשרויות לפקודה am instrument. רשימת האפשרויות המלאה מופיעה בכתובת com/android/commands/am/Am.java.

פרמטרים
options String

setTestCollection

public void setTestCollection (boolean collect)

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

פרמטרים
collect boolean

setTestPackageName

public void setTestPackageName (String packageName)

הגדרת חבילה להרצת כל הבדיקות שצוינו. צריך להפעיל את הפונקציה הזו לפני הפונקציה run.

פרמטרים
packageName ‫String: שם החבילה המלא (למשל x.y.z)

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

הגדרת הפעלה רק של בדיקות בגודל נתון. חובה להפעיל את הפונקציה לפני הפעלת הפקודה run.

פרמטרים
size ‫IRemoteAndroidTestRunner.TestSize: TestSize שצריך להריץ.

שיטות מוגנות

getArgsCommand

protected String getArgsCommand ()

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

החזרות
String

getRunnerPath

protected String getRunnerPath ()

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

החזרות
String