הפעלת בדיקות CTS אוטומטיות (Android מגרסה 11 ואילך)

יש שתי אפשרויות להרצת בדיקות אוטומטיות של CTS:

  • Trade Federation היא מסגרת לאפליקציות ולבדיקות שמאפשרת להריץ בדיקות משורת הפקודה. באופן בסיסי, המסגרת מאפשרת להוסיף הערות לבדיקות באמצעות ההערה @Test, והאפליקציה מאתרת את הבדיקות האלה ומריצה אותן.

  • OmniLab Android Test Station היא אפליקציה שמאפשרת להריץ בדיקות בממשק משתמש גרפי.

בדף הזה מוסבר איך להריץ בדיקות אוטומטיות באמצעות Trade Federation. להוראות להרצת בדיקות באמצעות OmniLab Android Test Harness, ראו OmniLab Android Test Station.

הפעלת כל בדיקות CTS האוטומטיות

Trade Federation מכיל את מסוף CTS, ממשק שורת פקודה להרצת בדיקות. כדי להריץ את כל חבילת הבדיקות האוטומטיות של CTS:

  1. חשוב לוודא שפעלתם לפי ההוראות במאמר הגדרת בדיקות אוטומטיות של CTS.
  2. בתחנת העבודה לבדיקה, מריצים את הסקריפט cts-tradefed מהתיקייה שבה חבילה CTS נפתחה:

    ./android-cts/tools/cts-tradefed
    

    במסוף CTS מוצג סמן כדי להקליד פקודות CTS (cts-tradefed >).

  3. תוכנית הבדיקה cts מכילה את כל בדיקות CTS האוטומטיות. מריצים את הפקודה הבאה כדי להריץ את תוכנית הבדיקה cts:

    run cts
    

    מתבצעות הבדיקות האוטומטיות של CTS. חשוב לזכור:

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

    • בכל פעם שמריצים את CTS, מקישים על ctrl+c כדי לעצור את מסוף CTS הקיים ואז מפעילים מחדש את מסוף CTS.

    • אי אפשר להריץ כמה גרסאות של CTS במארח יחיד, כי כל אחת מהן נפתחת עם שרת קיים של קוד מיקום פתוח (OLC).

  4. צפייה בתוצאות הבדיקה. מידע נוסף זמין במאמר פירוש תוצאות CTS.

  5. אם זו הפעם הראשונה שאתם מריצים את הבדיקה, יכול להיות שחלק מהבדיקות ייכשלו בגלל בעיות שלא בשליטתכם. לדוגמה, יכול להיות שהחיבור לרשת איטי או שעוצמת האות של ה-GPS חלשה. מריצים מחדש (מנסים שוב) את הבדיקות עד שכל המודולים של הבדיקות יושלמו ומספרי הכשל בבדיקה זהים בין שתי סשנים האחרונים של הניסיון החוזר:

    run retry --retry session_number`
    
  6. אם הבדיקות נכשלות באופן עקבי בניסיונות חוזרים, כדאי להתמקד בניפוי באגים של שאר הבדיקות שנכשלו. למידע על פתרון בעיות בתוצאות בדיקות, תוכלו לקרוא את המאמרים טיפול ראשוני בשגיאות בבדיקה ופתרון בעיות בבדיקות CTS.

הפעלת CTS במכשירים עם מסכים מרובים

אם במכשיר שלכם מותקנת מערכת Android מגרסה 11 או 12, ויש לו כמה מסכים, עליכם להריץ את תוכנית הבדיקה cts-foldable בנפרד:

run cts-foldable

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

הרצת בדיקות במספר מכשירים

מריצים את הפקודה הבאה כדי להריץ את תוכנית הבדיקה cts-multidevice:

run cts-multidevice

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

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

  1. מריצים את הפקודה list modules כדי לזהות את שם תוכנית הבדיקה שרוצים להריץ.

  2. מריצים את תוכנית הבדיקה:

    run cts --plan test_module_or_plan_name
    

שיפור זמן ביצוע הבדיקה

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

כדי לפצל בדיקות ב-Android מגרסה 11 ואילך, מריצים את הפקודה:

run cts --shard-count number_of_shards

בנוסף, לפני שמריצים את הבדיקות לאימות, אפשר לשפר את זמן הביצוע של הבדיקות באמצעות הפקודה run cts-dev של CTS. הפקודה הזו מדלגת על התנאים המוקדמים, על איסוף פרטי המכשיר ועל כל בודקי סטטוס המערכת. בנוסף, הבדיקה מתבצעת רק ב-ABI אחד.