מסוף פקודות CTS v2

שימוש במסוף CTS v2

ל-Android 7.0 ואילך, יש להשתמש ב-CTS גרסה 2.

בחירת תוכניות

תוכניות הבדיקה הזמינות כוללות:

  • cts – מפעיל CTS מהתקנת CTS קיימת.
  • cts-camera — מפעיל את מצלמת CTS מהתקנה קיימת של CTS.
  • cts-Java — מריץ בדיקות ליבה של Java מהתקנת CTS קיימת.
  • cts-pdk – הרצת בדיקות שימושיות לאימות גרסת ה-PDK של פיוז'ן.
  • הכול – הגדרה נפוצה של חבילות תאימות.

אלה ההגדרות שזמינות לכם:

  • Basic-reporters – הגדרה באמצעות דיווחים בסיסיים של CTS.
  • collect-tests-only – מפעילה CTS מהתקנת CTS קיימת.
  • common-compatibility-config – הגדרה נפוצה של חבילות תאימות.
  • cts-filtered-sample – הגדרה נפוצה של חבילות תאימות.
  • cts-known-failures – הגדרה עם כשלים ידועים ב-CTS.
  • cts-preconditions – הגדרות של תנאי מוקדם של CTS.
  • host – מריץ בדיקה אחת המבוססת על המארח במכשיר קיים.
  • instrument – מריץ בדיקה אחת של הגדרת אינסטרומנטציה של Android במכשיר קיים.
  • Native-benchmark – מריץ בדיקת מתח מובנית במכשיר קיים.
  • native-stream – מריץ בדיקת מתח מובנית במכשיר קיים.
  • reload – בדיקה מזויפת שממתינה למכשירים שכמעט הריקו אותם ושומרת אותם לצורך טעינה.
  • testdef – הרצת בדיקות שכלולות בקובצי test_def.xml במכשיר קיים.
  • util/wifi – הגדרות שירות להגדרת Wi-Fi במכשיר.
  • util/Wipe – איפוס של נתוני המשתמש במכשיר.

את כל התוכניות וההגדרות האלה אפשר לבצע באמצעות הפקודה run cts.

מסמך עזר בנושא פקודות במסוף CTS v2

טבלה זו מסכמת את פקודות המסוף של CTS v2 עבור לשימושים שונים.

מארח תיאור
help הצגת סיכום של הפקודות הנפוצות ביותר
help all הצגת הרשימה המלאה של הפקודות הזמינות
version מציגים את הגרסה.
exit צא בחינות ממסוף ה-CTS. המסוף נסגר אחרי כל הפעולות הבדיקות שפועלות כרגע הסתיימו.
extdir

קובץ ההורדות הדחוס דחוס ל-extdir. אם רוצים כדי להסיר את הפלט המנופח, משתמשים באפשרות -q:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

אם אתם רוצים לפרוס את קובץ ה-ZIP לספרייה הנוכחית, אל תשתמשו באפשרות -d. פשוט להריץ:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip
ריצה תיאור
run cts

ב-Android 10, מפעילים את תוכנית CTS המוגדרת כברירת מחדל ואת CTS-Instant יחד (כלומר, ההפעלה המלאה של ה-CTS). ב-Android 9 ומטה, מריצים את ברירת המחדל תוכנית CTS בלבד. שימוש באפשרות המקיפה הזו (כולל תנאים מוקדמים) לאימות מכשיר. מידע על הכללות זמין בקובץ cts.xml.

מסוף ה-CTS יכול לקבל פקודות אחרות בזמן שהבדיקות מתבצעות.

אם אין מכשירים מחוברים, המחשב (או המארח) של CTS ימתין למכשיר יחובר לפני שמתחילים בבדיקות. אם יותר מאישור אחד המכשיר מחובר, מארח ה-CTS יבחר מכשיר באופן אוטומטי.

run cts-instant

ב-Android 9, מפעילים את תוכנית ברירת המחדל CTS-Instant.

run cts --module-parameter INSTANT_APP

ב-Android 10, מפעילים את תוכנית ברירת המחדל CTS-Instant.

run cts --module-parameter INSTANT_APP --module/-m test_module_name

ב-Android 10, מריצים את מודול הבדיקה CTS-Instant שצוין או מודולים.
run retry

ל-Android מגרסה 9 ואילך בלבד. ניסיון חוזר של כל הבדיקות שנכשלו או לא בוצעו מהסשנים הקודמים. לדוגמה, run retry --retry -s או run retry --retry --shard-count עם פיצול לפי TF.

run cts --retry לא מותרת ב-Android מגרסה 9 ואילך.
run cts-sim

ל-Android מגרסה 11 ואילך. מריצה את קבוצת המשנה של בדיקות המכשיר עם כרטיס SIM.
--device-token

ל-Android מגרסה 8.1 ומטה. מציינת שמכשיר נתון ב-Assistant. לדוגמה: --device-token 1a2b3c4d:sim-card.
--enable-token-sharding

ל-Android מגרסה 10 ואילך בלבד. אוטומטית תואם לבדיקה נדרש סוג כרטיס ה-SIM המתאים. אין צורך לספק את המספר הסידורי של המכשיר כדי להפעיל מקרי בדיקה שקשורים ל-SIM. כרטיסי SIM נתמכים: SIM_CARD, UICC_SIM_CARD, ו-SECURE_ELEMENT_SIM_CARD.

run cts-dev

