ModuleDefinition
public
class
ModuleDefinition
extends Object
implements
ITestCollector
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.ModuleDefinition |
מאגר של הגדרות הפעלת הבדיקה. הכיתה הזו משמשת לעזרה בהכנה ובהרצה של הבדיקות.
סיכום
שדות | |
---|---|
public
static
final
String |
ISOLATION_COST
|
public
static
final
String |
MODULE_ABI
|
public
static
final
String |
MODULE_CACHED
המאפיין הזה מוגדר כ-true אם תוצאות מודול הבדיקה נשמרו במטמון. |
public
static
final
String |
MODULE_CONTROLLER
|
public
static
final
String |
MODULE_EXTERNAL_DEPENDENCIES
|
public
static
final
String |
MODULE_ID
מזהה המודול – השם שישמש לזיהוי ייחודי של המודול במהלך testRunStart. |
public
static
final
String |
MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
|
public
static
final
String |
MODULE_ISOLATED
המאפיין הזה מוגדר כ-true אם המודול פועל במכשיר שהכינו מחדש. |
public
static
final
String |
MODULE_NAME
שם המודול הוא שם הבסיס שמשויך למודול, והוא בדרך כלל מגיע מקובץ התצורה Xml TF שממנו המודול נטען. |
public
static
final
String |
MODULE_PARAMETERIZATION
|
public
static
final
String |
MODULE_SKIPPED
המאפיין הזה מוגדר כ-true אם מודול הבדיקה דלג על הבדיקה |
public
static
final
String |
MODULE_TEST_COUNT
|
public
static
final
String |
PREPARATION_TIME
|
public
static
final
String |
RETRY_FAIL_COUNT
|
public
static
final
String |
RETRY_SUCCESS_COUNT
|
public
static
final
String |
RETRY_TIME
|
public
static
final
String |
SPARSE_MODULE
הנכס הזה מוגדר כ-true אם מדווחים רק על אירועים ברמת המודול. |
public
static
final
String |
TEAR_DOWN_TIME
|
public
static
final
String |
TEST_TIME
|
בנאים ציבוריים | |
---|---|
ModuleDefinition()
|
|
ModuleDefinition(String name,
Constructor |
|
ModuleDefinition(String name,
Constructor |
שיטות ציבוריות | |
---|---|
int
|
compareTo(ModuleDefinition moduleDef)
|
String
|
getId()
מחזיר את שם המודול הייחודי. |
Integer
|
getIntraModuleShardCount()
|
Integer
|
getIntraModuleShardIndex()
|
IConfiguration
|
getModuleConfiguration()
|
IInvocationContext
|
getModuleInvocationContext()
הפונקציה מחזירה את הערך של |
|
getRequiredTokens(TestInformation testInfo)
|
long
|
getRuntimeHint()
הפונקציה מחזירה את משך הזמן המשוער להרצת כל הבדיקות במודול. |
boolean
|
hasModuleFailed()
הפונקציה מחזירה את הערך True אם הופעלה קריאה ל-testRunFailure במודול * |
int
|
neededDevices()
הפונקציה מחזירה את מספר המכשירים שצפויים להריץ את הבדיקה הזו. |
int
|
numTests()
הפונקציה מחזירה את המספר הנוכחי של |
final
void
|
reportNotExecuted(ITestInvocationListener listener, String message)
דיווח על מודולים שלא בוצעו בכלל. |
final
void
|
run(TestInformation moduleInfo, ITestInvocationListener listener,
מריצים את כל |
final
void
|
run(TestInformation moduleInfo, ITestInvocationListener listener,
מריצים את כל |
final
void
|
run(TestInformation moduleInfo, ITestInvocationListener listener)
מריצים את כל ה- |
Throwable
|
runPreparation(boolean includeSuitePreparers)
הרצת כלי ההכנה של הבדיקה, כולל כלי הכנה ברמת הסוויט אם צוין. |
void
|
setBuild(IBuildInfo build)
מזינים את |
void
|
setCollectTestsOnly(boolean collectTestsOnly)
הפעלה או השבתה של מצב אוסף הבדיקות |
void
|
setDevice(ITestDevice device)
מזינים את |
void
|
setEnableDynamicDownload(boolean enableDynamicDownload)
האם להפעיל הורדה דינמית ברמת המודול. |
void
|
setIntraModuleInformation(int shardCount, int shardIndex)
|
void
|
setLogSaver(ILogSaver logSaver)
מעבירים את שומר יומן ההפעלה למודול כדי שיוכל להשתמש בו במקרה הצורך. |
final
void
|
setMergeAttemps(boolean mergeAttempts)
קובע אם למזג תוצאות או לא. |
void
|
setMetricCollectors(
מוסיפים את הרשימה של |
void
|
setRecoverVirtualDevice(boolean recoverVirtualDevice)
ערכות אמורות לשחזר מכשיר וירטואלי. |
final
void
|
setRetryDecision(IRetryDecision decision)
הגדרת |
boolean
|
shouldRecoverVirtualDevice()
הפונקציה מחזירה אם צריך לשחזר מכשיר וירטואלי. |
String
|
toString()
|
void
|
transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)
העתקת כמה מההגדרות ברמת חבילת הערוצים |
שיטות מוגנות | |
---|---|
boolean
|
hasTests()
הפונקציה מחזירה את הערך True אם עדיין יש |
שדות
ISOLATION_COST
public static final String ISOLATION_COST
MODULE_ABI
public static final String MODULE_ABI
MODULE_CACHED
public static final String MODULE_CACHED
המאפיין הזה מוגדר כ-true אם תוצאות מודול הבדיקה נשמרו במטמון.
MODULE_ControlLER
public static final String MODULE_CONTROLLER
MODULE_EXTERNAL_DEPENDENCIES
public static final String MODULE_EXTERNAL_DEPENDENCIES
MODULE_ID
public static final String MODULE_ID
מזהה המודול – השם שישמש לזיהוי ייחודי של המודול במהלך testRunStart. בדרך כלל הוא יהיה שילוב של MODULE_ABI + MODULE_NAME.
MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
MODULE_ISOLATED
public static final String MODULE_ISOLATED
המאפיין הזה מוגדר כ-true אם המודול פועל במכשיר שהכינו מחדש.
MODULE_NAME
public static final String MODULE_NAME
שם המודול הוא שם הבסיס שמשויך למודול, בדרך כלל מגיע מקובץ התצורה של Xml TF שממנו המודול נטען.
MODULE_PARAMETERIZATION
public static final String MODULE_PARAMETERIZATION
MODULE_SKIPPED
public static final String MODULE_SKIPPED
המאפיין מוגדר כ-True אם המערכת מדלגת על מודול הבדיקה
MODULE_TEST_COUNT
public static final String MODULE_TEST_COUNT
PREPARATION_TIME (זמן הכנה)
public static final String PREPARATION_TIME
RETRY_FAIL_COUNT
public static final String RETRY_FAIL_COUNT
RETRY_SUCCESS_COUNT
public static final String RETRY_SUCCESS_COUNT
RETRY_TIME
public static final String RETRY_TIME
SPARSE_MODULE
public static final String SPARSE_MODULE
הנכס הזה מוגדר כ-true אם מדווחים רק על אירועים ברמת המודול.
TEAR_DOWN_TIME
public static final String TEAR_DOWN_TIME
TEST_TIME
public static final String TEST_TIME
בנאים ציבוריים
הגדרת מודול
public ModuleDefinition ()
ModuleDefinition
public ModuleDefinition (String name,tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)
Constructor
פרמטרים | |
---|---|
name |
String : השם הייחודי של הגדרות הבדיקה. |
tests |
: רשימה של IRemoteTest שצריך להריץ. |
preparersPerDevice |
: רשימה של ITargetPreparer שישמשו להגדרת המכשיר. |
multiPreparers |
|
moduleConfig |
IConfiguration : ה-IConfiguration של תצורת המודול הבסיסי. |
הגדרת מודול
public ModuleDefinition (String name,tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)
Constructor
פרמטרים | |
---|---|
name |
String : שם ייחודי של הגדרת הבדיקה. |
tests |
: רשימה של IRemoteTest שצריך לפעול. |
preparersPerDevice |
: רשימה של ITargetPreparer שישמשו להגדרת המכשיר. |
suitePreparersPerDevice |
|
multiPreparers |
|
moduleConfig |
IConfiguration : ה-IConfiguration של תצורת המודול הבסיסי. |
שיטות ציבוריות
compareTo
public int compareTo (ModuleDefinition moduleDef)
פרמטרים | |
---|---|
moduleDef |
ModuleDefinition |
החזרות | |
---|---|
int |
getId
public String getId ()
החזרת שם המודול הייחודי.
החזרות | |
---|---|
String |
getIntraModuleShardCount
public Integer getIntraModuleShardCount ()
החזרות | |
---|---|
Integer |
getIntraModuleShardIndex
public Integer getIntraModuleShardIndex ()
החזרות | |
---|---|
Integer |
getModuleInvocationContext
public IInvocationContext getModuleInvocationContext ()
הפונקציה מחזירה את הערך של IInvocationContext
שמשויך למודול.
החזרות | |
---|---|
IInvocationContext |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
פרמטרים | |
---|---|
testInfo |
TestInformation |
החזרות | |
---|---|
|
getRuntimeHint
public long getRuntimeHint ()
מחזירה את הזמן המשוער להרצת כל הבדיקות במודול.
החזרות | |
---|---|
long |
hasModuleFailed
public boolean hasModuleFailed ()
הפונקציה מחזירה את הערך True אם הופעלה קריאה ל-testRunFailure במודול *
החזרות | |
---|---|
boolean |
מכשירים נחוצים
public int neededDevices ()
הפונקציה מחזירה את מספר המכשירים שצפויים להריץ את הבדיקה הזו.
החזרות | |
---|---|
int |
numTests
public int numTests ()
הפונקציה מחזירה את המספר הנוכחי של IRemoteTest
שממתינים להרצה.
החזרות | |
---|---|
int |
reportNotExecuted
public final void reportNotExecuted (ITestInvocationListener listener, String message)
הדוח כלל מודולים שלא הופעלו.
פרמטרים | |
---|---|
listener |
ITestInvocationListener |
message |
String |
ראן
public final void run (TestInformation moduleInfo, ITestInvocationListener listener,moduleLevelListeners)
מריצים את כל IRemoteTest
שמכיל המודול ומשתמשים בכל ה-preparers לפני ואחרי כדי להגדיר ולנקות את המכשיר.
פרמטרים | |
---|---|
moduleInfo |
TestInformation |
listener |
ITestInvocationListener : ה-ITestInvocationListener שבו מדווחים על התוצאות. |
moduleLevelListeners |
: רשימת המאזינים ברמת המודול. |
זריקות | |
---|---|
DeviceNotAvailableException |
במקרה שהמכשיר עובר למצב אופליין. |
ראן
public final void run (TestInformation moduleInfo, ITestInvocationListener listener,moduleLevelListeners, int maxRunLimit)
מריצים את כל IRemoteTest
שמכיל המודול ומשתמשים בכל ה-preparers לפני ואחרי כדי להגדיר ולנקות את המכשיר.
פרמטרים | |
---|---|
moduleInfo |
TestInformation : ה-TestInformation של המודול. |
listener |
ITestInvocationListener : ה-ITestInvocationListener שבו מדווחים על התוצאות. |
moduleLevelListeners |
: רשימת המאזינים ברמת המודול. |
maxRunLimit |
int : המספר המקסימלי של הפעלות לכל בדיקת תוכנה. |
זריקות | |
---|---|
DeviceNotAvailableException |
במקרה שהמכשיר עובר למצב אופליין. |
ראן
public final void run (TestInformation moduleInfo, ITestInvocationListener listener)
מריצים את כל IRemoteTest
שמכיל המודול ומשתמשים בכל ה-preparers לפני ואחרי כדי להגדיר ולנקות את המכשיר.
פרמטרים | |
---|---|
moduleInfo |
TestInformation |
listener |
ITestInvocationListener : ה-ITestInvocationListener שבו מדווחים על התוצאות. |
זריקות | |
---|---|
DeviceNotAvailableException |
במקרה שהמכשיר עובר למצב אופליין. |
runPreparation
public Throwable runPreparation (boolean includeSuitePreparers)
הרצת כלי ההכנה של הבדיקה, כולל כלי הכנה ברמת הסוויט אם צוין.
פרמטרים | |
---|---|
includeSuitePreparers |
boolean : מגדירים את הערך true כדי להריץ גם כלי הכנה ברמת חבילת הערוצים. |
החזרות | |
---|---|
Throwable |
Throwable של כל החרגה שהופיעה במהלך הפעלת הכלי להכנת הנתונים. |
setBuild
public void setBuild (IBuildInfo build)
מזינים את IBuildInfo
לשימוש במהלך הבדיקות.
פרמטרים | |
---|---|
build |
IBuildInfo |
setCollectTestsOnly
public void setCollectTestsOnly (boolean collectTestsOnly)
הפעלה או השבתה של מצב אוסף הבדיקות
setDevice
public void setDevice (ITestDevice device)
מזינים את ITestDevice
לשימוש במהלך הבדיקות.
פרמטרים | |
---|---|
device |
ITestDevice |
setEnableDynamicDownload
public void setEnableDynamicDownload (boolean enableDynamicDownload)
האם להפעיל הורדה דינמית ברמת המודול.
פרמטרים | |
---|---|
enableDynamicDownload |
boolean |
setIntraModuleInformation
public void setIntraModuleInformation (int shardCount, int shardIndex)
פרמטרים | |
---|---|
shardCount |
int |
shardIndex |
int |
setLogSaver
public void setLogSaver (ILogSaver logSaver)
מעבירים את שומר יומן ההפעלה למודול כדי שיוכל להשתמש בו במקרה הצורך.
פרמטרים | |
---|---|
logSaver |
ILogSaver |
setMergeAttemps
public final void setMergeAttemps (boolean mergeAttempts)
קובע אם למזג תוצאות או לא.
פרמטרים | |
---|---|
mergeAttempts |
boolean |
setMetricCollectors
public void setMetricCollectors (collectors)
מוסיפים את הרשימה של IMetricCollector
שתשמש את המודול.
פרמטרים | |
---|---|
collectors |
|
setRecoverVirtualDevice
public void setRecoverVirtualDevice (boolean recoverVirtualDevice)
הקבוצות אמורות לשחזר את המכשיר הווירטואלי.
פרמטרים | |
---|---|
recoverVirtualDevice |
boolean |
setRetryDecision
public final void setRetryDecision (IRetryDecision decision)
מגדיר את IRetryDecision
שישמש לניסיון חוזר בתוך המודול.
פרמטרים | |
---|---|
decision |
IRetryDecision |
צריך לשחזרVirtualDevice
public boolean shouldRecoverVirtualDevice ()
הפונקציה מחזירה את הערך 'כן' אם צריך לשחזר מכשיר וירטואלי.
החזרות | |
---|---|
boolean |
toString
public String toString ()
החזרות | |
---|---|
String |
transferSuiteLevelOptions
public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)
העתקת כמה מההגדרות ברמת חבילת הערוצים
פרמטרים | |
---|---|
mSuiteConfiguration |
IConfiguration |
שיטות מוגנות
hasTests
protected boolean hasTests ()
הפונקציה מחזירה את הערך True אם עדיין יש IRemoteTest
למודול להריץ במאגר שלו. אחרת, הערך יהיה False.
החזרות | |
---|---|
boolean |