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

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

ממשק בסיס

הממשק הבסיסי הוא 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.

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