החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ModuleDefinition

public class ModuleDefinition
extends Object implements Comparable<ModuleDefinition>, ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.suite.ModuleDefinition

‫Container for the test run configuration. הכיתה הזו עוזרת להתכונן להרצת הבדיקות.

סיכום

ערכים קבועים
`String`	`ISOLATION_COST`
`String`	`MODULE_ABI`
`String`	`MODULE_CACHED` המאפיין הזה מוגדר כ-True אם התוצאות של מודול הבדיקה נשמרו במטמון.
`String`	`MODULE_CONTROLLER`
`String`	`MODULE_EXTERNAL_DEPENDENCIES`
`String`	`MODULE_ID` מזהה המודול הוא השם שישמש לזיהוי ייחודי של המודול במהלך testRunStart.
`String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`String`	`MODULE_ISOLATED` המאפיין הזה מוגדר כ-true אם המודול פעל במכשיר שהוכן לאחרונה.
`String`	`MODULE_NAME` שם המודול הוא השם הבסיסי שמשויך למודול, בדרך כלל מגיע מקובץ ההגדרות של Xml TF שממנו נטען המודול.
`String`	`MODULE_PARAMETERIZATION`
`String`	`MODULE_SKIPPED` המאפיין הזה מוגדר כ-true אם דילגו על מודול הבדיקה
`String`	`MODULE_TEST_COUNT`
`String`	`PREPARATION_TIME`
`String`	`RETRY_FAIL_COUNT`
`String`	`RETRY_SUCCESS_COUNT`
`String`	`RETRY_TIME`
`String`	`SPARSE_MODULE` הנכס הזה מוגדר כ-True אם מדווחים רק על אירועים ברמת המודול.
`String`	`TEAR_DOWN_TIME`
`String`	`TEST_TIME`

‫constructors ציבוריים
`ModuleDefinition()`
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` Constructor
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, Map<String, List<ITargetPreparer>> suitePreparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` Constructor

‫methods ציבוריים
`int`	`compareTo(ModuleDefinition moduleDef)`
`Set<Digest>`	`getFilterDigests()` הפונקציה מחזירה את התקצירים של המסננים שמשויכים לבדיקות.
`String`	`getId()` הפונקציה מחזירה את השם הייחודי של המודול.
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` הפונקציה מחזירה את `IInvocationContext` שמשויך למודול.
`TestInformation`	`getModuleTestInformation()`
`Set<TokenProperty>`	`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, int maxRunLimit)` מריצים את כל ה-`IRemoteTest` שכלולים במודול ומשתמשים בכל כלי ההכנה לפני ואחרי כדי להגדיר ולנקות את המכשיר.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` מריצים את כל ה-`IRemoteTest` שכלולים במודול ומשתמשים בכל כלי ההכנה לפני ואחרי כדי להגדיר ולנקות את המכשיר.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` הרצת ההכנות של הבדיקה, כולל הכנות ברמת החבילה אם צוינו.
`void`	`setBuild(IBuildInfo build)` מזריקים את `IBuildInfo` לשימוש במהלך הבדיקות.
`void`	`setCollectKernelLog(boolean collectKernelLog)`
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` המתג מפעיל או משבית את מצב איסוף הבדיקות
`void`	`setDefaultLogCollectors(List<IMetricCollector> collectors)`
`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(List<IMetricCollector> collectors)` מזריקים את רשימת `IMetricCollector` לשימוש על ידי המודול.
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` הערכה אמורה לשחזר את המכשיר הווירטואלי.
`void`	`setRemoveModuleBuffering(boolean removeModuleBuffering)`
`void`	`setReportModuleEnd(boolean shouldReportModuleEnd)`
`void`	`setReportModuleStart(boolean shouldReportModuleStart)`
`final void`	`setRetryDecision(IRetryDecision decision)` מגדירה את ה-`IRetryDecision` שייעשה בו שימוש לניסיון חוזר בתוך המודול.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`boolean`	`shouldRecoverVirtualDevice()` הפונקציה מחזירה ערך אם צריך לשחזר את המכשיר הווירטואלי.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` העתקת חלק מההגדרות ברמת החבילה

שיטות מוגנות
`boolean`	`hasTests()` הפונקציה מחזירה את הערך True אם עדיין יש `IRemoteTest` להפעלה במאגר של המודול.

ערכים קבועים

ISOLATION_COST

public static final String ISOLATION_COST

ערך קבוע: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

ערך קבוע: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

המאפיין הזה מוגדר כ-True אם התוצאות של מודול הבדיקה נשמרו במטמון.

ערך קבוע: "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

ערך קבוע: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

ערך קבוע: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

מזהה המודול הוא השם שישמש לזיהוי ייחודי של המודול במהלך testRunStart. בדרך כלל מדובר בשילוב של MODULE_ABI + MODULE_NAME.

ערך קבוע: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

ערך קבוע: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

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

ערך קבוע: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

שם המודול הוא השם הבסיסי שמשויך למודול, בדרך כלל מגיע מקובץ ההגדרות של Xml TF שממנו נטען המודול.

ערך קבוע: "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

ערך קבוע: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

המאפיין הזה מוגדר כ-true אם דילגו על מודול הבדיקה

ערך קבוע: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

ערך קבוע: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

ערך קבוע: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

ערך קבוע: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

ערך קבוע: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

ערך קבוע: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

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

ערך קבוע: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

ערך קבוע: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

ערך קבוע: "TEST_TIME"

‫constructors ציבוריים

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Constructor

פרמטרים
`name`	‫`String`: השם הייחודי של הגדרת הבדיקה.
`tests`	`Collection`: רשימה של `IRemoteTest` שצריך להריץ.
`preparersPerDevice`	‫`Map`: רשימה של `ITargetPreparer` שישמשו להגדרת המכשיר.
`multiPreparers`	`List`
`moduleConfig`	‫`IConfiguration`: ה-`IConfiguration` של הגדרות המודול הבסיסי.

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                Map<String, List<ITargetPreparer>> suitePreparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Constructor

פרמטרים
`name`	‫`String`: השם הייחודי של הגדרת הבדיקה.
`tests`	`Collection`: רשימה של `IRemoteTest` שצריך להריץ.
`preparersPerDevice`	‫`Map`: רשימה של `ITargetPreparer` שישמשו להגדרת המכשיר.
`suitePreparersPerDevice`	`Map`
`multiPreparers`	`List`
`moduleConfig`	‫`IConfiguration`: ה-`IConfiguration` של הגדרות המודול הבסיסי.

‫methods ציבוריים

compareTo

public int compareTo (ModuleDefinition moduleDef)

פרמטרים
`moduleDef`	`ModuleDefinition`

החזרות
`int`

getFilterDigests

public Set<Digest> getFilterDigests ()

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

החזרות
`Set<Digest>`

הקפצת הודעות שגיאה (throw)
`IOException`

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`

