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

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

ממשק הבסיס

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

ממשק נקי יותר

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

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

המלצות

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

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

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