InstrumentationTest

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

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

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

סיכום

ערכים קבועים

String RUN_TESTS_AS_USER_KEY

String RUN_TESTS_ON_SDK_SANDBOX

שדות

protected boolean mDebug

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

Constructors ציבוריים

InstrumentationTest()

‫methods ציבוריים

void addDeviceListeners( extraListeners)

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

void addInstrumentationArg(String key, String value)

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

IAbi getAbi()
IConfiguration getConfiguration()

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

String getCoverageTarget()

קבלת נתוני כיסוי של יעד שהוגדר בעבר באמצעות setCoverageTarget(String).

boolean getDebug()

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

ITestDevice getDevice()

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

String getForceAbi()
long getMaxTimeout()

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

String getPackageName()

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

String getRunName()

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

String getRunnerName()

מקבל את כלי ההרצה של מכשור 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-ops)

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)

הגדרת רשימת IMetricCollectors שהוגדרו להרצת הבדיקה.

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)

אפשר גם להגדיר את הכלי להרצת בדיקות (Instrumentation) של 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_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

ערך קבוע: "RUN_TESTS_ON_SDK_SANDBOX"

שדות

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Constructors ציבוריים

InstrumentationTest

public InstrumentationTest ()

‫methods ציבוריים

addDeviceListeners

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

קבלת נתוני כיסוי של יעד שהוגדר בעבר באמצעות 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 ()

מקבל את כלי ההרצה של מכשור 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-ops)

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

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

הגדרת רשימת IMetricCollectors שהוגדרו להרצת הבדיקה.

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

אפשר גם להגדיר את הכלי להרצת בדיקות (Instrumentation) של 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