getModuleTestInformation

public TestInformation getModuleTestInformation ()

החזרות
`TestInformation`

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

פרמטרים
`testInfo`	`TestInformation`

החזרות
`Set<TokenProperty>`

getRuntimeHint

public long getRuntimeHint ()

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

החזרות
`long`

hasModuleFailed

public boolean hasModuleFailed ()

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

החזרות
`boolean`

neededDevices

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, 
                int maxRunLimit)

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

פרמטרים
`moduleInfo`	‫`TestInformation`: `TestInformation` של המודול.
`listener`	‫`ITestInvocationListener`: `ITestInvocationListener` שבו ידווחו התוצאות.
`maxRunLimit`	‫`int`: המספר המקסימלי של הרצות לכל מקרה בדיקה.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם המכשיר עובר למצב אופליין.

ראן

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

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

פרמטרים
`moduleInfo`	`TestInformation`
`listener`	‫`ITestInvocationListener`: `ITestInvocationListener` שבו ידווחו התוצאות.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם המכשיר עובר למצב אופליין.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

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

פרמטרים
`includeSuitePreparers`	‫`boolean`: מגדירים את הערך `true` כדי להפעיל גם את כלי ההכנה ברמת החבילה.

החזרות
`Throwable`	`Throwable` של כל חריגה שמועלית כשמריצים את כלי ההכנה.

setBuild

public void setBuild (IBuildInfo build)

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

פרמטרים
`build`	`IBuildInfo`

setCollectKernelLog

public void setCollectKernelLog (boolean collectKernelLog)

פרמטרים
`collectKernelLog`	`boolean`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

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

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

פרמטרים
`collectors`	`List`

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

מזריקים את רשימת IMetricCollector לשימוש על ידי המודול.

פרמטרים
`collectors`	`List`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

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

פרמטרים
`recoverVirtualDevice`	`boolean`

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

פרמטרים
`removeModuleBuffering`	`boolean`

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

פרמטרים
`shouldReportModuleEnd`	`boolean`

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

פרמטרים
`shouldReportModuleStart`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

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

פרמטרים
`decision`	`IRetryDecision`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

פרמטרים
`useModuleResultsForwarder`	`boolean`

shouldRecoverVirtualDevice

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`