הפעל בדיקות CTS

Trade Federation היא מסגרת בדיקה רציפה להפעלת בדיקות במכשירי אנדרואיד. כדי להפעיל את חבילת בדיקת התאימות (CTS), קרא תחילה את סקירת הפדרציה המסחרית לקבלת הסבר על מסגרת הבדיקה של Tradefed.

כדי להפעיל תוכנית בדיקה:

1. הגדר מכשירים בבדיקה (DUTs) לפי הגדרת מכשיר אנדרואיד .
2. ודא שהתקנת את הגרסאות האחרונות של Android Debug Bridge (adb) ושל Android Asset Packaging Tool (AAPT) והוספת את המיקום של כלים אלה לנתיב המערכת של המחשב שלך. למידע על התקנת כלים אלה, ראה הגדרת CTS: ADB ו-AAPT.
3. הורד את רכיבי ה-CTS ששוחררו על גבי המחשב המארח של לינוקס שלך ופתח את ה-build למיקום המארח.
4. חבר לפחות מכשיר אחד. כדי להכין את ה-DUT:
   • לחץ על לחצן הבית כדי להגדיר את המכשיר למסך הבית.
   • אל תשתמש ב-DUT עבור כל משימות אחרות.
   • שמור את ה-DUT במצב נייח כדי למנוע הפעלת פעילות חיישן.
   • כוון את מצלמת המכשיר לעבר אובייקט שניתן למקד.
   • אל תלחץ על מקשים כלשהם במכשיר בזמן שה-CTS פועל. לחיצה על מקשים או נגיעה במסך של DUT מפריעה לבדיקות הריצה ועלולה להוביל לכשלים בבדיקה.

5. הפעל את הסקריפט CTS-tradefed של מסוף CTS מהתיקייה שבה נפתחה חבילת CTS. במעטפת שורת הפקודה של המארח, הרץ:

   ./android-cts/tools/cts-tradefed

6. הפעל את תוכנית הבדיקה המוגדרת כברירת מחדל (מכילה את כל חבילות הבדיקה):

   cts-tradefed > run cts

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

     • עבור אנדרואיד 9 ומעלה, השתמש באפשרות הפקודה

       --shard-count number_of_shards

     • עבור אנדרואיד 8.1 ומטה, השתמש באפשרות הפקודה

       --shards number_of_shards

   • אם אינך רוצה להפעיל את כל חבילת הבדיקה, תוכל להפעיל את תוכנית ה-CTS לבחירתך משורת הפקודה:

     run cts --plan test_plan_name

     כדי למצוא את שם תוכנית הבדיקה:

     • עבור אנדרואיד 7.0 ומעלה, כדי לראות רשימה של מודולי בדיקה, הזן

       list modules

     • עבור אנדרואיד 6.0 ומטה, כדי להציג רשימה של תוכניות בדיקה במאגר, הזן

       list plans

     • עבור אנדרואיד 6.0 ומטה, כדי להציג רשימה של חבילות בדיקה במאגר, הזן

       list packages

   • לאפשרויות פקודה נוספות בהתאם לגרסאות CTS, עיין בהפניה לפקודת המסוף , או תחת "עזרה לכולם" במסוף Tradefed.

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

   • עבור אנדרואיד 9 ומעלה, השתמש

     run retry --retry session_number --shard-count number_of_shards

   • עבור אנדרואיד 7.0–8.1, השתמש

     run cts --retry session_number --shards number_of_shards

   • לאפשרויות נוספות של נסה שוב בהתאם לגרסת CTS, ראה CTS v2 Command Console .

   • כדי להבין את פרטי ההטמעה עבור ניסיון חוזר של CTS, ראה ניסיון חוזר של Trade Federation Suite .

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

   • עבור אנדרואיד 11 ומעלה, אפשרות הפקודה הבאה של נסה שוב מופעלת כברירת מחדל בפקודת run cts :

     run retry --retry  --new-parameterized-handling

9. צפה בהתקדמות הבדיקה ובתוצאות המדווחות במסוף.

הפעל CTS באמצעות Android Test Station

Android Test Station הוא כלי אוטומציה של בדיקות שמפתחי אנדרואיד ומהנדסי בדיקה יכולים להשתמש בו כדי להשתמש בממשק משתמש להפעלת חבילות בדיקה סטנדרטיות. זה עובד עם חבילת בדיקת התאימות של אנדרואיד (CTS) .

הכלי זמין לציבור דרך ATS User Guide , והקוד שלו הוא בקוד פתוח ב-AOSP ( multitest_transport , tradefed_cluster ).

הפעל CTS עבור מצבים חלופיים

מהדורת CTS 10 R4 מוסיפה תוכנית בדיקה עבור מכשירים עם מצבים חלופיים, או עבור מכשירים עם יותר ממסך אחד. בצע את תוכנית הבדיקה של המצבים החלופיים באמצעות run cts-foldable .

מקרי בדיקה שעברו או נכשלו עבור מצב מסך חלופי מצורפים לערך מ- display_mode , לדוגמה, testcase1[display_mode=0] .

ב-CTS 13, ה-API של DeviceStateManager מאפשר להפעיל מודולי בדיקה עם אפשרות התצורה הבאה במצבי התקן שונים של התקן מתקפל. ביצוע הבדיקה הוא אוטומטי ב-CTS בהתבסס על מצבי קיפול התצוגה המוגדרים במכשיר ללא צורך בהפעלת תוכנית הבדיקה cts-foldable .

<option name="config-descriptor:metadata" key="parameter" value="all_foldable_states" />

בדיקות ריבוי מכשירים ב-CTS

אנדרואיד 13 ואילך תומך בבדיקות ריבוי מכשירים. בדיקות הדורשות התקנים מרובים מבוצעות אוטומטית במהלך ריצת ה-CTS. CTS 13 כולל כמה בדיקות מרובות התקנים המופעלות אוטומטית כאשר נעשה שימוש בריסוק. בעוד שבדיקה אינה דורשת שינויים נוספים בהגדרה הפיזית, יש להתקין virtualenv כדי שהבדיקות יפעלו כהלכה. לפרטים, ראה סוויטות מרובות מכשירים .

הפעל בדיקות מרובות מכשירים

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

  cts-tradefed > run cts-multidevice
  

כל האפשרויות הרגילות נתמכות. כדי למקד למכשירים ספציפיים, הוסף --serial <serial1> --serial <serial2> וכן הלאה עבור מספר המכשירים הממוקדים.

כדי להפעיל בדיקות ריבוי מכשירים באופן אוטומטי, השתמש ב-sharding, כמו ב-- --shard-count 2 .