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, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)

Constructor

ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)

Constructor

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

int compareTo(ModuleDefinition moduleDef)

String getId()

מחזיר את שם המודול הייחודי.

Integer getIntraModuleShardCount()
Integer getIntraModuleShardIndex()
IConfiguration getModuleConfiguration()
IInvocationContext getModuleInvocationContext()

הפונקציה מחזירה את הערך של IInvocationContext שמשויך למודול.

getRequiredTokens(TestInformation testInfo)
long getRuntimeHint()

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

boolean hasModuleFailed()

הפונקציה מחזירה את הערך True אם הופעלה קריאה ל-testRunFailure במודול *

int neededDevices()

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

int numTests()

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

final void reportNotExecuted(ITestInvocationListener listener, String message)

דיווח על מודולים שלא בוצעו בכלל.

final void run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners)

מריצים את כל IRemoteTest שמכיל המודול ומשתמשים בכל ה-preparers לפני ואחרי כדי להגדיר ולנקות את המכשיר.

final void run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, int maxRunLimit)

מריצים את כל IRemoteTest שמכיל המודול ומשתמשים בכל ה-preparers לפני ואחרי כדי להגדיר ולנקות את המכשיר.

final void run(TestInformation moduleInfo, ITestInvocationListener listener)

מריצים את כל ה-IRemoteTest הכלולים במודול ומשתמשים בכל המכינים לפני ואחרי ההגדרה של המכשיר וניקויו.

Throwable runPreparation(boolean includeSuitePreparers)

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

void setBuild(IBuildInfo build)

מזינים את IBuildInfo לשימוש במהלך הבדיקות.

void setCollectTestsOnly(boolean collectTestsOnly)

הפעלה או השבתה של מצב אוסף הבדיקות

void setDevice(ITestDevice device)

מזינים את ITestDevice לשימוש במהלך הבדיקות.

void setEnableDynamicDownload(boolean enableDynamicDownload)

האם להפעיל הורדה דינמית ברמת המודול.

void setIntraModuleInformation(int shardCount, int shardIndex)
void setLogSaver(ILogSaver logSaver)

מעבירים את שומר יומן ההפעלה למודול כדי שיוכל להשתמש בו במקרה הצורך.

final void setMergeAttemps(boolean mergeAttempts)

קובע אם למזג תוצאות או לא.

void setMetricCollectors( collectors)

מוסיפים את הרשימה של IMetricCollector שתשמש את המודול.

void setRecoverVirtualDevice(boolean recoverVirtualDevice)

ערכות אמורות לשחזר מכשיר וירטואלי.

final void setRetryDecision(IRetryDecision decision)

הגדרת IRetryDecision לשימוש בניסיון חוזר בתוך המודול.

boolean shouldRecoverVirtualDevice()

הפונקציה מחזירה אם צריך לשחזר מכשיר וירטואלי.

String toString()

void transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)

העתקת כמה מההגדרות ברמת חבילת הערוצים

שיטות מוגנות

boolean hasTests()

הפונקציה מחזירה את הערך True אם עדיין יש IRemoteTest למודול להריץ במאגר שלו.

שדות

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

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

החזרות
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

הפונקציה מחזירה את הערך של IInvocationContext שמשויך למודול.

החזרות
IInvocationContext

getRequiredTokens

public  getRequiredTokens (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