com.android.tradefed.targetprep

ממשקים

FlashingResourcesParser.Constraint ממשק סינון, שמיועד לאפשר ל-FlashingResourcesParser להתעלם מחלק מהמשאבים שאחרת הוא עשוי להשתמש בהם 
iDeviceFlasher הפעלה של תמונה של מכשיר במכשיר. 
IFlashingResourcesParser ממשק לאספקת הגרסאות הנדרשות של קובצי תמונות עזר שנדרשים לצריבת ROM‏ (flash) של מכשיר. 
IFlashingResourcesRetriever ממשק לאחזור קובצי תמונה משניים שנדרשים לצריבת ROM‏ (flash) של מכשיר. 
IHostCleaner מנקה את המארח אחרי שהרצת הבדיקה מסתיימת. 
ILabPreparer ממשק סמן למי שמכין את המעבדה

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

ITargetCleaner הממשק הזה הוצא משימוש. ‫tearDown הועברה לממשק הבסיסי ITargetPreparer. 
ITargetPreparer הפעולה מכינה את סביבת הבדיקה להרצת הבדיקה. 
ITestsZipInstaller הפקודה מתקינה במכשיר בדיקות מקובץ ZIP של בדיקות (כפי שמופק על ידי מערכת ה-build). 

קורסים

AFlagsTargetPreparer משתמשים ב-aflags כדי לבטל את ההגדרה של דגלים לפני שמריצים בדיקה. 
AllTestAppsInstallSetup ITargetPreparer שמתקין את כל האפליקציות מתיקייה IDeviceBuildInfo.getTestsDir() במכשיר. 
AoaTargetPreparer ITargetPreparer שמבצע סדרה של פעולות (למשל קליקים והחלקות) באמצעות פרוטוקול Android Open Accessory‏ (AOAv2). 
AppSetup ITargetPreparer שמתקין קובץ APK ואת הבדיקות שלו. 
ArtChrootPreparer יצירת ספריית chroot לבדיקות ART. 
BaseEmulatorPreparer הכנה נפוצה להפעלת אמולטור מקומי. 
BaseSwitchUserTargetPreparer ‫ITargetPreparer שמשנה את סוג המשתמש שצוין ב-setUp. 
BaseSystemTestEnvPreparer הפעלה מחדש של סביבת בדיקת מערכת בסיסית
BaseTargetPreparer מחלקת הטמעה בסיסית של ITargetPreparer שמאפשרת לקבוע אם האובייקט מושבת או לא. 
BuildInfoRecorder ‫ITargetPreparer שכותב מטא-נתונים של פרטי בנייה לקובץ שצוין. 
CdmaDeviceFlasher מחלקת תמונות שמוצגות לזמן קצר במכשיר Android פיזי עם רדיו CDMA. 
CompatTargetPreparer ITargetPreparer שמכין את המכשיר להרצת בדיקות תאימות. 
CompileBootImageWithSpeedTargetPreparer הקומפיילר מבצע קומפילציה מחדש של נתיב המחלקה של האתחול ושל שרת המערכת באמצעות מסנן הקומפיילר 'speed'. 
CpuThrottlingWaiter ‫ITargetPreparer שממתין עד שהתדירות המקסימלית בכל הליבות משוחזרת לרמה הגבוהה ביותר שזמינה 
CreateAvdPreparer  
CreateUserPreparer הכלי Target preparer ליצירת משתמש משני ולניקוי שלו בסוף. 
CrosDutTopologyPreparer כלי הכנה שמריץ את הכלי dt-converter כדי ליצור הגדרות בדיקה ופרמטרים לבדיקה. 
CrosLsNexusPreparer מכין שמתחיל ומפסיק את שירות LSNexus במכשיר ChromeOS. 
DefaultTestsZipInstaller הטמעה שמוגדרת כברירת מחדל של קובץ zip להתקנת בדיקות. 
DeviceActionTargetPreparer ‫ITargetPreparer כדי לבצע פעולות במכשיר. 
DeviceBuildInfoBootStrapper ‫ITargetPreparer שמחליף שדות של פרטי גרסה במאפיינים שנקראים מהמכשיר

