מבחן מכשור

public class InstrumentationTest
extends Object implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver

java.lang.Object
com.android.tradefed.testtype.InstrumentationTest


מבחן שמריץ חבילת בדיקת מכשור במכשיר נתון.

סיכום

שדות

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

בנאים ציבוריים

InstrumentationTest ()

שיטות ציבוריות

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

מאפשר להוסיף עוד מאזינים מותאמים אישית לרץ

void addInstrumentationArg (String key, String value)

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

IAbi getAbi ()
IConfiguration getConfiguration ()

מקבל את IConfiguration עבור בדיקה זו.

String getCoverageTarget ()

קבל את coverageTarget שהוגדר בעבר באמצעות setCoverageTarget(String) .

boolean getDebug ()

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

ITestDevice getDevice ()

קבל את המכשיר בבדיקה.

String getForceAbi ()
long getMaxTimeout ()

מחזירה את פסק הזמן המרבי שנקבע עבור המכשור.

String getPackageName ()

קבל את חבילת המניפסט של Android להפעלה.

String getRunName ()

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

String getRunnerName ()

מקבל את רץ המכשור של אנדרואיד לשימוש.

void run ( TestInformation testInfo, ITestInvocationListener listener)

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

void setAbi ( IAbi abi)
void setClassName (String testClassName)

לחלופין, הגדר את שם מחלקת הבדיקה להפעלה.

void setCollectTestsOnly (boolean shouldCollectTest)

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

void setCollectsTestsShellTimeout (int timeout)

שיטה זו הוצאה משימוש. שיטה זו היא ללא הפעלה

void setConfiguration ( IConfiguration config)

מזריק את IConfiguration בשימוש.

void setCoverageTarget (String coverageTarget)

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

void setDebug (boolean debug)

הגדר את הגדרת ניפוי באגים במכשור.

void setDevice ( ITestDevice device)

הזרקו את המכשיר הנבדק.

void setEnforceFormat (boolean enforce)

הגדר True אם אנו אוכפים את פורמט הפלט AJUR של המכשור.

void setForceAbi (String abi)

מגדיר אפשרות כוח-abi.

void setInstallFile (File installFile)

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

void setIsolatedStorage (boolean isolatedStorage)

הגדר אם להשתמש באחסון המבודד או לא.

void setMethodName (String testMethodName)

לחלופין, הגדר את שיטת הבדיקה להפעלה.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

מגדיר את רשימת ה- IMetricCollector שהוגדרו להפעלת המבחן.

void setPackageName (String packageName)

הגדר את חבילת המניפסט של Android להפעלה.

void setReRunUsingTestFile (boolean reRunUsingTestFile)

מגדיר את האפשרות --rerun-from-file.

void setRerunMode (boolean rerun)

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

void setRunName (String runName)

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

void setRunnerName (String runnerName)

לחלופין, הגדר את רץ המכשור של אנדרואיד לשימוש.

void setShellTimeout (long timeout)

אופציונלי, הגדר את הזמן המקסימלי (במילישניות) המצפה לפלט מעטפת מהמכשיר.

void setTestFilePathOnDevice (String testFilePathOnDevice)

