מתכוננים ליעד

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

ממשק בסיס

הממשק הבסיסי הוא 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, שמגדיר את האופן שבו מערכת TradeFederal מפעילה את מודול ה-CTS backup.

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