השלם מבחני רכב בקופסה

Complete Automotive Tests in a Box (CATBox) היא חבילת קוד פתוח המספקת את המסגרות והכלים הנדרשים לייעול וביצוע בדיקות רכב עם תצורה מינימלית. CATBox ניתן להרחבה ותואם לכלים, לתשתית ולבדיקות שבהם אתה משתמש כדי לבדוק ולאמת את יישומי מערכת ההפעלה Android Automotive (AAOS) שלך. כתוצאה מכך, אתה יכול לספק מוצרים באיכות גבוהה לשוק.

עיצוב ויישום CATBox

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

התמונה הבאה ממחישה עיצוב ברמה גבוהה של חבילת CATBox.

איור 1. חבילת CATBox

Tradefed

Tradefed היא מסגרת בדיקה מתמשכת בקוד פתוח המשמשת לביצוע בדיקות במכשירי אנדרואיד. לפרטים, ראה סקירה כללית של הפדרציה המסחרית .

מסגרת בדיקת רכב

CATBox מבוסס על מסגרת בדיקה לרכב בשם Spectatio, המספקת ממשקי API לבדיקת יישומים שונים במכשירי רכב. הוא בנוי על גבי UI Automator , מסגרת לבדיקות קוד פתוח, המספקת סט של ממשקי API לבניית מבחני ממשק משתמש המקיימים אינטראקציה עם יישומי משתמשים ומערכת.

הורדות של חבילת בדיקות CATBox

אנדרואיד 12

אנדרואיד 12 היא ההשקה של אבן הדרך לפיתוח בשם הקוד S. השתמש בקישורים הבאים כדי להוריד חבילות בדיקה CATBox עבור אנדרואיד 12:

• אנדרואיד 12 (arm64)
• Android 12 (x86_64)

אנדרואיד 11

אנדרואיד 11 היא השחרור של אבן הדרך לפיתוח בשם הקוד R. השתמש בקישורים הבאים כדי להוריד חבילות בדיקה CATBox עבור אנדרואיד 11:

• אנדרואיד 11 (arm64)
• Android 11 (x86_64)

בניית CATBox

השתמש בפקודת ה- catbox build ברגע שקוד ה-AOSP של Android זמין בתחנת העבודה המקומית. כדי לבנות את חבילת CATBox באופן מקומי:

1. בחר Device Target והפעל את הפקודה הבאה:

   # Select Device Target Based on Device Architecture
   $ lunch <target>
   

2. כדי לבנות CATBox, הפעל את הפקודה הבאה:

   # Build CATBox
   $ make catbox
   

   פקודה זו יוצרת את הקובץ android-catbox.zip בספריית /out/host/linux-x86/catbox , אשר לאחר מכן ניתן להשתמש בה להפעלת בדיקות.

הגדרת סביבה

הגדרת הסביבה הנדרשת לביצוע בדיקות CATBox דומה להגדרת CTS . כדי להגדיר את הסביבה, השלם כל אחת מהמשימות הבאות:

• התקן את ADB ו-AAPT .
• התקן JDK. ראה ערכת פיתוח Java עבור אובונטו.
• הגדל את מגבלת הזיכרון. ראה דרישות אחסון .

הגדרה וביצוע של CATBox

השתמש במסגרת הבדיקה של Tradefed כדי להפעיל את הבדיקות במכשירי אנדרואיד. לפני הגדרת CATBox, הכר את סקירת הפדרציה הסחר .

כדי להגדיר ולהפעיל CATBox, עיין בסעיפים למטה.

הגדרת מכשיר

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

1. ודא שהתקנת את הגרסאות האחרונות של Android Debug Bridge (adb) וגם של Android Asset Packaging Tool (AAPT) , וכן הוספת את המיקום של כלים אלה לנתיב המערכת של המחשב שלך. לפרטים, ראה ADB ו-AAPT .

2. חבר לפחות מכשיר אחד והכן את ההתקן בבדיקה (DUT) באופן הבא:

   1. כדי לאפס את מכשיר הרכב להגדרות היצרן, לחץ על הגדרות > מערכת > אפשרויות איפוס > מחק את כל הנתונים .
   2. המתן עד שהמכשיר יופעל מחדש באופן אוטומטי.

   3. ודא ש-adb מופעל. כדי לוודא שהמכשיר זמין, הפעל את הפקודה הבאה:

      $ adb devices
      

   4. כדי להפעיל את השורש, הפעל את הפקודה הבאה:

      # Enable Root
      $ adb -s DEVICE_SERIAL root
      

      החלף את DEVICE_SERIAL במזהה הטורי של מכשיר הרכב.

   5. התחבר ל-Wi-Fi.

חלץ את חבילת CATBox

לאחר השלמת הגדרת המכשיר, פתח את חבילת CATBox ועבור לתיקיה שחולצה:

# Extract the CATBox Package
$ unzip android-catbox.zip

# Navigate to extracted CATBox Package
$ cd android-catbox

בצע בדיקות ב-CATBox

כדי להפעיל CATBox עם תוכניות הבדיקה בחבילת CATBox, הפעל את הפעולות הבאות:

./tools/catbox-tradefed run commandAndExit TEST_PLAN_NAME --serial DEVICE_SERIAL

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

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

./tools/catbox-tradefed list plans | grep -i catbox

הטבלה הבאה מציגה תוכניות בדיקה זמינות לפי סוג:

