Trade Federation היא מסגרת בדיקה רציפה להפעלת בדיקות במכשירי אנדרואיד. כדי להפעיל את חבילת בדיקת התאימות (CTS), קרא תחילה את סקירת הפדרציה המסחרית לקבלת הסבר על מסגרת הבדיקה של Tradefed.
כדי להפעיל תוכנית בדיקה:
- הגדר מכשירים בבדיקה (DUTs) לפי הגדרת מכשיר אנדרואיד .
- ודא שהתקנת את הגרסאות האחרונות של Android Debug Bridge (adb) ושל Android Asset Packaging Tool (AAPT) והוספת את המיקום של כלים אלה לנתיב המערכת של המחשב שלך. למידע על התקנת כלים אלה, ראה הגדרת CTS: ADB ו-AAPT.
- הורד את רכיבי ה-CTS ששוחררו על גבי המחשב המארח של לינוקס שלך ופתח את ה-build למיקום המארח.
- חבר לפחות מכשיר אחד. כדי להכין את ה-DUT:
- לחץ על לחצן הבית כדי להגדיר את המכשיר למסך הבית.
- אל תשתמש ב-DUT עבור כל משימות אחרות.
- שמור את ה-DUT במצב נייח כדי למנוע הפעלת פעילות חיישן.
- כוון את מצלמת המכשיר לעבר אובייקט שניתן למקד.
- אל תלחץ על מקשים כלשהם במכשיר בזמן שה-CTS פועל. לחיצה על מקשים או נגיעה במסך של DUT מפריעה לבדיקות הריצה ועלולה להוביל לכשלים בבדיקה.
הפעל את הסקריפט CTS-tradefed של מסוף CTS מהתיקייה שבה נפתחה חבילת CTS. במעטפת שורת הפקודה של המארח, הרץ:
./android-cts/tools/cts-tradefed
הפעל את תוכנית הבדיקה המוגדרת כברירת מחדל (מכילה את כל חבילות הבדיקה):
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.
הפעל מספר הפעלות של ניסיון חוזר עד להשלמת כל מודולי הבדיקה ומספרי הכישלון בבדיקה זהים בשני הפעלות הנסיונות החוזרות האחרונות.
עבור אנדרואיד 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 .
הפעל הפעלת ניסיון חוזר רק במבחנים שנכשלו. מבחנים שעברו פרמטרים לא מנוסים שוב.
עבור אנדרואיד 11 ומעלה, אפשרות הפקודה הבאה של נסה שוב מופעלת כברירת מחדל בפקודת
run cts
:run retry --retry
--new-parameterized-handling
צפה בהתקדמות הבדיקה ובתוצאות המדווחות במסוף.
הפעל 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
.