לחלופין, הגדר את הנתיב לקובץ הממוקם במכשיר שאמור להכיל רשימה של מחלקות ושיטות בדיקה מופרדות בין שורות (פורמט: com.foo.Class#method) שיופעלו.

void setTestPackageName (String testPackageName)

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

void setTestSize (String size)

לחלופין, הגדר את גודל הבדיקה להפעלה.

void setTestTimeout (long timeout)

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

void setTestsToRun ( tests) setTestsToRun ( tests)

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

void setWindowAnimation (boolean windowAnimation)

שיטות מוגנות

static excludeNonExecuted ( TestRunResult results)

סנן את "NOT_EXECUTED" למטרת מעקב אחר מה שצריך להפעיל מחדש.

String getClassName ()

קבל את שם הכיתה לפעול.

ListInstrumentationParser getListInstrumentationParser ()

קבל את ListInstrumentationParser המשמש לניתוח שאילתות 'pm list instrumentation'.

String getMethodName ()

קבל את שיטת הבדיקה לפעול.

String getTestPackageName ()

קבל את חבילת ה-Java לבדיקה להפעלה.

String queryRunnerName ()

שאל את המכשיר עבור רץ מבחן לשימוש.

void setRunnerArgs (IRemoteAndroidTestRunner runner)

שדות

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

בנאים ציבוריים

מבחן מכשור

public InstrumentationTest ()

שיטות ציבוריות

הוסף DeviceListeners

public void addDeviceListeners ( extraListeners)

מאפשר להוסיף עוד מאזינים מותאמים אישית לרץ

פרמטרים
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

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

פרמטרים
key String : שם הארגומנט

value String : ערך הארגומנט

getAbi

public IAbi getAbi ()

החזרות
IAbi

getConfiguration

public IConfiguration getConfiguration ()

מקבל את IConfiguration עבור בדיקה זו.

החזרות
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

קבל את coverageTarget שהוגדר בעבר באמצעות setCoverageTarget(String) .

החזרות
String

getDebug

public boolean getDebug ()

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

החזרות
boolean הגדרת ניפוי באגים בוליאני.

getDevice

public ITestDevice getDevice ()

קבל את המכשיר בבדיקה.

החזרות
ITestDevice ה- ITestDevice

getForceAbi

public String getForceAbi ()

החזרות
String

getMaxTimeout

public long getMaxTimeout ()

מחזירה את פסק הזמן המרבי שנקבע עבור המכשור.

החזרות
long

getPackageName

public String getPackageName ()

קבל את חבילת המניפסט של Android להפעלה.

החזרות
String

getRunName

public String getRunName ()

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

החזרות
String

getRunnerName

public String getRunnerName ()

מקבל את רץ המכשור של אנדרואיד לשימוש.

החזרות
String

לָרוּץ

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

פרמטרים
testInfo TestInformation : אובייקט TestInformation המכיל מידע שימושי להפעלת בדיקות.

listener ITestInvocationListener : ה- ITestInvocationListener של תוצאות הבדיקה

זורק
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

פרמטרים
abi IAbi

setClassName

public void setClassName (String testClassName)

לחלופין, הגדר את שם מחלקת הבדיקה להפעלה.

פרמטרים
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

שיטה זו הוצאה משימוש.
שיטה זו היא ללא הפעלה

הגדר את הזמן המקסימלי ב-ms כדי לאפשר את 'זמן מקסימום לתגובת פלט מעטפת' בעת איסוף בדיקות.

פרמטרים
timeout int

setConfiguration

public void setConfiguration (IConfiguration config)

מזריק את IConfiguration בשימוש.

פרמטרים
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

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

כרגע לא בשימוש. שיטה זו קיימת רק כך שניתן לאחזר את coverageTarget מאוחר יותר באמצעות getCoverageTarget()

פרמטרים
coverageTarget String

setDebug

public void setDebug (boolean debug)

הגדר את הגדרת ניפוי באגים במכשור.

פרמטרים
debug boolean : ערך בוליאני להגדרת ניפוי באגים במכשור.

setDevice

public void setDevice (ITestDevice device)

הזרקו את המכשיר הנבדק.

פרמטרים
device ITestDevice : ה- ITestDevice לשימוש

setEnforceFormat

public void setEnforceFormat (boolean enforce)

הגדר True אם אנו אוכפים את פורמט הפלט AJUR של המכשור.

פרמטרים
enforce boolean

setForceAbi

public void setForceAbi (String abi)

מגדיר אפשרות כוח-abi.

setInstallFile

public void setInstallFile (File installFile)

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

פרמטרים
installFile File : ERROR(/File) הניתנת להתקנה

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

הגדר אם להשתמש באחסון המבודד או לא.

פרמטרים
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

לחלופין, הגדר את שיטת הבדיקה להפעלה.

פרמטרים
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

מגדיר את רשימת ה- IMetricCollector שהוגדרו להפעלת המבחן.

פרמטרים
collectors

setPackageName

public void setPackageName (String packageName)

הגדר את חבילת המניפסט של Android להפעלה.

פרמטרים
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

מגדיר את האפשרות --rerun-from-file.

פרמטרים
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

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

פרמטרים
rerun boolean

setRunName

public void setRunName (String runName)

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

פרמטרים
runName String

setRunnerName

public void setRunnerName (String runnerName)

לחלופין, הגדר את רץ המכשור של אנדרואיד לשימוש.

פרמטרים
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

אופציונלי, הגדר את הזמן המקסימלי (במילישניות) המצפה לפלט מעטפת מהמכשיר.

פרמטרים
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

לחלופין, הגדר את הנתיב לקובץ הממוקם במכשיר שאמור להכיל רשימה של מחלקות ושיטות בדיקה מופרדות בין שורות (פורמט: com.foo.Class#method) שיופעלו. אם מוגדר, ינסה אוטומטית להריץ מחדש בדיקות באמצעות קובץ בדיקה זה באמצעות InstrumentationFileTest במקום לבצע פקודות adb נפרדות עבור כל בדיקה שנותרה באמצעות הפעלה חוזרת.

פרמטרים
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

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

אם אינו ריק, רק בדיקות בחבילת ה-Java הנתונה יבוצעו.

תתעלם אם ערך שאינו ריק סופק ל- setClassName(String)

פרמטרים
testPackageName String

setTestSize

public void setTestSize (String size)

לחלופין, הגדר את גודל הבדיקה להפעלה.

פרמטרים
size String

setTestTimeout

public void setTestTimeout (long timeout)

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

פרמטרים
timeout long

setTestsToRun

public void setTestsToRun ( tests)

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

פרמטרים
tests : הבדיקות להרצה

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

פרמטרים
windowAnimation boolean

שיטות מוגנות

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

סנן את "NOT_EXECUTED" למטרת מעקב אחר מה שצריך להפעיל מחדש.

פרמטרים
results TestRunResult

החזרות

getClassName

protected String getClassName ()

קבל את שם הכיתה לפעול.

החזרות
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

קבל את ListInstrumentationParser המשמש לניתוח שאילתות 'pm list instrumentation'.

החזרות
ListInstrumentationParser

getMethodName

protected String getMethodName ()

קבל את שיטת הבדיקה לפעול.

החזרות
String

getTestPackageName

protected String getTestPackageName ()

קבל את חבילת ה-Java לבדיקה להפעלה.

החזרות
String

queryRunnerName

protected String queryRunnerName ()

שאל את המכשיר עבור רץ מבחן לשימוש.

החזרות
String שם רץ הבדיקה הראשון שתואם את החבילה או null אם לא נמצא.

זורק
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

פרמטרים
runner IRemoteAndroidTestRunner