בדף הזה נסביר איך לכתוב בדיקת מעטפת. אם אפשר לבצע בדיקה באמצעות סקריפט מעטפת, אפשר להריץ אותה באמצעות ExecutableHostTest. ExecutableHostTest תומך בסינון בדיקות ובחלוקה של בדיקות למחיצות (sharding).
כתיבת בדיקת מעטפת
סקריפט המעטפת הראשי פועל במארח. קודם צריך לדחוף למכשיר סקריפטים או קבצים בינאריים אחרים להרצה במכשיר ואת קובצי הנתונים הנדרשים.
אפשר לעשות זאת כחלק מהסקריפט הראשי או באמצעות PushFilePreparer.
אם לבדיקה יש מודולים בינאריים של המכשיר שצריך להתקין לצד הבדיקה, צריך לציין אותם באמצעות המאפיין data_device_bins.
sh_test {
name: "module-name",
...
data_device_bins: ["target-name"],
}
בדיקת המעטפת ziptool-tests היא דוגמה לכך.
תוצאת הבדיקה של כל בדיקה מבוססת על סטטוס היציאה של הסקריפט הראשי.
הבדיקה יכולה לפוג אם צוין per-binary-timeout.
הגדרת בדיקת מעטפת
בהגדרת XML של Tradefed, בדיקות המעטפת מופעלות דרך ה-runner ExecutableHostTest.
<test class="com.android.tradefed.testtype.binary.ExecutableHostTest" >
<option name="binary" value="your-test-script.sh" />
<option name="relative-path-execution" value="true" />
<option name="per-binary-timeout" value="15m" />
</test>
מגדירים את הסקריפט הראשי של הבדיקה כערך של האפשרות binary. כדאי לבדוק אפשרויות אחרות של ExecutableHostTest.
אם הסקריפט דורש הרשאת root, מוסיפים את RootTargetPreparer להגדרה.