גורמים שמוגדרים כמי שמילא את הטופס

הפונקציות Target preparers מופעלות לפני הבדיקות ברמת הבדיקה שבה הן מוגדרות. כך אפשר להגדיר כל מכשיר כדי שהבדיקות יפעלו בצורה חלקה.

ממשק בסיסי

ממשק הבסיס הוא ITargetPreparer, שמאפשר הטמעה של שיטת setUp לביצוע. מומלץ להטמיע את המחלקה המופשטת הבסיסית שלנו BaseTargetPreparer, שמספקת תכונה מובנית להשבתה של כלי הכנה בקלות.

ממשק נקי יותר

ההרחבה הטבעית של setUp היא tearDown, והיא מסופקת על ידי ממשק אחר, ITargetCleaner. הוא מספק את הממשק tearDown שמאפשר לנקות את כל מה שנעשה ב-setUp אחרי הרצת הבדיקה.

הכיתה BaseTargetPreparer גם מרחיבה את ITargetCleaner.

המלצות

מומלץ להגביל כל מכין לפונקציה ראשית אחת, למשל התקנת APK או הפעלת פקודה. כך קל יותר לעשות שימוש חוזר ב-preparers.

כדאי גם לבדוק את רשימת מגישי הבקשות הזמינים לפני שמוסיפים חדש, כדי למנוע כפילויות. האפשרות 'הכנה' זמינה בtools/tradefederation/core/src/com/android/tradefed/targetprep/.

הגדרות XML

תג האובייקט הוא target_preparer, לדוגמה:

<target_preparer class="com.android.tradefed.targetprep.InstallApkSetup">
    <option name="install-arg" value="-d"/>
</target_preparer>

כדאי לעיין גם במאמר הגדרת חבילות כדי לקבל הקשר.

הגדרה ברמה העליונה

אם מציינים את ההגדרה הזו בהגדרה ברמה העליונה, הכלי להכנת המכשיר יפעל רק פעם אחת לכל מכשיר. דוגמה: cts-common.xml, שהיא הגדרה ברמה העליונה לבדיקות של חבילת הבדיקות לתאימות (CTS) של Android.

הגדרה ברמת המודול

אם מציינים את המכין ברמת המודול, הוא תמיד יפעל לפני המודול הזה. דוגמה: backup/AndroidTest.xml, שמגדירה איך Tradefed מפעיל את מודול ה-CTS‏ backup.

שימו לב: למרות שהכלי להכנת הנתונים פועל לפני המודול, הוא פועל אחרי כל הכלים לבדיקת סטטוס המערכת.