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

השתמש בקונסולת CTS v2

עבור אנדרואיד 7.0 ומעלה, השתמש ב-CTS v2.

בחר תוכניות

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

  • cts - מפעיל CTS מהתקנה קיימת של CTS.
  • cts-camera - מפעיל את מצלמת CTS מהתקנה קיימת של CTS.
  • cts-java - מפעיל בדיקות Core Java מהתקנת CTS קיימת מראש.
  • cts-pdk - מפעיל בדיקות שימושיות באימות מבנה היתוך PDK.
  • הכל - תצורה נפוצה עבור חבילות תאימות.

תצורות זמינות אחרות כוללות את הדברים הבאים:

  • בסיסי-כתבים - תצורה עם כתבי CTS בסיסיים.
  • collect-tests-only - מפעיל CTS מהתקנה קיימת של CTS.
  • common-compatibility-config - תצורה משותפת עבור חבילות תאימות.
  • cts-filtered-sample - תצורה נפוצה עבור חבילות תאימות.
  • cts-known-failures - תצורה עם כשלים ידועים של CTS.
  • cts-preconditions - תצורות CTS preconditions.
  • מארח — מפעיל בדיקה אחת מבוססת מארח במכשיר קיים.
  • מכשיר - מפעיל בדיקת מכשור אנדרואיד אחת במכשיר קיים.
  • native-benchmark - מפעיל מבחן מאמץ מקורי במכשיר קיים.
  • native-stress - מפעיל מבחן מאמץ מקורי במכשיר קיים.
  • טעינה מחדש - בדיקה מזויפת שמחכה למכשירים שכמעט פרקו ומחזיקה אותם לטעינה.
  • 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

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

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

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

run cts-instant

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

run cts --module-parameter INSTANT_APP

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

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

באנדרואיד 10, הפעל את מודול הבדיקה או המודולים שצוינו CTS-Instant.

run retry

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

run cts --retry אינו מותר עבור Android 9 ואילך.

run cts-sim

עבור אנדרואיד 11 ומעלה. מפעיל את תת-קבוצת הבדיקות במכשיר עם כרטיס SIM.

--device-token

עבור אנדרואיד 8.1 ומטה. מציין שלמכשיר נתון יש את האסימון הנתון. לדוגמה, --device-token 1a2b3c4d:sim-card .

--enable-token-sharding

עבור אנדרואיד 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 עבור אנדרואיד 8.1 או גרסאות נמוכות יותר . רסיס CTS למספר נתון של נתחים עצמאיים, כדי להפעיל על מספר מכשירים במקביל.
--shard-count number_of_shards עבור אנדרואיד 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 רשום פקודות 'הפעלה' המופעלות כעת במכשירים.
list commands רשום את כל הפקודות 'הפעלה' שנמצאות כעת בתור הממתינות להקצאה למכשירים.
list results רשימת תוצאות CTS המאוחסנות כעת במאגר.
list devices רשום את המכשירים המחוברים כעת ואת מצבם.

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

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

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

מזבלה תיאור
dump logs זרוק את יומני המסחר המוזנים עבור כל הפניות הפועלות.
לְהוֹסִיף תיאור
add subplan --name/-n subplan_name
--result-type
[pass | fail | timeout | notExecuted]
[--session session_id ]
צור תוכנית משנה הנגזרת מההפעלה הקודמת; אפשרות זו יוצרת תוכנית משנה שניתן להשתמש בה להפעלת תת-קבוצת בדיקות.

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