מריצים את תוכנית CTS המוגדרת כברירת מחדל (כלומר, את ההפעלה המלאה של CTS), אבל דילוג על התנאים המוקדמים כדי לחסוך זמן ריצה לפיתוח איטרטיבי של לבדיקה. ההגדרה הזו עוקפת את האימות וההגדרה של המכשיר הגדרות אישיות, כמו דחיפת קובצי מדיה או בדיקה אם יש חיבור Wi-Fi חיבור, כפי שמתבצע כאשר משתמשים באפשרות --skip-preconditions. הזה הפקודה גם מדלגת על איסוף מידע על המכשיר ועל כל בודקי הסטטוס של המערכת. כמו כן מפעילה את הבדיקות ב-ABI אחד בלבד. לצורך אימות מכשירים, יש להימנע מהאופטימיזציה הזו כוללים את כל התנאים המוקדמים והבדיקות. צפייה cts-dev.xml להחרגות.

מסוף ה-CTS יכול לקבל פקודות אחרות בזמן שהבדיקות מתבצעות.

אם אין מכשירים מחוברים, המחשב (או המארח) של CTS ימתין למכשיר יחובר לפני שמתחילים בבדיקות. אם יותר מאישור אחד המכשיר מחובר, מארח ה-CTS יבחר מכשיר באופן אוטומטי.
--subplan subplan_name הפעלת תוכנית המשנה שצוינה.
--module/-m test_module_name --test/-t test_name  הריצו את המודול שצוין ובדקו. לדוגמה, run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes מפעיל את החבילה, המחלקה או הבדיקה הספציפיים.
--retry ניסיון חוזר של כל הבדיקות שנכשלו או שלא בוצעו מהסשנים הקודמים. צריך להשתמש בפונקציה list results כדי לקבל את מזהה הסשן.
--retry-type NOT_EXECUTED יש לנסות שוב רק בדיקות שלא בוצעו מהסשנים הקודמים. צריך להשתמש בפונקציה list results כדי לקבל את מזהה הסשן.
--shards number_of_shards ל-Android מגרסה 8.1 ומטה. פיצול CTS להיתקל במספר נתון של מקטעי נתונים עצמאיים, כדי לפעול בכמה מכשירים במקביל.
--shard-count number_of_shards ל-Android 9. פיצול של CTS רציף במספר נתון של מקטעים עצמאיים, כדי שיפעלו בכמה מכשירים במקביל.
--serial/-s deviceID הרצת CTS במכשיר הספציפי.
--include-filter "test_module_name test_name" צריך להריץ עם המודולים שצוינו או לבדוק חבילות, מחלקות ובקשות תמיכה. לדוגמה, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" כולל את המודול שצוין.

האפשרות של הפקודה הזו לא נתמכת במהלך הניסיון החוזר.
--exclude-filter "test_module_name test_name" מחריגים מההרצה את המודולים שצוינו או את החבילות, המחלקות והבקשות לבדיקה. לדוגמה, run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" לא כוללת את המודול שצוין.
--log-level-display/-l log_level הפעל את רמת היומן המינימלית שצוינה עבור STDOUT. הערכים התקפים: [VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT].
--abi abi_name לאלץ את הבדיקה לרוץ ב-ABI הנתון ב-32 או ב-64. כברירת מחדל, CTS מריצה בדיקה פעם אחת לכל ממשק ABI שהמכשיר תומך בו.
--logcat-on-failure,
--bugreport-on-failure,
--screenshoot-on-failure		 תצוגה מפורטת יותר של כשלים יכולה לעזור באבחון.
--device-token מציינת שלמכשיר מסוים יש את האסימון הנתון, למשל --device-token 1a2b3c4d:sim-card.
--skip-device-info מדלג על איסוף מידע על המכשיר.
--skip-preconditions דילוג על התנאים המוקדמים כדי לחסוך זמן ריצה לפיתוח איטרטיבי של בדיקה חדשה. ההגדרה הזו עוקפת את האימות וההגדרה של המכשיר הגדרות אישיות, כמו דחיפת קובצי מדיה או בדיקה אם יש חיבור Wi-Fi חיבור כזה.
רשימה תיאור
list modules להציג את כל המודולים לבדיקה שזמינים במאגר.
list plans או list configs הצגת רשימה של כל תוכניות הבדיקה (הגדרות) הזמינות במאגר.
list subplans הצגת רשימה של כל תוכניות המשנה הזמינות במאגר.
list invocations הצגת רשימה של פקודות run שמבוצעות כרגע במכשירים.
list commands הצגת רשימה של כל פקודות run שנמצאות כרגע בתור שבהמתנה להקצאה למכשירים.
list results הצגת רשימה של תוצאות CTS שמאוחסנות כרגע במאגר.
list devices הצגת רשימה של המכשירים שמחוברים עכשיו והמצב שלהם.

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

מכשירים לא זמינים הם מכשירים שניתן לראות דרך adb, אבל לא מגיבים ל-adb ולא יוקצו לבדיקות.

מכשירים מוקצים הם מכשירים שמריצים כרגע בדיקות.
Dump תיאור
dump logs מוחקים את היומנים שאוחדו לכל ההפעלות הפעילות.
הוספה תיאור
add subplan --name/-n subplan_name
--result-type
[passed | failed | not_executed]
[--session session_id]		 ליצור תוכנית משנה שנגזרת מסשן קודם. האפשרות הזאת יוצרת תוכנית משנה שאפשר להשתמש בה כדי להריץ קבוצת משנה של בדיקות.

היחיד האפשרות הנדרשת היא --session. תוספים אחרים הם אופציונליים, אבל אם כלול, חייב לבוא ערך. אפשר לחזור על האפשרות --result-type; לדוגמה הערך add subplan --session 0 --result-type passed --result-type failed תקין.