InstrumentationTest

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

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)

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

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()

הפונקציה מקבלת את ה-runner לכלי למדידה ב-Android שבו רוצים להשתמש.

boolean isOrchestrator()

הפונקציה מחזירה את הערך של ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)

void run(TestInformation testInfo, ITestInvocationListener listener)

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

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

אפשר גם להגדיר את שם הכיתה של הבדיקה להרצה.

void setCollectTestsOnly(boolean shouldCollectTest)

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

void setCollectsTestsShellTimeout(int timeout)

השיטה הזו הוצאה משימוש. השיטה הזו היא פעולה ללא תפעול (no-op)

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)

הגדרת האפשרות force-abi.

void setInstallFile(File installFile)

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

void setIsolatedStorage(boolean isolatedStorage)

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

void setMethodName(String testMethodName)

אפשר גם להגדיר את שיטת הבדיקה להפעלה.

void setMetricCollectors( collectors)

הגדרת רשימת ה-IMetricCollector שמוגדרים להרצת הבדיקה.

void setOrchestrator(boolean useOrchestrator)

הגדרת האפשרות --orchestrator

void setPackageName(String packageName)

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

void setReRunUsingTestFile(boolean reRunUsingTestFile)

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

void setRerunMode(boolean rerun)

אפשר גם להגדיר את מצב ההפעלה מחדש.

void setRunName(String runName)

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

void setRunnerName(String runnerName)

אפשר גם להגדיר את ה-runner של Android לצורך שימוש.

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)

הגדרת אוסף הבדיקות ש-InstrumentationTest הזה צריך להריץ.

void setWindowAnimation(boolean windowAnimation)

שיטות מוגנות

static excludeNonExecuted(TestRunResult results)

מסננים את הערכים 'NOT_EXECUTED' ו-'Skipped' כדי לעקוב אחרי מה שצריך להריץ מחדש.

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

יוצרים ציבוריים

InstrumentationTest

public InstrumentationTest ()

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

addDeviceListeners

public void addDeviceListeners ( extraListeners)

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

פרמטרים
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 ()

הפונקציה מקבלת את ה-runner לכלי למדידה ב-Android שבו רוצים להשתמש.

החזרות
String

isOrchestrator

public boolean isOrchestrator ()

הפונקציה מחזירה את הערך של ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)

החזרות
boolean

ראן

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)

השיטה הזו הוצאה משימוש.
השיטה הזו היא ללא תפעול (no-op)

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

פרמטרים
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)

הגדרת האפשרות force-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

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

הגדרת האפשרות --orchestrator

פרמטרים
useOrchestrator boolean

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)

אפשר גם להגדיר את ה-runner לכלי למדידה ב-Android.

פרמטרים
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

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

פרמטרים
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

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

פרמטרים
testFilePathOnDevice String

setTestPackageName

public void setTestPackageName (String testPackageName)

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

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

המערכת תתעלם מהערך אם צוין ערך שאינו null ל-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)

הגדרת אוסף הבדיקות ש-InstrumentationTest הזה צריך להריץ.

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

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

פרמטרים
windowAnimation boolean

שיטות מוגנות

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

מסננים את הערכים 'NOT_EXECUTED' ו-'Skipped' כדי לעקוב אחרי מה שצריך להריץ מחדש.

פרמטרים
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