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

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

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

מחלקות משנה ישירות ידועות AndroidJUnitTest, CodeCoverTest AndroidJUnitTest בדיקה שמריצה חבילה של בדיקת אינסטרומנטציה במכשיר נתון באמצעות android.support.test.runner.AndroidJUnitRunner.  בדיקת קוד כיסוי בדיקה שמריצה חבילת בדיקת אינסטרומנטציה במכשיר נתון יוצרת את הדוח 'כיסוי הקוד'.

---

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

סיכום

שדות
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