בדיקת אינסטרומנטציה

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

JavaScript.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)

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

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

קבלת השם המותאם אישית של הרצת הבדיקה שיסופק ל-listener

String getRunnerName()

מקבל את השימוש במכשיר האינסטרומנטציה של Android.

boolean isOrchestrator()

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

void run(TestInformation testInfo, ITestInvocationListener listener)

הרצת הבדיקות ודיווח על התוצאה ל-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)

הגדרת הרשימה של פריטי 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)

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

void setRunnerName(String runnerName)

אפשר גם להגדיר את כלי האינסטרומנטציה של Android לשימוש.

void setShellTimeout(long timeout)

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

void setTestFilePathOnDevice(String testFilePathOnDevice)

אפשר גם להגדיר את הנתיב לקובץ שנמצא במכשיר שאמור להכיל רשימת שורות מחלקות בדיקה ושיטות בדיקה נפרדות (format: 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" המערכת דילגה עליה כדי לעקוב אחרי מה שצריך להריץ מחדש.

String getClassName()

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

ListInstrumentationParser getListInstrumentationParser()

משתמשים ב-ListInstrumentationParser לניתוח 'אינסטרומנטציה של רשימת PM' שאילתות.

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

ניפוי באגים

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

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

בדיקת אינסטרומנטציה

public InstrumentationTest ()

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

addDeviceListeners

public void addDeviceListeners ( extraListeners)

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

פרמטרים
extraListeners

הוספה אינסטרומנטציהArg

public void addInstrumentationArg (String key, 
                String value)

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

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

getAbi

public IAbi getAbi ()

החזרות
IAbi

getConfiguration

public IConfiguration getConfiguration ()

הפונקציה מקבלת את ה-IConfiguration לבדיקה הזו.

החזרות
IConfiguration

getCoverTarget

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

קבלת השם המותאם אישית של הרצת הבדיקה שיסופק ל-listener

החזרות
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)

הרצת הבדיקות ודיווח על התוצאה ל-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)

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

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

פרמטרים
timeout int

הגדרה

public void setConfiguration (IConfiguration config)

החדרת IConfiguration בשימוש.

פרמטרים
config IConfiguration

להגדיר כיסוי

public void setCoverageTarget (String coverageTarget)

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

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

פרמטרים
coverageTarget String

setDebug

public void setDebug (boolean debug)

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

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

הגדרת מכשיר

public void setDevice (ITestDevice device)

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

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

הגדרה אכיפה

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

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

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

פרמטרים
useOrchestrator boolean

setPackageName

public void setPackageName (String packageName)

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

פרמטרים
packageName String

setReRunUsageTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

פרמטרים
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

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

פרמטרים
rerun boolean

שם הפרמטר setRunName

public void setRunName (String runName)

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

פרמטרים
runName String

setRunnerName

public void setRunnerName (String runnerName)

אפשר גם להגדיר את כלי האינסטרומנטציה של Android לשימוש.

פרמטרים
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

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

פרמטרים
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

אפשר גם להגדיר את הנתיב לקובץ שנמצא במכשיר שאמור להכיל רשימת שורות מחלקות בדיקה ושיטות בדיקה נפרדות (format: 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 ( tests)

הגדרת אוסף הבדיקות שיבוצעו באמצעות InstrumentationTest הזה.

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

אנימציה setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

פרמטרים
windowAnimation boolean

שיטות מוגנות

אל תכלול לא בוצעה

protected static  excludeNonExecuted (TestRunResult results)

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

פרמטרים
results TestRunResult

החזרות

getClassName

protected String getClassName ()

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

החזרות
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

משתמשים ב-ListInstrumentationParser לניתוח 'אינסטרומנטציה של רשימת PM' שאילתות.

החזרות
ListInstrumentationParser

getMethodName

protected String getMethodName ()

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

החזרות
String

getTestPackageName

protected String getTestPackageName ()

מורידים את חבילת ה-Java לבדיקה.

החזרות
String

queryRunnerName

protected String queryRunnerName ()

מריצים שאילתה במכשיר על מנת להשתמש בו.

החזרות
String שם הרצת המבחן הראשון שתואם לחבילה או null אם לא נמצאו.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

פרמטרים
runner IRemoteAndroidTestRunner