האפשרות הזו שימושית לבדיקת מכשירים עם גרסאות Build שנוצרו ממקור חיצוני (למשל 

DeviceBuildInfoInjector ‫ITargetPreparer שמוסיף מטא-נתונים של DeviceBuildDescriptor אל IBuildInfo. 
DeviceCleaner מבצע הפעלה מחדש או פורמט כפעולת ניקוי אחרי הבדיקה, ויש לו אפשרות לכבות את המסך 
DeviceFlashPreparer ‫ITargetPreparer שמהבהב תמונה בחומרה פיזית של Android. 
DeviceImageZipFlashingTargetPreparer כלי להכנת יעד שמבזיק את המכשיר עם תמונות של המכשיר שסופקו בפורמט ספציפי. 
DeviceOwnerTargetPreparer ‫ITargetPreparer שמגדיר רכיב של בעלי המכשיר. 
DeviceSetup ‫ITargetPreparer שמגדיר מכשיר לבדיקה על סמך Option שסופקו. 
DeviceStorageFiller הכלי להכנת היעד ימלא את האחסון כך שיהיה זמין נפח אחסון מסוים. 
DeviceStringPusher הכנת היעד לכתיבת מחרוזת לקובץ. 
DeviceUpdateTargetPreparer אבסטרקציה ITargetPreparer שמטפלת בשלבים נפוצים של עדכון מכשירים באמצעות קובץ תמונת מכשיר ממקור חיצוני (בניגוד לשירות בנייה). 
DeviceWiper ITargetPreparer שמאפס את נתוני המשתמשים 
DexMetadataExtractor הפקודה מתקינה קובצי מטא-נתונים של Dex עבור קובצי APK שצוינו. 
DisableSELinuxTargetPreparer קובץ להכנת היעד שמשבית את SELinux אם הוא מופעל. 
DynamicSystemPreparer ‫ITargetPreparer שמגדיר קובץ אימג' של מערכת על גרסת build של מכשיר באמצעות עדכון מערכת דינמי. 
EhideTargetPreparer מפעיל את ehide, שמסתיר את ממשק האתרנט ממערך הרשת של Android. 
EraseUserDataPreparer ITargetPreparer שמאפס את נתוני המשתמש במכשיר. 
FastbootCommandPreparer כלי להכנת יעד שמפעיל את fastboot ושולח פקודות fastboot. 
FastbootDeviceFlasher מחלקת fastboot שמשמשת להעברת תמונה לציוד פיזי של Android. 
FastbootUpdateBootstrapPreparer ‫ITargetPreparer שמעביר קבצים שצוינו (תוכנת אתחול, רדיו, קובץ ZIP של תמונת המכשיר) אל IDeviceBuildInfo כדי להפעיל את FastbootDeviceFlasher במכשירים, ואז מוסיף מאפייני מכשיר אחרי האתחול לפרטי ה-build לצורך דיווח על התוצאות. 
FeatureFlagTargetPreparer הכיתה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ AFlagsTargetPreparer. 
FlashingResourcesParser מחלקה שמנתחת את הגרסאות הנדרשות של קבצי תמונות עזר שנדרשים לצריבת ROM‏ (flash) של מכשיר. 
FlashingResourcesParser.AndroidInfo הגדרה של typedef ל-Map<String, MultiMap<String, String>>. 
FolderSaver ‫ITargetPreparer ששולף ספריות מהמכשיר, דוחס אותן ושומר אותן בקצה העורפי של הרישום ביומן. 
FutilityCommandPreparer הכנה להפעלת פקודות חוסר תועלת. 
GkiDeviceFlashPreparer כלי להכנת יעד שמבצע פלאשינג של המכשיר עם תמונה גנרית של ליבת Android נפוצה. 
GsiDeviceFlashPreparer כלי להכנת יעד שצורך את המכשיר עם קובץ אימג' כללי של מערכת Android. 
HsumBootStrategyPreparer  
InstallAllTestZipAppsSetup ITargetPreparer שמתקין את כל האפליקציות בקובץ ZIP לבדיקה. 
InstallApexModuleTargetPreparer  
InstallApkSetup קובץ ITargetPreparer שמתקין קובץ APK אחד או יותר שנמצאים במערכת הקבצים. 
InstallBuildEnvApkSetup ‫ITargetPreparer שמתקין קובץ APK אחד או יותר של בדיקה מסביבת build של פלטפורמת Android. 
InstallKernelModulePreparer כלי להכנת יעד שמתקין מודולים של ליבת המערכת. 
‫InstrumentationPreparer ITargetPreparer שמריץ מכשור 
KillExistingEmulatorPreparer ITargetPreparer שמכבה אמולטור שפועל. 
KnownFailurePreparer הגדרת המכין של היעד לדילוג על ניסיון חוזר במקרה של כשל ידוע. 
LocalEmulatorLaunch ‫TargetPreparer שמפעיל אמולטור באופן מקומי מסביבת build של Android. 
LocalEmulatorSnapshot ‫TargetPreparer שמיועד ליצירת תמונת מצב אמולטור נקייה מסביבת פיתוח/build של Android
MixKernelTargetPreparer ITargetPreparer שמאפשר לערבב קובץ אימג' של ליבה עם קובץ האימג' של המכשיר. 
MixRadioTargetPreparer ITargetPreparer שמאפשרת לערבב תמונה של רדיו עם תמונת המכשיר. 
ModuleOemTargetPreparer  
ModulePusher  
NativeLeakCollector ‫ITargetPreparer שמופעלת בה הפקודה dumpsys meminfo --unreachable -a כדי לזהות את הזיכרון המקורי שלא ניתן להגיע אליו, שמוחזק כרגע על ידי כל תהליך. 
OtaUpdateDeviceFlasher כלי להעברת קובץ אימג' למכשיר שמפעיל את הסקריפט system/update_engine/scripts/update_device.py עם חבילת OTA מלאה או מצטברת כדי לעדכן את קובץ האימג' של המכשיר. 
PerfettoPreparer הכלי Perfetto preparer דוחף את קובץ ההגדרות למכשיר במיקום סטנדרטי שאליו יש ל-Perfetto גישה. 
ProfileTargetPreparer מחלקת בסיס להגדרת כלי להכנת היעד לכל משתמש בפרופיל android.os.usertype.profile.XXX. 
PushFileInvoker הכיתה הזו הוצאה משימוש. במקום זאת, אפשר להשתמש ב-PushFilePreparer 
PushFilePreparer ITargetPreparer שמנסה להעביר מספר כלשהו של קבצים מנתיב כלשהו במארח לנתיב כלשהו במכשיר. 
PythonVirtualenvPreparer מגדיר סביבה וירטואלית של Python במארח ומתקין חבילות. 
RebootTargetPreparer כלי להכנת יעד שמפעיל מחדש את המכשיר. 
RecoveryLogPreparer כלי להכנת יעד שמשמש לאיסוף יומנים לפני השחזור. 
RemoveSystemAppPreparer ‫ITargetPreparer להסרת קובץ APK ממחיצת המערכת לפני הרצת בדיקה. 
RestartSystemServerTargetPreparer כלי הכנה של יעד שמפעיל מחדש את שרת המערכת בלי להפעיל מחדש את המכשיר. 
RootcanalForwarderPreparer  
RootTargetPreparer מכין את היעד לביצוע הפעולות adb root או adb unroot על סמך האפשרות force-root. 
RunCommandTargetPreparer  
RunHostCommandTargetPreparer הכלי Target preparer מריץ פקודות שרירותיות במארח לפני ואחרי הרצת הבדיקה. 
RunHostScriptTargetPreparer הכנה של יעד שמבצע סקריפט לפני הפעלת בדיקה. 
RunOnCloneProfileTargetPreparer  
RunOnPrivateProfileTargetPreparer  
RunOnSdkSandboxTargetPreparer ‫ITargetPreparer מציין שהבדיקות צריכות לפעול בארגז החול של ה-SDK. 
RunOnSecondaryUserTargetPreparer ‫ITargetPreparer כדי לוודא שהבדיקה תפעל כמשתמש משני. 
RunOnSystemUserTargetPreparer ITargetPreparer שמציין שצריך להריץ בדיקות על המשתמש (ולא על המשתמש הנוכחי). 
RunOnWorkProfileTargetPreparer ITargetPreparer שיוצר פרופיל עבודה בהגדרה, ומסמן שהבדיקות צריכות להתבצע אצל המשתמש הזה. 
SemaphoreTokenTargetPreparer זהו קובץ הכנה שמשמש לשימוש באסימון כדי לבצע סריאליזציה של בדיקת ההפעלה במארח tradefed. 
SideloadOtaTargetPreparer כלי להכנת יעד שמבצע העברה צדדית של חבילת OTA שצוינה, מחיל את החבילה, ממתין עד שהמכשיר יופעל ומזריק את מאפייני הגרסה של המכשיר כדי להשתמש בהם כפרטי הגרסה

הכלי הזה מניח שהמכשיר יהיה במצב adb רגיל כשהוא יופעל, וידאג שהמכשיר יצא מאותו מצב אבל עם הגרסה החדשה יותר. 

StopServicesSetup ITargetPreparer שמפסיק את השירותים במכשיר. 
StubTargetPreparer הטמעה ריקה של פלייסהולדר של ITargetPreparer. 
SwitchUserTargetPreparer הטמעת ברירת המחדל של BaseSwitchUserTargetPreparer – מידע נוסף זמין ב-javadoc של המחלקה. 
SystemUpdaterDeviceFlasher ‫IDeviceFlasher שמסתמך על כלי לעדכון המערכת כדי להתקין קובץ אימג' של המערכת שצורף לחבילת עדכון OTA. 
TearDownPassThroughPreparer מאפשר להריץ tearDown על רכיבי preparer שנכללים בהגדרה כאובייקט. 
TemperatureThrottlingWaiter ITargetPreparer שמחכה עד שהטמפרטורה של המכשיר תרד לטמפרטורת היעד 
TestAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקייה IDeviceBuildInfo.getTestsDir() במכשיר. 
TestFilePushSetup ITargetPreparer שמעביר קובץ אחד או יותר או תיקיות מתיקיית IDeviceBuildInfo.getTestsDir() למכשיר. 
TestSystemAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקייה IDeviceBuildInfo.getTestsDir() במחיצת /system במכשיר. 
TimeWaster מכין יעד פשוט שגורם לבזבוז זמן ועלול להפעיל מחדש את המכשיר. 
UserCleaner ‫ITargetPreparer שמסיר משתמשים משניים במהלך הסרת הקישור. 
UserHelper  
VisibleBackgroundUserPreparer הכנת יעד להרצת בדיקות במשתמש שהופעל ברקע. 
WaitForDeviceDatetimePreparer ‫ITargetPreparer שממתין להגדרת תאריך ושעה במכשיר

אפשרות נוספת היא שהמכין יכפה TargetSetupError אם התאריך והשעה לא מוגדרים בתוך הזמן הקצוב לתפוגה. 

WifiPreparer ITargetPreparer שמגדיר את ה-Wi-Fi במכשיר אם צריך. 

טיפוסים בני מנייה (enum)

AltDirBehavior סוג enum להגדרת התנהגויות חלופיות של ספריות עבור תוכנות התקנה/דוחפים שונים של פריטי בדיקה

 

DeviceCleaner.CleanupAction  
DeviceCleaner.PostCleanupAction  
DynamicSystemPreparer.PvmfwFlashMode  
FlashingMethod סוג enum שמתאר את השיטה שבה משתמשים כדי לצרוב ROM במכשיר שנבדק 
GsiDeviceFlashPreparer.PvmfwFlashMode  
IDeviceFlasher.UserDataFlashOption ספירה של אפשרויות לטיפול בתמונה של נתוני המשתמש 

חריגים

BuildError השגיאה הזו מופיעה אם ה-build שסופק לא מצליח לפעול. 
DeviceFailedToBootError החריג הזה מופעל אם המכשיר לא מצליח לבצע אתחול אחרי שבוצע בו פלאשינג עם build. 
ModulePusher.ModulePushError שגיאה קריטית במהלך שליחת מודול Mainline. 
TargetSetupError אירעה שגיאה חמורה במהלך ההכנה של היעד לבדיקה.