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

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

BaseTargetPreparer

public abstract class BaseTargetPreparer
extends Object implements ITargetPreparer

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer

תת-כיתות ישירות ידועות

AdbStopServerPreparer,‏ AllTestAppsInstallSetup,‏ AoaTargetPreparer,‏ AppSetup,‏ ArtChrootPreparer,‏ BaseEmulatorPreparer,‏ BuildInfoRecorder,‏ CompanionAllocator,‏ CompanionAwarePreparer,‏ CompileBootImageWithSpeedTargetPreparer,‏ CpuThrottlingWaiter,‏ CreateAvdPreparer,‏ CreateUserPreparer,‏ DeviceActionTargetPreparer,‏ DeviceBuildInfoBootStrapper ו-57 אחרים.

AdbStopServerPreparer	מטרגטים את הכלי להכנת הבדיקה כדי שיפסיק את שרת adb במארח לפני ואחרי הרצת בדיקות adb.
AllTestAppsInstallSetup	`ITargetPreparer` שמתקין את כל האפליקציות מתיקייה `IDeviceBuildInfo.getTestsDir()` במכשיר.
AoaTargetPreparer	`ITargetPreparer` שמבצע סדרה של פעולות (למשל קליקים ותנועות החלקה) באמצעות פרוטוקול Android Open Accessory‏ (AOAv2).
AppSetup	`ITargetPreparer` שמתקין קובץ APK ואת הבדיקות שלו.
ArtChrootPreparer	יצירת ספריית chroot לבדיקות ART.
BaseEmulatorPreparer	הכנה נפוצה להפעלת אמולטור מקומי.
BuildInfoRecorder	`ITargetPreparer` שכותב מטא-נתונים של פרטי build לקובץ מסוים.
CompanionAllocator	מחלקה בסיסית שמטפלת בהקצאה ובשחרור של מכשיר נלווה צריך להטמיע את `getCompanionDeviceSelectionOptions()` כדי לתאר את הקריטריונים הנדרשים להקצאת מכשיר התלווה.
CompanionAwarePreparer	`ITargetPreparer` שמכיל את הלוגיקה של אחזור מכשיר נלווה שכבר הוקצה.
CompileBootImageWithSpeedTargetPreparer	קומפילציה מחדש של נתיב ה-Classpath של האתחול ושל שרת המערכת באמצעות מסנן המהדר 'מהירות'.
CpuThrottlingWaiter	`ITargetPreparer` שממתין עד שהתדירות המקסימלית בכל הליבות תוחזר לרמה הגבוהה ביותר הזמינה.
CreateAvdPreparer
CreateUserPreparer	יוצר המשתמש והכלי לניקוי בסוף התהליך.
DeviceActionTargetPreparer	`ITargetPreparer` כדי לבצע פעולות במכשיר.
DeviceBuildInfoBootStrapper	`ITargetPreparer` שמחליף את שדות פרטי ה-build במאפיינים שנקראים מהמכשיר האפשרות הזו שימושית לבדיקת מכשירים עם גרסאות build שנוצרו ממקור חיצוני (למשל:
DeviceBuildInfoInjector	`ITargetPreparer` שמוסיף מטא-נתונים של `DeviceBuildDescriptor` ל-`IBuildInfo`.
DeviceCleaner	הפעלה מחדש או פורמט כפעולת ניקוי אחרי הבדיקה, ואפשרות לכיבוי המסך
DeviceFlashPreparer	`ITargetPreparer` שמציג תמונת אימג' בחומרה פיזית של Android.
DeviceOwnerTargetPreparer	`ITargetPreparer` שמגדיר רכיב של בעלי מכשיר.
DeviceSetup	`ITargetPreparer` שמגדיר מכשיר לבדיקה על סמך `Option`s שסופקו.
DeviceStorageFiller	מגדירים את הכלי למלא את נפח האחסון כדי שיהיה מקום פנוי.
DeviceStringPusher	הכנת יעד לכתיבה של מחרוזת לקובץ.
DeviceWiper	`ITargetPreparer` שמאפס את userdata
DisableSELinuxTargetPreparer	כלי להכנת יעד שמשבית את SELinux אם הוא מופעל.
DynamicSystemPreparer	קובץ `ITargetPreparer` שמגדיר קובץ אימג' של מערכת מעל גרסה של מכשיר עם עדכון מערכת דינמי.
EraseUserDataPreparer	`ITargetPreparer` שמאפס את נתוני המשתמש במכשיר.
FastbootCommandPreparer	כלי להכנת יעד שמפעיל את fastboot ושולח פקודות fastboot.
FeatureFlagTargetPreparer	עדכון של DeviceConfig (דגלים של תכונות שמותאמים על ידי שירות מרוחק).
FoldableModePreparer	שירות לעיבוד יעד שיכול לשנות את המצב המתקפל של מכשיר.
FolderSaver	`ITargetPreparer` ששואב ספריות מהמכשיר, דוחס אותן ושומר אותן בקצה העורפי של הרישום ביומן.
GkiDeviceFlashPreparer	כלי להכנת יעד שמבצע אימיג' של המכשיר באמצעות קובץ אימג' גנרי של ליבה נפוצה של Android.
GsiDeviceFlashPreparer	כלי להכנת יעד שמבצע אימיג' של המכשיר באמצעות תמונת מערכת גנרית (GSI) ל-Android.
InstallAllTestZipAppsSetup	`ITargetPreparer` שמתקין את כל האפליקציות בקובץ zip לבדיקה.
InstallApkSetup	`ITargetPreparer` שמתקין קובץ APK אחד או יותר שנמצאים במערכת הקבצים.
InstallBuildEnvApkSetup	`ITargetPreparer` שמתקין קובץ APK אחד או יותר לבדיקה מסביבת build של פלטפורמת Android.
InstallKernelModulePreparer	כלי להכנת יעד שמתקין מודולים של ליבה.
InstrumentationPreparer	`ITargetPreparer` שמריץ את המדידה
KillExistingEmulatorPreparer	`ITargetPreparer` שמשבית אמולטור שפועל.
KnownFailurePreparer	Target preparer to skip retrying known failure.
MixKernelTargetPreparer	`ITargetPreparer` שמאפשרת לשלב בין קובץ אימג' של ליבה לבין קובץ אימג' של מכשיר.
NativeLeakCollector	`ITargetPreparer` שמריץ את הפקודה 'dumpsys meminfo --unreachable -a' כדי לזהות את הזיכרון המקומי שלא ניתן לגשת אליו שנמצא כרגע בכל תהליך.
NoApkTestSkipper	כלי הכנה מיוחד שמאפשר לדלג על קריאה לחלוטין (הכנה ובדיקות) אם אין חבילות APK לבדיקה.
PerfettoPreparer	הכלי לעיבוד של Perfetto דוחף את קובץ התצורה למכשיר במיקום סטנדרטי שיש ל-Perfetto גישה אליו.
ProfileTargetPreparer	כיתה בסיסית להגדרת כלי להכנת יעדים לכל משתמש בפרופיל `android.os.usertype.profile.XXX`.
PushFilePreparer	`ITargetPreparer` שמנסה לדחוף מספר כלשהו של קבצים מכל נתיב מארח לכל נתיב מכשיר.
PythonVirtualenvPreparer	הגדרת Python virtualenv במארח והתקנת חבילות.
RebootTargetPreparer	כלי להתקנת יעד שמפעיל מחדש את המכשיר.
RecoveryLogPreparer	כלי לעיבוד מטרות שמשתמש באיסוף יומנים לפני השחזור.
RemoveSystemAppPreparer	`ITargetPreparer` להסרת קובץ APK ממחיצה המערכת לפני הרצה של בדיקה.
RestartSystemServerTargetPreparer	כלי לניהול יעדי התקנה שמפעיל מחדש את שרת המערכת בלי להפעיל מחדש את המכשיר.
RootTargetPreparer	כלי להכנת יעד שמבצע את הפקודה 'adb root' או 'adb unroot' על סמך האפשרות 'force-root'.
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	מטרגטים את הכלי להכנת הבדיקה כדי להריץ פקודות שרירותיות של המארח לפני ואחרי הרצת הבדיקה.
RunHostScriptTargetPreparer	כלי לטירגוט שמפעיל סקריפט לפני הפעלת בדיקה.
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` כדי לסמן שצריך להריץ את הבדיקות בארגז החול של ה-SDK.
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` כדי לוודא שהבדיקה פועלת כמשתמש משני.
RunOnSystemUserTargetPreparer	`ITargetPreparer` שמציין שצריך להריץ את הבדיקות על המשתמש (ולא על המשתמש הנוכחי).
SemaphoreTokenTargetPreparer	זהו מכשיר הכנה שמשתמש באסימון כדי לסדר את ביצוע הבדיקה במארח של Tradefed.
StopServicesSetup	`ITargetPreparer` שגורם להפסקת השירותים במכשיר.
StubTargetPreparer	הטמעה ריקה של placeholder של `ITargetPreparer`.
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 במכשיר במקרה הצורך.

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

CheckPairingPreparer	`CompanionAwarePreparer` שמאמת את הקישור ב-BT בין המכשיר הראשי למכשיר הנלווה.
CompanionRunCommandTargetPreparer	`ITargetPreparer` שמריץ פקודות ספציפיות במכשיר התומך שהוקצה
CompanionTestAppInstallSetup	`ITargetPreparer` שמתקין אפליקציה אחת או יותר מתיקיית `IDeviceBuildInfo.getTestsDir()` במכשיר נלווה שהוקצה.
DeviceImageZipFlashingTargetPreparer	כלי להכנת יעד שמאפס את המכשיר באמצעות קובצי אימג' של המכשיר שסופקו בפורמט ספציפי.
DeviceUpdateTargetPreparer	פונקציית `ITargetPreparer` מופשטת שמטפלת בשלבים נפוצים של עדכון מכשירים באמצעות קובץ אימג' של המכשיר ממקור חיצוני (בניגוד לשירות build).
FastbootUpdateBootstrapPreparer	`ITargetPreparer` שמארגן קבצים ספציפיים (מרכז האתחול, הרדיו, קובץ ה-zip של קובץ האימג' של המכשיר) ב-`IDeviceBuildInfo` כדי להפעיל את ה-flash במכשירים באמצעות `FastbootDeviceFlasher`, ולאחר מכן מזין מאפייני מכשיר לאחר האתחול בפרטי ה-build למטרות דיווח על תוצאות.
InstallApexModuleTargetPreparer
LocalEmulatorLaunch	TargetPreparer שמפעיל אמולטור באופן מקומי מסביבת build של Android.
LocalEmulatorSnapshot	TargetPreparer שנועד ליצור קובץ snapshot נקי של אמולטור מסביבת פיתוח או build של Android
ModuleOemTargetPreparer
PushFileInvoker	הסיווג הזה הוצא משימוש. במקום זאת, צריך להשתמש ב-`PushFilePreparer`
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnWorkProfileTargetPreparer	`ITargetPreparer` שיוצר פרופיל עבודה בתהליך ההגדרה ומסמן שצריך להריץ את הבדיקות במשתמש הזה.
SideloadOtaTargetPreparer	כלי להכנת יעד שמבצע טעינת צד של חבילת OTA מסוימת, מחיל את החבילה, ממתין שהמכשיר יופעל ומחדיר את מאפייני ה-build של המכשיר לשימוש כפרטי build הכלי הזה להכנת יעד מניח שהמכשיר יהיה במצב adb רגיל כשהוא יופעל, וידאג שהמכשיר ייצא מהמצב הזה עם הגרסה החדשה של ה-build.
SuiteApkInstaller	התקנה של חבילות APK מסוימות להגדרת Suite: מהמשתנה $ANDROID_TARGET_OUT_TESTCASES או מה-ROOT_DIR בנתוני ה-build.

סוג בסיס להטמעה של ITargetPreparer שמאפשר לקבוע אם האובייקט מושבת או לא.

סיכום

יוצרים ציבוריים
`BaseTargetPreparer()`

שיטות ציבוריות
`final boolean`	`isDisabled()` הפונקציה מחזירה את הערך True אם האובייקט כולו מושבת (מחמיצים את ההגדרה וההסרה).
`final boolean`	`isTearDownDisabled()` הפונקציה מחזירה את הערך True אם צריך לדלג רק על teardown.
`final void`	`setDisable(boolean isDisabled)` מגדיר אם האובייקט יושבת.
`final void`	`setDisableTearDown(boolean isDisabled)` מגדיר אם צריך לדלג על שלב הפירוק של האובייקט.

יוצרים ציבוריים

BaseTargetPreparer

public BaseTargetPreparer ()

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

isDisabled

public final boolean isDisabled ()

הפונקציה מחזירה את הערך True אם האובייקט כולו מושבת (מחמיצים את ההגדרה וההסרה). אחרת, הערך יהיה false.

החזרות
`boolean`

isTearDownDisabled

public final boolean isTearDownDisabled ()

הפונקציה מחזירה את הערך True אם צריך לדלג רק על teardown. אחרת, הערך יהיה false.

החזרות
`boolean`

setDisable

public final void setDisable (boolean isDisabled)

מגדיר אם האובייקט יושבת. אם האפשרות מושבתת, צריך לדלג על שני השלבים של ההגדרה והפירוק. אפשר להשתמש בה כדי להשבית אובייקט כברירת מחדל ב-constructor של ברירת המחדל.

פרמטרים
`isDisabled`	`boolean`: המצב שאליו צריך להעביר את האובייקט.

setDisableTearDown

public final void setDisableTearDown (boolean isDisabled)

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

פרמטרים
`isDisabled`	`boolean`: המצב שאליו צריך להעביר את האובייקט.