סוג בדיקה	שֵׁם
תוכניות בדיקה פונקציונליות	catbox-functional-notification catbox-functional-setting catbox-functional-dial catbox-functional-system-setting catbox-functional-app-info-setting catbox-functional-network-setting catbox-functional-security-setting catbox-functional-sound-setting catbox-functional-date-time-setting catbox-functional-appgrid catbox-functional-home catbox-functional-lock-screen catbox-functional-navigation-bar catbox-functional-ux-restriction catbox-functional-bluetooth-audio
תוכניות לבדיקת ביצועים	catbox-performance-cold-app-start-up-settings catbox-performance-hot-app-start-up-settings catbox-performance-jank-settings catbox-performance-cold-app-start-up-dialer catbox-performance-hot-app-start-up-dialer catbox-performance-jank-contact-list catbox-performance-jank-notifications catbox-performance-jank-appgrid catbox-performance-cold-app-start-up-mediacenter catbox-performance-hot-app-start-up-mediacenter catbox-performance-create-and-switch-to-new-guest catbox-performance-create-and-switch-to-new-user catbox-performance-create-and-switch-to-precreated-guest catbox-performance-create-and-switch-to-precreated-user catbox-performance-switch-to-existing-user

תוצאות בדיקת CATBox

תוצאות הבדיקה נשמרות בתיקייה android-catbox/results/latest עבור ביצוע בדיקות פונקציונליות וביצועים כאחד.

• לתוצאות הבדיקה, עיין ב- test_result.xml .
• לפרטים על בדיקות כשל, ראה test_result_failures_suite.html .
• לתוצאות מדדי ביצועים, ראה CatboxPerformanceTests.reportlog.json report-log-files .

יומנים נשמרים בנתיב android-catbox/logs/latest עבור ביצוע בדיקות פונקציונליות וביצועים כאחד.

בדיקות מסוימות, כגון חיוג, אודיו בלוטות', ומבחני ג'אנק של רשימת אנשי קשר דורשות הגדרת מכשיר נוספת.

בדיקת חיוג

בדיקת החיוג דורשת הגדרת מכשיר ופרמטרים של זמן ריצה. כדי להגדיר את המכשיר:

1. חבר את המכשיר הנייד ליחידת הראש של הרכב באמצעות Bluetooth.
2. ודא שטלפון הבדיקה מכיל כרטיס SIM להפעלת בדיקות חיוג ומחובר לרשת הסלולרית.
3. בדיקות חיוג משתמשות ברירת המחדל של אנשי קשר המאוחסנים בטלפון. השתמש ב- contacts.vcf כדי לטעון אנשי קשר בטלפון.

4. החלף את ה- COMPANION_SERIAL במזהה הטורי של הטלפון והפעל את הפקודות הבאות:

   # Contacts can be loaded on the phone by pushing the contacts.vcf file on
   the phone and importing it in the Contacts application.
   
   OR
   
   # Importing contacts using adb.
   
   # Push contacts VCF file to phone
   
   $ adb -s COMPANION_SERIAL push <path-to-downloaded-contacts-vcf-file> /storage/emulated/0/Android/data/com.google.android.contacts/contacts.vcf
   
   # Grant Read Permissions
   
   $ adb -s COMPANION_SERIAL shell pm grant com.google.android.contacts
   android.permission.READ_EXTERNAL_STORAGE
   
   # Import contacts from the VCF file
   
   $ adb -s COMPANION_SERIAL shell am start-activity -W -t 'text/x-vcard' -d file:///storage/emulated/0/Android/data/com.google.android.contacts/contacts.vcf
   -a android.intent.action.VIEW com.google.android.contacts
   
   # Then accept the prompts on the UI to load the contacts.
   

פרמטרים של זמן ריצה

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

Parameters for Large Phone Number:
--module-arg AndroidAutomotiveDialTests:instrumentation-arg:large-phone-number:=< 10 digit phone number>

Parameters for Small Phone Number:
--module-arg AndroidAutomotiveDialTests:instrumentation-arg:small-phone-number:=< 3 digit phone number>

Parameters for Search Contact Name:
--module-arg AndroidAutomotiveDialTests:instrumentation-arg:search-contact-name:=< some contact name stored on the phone >

Parameters for Search Contact Number:
--module-arg AndroidAutomotiveDialTests:instrumentation-arg:search-contact-number:=< contact number of the name provided in the search contact name >

בדיקת שמע בלוטות'

כדי להגדיר מכשיר לבדיקת אודיו Bluetooth:

1. ודא שאפליקציית YouTube Music מותקנת בטלפון ושנכנסת לחשבון. אם לא, התקן את האפליקציה והיכנס לחשבון.
2. התאם את הטלפון באופן ידני למכשיר הרכב באמצעות Bluetooth.
3. לאחר ההתאמה של הטלפון, הפעל שיר בטלפון ולאחר מכן התחל לבצע את הבדיקה.

מבחן ג'אנק רשימת אנשי קשר

כדי להגדיר מכשיר עבור מבחן הג'אנק של רשימת אנשי הקשר:

1. ודא שלטלפון יש מספר אנשי קשר כדי שהבדיקה תוכל לגלול ברשימת אנשי הקשר כדי לאסוף מדדי ג'אנק.
2. התאם את הטלפון באופן ידני למכשיר הרכב באמצעות Bluetooth.
3. לאחר שיוך הטלפון, ניתן לגשת לאנשי הקשר במכשיר.