דף זה תורגם על ידי Cloud Translation API.

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` שמגדיר מכשיר לבדיקה על סמך `Option`s שסופקו.
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`	אם המכשיר לא מגיב