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

הפונקציה 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.

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