החל מ-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 ועוד 79 אחרים.

AdbStopServerPreparer	הכלי Target preparer מפסיק את שרת ה-adb במארח לפני ואחרי הפעלת בדיקות adb.
AllTestAppsInstallSetup	`ITargetPreparer` שמתקין את כל האפליקציות מתיקייה `IDeviceBuildInfo.getTestsDir()` במכשיר.
AoaTargetPreparer	`ITargetPreparer` שמבצע סדרה של פעולות (למשל קליקים והחלקות) באמצעות פרוטוקול Android Open Accessory‏ (AOAv2).
AppSetup	קובץ `ITargetPreparer` שמתקין קובץ APK ואת הבדיקות שלו.
ArtChrootPreparer	יצירת ספריית chroot לבדיקות ART.
BaseEmulatorPreparer	הכנה נפוצה להפעלת אמולטור מקומי.
BaseTargetPreparer	מחלקת הטמעה בסיסית של `ITargetPreparer` שמאפשרת לקבוע אם האובייקט מושבת או לא.
BuildInfoRecorder	`ITargetPreparer` שכותב מטא-נתונים של פרטי בנייה לקובץ שצוין.
CheckPairingPreparer	`CompanionAwarePreparer` שמאמת את ההתאמה של Bluetooth בין המכשיר הראשי למכשיר הנלווה
CompanionAllocator	מחלקה בסיסית שמטפלת בהקצאה ובשחרור של מכשיר נלווה צריך להטמיע את `getCompanionDeviceSelectionOptions()` כדי לתאר את הקריטריונים שנדרשים להקצאת המכשיר הנלווה
CompanionAwarePreparer	‫`ITargetPreparer` שמכיל את הלוגיקה של קבלת מכשיר נלווה שכבר הוקצה.
CompanionRunCommandTargetPreparer	`ITargetPreparer` שמריץ פקודות שצוינו במכשיר הנלווה שהוקצה
CompanionTestAppInstallSetup	`ITargetPreparer` שמתקין אפליקציה אחת או יותר מתיקייה `IDeviceBuildInfo.getTestsDir()` במכשיר נלווה שהוקצה.
CompileBootImageWithSpeedTargetPreparer	הקומפיילר מבצע קומפילציה מחדש של נתיב המחלקה של האתחול ושל שרת המערכת באמצעות מסנן הקומפיילר 'speed'.
CpuThrottlingWaiter	‫`ITargetPreparer` שממתין עד שתדירות השימוש המקסימלית בכל הליבות חוזרת לרמה הגבוהה ביותר שזמינה
CreateAvdPreparer
CreateUserPreparer	הכלי להכנת טירגוט ליצירת משתמש ולניקוי שלו בסוף.
DeviceActionTargetPreparer	`ITargetPreparer` כדי לבצע פעולות במכשיר.
DeviceBuildInfoBootStrapper	`ITargetPreparer` שמחליף שדות של פרטי גרסה במאפיינים שנקראים מהמכשיר האפשרות הזו שימושית לבדיקת מכשירים עם גרסאות שנוצרו ממקור חיצוני (למשל
DeviceBuildInfoInjector	`ITargetPreparer` שמוסיף מטא-נתונים של `DeviceBuildDescriptor` ל-`IBuildInfo`.
DeviceCleaner	מבצע אתחול מחדש או פורמט כפעולת ניקוי אחרי הבדיקה, ויכול גם לכבות את המסך
DeviceFlashPreparer	‫`ITargetPreparer` שמציג תמונה בחומרה פיזית של Android.
DeviceImageZipFlashingTargetPreparer	כלי להכנת יעד שמבזיק את המכשיר עם תמונות של המכשיר שסופקו בפורמט ספציפי.
DeviceOwnerTargetPreparer	‫`ITargetPreparer` שמגדיר רכיב של בעלי המכשיר.
DeviceSetup	`ITargetPreparer` שמגדיר מכשיר לבדיקה על סמך `Option` שסופקו.
DeviceStorageFiller	הכנת יעד למילוי האחסון כך שיהיה זמין נפח אחסון מסוים.
DeviceStringPusher	הכנת היעד לכתיבת מחרוזת לקובץ.
DeviceUpdateTargetPreparer	תקציר `ITargetPreparer` שמטפל בשלבים נפוצים של עדכון מכשירים באמצעות קובץ תמונת מכשיר ממקור חיצוני (בניגוד לשירות בנייה).
DeviceWiper	`ITargetPreparer` שמאפס את נתוני המשתמשים
DisableSELinuxTargetPreparer	קובץ הכנה ליעד שמשבית את SELinux אם הוא מופעל.
DynamicSystemPreparer	`ITargetPreparer` שמגדיר קובץ אימג' של מערכת על גרסת build של מכשיר עם עדכון מערכת דינמי.
EraseUserDataPreparer	`ITargetPreparer` שמאפס את נתוני המשתמש במכשיר.
FastbootCommandPreparer	כלי להכנת יעד שמפעיל את fastboot ושולח פקודות fastboot.
FastbootUpdateBootstrapPreparer	‫`ITargetPreparer` שמכין קבצים ספציפיים (תוכנת אתחול, רדיו, קובץ ZIP של תמונת המכשיר) לגיבוי ב-`IDeviceBuildInfo` כדי לגבות את המכשירים באמצעות `FastbootDeviceFlasher`, ואז מחדיר מאפייני מכשיר אחרי האתחול לפרטי ה-build לצורך דיווח על התוצאות.
FeatureFlagTargetPreparer	עדכון של DeviceConfig (דגלי תכונות שמותאמים על ידי שירות מרוחק).
FoldableModePreparer	כלי להכנת מכשיר היעד שיכול לשנות את מצב הקיפול של המכשיר.
FolderSaver	‫`ITargetPreparer` ששולף ספריות מהמכשיר, דוחס אותן ושומר אותן בקצה העורפי של הרישום.
FutilityCommandPreparer	הכנה להפעלת פקודות חוסר תועלת.
GkiDeviceFlashPreparer	כלי להכנת יעד שמבצע פלאשינג של המכשיר עם תמונה גנרית של ליבת Android נפוצה.
GoogleAccountPreparer	`ITargetPreparer` שתומכת בהגדרת חשבונות Google.
GsiDeviceFlashPreparer	כלי להכנת יעד שצורך את המכשיר עם תמונת מערכת גנרית של Android.
ILabPreparer	ממשק סמן למי שמכין את המעבדה בקטע `ITargetPreparer` מוסבר מה הייעוד של הממשקים האלה.
ITargetCleaner	הממשק הזה הוצא משימוש. ‫tearDown הועבר לממשק הבסיסי ITargetPreparer.
InstallAllTestZipAppsSetup	`ITargetPreparer` שמתקין את כל האפליקציות בקובץ zip של בדיקה.
InstallApexModuleTargetPreparer
InstallApkSetup	קובץ `ITargetPreparer` שמתקין קובץ APK אחד או יותר שנמצאים במערכת הקבצים.
InstallBuildEnvApkSetup	‫`ITargetPreparer` שמתקין קובץ APK אחד או יותר לבדיקה מסביבת build של פלטפורמת Android.
InstallKernelModulePreparer	כלי להכנת יעד שמתקין מודולים של ליבת מערכת ההפעלה.
InstrumentationPreparer	`ITargetPreparer` שמריץ מכשור
KillExistingEmulatorPreparer	`ITargetPreparer` שמכבה אמולטור שפועל.
KnownFailurePreparer	הגדרת המכין של היעד לדילוג על ניסיון חוזר במקרה של כשל ידוע.
LocalEmulatorLaunch	‫TargetPreparer שמפעיל אמולטור באופן מקומי מסביבת build של Android.
LocalEmulatorSnapshot	‫TargetPreparer שמיועד ליצירת תמונת מצב נקייה של אמולטור מסביבת פיתוח/בנייה של Android
MixKernelTargetPreparer	`ITargetPreparer` שמאפשר לערבב קובץ אימג' של ליבה עם קובץ האימג' של המכשיר.
MixRadioTargetPreparer	`ITargetPreparer` שמאפשרת לשלב תמונה של רדיו עם תמונת המכשיר.
ModuleOemTargetPreparer
NativeLeakCollector	‫`ITargetPreparer` שמריץ את הפקודה 'dumpsys meminfo --unreachable -a' כדי לזהות את הזיכרון המקורי שלא ניתן להגיע אליו, שמוחזק כרגע על ידי כל תהליך.
NoApkTestSkipper	רכיב מכין מיוחד שמאפשר לדלג על הפעלה לחלוטין (הכנה ובדיקות) אם אין קובצי APK לבדיקה.
PerfettoPreparer	הכלי Perfetto preparer דוחף את קובץ ההגדרות למכשיר במיקום סטנדרטי שאליו יש ל-Perfetto גישה.
ProfileTargetPreparer	מחלקת בסיס להגדרת כלי להכנת יעדים לכל משתמש בפרופיל `android.os.usertype.profile.XXX`.
PushFileInvoker	הכיתה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`PushFilePreparer`
PushFilePreparer	`ITargetPreparer` שמנסה לדחוף מספר כלשהו של קבצים מנתיב כלשהו במארח לנתיב כלשהו במכשיר.
PythonVirtualenvPreparer	מגדיר סביבה וירטואלית של Python במארח ומתקין חבילות.
RebootTargetPreparer	כלי להכנת יעד שמפעיל מחדש את המכשיר.
RecoveryLogPreparer	הכלי להכנת היעד שימש לאיסוף יומנים לפני השחזור.
RemoveSystemAppPreparer	‫`ITargetPreparer` להסרת קובץ APK ממחיצת המערכת לפני הרצת בדיקה.
RestartSystemServerTargetPreparer	הכלי להכנת היעד שמפעיל מחדש את שרת המערכת בלי להפעיל מחדש את המכשיר.
RootTargetPreparer	מכין את היעד לביצוע הפקודות adb root או adb unroot על סמך האפשרות force-root.
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	הכלי Target preparer מריץ פקודות שרירותיות במארח לפני ואחרי הרצת הבדיקה.
RunHostScriptTargetPreparer	הכלי Target preparer שמריץ סקריפט לפני הפעלת בדיקה.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	‫`ITargetPreparer` לסימון בדיקות שצריך להריץ בארגז החול של ה-SDK.
RunOnSecondaryUserTargetPreparer	‫`ITargetPreparer` כדי לוודא שהבדיקה תפעל כמשתמש משני.
RunOnSystemUserTargetPreparer	`ITargetPreparer` שמציין שהבדיקות צריכות לפעול על המשתמש (ולא על המשתמש הנוכחי).
RunOnWorkProfileTargetPreparer	`ITargetPreparer` שיוצר פרופיל עבודה בהגדרה, ומסמן שהבדיקות צריכות להתבצע אצל המשתמש הזה.
SemaphoreTokenTargetPreparer	זהו קובץ הכנה שמשמש לשימוש באסימון כדי לבצע סריאליזציה של בדיקת ההפעלה במארח tradefed.
SideloadOtaTargetPreparer	כלי להכנת יעד שמבצע העברה צדדית של חבילת OTA שצוינה, מחיל את החבילה, ממתין עד שהמכשיר יופעל ומזריק את מאפייני הגרסה של המכשיר לשימוש כפרטי גרסה הכלי הזה מניח שהמכשיר יהיה במצב adb רגיל כשהוא יופעל, וידאג שהמכשיר יצא מאותו מצב אבל עם הגרסה החדשה יותר.
StopServicesSetup	`ITargetPreparer` שמפסיק את השירותים במכשיר.
StubTargetPreparer	הטמעה ריקה של פלייסהולדר של `ITargetPreparer`.
SuiteApkInstaller	מתקין חבילות APK שצוינו להגדרת החבילה: מתוך המשתנה ‎ $ANDROID_TARGET_OUT_TESTCASES או מתוך ROOT_DIR בפרטי הבנייה.
SwitchUserTargetPreparer	‫`ITargetPreparer` שעובר לסוג המשתמש שצוין ב-setUp.
TearDownPassThroughPreparer	מאפשר להריץ tearDown על preparers שכלולים בהגדרה כאובייקט.
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 שמתקין תוכנה.

סיכום

‫methods ציבוריים
`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)`

‫methods ציבוריים

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

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

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

זריקות
`TargetSetupError`	אם קרתה שגיאה קריטית בהגדרת הסביבה
`BuildError`	אם מתרחשת שגיאה שקשורה ל-BuildInfo
`DeviceNotAvailableException`	אם המכשיר לא מגיב

setUp

public void setUp (TestInformation testInformation)

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

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

זריקות
`TargetSetupError`	אם קרתה שגיאה קריטית בהגדרת הסביבה
`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`: נתונים על הגרסה שנבדקת.
`e`	‫`Throwable`: אם הקריאה הסתיימה בחריגה, זו תהיה החריגה שנתפסה ברמת הקריאה. אחרת, הוא יהיה `null`.

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