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

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

ממשק בסיס

הממשק הבסיסי הוא 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, זוהי הגדרה ברמה העליונה לבדיקות של הכלי לבדיקת תאימות ל-Android (CTS).

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

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

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