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 אחרים. AdbStopServerSetupr מכין יעד שיפסיק את שרת 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 שמשקף את הלוגיקה של קבלת מכשיר נלווה שכבר הוקצה.  CompanionRunCommandTargetPlanr ITargetPreparer שמריץ פקודות ספציפיות במכשיר התומך שהוקצה  CompanionTestAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקיית IDeviceBuildInfo#getTestsDir() במכשיר נלווה שהוקצה.  CompileBootImageWithרוצהspeedTargetPreparer הידור מחדש של נתיב האתחול ושרת המערכת עם מסנן המהדר (speed)  CpuThrottlingWaiter ITargetPreparer שנמצא בהמתנה עד שהתדירות המקסימלית בכל הליבות תשוחזר לרמה הגבוהה ביותר שזמינה. CreateAvdPreparer   CreateUserPreparer יוצרים משתמש ומנקים אותו בסוף.  DeviceActionTargetPreparer ITargetPreparer לביצוע פעולות במכשיר.  DeviceBuildInfoBootStrapper ITargetPreparer שמחליף שדות של מידע על גרסאות build במאפיינים שנקראים מהמכשיר האפשרות הזו שימושית לבדיקה של מכשירים עם גרסאות build שנוצרו ממקור חיצוני (למשל:  DeviceBuildInfoInjector ITargetPreparer שמוסיף את המטא-נתונים DeviceBuildDescriptor אל השדה IBuildInfo.  DeviceCleaner הפעלה מחדש או פורמט כפעולת ניקוי אחרי הבדיקה, ואפשרות לכיבוי המסך  DeviceFlashFlashr ITargetPreparer שמבהב תמונה בחומרה פיזית של Android.  DeviceImageZipFlashingTargetPreparer כלי להכנת יעד שמבהב במכשיר עם תמונות של המכשיר שסופקו באמצעות פורמט ספציפי.  DeviceOwnerTargetTargetr ITargetPreparer שמגדיר רכיב של בעלי מכשיר.  DeviceSetup ITargetPreparer שמגדיר מכשיר לבדיקה על סמך Options שסופקו.  DeviceStorageFiller מכין יעד שימלא את נפח האחסון כדי שיהיה מקום פנוי.  DeviceStringPusher הכנת יעד לכתיבה של מחרוזת לקובץ.  DeviceUpdateTargetSetupr ITargetPreparer מופשט שמטפל בשלבים נפוצים של עדכון מכשירים באמצעות קובץ תמונה של מכשיר ממקור חיצוני (בניגוד לשירות build).  DeviceWiper ITargetPreparer שמאפס את נתוני המשתמשים DisableSELinuxTargetPreparer מכין היעד שמשבית את SELinux אם הוא מופעל.  DynamicSystemPreparer קובץ ITargetPreparer שמגדיר קובץ אימג' של מערכת מעל גרסה של מכשיר עם עדכון מערכת דינמי.  EraseUserDataPreparer ITargetPreparer שמאפס את נתוני המשתמש במכשיר.  FastbootCommand ימיןr כלי להכנת יעד שמפעיל את fastboot ושולח פקודות fastboot.  FastbootUpdateBootstrapler ITargetPreparer שמעביר קבצים שצוינו (תוכנת אתחול, רדיו, קובץ ZIP של תמונת המכשיר) אל IDeviceBuildInfo כדי לגרום למכשירים לפעול עם FastbootDeviceFlasher, ולאחר מכן מחדיר מאפייני מכשיר לאחר ההפעלה אל פרטי ה-build למטרות דיווח על תוצאות.  FeatureflagTarget שזמינות עדכון של DeviceConfig (דגלים של תכונות שמותאמים על ידי שירות מרוחק).  FoldableModePreparer שירות לעיבוד יעד שיכול לשנות את המצב המתקפל של מכשיר.  FolderSaver ITargetPreparer ששואב ספריות מהמכשיר, דוחס אותן ושומר אותן בקצה העורפי של הרישום ביומן.  GkiDeviceFlashFlashr כלי להכנת יעד שמבצע אימיג' של המכשיר באמצעות קובץ אימג' גנרי של ליבה נפוצה של Android.  GsiDeviceFlashPreparer כלי להכנת יעד שמבצע אימיג' של המכשיר באמצעות תמונת מערכת גנרית (GSI) ל-Android.  ILabPreparer ממשק של סמן לצורך הכנת מעבדה תיאור של הממשקים האלה מופיע בקטע ITargetPreparer.  ITargetCleaner הממשק הזה הוצא משימוש. השיטה tearDown הועברה לממשק הבסיסי ITargetPreparer.  InstallAllTestZipAppsSetup ITargetPreparer שמתקין את כל האפליקציות בקובץ zip לבדיקה.  InstallApexModuleTargetPlanr   InstallApkSetup ITargetPreparer שמתקין קובץ APK אחד או יותר שנמצא במערכת הקבצים.  התקנתBuildEnvApkSetup ITargetPreparer שמתקין חבילת APK אחת או יותר לבדיקה בסביבת build של פלטפורמת Android.  InstallKernelModule readyr כלי להכנת יעד שמתקינים מודולים של ליבה (kernel).  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 לבדיקה.  הכנה להגשה ההכנה של Perfetto מעבירה את קובץ התצורה למכשיר במיקום סטנדרטי שאליו יש גישה אליו.  ProfileTargetPreparer מחלקה בסיסית להגדרת כלי להכנת יעדים לכל משתמש בפרופיל android.os.usertype.profile.XXX.  PushFileInvoker הכיתה הזו הוצאה משימוש. במקום זאת, אתם יכולים להשתמש ב-PushFilePreparer PushFilePreparer ITargetPreparer שמנסה לדחוף מספר כלשהו של קבצים מכל נתיב מארח לכל נתיב של מכשיר.  PythonVirtualenvPreparer הגדרת Python virtualenv במארח והתקנת חבילות.  להפעיל מחדש לטירגוט מכין היעד שמפעיל מחדש את המכשיר.  RecoveryLogPreparer כלי להכנת יעד שמשמש לאיסוף יומנים לפני השחזור.  RemoveSystemAppPreparer ITargetPreparer להסרת APK ממחיצת המערכת לפני הרצת בדיקה.  ResumeSystemServerTargetPreparer כלי לניהול יעדי התקנה שמפעיל מחדש את שרת המערכת בלי להפעיל מחדש את המכשיר.  RootTargetPreparer כלי להכנת יעד שמבצע "adb root" או "adb unroot" בהתאם לאפשרות "force-root".  RootcanalForwarder המוכנות   RunCommandTargetPreparer   RunHostCommandTargetPreparer כלי להכנת יעד להריץ פקודות מארח שרירותיות לפני ואחרי הרצת הבדיקה.  RunHostScriptTargetFixr כלי לטירגוט שמפעיל סקריפט לפני הפעלת בדיקה.  RunOnCloneProfileTargetPreparer   RunOnPrivateProfileTargetTargetr   RunOnSdkSandboxTargetPreparer ITargetPreparer כדי לסמן שהבדיקות צריכות לרוץ ב-Sandbox של SDK.  RunOnsecondaryUserTargetTargetr ITargetPreparer כדי להבטיח שהבדיקה תפעל כמשתמש משני.  RunOnSystemUserTargetPreparer ITargetPreparer שמציין שצריך להריץ את הבדיקות על המשתמש (ולא על המשתמש הנוכחי).  RunOnWorkProfileTargetPreparer ITargetPreparer שיוצר פרופיל עבודה בתהליך ההגדרה ומסמן שצריך להריץ את הבדיקות באותו משתמש.  SemaphoreTokenTargetPreparer זהו מתקן הכנה שמשמש לשימוש באסימון כדי ליצור סריאליזציה של הרצת בדיקה במארח שנכנס לתוקף.  SideloadOtaTargetanswerr כלי להכנת יעד שמבצע טעינת צדדית של חבילת OTA מסוימת, מחיל את החבילה, ממתין להפעלה של המכשיר ומחדיר את מאפייני ה-build של המכשיר לשימוש כפרטי build הכלי הזה להכנת יעד מניח שהמכשיר יהיה במצב adb רגיל כשהוא יופעל, וידאג שהמכשיר ייצא מהמצב הזה עם הגרסה החדשה של ה-build.  הגדרת שירותים ITargetPreparer שגורם להפסקת השירותים במכשיר.  StubTargetPreparer הטמעה ריקה של placeholder של ITargetPreparer.  SuiteApkInstaller התקנות של חבילות ה-APK שצוינו עבור הגדרת החבילה: מהמשתנה $ANDROID_TARGET_OUT_TESTCASES או מהמשתנה ROOT_DIR בפרטי ה-build.  SwitchUserTargetPreparer ITargetPreparer שמתחלף לסוג המשתמש שצוין ב-setUp.  TearDownPassThroughe מאפשרת להריץ את tearDown במכינים שכלולים ב-config כאובייקט.  Measurement Throttlingwaiter ITargetPreparer שממתין עד שטמפרטורת המכשיר תגיע לטמפרטורת היעד  TestAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקייה IDeviceBuildInfo.getTestsDir() במכשיר.  TestFilePushSetup ITargetPreparer שמעביר קובץ אחד או יותר מתיקיית IDeviceBuildInfo.getTestsDir() למכשיר.  TestSystemAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקיית IDeviceBuildInfo.getTestsDir() במחיצה /system במכשיר.  TimeWaster כלי פשוט להכנת יעד שגורם לבזבוז זמן ויכול להפעיל מחדש את המכשיר.  UserCleaner ITargetPreparer שמסיר משתמשים משניים במהלך פירוק.  VisibleBackgroundUserPreparer מתכוננים ליעד להרצת בדיקות במשתמש שמופעל ברקע ומוצג.  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	if fatal error occurred setting up environment
BuildError	אם מתרחשת שגיאה שקשורה ל-BuildInfo
DeviceNotAvailableException	אם המכשיר לא מגיב

הגדרה

public void setUp (TestInformation testInformation)

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

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

קליעות
TargetSetupError	if fatal error occurred setting up environment
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	אם המכשיר לא מגיב