ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer
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 אם המכשיר לא מגיב