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 שמגדיר מכשיר לבדיקה על סמך Options שסופקו.  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	אם המכשיר לא מגיב