שימוש חוזר בחבילה

בדרך כלל חבילה כוללת כמה מודולים של בדיקות, והיא יכולה להגיע לגודל גדול למדי של מאגר בדיקות. לדוגמה, חבילת בדיקות התאימות של Android‏ (CTS) כוללת מאות מודולים ומאות אלפי תרחישי בדיקה.

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

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

הטמעת ניסיון חוזר של החבילה

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

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

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

דוגמה לניסיון חוזר של חבילה: CTS

הגדרת הניסיון החוזר ב-CTS היא:

<configuration description="Runs a retry of a previous CTS session.">
    <object type="previous_loader" class="com.android.compatibility.common.tradefed.result.suite.PreviousResultLoader" />
    <test class="com.android.tradefed.testtype.suite.retry.RetryRescheduler" />

    <logger class="com.android.tradefed.log.FileLogger">
        <option name="log-level-display" value="WARN" />
    </logger>
</configuration>

הכלל הזה רלוונטי לרוב החבילות שמרחיבות אותו, למשל VTS.

הוא יופעל באמצעות:

cts-tradefed run retry --retry <session>

כדי למצוא את הסשן, עליכם לרשום את התוצאות הקודמות במסוף CTS:

cts-tf > l r
Session  Pass  Fail  Modules Complete  Result Directory     Test Plan  Device serial(s)  Build ID   Product
0        2092  30    148 of 999        2018.10.29_14.12.57  cts        [serial]          P          Pixel

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

לדוגמה:

cts-tradefed run cts-dev -m CtsGestureTestCases

הניסיון החוזר של הפקודה שלמעלה תמיד מוגדר ל-CtsGestureTestCases כי אנחנו מנסים שוב פקודה שכוללת רק אותו.

הגדרת ניסיון חוזר לחבילה בסגנון CTS

כדי שניתן יהיה לנסות שוב, צריך לייצא את התוצאות הקודמות בפורמט proto. צריך להוסיף את הפריטים הבאים:

<result_reporter class="com.android.compatibility.common.tradefed.result.suite.CompatibilityProtoResultReporter" />

צריך להוסיף את זה להגדרת ה-XML של הפקודה הראשית, וכתוצאה מכך נוצר קובץ test-record.pb בתיקיית התוצאה.

לאחר מכן, הניסיון החוזר של CTS טוען נתונים משילוב של test-record.pb ושל test_result.xml הקיים כדי להכין את ההפעלה החוזרת.