החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

תת-כיתות עקיפות ידועות

AdbStopServerPreparer,‏ AllTestAppsInstallSetup,‏ AoaTargetPreparer,‏ AppSetup,‏ ArtChrootPreparer,‏ BaseEmulatorPreparer,‏ BaseTargetPreparer,‏ BuildInfoRecorder,‏ CheckPairingPreparer,‏ CompanionAllocator,‏ CompanionAwarePreparer,‏ CompanionRunCommandTargetPreparer,‏ CompanionTestAppInstallSetup,‏ CompileBootImageWithSpeedTargetPreparer,‏ CpuThrottlingWaiter ו-76 אחרים.

AdbStopServerPreparer	מטרגטים את הכלי להכנת הבדיקה כדי שיפסיק את שרת adb במארח לפני ואחרי הרצת בדיקות adb.
AllTestAppsInstallSetup	`ITargetPreparer` שמתקין את כל האפליקציות מתיקייה `IDeviceBuildInfo.getTestsDir()` במכשיר.
AoaTargetPreparer	`ITargetPreparer` שמבצע סדרה של פעולות (למשל קליקים ותנועות החלקה) באמצעות פרוטוקול Android Open Accessory‏ (AOAv2).
AppSetup	`ITargetPreparer` שמתקין קובץ APK ואת הבדיקות שלו.
ArtChrootPreparer	יצירת ספריית chroot לבדיקות ART.
BaseEmulatorPreparer	הכנה נפוצה להפעלת אמולטור מקומי.
BaseTargetPreparer	סוג בסיס להטמעה של `ITargetPreparer` שמאפשר לקבוע אם האובייקט מושבת או לא.
BuildInfoRecorder	`ITargetPreparer` שכותב מטא-נתונים של פרטי build לקובץ מסוים.
CheckPairingPreparer	`CompanionAwarePreparer` שמאמת את הקישור ב-BT בין המכשיר הראשי למכשיר הנלווה.
CompanionAllocator	מחלקה בסיסית שמטפלת בהקצאה ובשחרור של מכשיר נלווה צריך להטמיע את `getCompanionDeviceSelectionOptions()` כדי לתאר את הקריטריונים הנדרשים להקצאת מכשיר התלווה.
CompanionAwarePreparer	`ITargetPreparer` שמכיל את הלוגיקה של אחזור מכשיר נלווה שכבר הוקצה.
CompanionRunCommandTargetPreparer	`ITargetPreparer` שמריץ פקודות ספציפיות במכשיר התומך שהוקצה
CompanionTestAppInstallSetup	`ITargetPreparer` שמתקין אפליקציה אחת או יותר מתיקיית `IDeviceBuildInfo.getTestsDir()` במכשיר נלווה שהוקצה.
CompileBootImageWithSpeedTargetPreparer	קומפילציה מחדש של נתיב ה-Classpath של האתחול ושל שרת המערכת באמצעות מסנן המהדר 'מהירות'.
CpuThrottlingWaiter	`ITargetPreparer` שממתין עד שהתדירות המקסימלית בכל הליבות תוחזר לרמה הגבוהה ביותר הזמינה.
CreateAvdPreparer
CreateUserPreparer	יוצר המשתמש והכלי לניקוי בסוף התהליך.
DeviceActionTargetPreparer	`ITargetPreparer` כדי לבצע פעולות במכשיר.
DeviceBuildInfoBootStrapper	`ITargetPreparer` שמחליף את שדות פרטי ה-build במאפיינים שנקראים מהמכשיר האפשרות הזו שימושית לבדיקת מכשירים עם גרסאות build שנוצרו ממקור חיצוני (למשל:
DeviceBuildInfoInjector	`ITargetPreparer` שמוסיף מטא-נתונים של `DeviceBuildDescriptor` ל-`IBuildInfo`.
DeviceCleaner	הפעלה מחדש או פורמט כפעולת ניקוי אחרי הבדיקה, ואפשרות לכיבוי המסך
DeviceFlashPreparer	`ITargetPreparer` שמציג תמונת אימג' בחומרה פיזית של Android.
DeviceImageZipFlashingTargetPreparer	כלי להכנת יעד שמאפס את המכשיר באמצעות קובצי אימג' של המכשיר שסופקו בפורמט ספציפי.
DeviceOwnerTargetPreparer	`ITargetPreparer` שמגדיר רכיב של בעלי מכשיר.
DeviceSetup	`ITargetPreparer` שמגדיר מכשיר לבדיקה על סמך `Option`s שסופקו.
DeviceStorageFiller	מגדירים את הכלי למלא את נפח האחסון כדי שיהיה מקום פנוי.
DeviceStringPusher	הכנת יעד לכתיבה של מחרוזת לקובץ.
DeviceUpdateTargetPreparer	פונקציית `ITargetPreparer` מופשטת שמטפלת בשלבים נפוצים של עדכון מכשירים באמצעות קובץ אימג' של המכשיר ממקור חיצוני (בניגוד לשירות build).
DeviceWiper	`ITargetPreparer` שמאפס את userdata
DisableSELinuxTargetPreparer	כלי להכנת יעד שמשבית את SELinux אם הוא מופעל.
DynamicSystemPreparer	קובץ `ITargetPreparer` שמגדיר קובץ אימג' של מערכת מעל גרסה של מכשיר עם עדכון מערכת דינמי.
EraseUserDataPreparer	`ITargetPreparer` שמאפס את נתוני המשתמש במכשיר.
FastbootCommandPreparer	כלי להכנת יעד שמפעיל את fastboot ושולח פקודות fastboot.
FastbootUpdateBootstrapPreparer	`ITargetPreparer` שמארגן קבצים ספציפיים (מרכז האתחול, הרדיו, קובץ ה-zip של קובץ האימג' של המכשיר) ב-`IDeviceBuildInfo` כדי להפעיל את ה-flash במכשירים באמצעות `FastbootDeviceFlasher`, ולאחר מכן מזין מאפייני מכשיר לאחר האתחול בפרטי ה-build למטרות דיווח על תוצאות.
FeatureFlagTargetPreparer	עדכון של DeviceConfig (דגלים של תכונות שמותאמים על ידי שירות מרוחק).
FoldableModePreparer	שירות לעיבוד יעד שיכול לשנות את המצב המתקפל של מכשיר.
FolderSaver	`ITargetPreparer` ששואב ספריות מהמכשיר, דוחס אותן ושומר אותן בקצה העורפי של הרישום ביומן.
GkiDeviceFlashPreparer	כלי להכנת יעד שמבצע אימיג' של המכשיר באמצעות קובץ אימג' גנרי של ליבה נפוצה של Android.
GsiDeviceFlashPreparer	כלי להכנת יעד שמבצע אימיג' של המכשיר באמצעות תמונת מערכת גנרית (GSI) ל-Android.
ILabPreparer	ממשק של סמן לצורך הכנת מעבדה תיאור של הממשקים האלה מופיע בקטע `ITargetPreparer`.
ITargetCleaner	הממשק הזה הוצא משימוש. השיטה tearDown הועברה לממשק הבסיסי ITargetPreparer.
InstallAllTestZipAppsSetup	`ITargetPreparer` שמתקין את כל האפליקציות בקובץ zip לבדיקה.
InstallApexModuleTargetPreparer
InstallApkSetup	`ITargetPreparer` שמתקין קובץ APK אחד או יותר שנמצאים במערכת הקבצים.
InstallBuildEnvApkSetup	`ITargetPreparer` שמתקין קובץ APK אחד או יותר לבדיקה מסביבת build של פלטפורמת Android.
InstallKernelModulePreparer	כלי להכנת יעד שמתקין מודולים של ליבה.
InstrumentationPreparer	`ITargetPreparer` שמריץ את המדידה
KillExistingEmulatorPreparer	`ITargetPreparer` שמשבית אמולטור שפועל.
KnownFailurePreparer	Target preparer to skip retrying known failure.
LocalEmulatorLaunch	TargetPreparer שמפעיל אמולטור באופן מקומי מסביבת build של Android.
LocalEmulatorSnapshot	TargetPreparer שנועד ליצור קובץ snapshot נקי של אמולטור מסביבת פיתוח או build של Android
MixKernelTargetPreparer	`ITargetPreparer` שמאפשרת לשלב בין קובץ אימג' של ליבה לבין קובץ אימג' של מכשיר.
ModuleOemTargetPreparer
NativeLeakCollector	`ITargetPreparer` שמריץ את הפקודה 'dumpsys meminfo --unreachable -a' כדי לזהות את הזיכרון המקומי שלא ניתן לגשת אליו שנמצא כרגע בכל תהליך.
NoApkTestSkipper	כלי הכנה מיוחד שמאפשר לדלג על קריאה לחלוטין (הכנה ובדיקות) אם אין חבילות APK לבדיקה.
PerfettoPreparer	הכלי לעיבוד של Perfetto דוחף את קובץ התצורה למכשיר במיקום סטנדרטי שיש ל-Perfetto גישה אליו.
ProfileTargetPreparer	כיתה בסיסית להגדרת כלי להכנת יעדים לכל משתמש בפרופיל `android.os.usertype.profile.XXX`.
PushFileInvoker	הסיווג הזה הוצא משימוש. במקום זאת, צריך להשתמש ב-`PushFilePreparer`
PushFilePreparer	`ITargetPreparer` שמנסה לדחוף מספר כלשהו של קבצים מכל נתיב מארח לכל נתיב מכשיר.
PythonVirtualenvPreparer	הגדרת Python virtualenv במארח והתקנת חבילות.
RebootTargetPreparer	כלי להתקנת יעד שמפעיל מחדש את המכשיר.
RecoveryLogPreparer	כלי לעיבוד מטרות שמשתמש באיסוף יומנים לפני השחזור.
RemoveSystemAppPreparer	`ITargetPreparer` להסרת קובץ APK ממחיצה המערכת לפני הרצה של בדיקה.
RestartSystemServerTargetPreparer	כלי לניהול יעדי התקנה שמפעיל מחדש את שרת המערכת בלי להפעיל מחדש את המכשיר.
RootTargetPreparer	כלי להכנת יעד שמבצע את הפקודה 'adb root' או 'adb unroot' על סמך האפשרות 'force-root'.
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	מטרגטים את הכלי להכנת הבדיקה כדי להריץ פקודות שרירותיות של המארח לפני ואחרי הרצת הבדיקה.
RunHostScriptTargetPreparer	כלי לטירגוט שמפעיל סקריפט לפני הפעלת בדיקה.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` כדי לסמן שצריך להריץ את הבדיקות בארגז החול של ה-SDK.
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` כדי לוודא שהבדיקה פועלת כמשתמש משני.
RunOnSystemUserTargetPreparer	`ITargetPreparer` שמציין שצריך להריץ את הבדיקות על המשתמש (ולא על המשתמש הנוכחי).
RunOnWorkProfileTargetPreparer	`ITargetPreparer` שיוצר פרופיל עבודה בתהליך ההגדרה ומסמן שצריך להריץ את הבדיקות במשתמש הזה.
SemaphoreTokenTargetPreparer	זהו מכשיר הכנה שמשתמש באסימון כדי לסדר את ביצוע הבדיקה במארח של Tradefed.
SideloadOtaTargetPreparer	כלי להכנת יעד שמבצע טעינת צד של חבילת OTA מסוימת, מחיל את החבילה, ממתין שהמכשיר יופעל ומחדיר את מאפייני ה-build של המכשיר לשימוש כפרטי build הכלי הזה להכנת יעד מניח שהמכשיר יהיה במצב adb רגיל כשהוא יופעל, וידאג שהמכשיר ייצא מהמצב הזה עם הגרסה החדשה של ה-build.
StopServicesSetup	`ITargetPreparer` שגורם להפסקת השירותים במכשיר.
StubTargetPreparer	הטמעה ריקה של placeholder של `ITargetPreparer`.
SuiteApkInstaller	התקנה של חבילות APK מסוימות להגדרת Suite: מהמשתנה $ANDROID_TARGET_OUT_TESTCASES או מה-ROOT_DIR בנתוני ה-build.
SwitchUserTargetPreparer	`ITargetPreparer` שמתחלף לסוג המשתמש שצוין ב-setUp.
TearDownPassThroughPreparer	מאפשרת להריץ את tearDown על מכשירי הכנה שכלולים בתצורה כאובייקט.
TemperatureThrottlingWaiter	`ITargetPreparer` שממתין עד שטמפרטורת המכשיר תגיע לטמפרטורת היעד
TestAppInstallSetup	`ITargetPreparer` שמתקין אפליקציה אחת או יותר מתיקייה `IDeviceBuildInfo.getTestsDir()` במכשיר.
TestFilePushSetup	`ITargetPreparer` שמעביר קובץ או ספרייה אחדים או יותר מתיקייה `IDeviceBuildInfo.getTestsDir()` למכשיר.
TestSystemAppInstallSetup	`ITargetPreparer` שמתקין אפליקציה אחת או יותר מתיקייה `IDeviceBuildInfo.getTestsDir()` למחיצה /system במכשיר.
TimeWaster	כלי פשוט להכנת יעד שגורם לבזבוז זמן ויכול להפעיל מחדש את המכשיר.
UserCleaner	`ITargetPreparer` שמסיר משתמשים משניים בזמן ניתוק.
VisibleBackgroundUserPreparer	יוצר מטרות לצורך הפעלת בדיקות במשתמש שהופעל במצב גלוי ברקע.
WaitForDeviceDatetimePreparer	`ITargetPreparer` שמחכה להגדרת תאריך ושעה במכשיר אפשר גם להגדיר שהמתכונן הזה יאלץ את המערכת להפעיל `TargetSetupError` אם זמן היצירה לא מוגדר בתוך זמן הקצוב לתפוגה.
WifiPreparer	`ITargetPreparer` שמגדיר את ה-Wi-Fi במכשיר במקרה הצורך.

הכנת סביבת הבדיקה להרצת הבדיקה.

לדוגמה, התקנת תוכנה, שינוי הגדרות הסביבה לצורך בדיקה, הפעלת יעדים וכו'.

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

סיכום

שיטות ציבוריות
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` השיטה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-`setUp(com.android.tradefed.invoker.TestInformation)`
`default void`	`setUp(TestInformation testInformation)` מבצעים את הגדרת היעד לבדיקה.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` אחרי הבדיקה, מבצעים את הניקוי או הפירוק של היעד.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` השיטה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-`tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`

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

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

השיטה הזו הוצאה משימוש.
יש להשתמש ב-setUp(com.android.tradefed.invoker.TestInformation) במקום זאת

מבצעים את הגדרת היעד לבדיקה.

פרמטרים
`device`	`ITestDevice`: ה-`ITestDevice` שרוצים להכין.
`buildInfo`	`IBuildInfo`: נתונים על ה-build שנבדק.

זריקות
`TargetSetupError`	if fatal error occurred setting up environment
`BuildError`	אם מתרחשת שגיאה שקשורה ל-BuildInfo
`DeviceNotAvailableException`	אם המכשיר לא מגיב

setUp

public void setUp (TestInformation testInformation)

מבצעים את הגדרת היעד לבדיקה.

פרמטרים
`testInformation`	`TestInformation`: ה-`TestInformation` של ההפעלה.

זריקות
`TargetSetupError`	if fatal error occurred setting up environment
`BuildError`	אם מתרחשת שגיאה בגלל שה-build מוכן
`DeviceNotAvailableException`	אם המכשיר לא מגיב

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

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

פרמטרים
`testInformation`	`TestInformation`: ה-`TestInformation` של ההפעלה.
`e`	`Throwable`: אם הקריאה הסתיימה בחריגה, זו תהיה החריגה שנלכדה ברמת הקריאה. אחרת, הערך יהיה `null`.

זריקות
`DeviceNotAvailableException`	אם המכשיר לא מגיב

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

השיטה הזו הוצאה משימוש.
יש להשתמש ב-tearDown(com.android.tradefed.invoker.TestInformation, Throwable) במקום זאת

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

פרמטרים
`device`	`ITestDevice`: ה-`ITestDevice` שרוצים להכין.
`buildInfo`	`IBuildInfo`: נתונים על ה-build שנבדק.
`e`	`Throwable`: אם הקריאה הסתיימה בחריגה, זו תהיה החריגה שנלכדה ברמת הקריאה. אחרת, הערך יהיה `null`.

זריקות
`DeviceNotAvailableException`	אם המכשיר לא מגיב