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:
אנדרואיד 11
אנדרואיד 11 היא השחרור של אבן הדרך לפיתוח בשם הקוד R. השתמש בקישורים הבאים כדי להוריד חבילות בדיקה CATBox עבור אנדרואיד 11:
בניית CATBox
השתמש בפקודת ה- catbox
build ברגע שקוד ה-AOSP של Android זמין בתחנת העבודה המקומית. כדי לבנות את חבילת CATBox באופן מקומי:
בחר Device Target והפעל את הפקודה הבאה:
# Select Device Target Based on Device Architecture $ lunch <target>
כדי לבנות CATBox, הפעל את הפקודה הבאה:
# Build CATBox $ make catbox
פקודה זו יוצרת את הקובץ
android-catbox.zip
בספריית/out/host/linux-x86/catbox
, אשר לאחר מכן ניתן להשתמש בה להפעלת בדיקות.
הגדרת סביבה
הגדרת הסביבה הנדרשת לביצוע בדיקות CATBox דומה להגדרת CTS . כדי להגדיר את הסביבה, השלם כל אחת מהמשימות הבאות:
- התקן את ADB ו-AAPT .
- התקן JDK. ראה ערכת פיתוח Java עבור אובונטו.
- הגדל את מגבלת הזיכרון. ראה דרישות אחסון .
הגדרה וביצוע של CATBox
השתמש במסגרת הבדיקה של Tradefed כדי להפעיל את הבדיקות במכשירי אנדרואיד. לפני הגדרת CATBox, הכר את סקירת הפדרציה הסחר .
כדי להגדיר ולהפעיל CATBox, עיין בסעיפים למטה.
הגדרת מכשיר
לפני הפעלת תוכנית בדיקה, בצע את השלבים הבאים להגדרת המכשיר שלך:
ודא שהתקנת את הגרסאות האחרונות של Android Debug Bridge (adb) וגם של Android Asset Packaging Tool (AAPT) , וכן הוספת את המיקום של כלים אלה לנתיב המערכת של המחשב שלך. לפרטים, ראה ADB ו-AAPT .
חבר לפחות מכשיר אחד והכן את ההתקן בבדיקה (DUT) באופן הבא:
- כדי לאפס את מכשיר הרכב להגדרות היצרן, לחץ על הגדרות > מערכת > אפשרויות איפוס > מחק את כל הנתונים .
- המתן עד שהמכשיר יופעל מחדש באופן אוטומטי.
ודא ש-adb מופעל. כדי לוודא שהמכשיר זמין, הפעל את הפקודה הבאה:
$ adb devices
כדי להפעיל את השורש, הפעל את הפקודה הבאה:
# Enable Root $ adb -s DEVICE_SERIAL root
החלף את
DEVICE_SERIAL
במזהה הטורי של מכשיר הרכב.התחבר ל-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
עבור ביצוע בדיקות פונקציונליות וביצועים כאחד.
בדיקות מסוימות, כגון חיוג, אודיו בלוטות', ומבחני ג'אנק של רשימת אנשי קשר דורשות הגדרת מכשיר נוספת.
בדיקת חיוג
בדיקת החיוג דורשת הגדרת מכשיר ופרמטרים של זמן ריצה. כדי להגדיר את המכשיר:
- חבר את המכשיר הנייד ליחידת הראש של הרכב באמצעות Bluetooth.
- ודא שטלפון הבדיקה מכיל כרטיס SIM להפעלת בדיקות חיוג ומחובר לרשת הסלולרית.
- בדיקות חיוג משתמשות ברירת המחדל של אנשי קשר המאוחסנים בטלפון. השתמש ב- contacts.vcf כדי לטעון אנשי קשר בטלפון.
החלף את ה-
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:
- ודא שאפליקציית YouTube Music מותקנת בטלפון ושנכנסת לחשבון. אם לא, התקן את האפליקציה והיכנס לחשבון.
- התאם את הטלפון באופן ידני למכשיר הרכב באמצעות Bluetooth.
- לאחר ההתאמה של הטלפון, הפעל שיר בטלפון ולאחר מכן התחל לבצע את הבדיקה.
מבחן ג'אנק רשימת אנשי קשר
כדי להגדיר מכשיר עבור מבחן הג'אנק של רשימת אנשי הקשר:
- ודא שלטלפון יש מספר אנשי קשר כדי שהבדיקה תוכל לגלול ברשימת אנשי הקשר כדי לאסוף מדדי ג'אנק.
- התאם את הטלפון באופן ידני למכשיר הרכב באמצעות Bluetooth.
- לאחר שיוך הטלפון, ניתן לגשת לאנשי הקשר במכשיר.