RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

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

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

סיכום

‫constructors ציבוריים

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Alternate constructor.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Alternate 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, Collection<ITestRunListener> listeners)

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

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

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

String getRunOptions()

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

String getRunnerName()

מחזירה את runnerName.

void removeInstrumentationArg(String name)

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

void run(ITestRunListener... listeners)

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

void run(Collection<ITestRunListener> 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(ITestRunListener)

אם לא צוין, ייעשה שימוש בשם החבילה

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)

Alternate constructor. משתמשים ב-runner ברירת המחדל של מכשור.

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

RemoteAndroidTestRunner

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

Alternate 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, 
                Collection<ITestRunListener> listeners)

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

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

getAmInstrumentCommand

public String getAmInstrumentCommand ()

החזרות
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

הפונקציה מחזירה את סוג כיסוי הבדיקה שנוצר על ידי ה-runner. מומלץ לקרוא את 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)

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

שיטה נוחה ל-run(Collection).

פרמטרים
listeners ‫ITestRunListener: האפליקציה מאזינה לתוצאות הבדיקה
הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

ראן

public void run (Collection<ITestRunListener> listeners)

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

פרמטרים
listeners ‫Collection: אוסף של פונקציות מסוג listener לתוצאות הבדיקה
הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException
IOException
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(ITestRunListener)

אם לא צוין, ייעשה שימוש בשם החבילה

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