ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

תת-מחלקות עקיפות ידועות AdbStopServerPreparer , AllTestAppsInstallSetup , AoaTargetPreparer , AppSetup , ArtChrootPreparer , BaseEmulatorPreparer , BaseTargetPreparer , BuildInfoRecorder , CheckPairingPreparer , CompanionAllocator CompanT CompanT compar , Compan ionTestAppInstallSetup , CompileBootImageWithSpeedTargetPreparer , CpuThrottlingWaiter ו-72 אחרים. 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 בין התקנים ראשיים והתקנים נלווים CompanionAlocator כיתת בסיס הדואגת להקצאה ושחרור מכשיר נלווה יש ליישם getCompanionDeviceSelectionOptions() כדי לתאר את הקריטריונים הדרושים להקצאת המכשיר הנלווה CompanionAwarePreparer ITargetPreparer שמכיל את ההיגיון של קבלת מכשיר נלווה שכבר הוקצה. CompanionRunCommandTargetPreparer ITargetPreparer המריץ פקודות שצוינו במכשיר הנלווה שהוקצה CompanionTestAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקיית IDeviceBuildInfo#getTestsDir() על מכשיר נלווה שהוקצה. CompileBootImageWithSpeedTargetPreparer הידור מחדש של מסלול האתחול ושרת המערכת עם מסנן המהדר 'מהירות'. CpuThrottlingWaiter ITargetPreparer שמחכה עד שתדירות מקסימלית בכל הליבות תשוחזר לרמה הגבוהה ביותר הזמינה CreateAvdPreparer CreateUserPreparer מכין יעד ליצירת משתמש וניקויו בסוף. DeviceBuildInfoBootStrapper ITargetPreparer המחליף שדות מידע על build בתכונות הנקראות מהמכשיר זה שימושי לבדיקת התקנים עם builds שנוצרו ממקור חיצוני (למשל DeviceBuildInfoInjector ITargetPreparer שמכניס מטא נתונים DeviceBuildDescriptor לתוך IBuildInfo . Device Cleaner מבצע אתחול מחדש או עיצוב כפעולת ניקוי לאחר הבדיקה, ולחלופין מכבה את המסך DeviceFlashPreparer ITargetPreparer שמציג תמונה על חומרת אנדרואיד פיזית. DeviceImageZipFlashingTargetPreparer מכין יעדים שמבליח את המכשיר עם תמונות המכשיר המסופקות בפורמט מסוים. DeviceOwnerTargetPreparer ITargetPreparer שמגדיר רכיב בעל מכשיר. הגדרת מכשיר ITargetPreparer שמגדיר מכשיר לבדיקה בהתבסס על Option שסופקו. DeviceStorageFiller היעד מכין כדי למלא את האחסון כך כמות מסוימת של מקום פנוי זמין. DeviceStringPusher מכין יעד לכתוב מחרוזת לקובץ. DeviceUpdateTargetPreparer ITargetPreparer אבסטרקטי שדואג לצעדים נפוצים סביב עדכון מכשירים עם קובץ תמונת מכשיר ממקור חיצוני (בניגוד לשירות build). DeviceWiper ITargetPreparer שמנגב נתוני משתמש DisableSELinuxTargetPreparer מכין יעדים שמנטרל את SELinux אם מופעל. DynamicSystemPreparer ITargetPreparer שמגדיר תמונת מערכת על גבי מבנה התקן עם עדכון המערכת הדינמי. EraseUserDataPreparer ITargetPreparer שמוחק את נתוני המשתמש במכשיר. FastbootCommandPreparer מכין יעדים שמפעיל אתחול מהיר ושולח פקודות אתחול מהיר. FastbootUpdateBootstrapPreparer ITargetPreparer שמשלב קבצים שצוינו (מטען אתחול, רדיו, התקן תמונה zip) לתוך IDeviceBuildInfo כדי לקבל הבזק להתקנים עם FastbootDeviceFlasher , ולאחר מכן מחדיר תכונות מכשיר לאחר האתחול למידע על הבנייה למטרות דיווח תוצאות. FeatureFlagTargetPreparer מעדכן את DeviceConfig (דגלי תכונה מכוונים על ידי שירות מרוחק). FoldableModePreparer מכין מטרות שיכול לשנות את המצב המתקפל של מכשיר. שומר תיקיות ITargetPreparer שמושך ספריות מהמכשיר, דוחס ושומר אותו בקצה האחורי של רישום. GkiDeviceFlashPreparer מכין יעדים שמבזק את המכשיר עם תמונה גנרית של גרעין נפוצה של אנדרואיד. GsiDeviceFlashPreparer מכין יעדים שמבליח את המכשיר עם תמונת מערכת גנרית של אנדרואיד. ILabPreparer ממשק מרקר למכיני מעבדה עיין ITargetPreparer לתיאור של מטרות הממשקים הללו. ITargetCleaner ממשק זה הוצא משימוש. tearDown הועבר לממשק הבסיסי של ITargetPreparer. התקן אתAllTestZipAppsSetup ITargetPreparer שמתקין את כל האפליקציות ב-zip לניסיון. התקן אתApexModuleTargetPreparer InstallApkSetup ITargetPreparer שמתקין אפליקציה אחת או יותר הממוקמת במערכת הקבצים. InstallBuildEnvApkSetup ITargetPreparer שמתקין אפקיית בדיקה אחת או יותר מפלטפורמת Android build env. מכין מכשירים ITargetPreparer שמפעיל מכשור KillExistingEmulatorPreparer ITargetPreparer שמכבה אמולטור פועל. KnownFailurePreparer מטרת מכין היעד לדלג על ניסיון חוזר של כשל ידוע. LocalEmulatorLaunch TargetPreparer שמשיק אמולטור באופן מקומי מסביבת בנייה של אנדרואיד. LocalEmulatorSnapshot TargetPreparer המיועד ליצירת תמונת מצב נקייה של אמולטור מסביבת בנייה/פיתוח של אנדרואיד MixKernelTargetPreparer ITargetPreparer המאפשר לערבב תמונת ליבה עם תמונת המכשיר. ModuleOemTargetPreparer NativeLeakCollector ITargetPreparer המריץ את 'dumpsys meminfo --unreachable -a' כדי לזהות את הזיכרון המקומי הבלתי ניתן להשגה המוחזק כעת על ידי כל תהליך. NoApkTestSkipper מכין מיוחד המאפשר לדלג על הזמנה לחלוטין (הכנה ומבחנים) אם אין apks לבדיקות. PerfettoPreparer מכין פרפטו דוחף את קובץ התצורה פנימה למכשיר במיקום סטנדרטי שאליו יש לפרפטו גישה. ProfileTargetPreparer כיתה בסיס להגדרת מכין יעדים עבור כל משתמש פרופיל android.os.usertype.profile.XXX . PushFileInvoker מחלקה זו הוצאה משימוש. השתמש במקום זאת PushFilePreparer PushFilePreparer ITargetPreparer שמנסה לדחוף כל מספר של קבצים מכל נתיב מארח לכל נתיב מכשיר. PythonVirtualenvPreparer מגדיר Python virtualenv על המארח ומתקין חבילות. RebootTargetPreparer מכין יעדים המאתחל את המכשיר. RecoveryLogPreparer מכין יעדים המשמש לאיסוף יומנים לפני התאוששות. RemoveSystemAppPreparer ITargetPreparer להסרת apk ממחיצת המערכת לפני הפעלת ניסיון. הפעל מחדש את SystemServerTargetPreparer מכין יעדים שמפעיל מחדש את שרת המערכת מבלי לאתחל את המכשיר. RootTargetPreparer מכין יעד שמבצע "adb root" או "adb unroot" על סמך אפשרות "force-root". RunCommandTargetPreparer RunHostCommandTargetPreparer מכין יעד להפעלת פקודות מארח שרירותיות לפני ואחרי הפעלת הבדיקה. RunHostScriptTargetPreparer מכין יעדים שמבצע סקריפט לפני הפעלת בדיקה. RunOnCloneProfileTargetPreparer RunOnSdkSandboxTargetPreparer ITargetPreparer כדי לסמן שבדיקות צריכות לפעול בארגז החול של sdk. RunOnSecondaryUserTargetPreparer ITargetPreparer שיוצר משתמש משני בהגדרה, ומסמן שצריך להריץ בדיקות באותו משתמש. RunOnSystemUserTargetPreparer ITargetPreparer שמסמן שצריך להריץ בדיקות על המשתמש (ולא על המשתמש הנוכחי). RunOnWorkProfileTargetPreparer ITargetPreparer שיוצר פרופיל עבודה בהגדרה, ומסמן שצריך להריץ בדיקות באותו משתמש. SemaphoreTokenTargetPreparer זהו מכין המשמש לשימוש באסימונים כדי לסידור הוצאת בדיקה במארח המוזן במסחר. SideloadOtaTargetPreparer מכין יעד שמבצע עומס צד של חבילת OTA שצוינה, מחיל את החבילה, ממתין לאתחול המכשיר ומחדיר את מאפייני בניית המכשיר לשימוש כמידע בנייה מכין יעד זה מניח שהמכשיר יהיה במצב adb רגיל בעת ההפעלה, ויבטיח שהמכשיר יוצא באותו מצב אך עם ה-build החדש יותר. StopServicesSetup ITargetPreparer שעוצר שירותים במכשיר. StubTargetPreparer יישום ריק של מציין מיקום של ITargetPreparer . SuiteApkInstaller מתקין חבילות APK שצוינו עבור תצורת Suite: או ממשתנה $ANDROID_TARGET_OUT_TESTCASES או מ-ROOT_DIR בפרטי הבנייה. SwitchUserTargetPreparer ITargetPreparer שעובר לסוג המשתמש שצוין ב-setUp. TearDownPassThroughPreparer מאפשר להפעיל TearDown על מכינים הכלולים בתצורה כאובייקט. מלצר מצערת טמפרטורה ITargetPreparer שמחכה עד שטמפרטורת המכשיר תרד ליעד TestAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקיית IDeviceBuildInfo.getTestsDir() במכשיר. TestFilePushSetup ITargetPreparer שדוחף קובץ/dir אחד או יותר מתיקיית IDeviceBuildInfo.getTestsDir() אל המכשיר. TestSystemAppInstallSetup ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקיית IDeviceBuildInfo.getTestsDir() במחיצת /system במכשיר. מבזבז זמן מכין מטרות פשוט לבזבז זמן ואפשר להפעיל מחדש את המכשיר. UserCleaner ITargetPreparer שמסיר משתמשים משניים בעת ניתוק. VisibleBackgroundUserPreparer מכין יעדים להפעלת בדיקות במשתמש שמופעל ברקע הגלוי. WaitForDeviceDatetimePreparer ITargetPreparer שמחכה להגדרת תאריך ושעה במכשיר לחלופין, מכין זה יכול לכפות TargetSetupError אם תאריך תאריך לא מוגדר בתוך פסק זמן, או לכפות תאריך תאריך מארח על המכשיר, WifiPreparer ITargetPreparer שמגדיר wifi במכשיר במידת הצורך.

---

מכין את סביבת הבדיקה לריצת הבדיקה.

לדוגמה, מתקין תוכנה, מתקן את הגדרות ה-env לבדיקה, השקת יעדים וכו'.

שים לב שניתן לציין מספר 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 : נתונים על הבנייה הנבדקת.

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

להכין

public void setUp (TestInformation testInformation)

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

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

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

לקרוע

public void tearDown (TestInformation testInformation, 
                Throwable e)

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

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

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

לקרוע

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

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

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

פרמטרים
device	ITestDevice : ה- ITestDevice להכנה.
buildInfo	IBuildInfo : נתונים על הבנייה הנבדקת.
e	Throwable : אם ההזמנה הסתיימה בחריג, זה יהיה החריג שנתפס ברמת ה-Invocation. אחרת, יהיה null .

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