מכינים את הקרקע

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

תתי-מחלקות עקיפות ידועות AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetTargetPreparer, AppSetup, ArtChrootroot,, BaseEmulator Preparer, BuildTargetStore חוויתr, BuildInfoRecorder, CheckPairing Preparer AdbStopServerPreparer מכין יעד שיפסיק את שרת adb במארח לפני ואחרי הרצת בדיקות adb.  AllTestAppsInstallSetup ITargetPreparer שמתקין את כל האפליקציות מתיקיית IDeviceBuildInfo#getTestsDir() במכשיר.  AoaTargetPreparer ITargetPreparer שמבצע סדרה של פעולות (למשל, קליקים והחלקות) באמצעות הפרוטוקול של Android Open Accessory (AOAv2).  הגדרת אפליקציה ITargetPreparer שמתקין APK ואת הבדיקות שלו.  ArtChrootPreparer יצירה של ספריית chroot לבדיקות ART.  BaseEmulator Re (מכין ל-BaseEmulator) מתכונן נפוץ להשקת אמולטור מקומי.  BaseTargetPlanr (מכין בסיס) סוג ההטמעה הבסיסי של ITargetPreparer שמאפשר לקבוע אם האובייקט יושבת או לא.  BuildInfoRecorder ITargetPreparer שכותב מטא-נתונים של פרטי build בקובץ ספציפי.  CheckPairingPreparer CompanionAwarePreparer שמאמת את חיבור BT בין מכשיר ראשי למכשירים נלווים CompanionAllocator מחלקת הבסיס שמטפלת בהקצאה של מכשיר נלווה ופינוי מקום להטמיע את getCompanionDeviceSelectionOptions() כדי לתאר את הקריטריונים שנדרשים להקצאת המכשיר הנלווה מודעות CompanionAware ITargetPreparer שמשקף את הלוגיקה של קבלת מכשיר נלווה שכבר הוקצה.  CompanionRunCommandTargetCommandr ITargetPreparer שמריץ פקודות מוגדרות במכשיר הנלווה שהוקצה CompanionTestAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקיית IDeviceBuildInfo#getTestsDir() במכשיר נלווה שהוקצה.  CompileBootImageWithSpeedTargetPreparer הידור מחדש של נתיב האתחול ושרת המערכת עם מסנן המהדר (speed)  CpuThrottlingwaiter ITargetPreparer שממתין עד שהתדירות המקסימלית בכל הליבות תשוחזר לרמה הגבוהה ביותר שזמינה. CreateAvdPreparer   CreateUserPreparer מכין יעד ליצירת משתמש ולניקוי שלו בסוף.  DeviceActionTargetPreparer ITargetPreparer לביצוע פעולות במכשיר.  DeviceBuildInfoBootStrapper ITargetPreparer שמחליף שדות של מידע על גרסאות build במאפיינים שנקראים מהמכשיר האפשרות הזו שימושית לבדיקת מכשירים עם גרסאות build שנוצרו ממקור חיצוני (למשל, DeviceBuildInfoInjector ITargetPreparer שמוסיף את המטא-נתונים DeviceBuildDescriptor אל השדה IBuildInfo.  מנקה מכשירים מבצע הפעלה מחדש או פירמוט כפעולת ניקוי לאחר הבדיקה, ובאופן אופציונלי מכבה את המסך DeviceFlashPreparer ITargetPreparer שמבהב תמונה בחומרה פיזית של Android.  DeviceImageZipFlashingTargetTargetr כלי להכנת יעד שמבהב במכשיר עם תמונות של המכשיר שסופקו באמצעות פורמט ספציפי.  DeviceOwnerTargetTargetr ITargetPreparer שמגדיר רכיב של בעלי מכשיר.  הגדרת המכשיר ITargetPreparer שמגדיר את המכשיר לבדיקה על סמך ערכי Option שסופקו.  DeviceStorageFiller מכין יעד שימלא את נפח האחסון כדי שיהיה מקום פנוי.  DeviceStringPusher יוצר היעד לכתיבת מחרוזת לקובץ.  DeviceUpdateTargetPreparer ITargetPreparer מופשט שמטפל בשלבים נפוצים של עדכון מכשירים באמצעות קובץ תמונה של מכשיר ממקור חיצוני (בניגוד לשירות build).  DeviceWiper ITargetPreparer שמאפס את נתוני המשתמשים DisableSELinuxTargetPreparer מכין היעד שמשבית את SELinux אם הוא מופעל.  דינמי מערכת מוכנות ITargetPreparer שמגדיר תמונת מערכת מעל גרסת ה-build של המכשיר עם עדכון מערכת דינמי.  מחקUserDataPreparer ITargetPreparer שמאפס את נתוני המשתמש במכשיר.  FastbootCommandCommandr כלי להכנת יעד שמפעיל אתחול מהיר ושולח פקודות של אתחול מהיר (fastboot).  FastbootUpdateBootstrapP ITargetPreparer שמעביר קבצים שצוינו (תוכנת אתחול, רדיו, קובץ ZIP של תמונת המכשיר) אל IDeviceBuildInfo כדי לגרום למכשירים לפעול עם FastbootDeviceFlasher, ולאחר מכן מחדיר מאפייני מכשיר לאחר ההפעלה אל פרטי ה-build למטרות דיווח על תוצאות.  FeatureflagTarget שזמינות מעדכנות את DeviceConfig (דגלי תכונות שכווננו על ידי שירות מרוחק).  FoldableModeModer כלי להכנת יעדים שיכול להחליף את מצב המכשיר המתקפל.  FolderSaver ITargetPreparer שמושך ספריות מהמכשיר, דוחס ושומר אותו בקצה העורפי לרישום ביומן.  GkiDeviceFlashFlashr הכנת יעד שמעדכן את המכשיר עם תמונה גנרית ליבה נפוצה של Android.  GsiDeviceFlashFlashr מכינים יעד שמבהב את המכשיר עם קובץ אימג' של מערכת גנרית של Android.  ILabPreparer ממשק סמנים למתכנני מעבדה בכתובת ITargetPreparer מוסבר למה הממשקים האלה מיועדים.  ITargetCleaner הממשק הזה הוצא משימוש. tearDown הועבר לממשק הבסיס ITargetPreparer.  להתקנתAllTestZipAppsSetup ITargetPreparer להתקנת כל האפליקציות בקובץ ZIP לבדיקה.  InstallApexModuleTargetPlanr   InstallApkSetup ITargetPreparer שמתקין קובץ APK אחד או יותר שנמצא במערכת הקבצים.  התקנתBuildEnvApkSetup ITargetPreparer שמתקין חבילת APK אחת או יותר לבדיקה בסביבת build של פלטפורמת Android.  כלי הכנה לאינסטרומנטציה ITargetPreparer שמפעיל את האינסטרומנטציה KillExistingEmulatorPreparer ITargetPreparer שמכבה אמולטור פועל.  הכנות לכישלון מבצע הכנה ליעד לדילוג על ניסיון חוזר נכשל.  LocalEmulatorLaunch יעד Preparer שמשיק אמולטור באופן מקומי מסביבת build של Android.  LocalEmulatorSnapshot כלי הכנה לטירגוט שמטרתו ליצור תמונת מצב נקייה של אמולטור מסביבת פיתוח/פיתוח של Android MixKernelTargetPreparer ITargetPreparer שמאפשר לשלב תמונת ליבה (kernel) עם תמונת המכשיר.  ModuleOemTargetPreparer   NativeLeakCollector ITargetPreparer שמריץ את 'dumpsys meminfo --unwardsable -a' כדי לזהות את הזיכרון המקורי שאינו נגיש כרגע בכל תהליך.  NoApkTestSkipper כלי הכנה מיוחד שמאפשר לדלג על ההפעלה המלאה (הכנה ובדיקות) אם אין חבילות APK לבדיקות.  Perfetto בתנאים ההכנה של Perfetto מעבירה את קובץ התצורה למכשיר במיקום סטנדרטי שאליו יש גישה אליו.  ProfileTargetSETr מחלקה בסיסית להגדרת כלי להכנת יעדים לכל משתמש בפרופיל android.os.usertype.profile.XXX.  PushFileInvoker הכיתה הזו הוצאה משימוש. שימוש ב-PushFilePreparer במקום זאת PushFilePreparer ITargetPreparer שמנסה לדחוף מספר כלשהו של קבצים מכל נתיב מארח לכל נתיב של מכשיר.  PythonVirtualenvPreparer מגדיר וירטואליה של Python בחבילות המארח והמתקין.  להפעיל מחדש לטירגוט מכין היעד שמפעיל מחדש את המכשיר.  RecoverLogPlanr (מכין שחזור) כלי להכנת יעד שמשמש לאיסוף יומנים לפני השחזור.  RemoveSystemAppPreparer ITargetPreparer להסרת APK ממחיצת המערכת לפני הרצת בדיקה.  ResumeSystemServerTargetPreparer מכין היעד שמפעיל מחדש את שרת המערכת בלי להפעיל מחדש את המכשיר.  RootTargetSetupr כלי להכנת יעד שמבצע "adb root" או "adb unroot" בהתאם לאפשרות "force-root".  RootcanalForwarder המוכנות   RunCommandTargetSetupr   RunHostCommandTargetPreparer כלי להכנת יעד להריץ פקודות מארח שרירותיות לפני ואחרי הרצת הבדיקה.  RunHostScriptTargetFixr כלי להכנת יעד שמריץ סקריפט לפני הרצת בדיקה.  RunOnCloneProfileTargetassessr   RunOnPrivateProfileTargetTargetr   RunOnSdkSandboxTargetPreparer ITargetPreparer כדי לסמן שהבדיקות צריכות לרוץ ב-Sandbox של SDK.  RunOnsecondaryUserTargetTargetr ITargetPreparer כדי להבטיח שהבדיקה תפעל כמשתמש משני.  RunOnSystemUserTargetPreparer ITargetPreparer שמסמן שצריך להריץ את הבדיקות על המשתמש (ולא על המשתמש הנוכחי).  RunOnWorkProfileTargetPreparer ITargetPreparer שיוצר פרופיל עבודה בתהליך ההגדרה ומסמן שצריך להריץ את הבדיקות באותו משתמש.  SemaphoreTokenTargetPreparer זהו מתקן הכנה שמשמש לשימוש באסימון כדי ליצור סריאליזציה של הרצת בדיקה במארח שנכנס לתוקף.  SideloadOtaTargetanswerr כלי להכנת יעד שמבצע טעינה משנית של חבילת OTA מסוימת, מחיל את החבילה, ממתין להפעלת המכשיר ומזין את מאפייני ה-build של המכשיר כדי שישמשו כמידע על גרסת ה-build בהכנת היעד הזה, ההנחה היא שהמכשיר יהיה במצב adb רגיל כשמפעילים אותו, והוא יבטיח שהמכשיר יוצא באותו מצב אבל עם ה-build החדש שהוא מיושם.  הגדרת שירותים ITargetPreparer שמפסיק את השירותים במכשיר.  StubTargetPreparer placeholder ריק של הטמעת ITargetPreparer ב-placeholder.  SuiteApkInstaller התקנות של חבילות ה-APK שצוינו עבור הגדרת החבילה: מהמשתנה $ANDROID_TARGET_OUT_TESTCASES או מהמשתנה ROOT_DIR בפרטי ה-build.  SwitchUserTargetPreparer ITargetPreparer שעובר לסוג המשתמש שצוין ב-setUp.  TearDownPassThroughe מאפשרת להריץ את tearDown במכינים שכלולים בתצורה כאובייקט.  Measurement Throttlingwaiter ITargetPreparer שנמצא בהמתנה עד שטמפרטורת המכשיר ירדה ליעד. TestAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקיית IDeviceBuildInfo.getTestsDir() במכשיר.  TestFilePushSetup ITargetPreparer שמעביר קובץ אחד או יותר מתיקיית IDeviceBuildInfo.getTestsDir() למכשיר.  TestSystemAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקיית IDeviceBuildInfo.getTestsDir() במחיצה /system במכשיר.  TimeWaster כלי פשוט להכנת יעד לבזבוז זמן ולהפעלה מחדש של המכשיר.  UserCleaner ITargetPreparer שמסיר משתמשים משניים במהלך פירוק.  VisualBackgroundUserPreparer מתכוננים ליעד להרצת בדיקות במשתמש שמופעל ברקע ומוצג.  PendingForDeviceDatetimePreparer ITargetPreparer שממתין להגדרת התאריך והשעה במכשיר לחלופין, כלי ההכנה הזה יכול לאלץ TargetSetupError אם התאריך והשעה לא מוגדרים במסגרת הזמן הקצוב לתפוגה.  הכנה ל-Wi-Fi 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) במקום זאת

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

הגדרה

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

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

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

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

הגדרה

public void setUp (TestInformation testInformation)

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

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

קליעות
TargetSetupError	אם אירעה שגיאה חמורה בהגדרת הסביבה
BuildError	אם תתרחש שגיאה בזמן ההכנה של ה-build
DeviceNotAvailableException	אם המכשיר לא מגיב

פירעון

public void tearDown (TestInformation testInformation, 
                Throwable e)

מבצעים את הניקוי/הסרת היעד לאחר הבדיקה.

פרמטרים
testInformation	TestInformation: ה-TestInformation של ההפעלה.
e	Throwable: אם ההפעלה הסתיימה במצב חריג, זה יהיה החריג שנתפס ברמת ההפעלה. אחרת, יהיה null.

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

פירעון

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	אם המכשיר לא מגיב