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 mInstrumentInPcc

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

‫constructors ציבוריים

InstrumentationTest()

‫methods ציבוריים

void addDeviceListeners(Set<String> 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 isCollectTestsOnly()
boolean isOrchestrator()

הפונקציה מחזירה את הערך של ERROR(InstrumentationTest.mOrchestrator/#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)

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

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(List<IMetricCollector> collectors)

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

void setOrchestrator(boolean useOrchestrator)

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

void setPackageName(String packageName)

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

void setReRunUsingTestFile(boolean reRunUsingTestFile)

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

void setRerunMode(boolean rerun)

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

void setRetryAttemptNumber(int attemptNumber)

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

מגדיר את מספר הניסיון החוזר על ידי שליחתו כארגומנט של מכשור retry_attempt לצד המכשיר של הרץ.

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(Collection<TestDescription> tests)

מגדירים את אוסף הבדיקות שצריך להריץ באמצעות InstrumentationTest.

void setWindowAnimation(boolean windowAnimation)

שיטות מוגנות

static Set<TestDescription> 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

mInstrumentInPcc

protected boolean mInstrumentInPcc

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

‫constructors ציבוריים

InstrumentationTest

public InstrumentationTest ()

‫methods ציבוריים

addDeviceListeners

public void addDeviceListeners (Set<String> extraListeners)

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

פרמטרים
extraListeners Set

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

isCollectTestsOnly

public boolean isCollectTestsOnly ()

החזרות
boolean האם הבדיקה הזו היא במצב collect-tests-only.

isOrchestrator

public boolean isOrchestrator ()

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

החזרות
boolean

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

פרמטרים
testInfo ‫TestInformation: אובייקט TestInformation שמכיל מידע שימושי להרצת בדיקות.
listener ‫ITestInvocationListener: ITestInvocationListener תוצאות הבדיקה
הקפצת הודעות שגיאה (throw)
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)

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

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

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

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

פרמטרים
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

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

פרמטרים
testMethodName String

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

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

פרמטרים
collectors List

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

setRetryAttemptNumber

public void setRetryAttemptNumber (int attemptNumber)

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

מגדיר את מספר הניסיון החוזר על ידי שליחתו כארגומנט של מכשור retry_attempt לצד המכשיר של הרץ.

פרמטרים
attemptNumber int

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 נפרדות לכל בדיקה שנותרה דרך הפעלה מחדש.

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

מגדירים את אוסף הבדיקות שצריך להריץ באמצעות InstrumentationTest.

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

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

פרמטרים
windowAnimation boolean

שיטות מוגנות

excludeNonExecuted

protected static Set<TestDescription> excludeNonExecuted (TestRunResult results)

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

פרמטרים
results TestRunResult

החזרות
Set<TestDescription>

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 אם לא נמצא שם כזה.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

פרמטרים
runner IRemoteAndroidTestRunner