שימוש ב-CTS Verifier

ה-Android Compatibility Test Suite Verifier (CTS Verifier) ​​משלים את חבילת בדיקת התאימות (CTS). בעוד CTS בודק ממשקי API ופונקציות הניתנות לאוטומטיות, CTS Verifier מספק בדיקות עבור ממשקי API ופונקציות שלא ניתן לבדוק במכשיר נייח ללא קלט או מיקום ידני, כגון איכות שמע, מסך מגע, מד תאוצה ומצלמה.

דרישות

לפני הפעלת CTS Verifier, ודא שיש לך את הציוד הבא:

  • מכשיר אנדרואיד שאימת את תאימות ה-API של Android על ידי העברת ה-CTS בהצלחה. זהו המכשיר הנבדק (DUT).
  • מחשב לינוקס עם יציאת USB 2.0 תואמת. כל החיבורים ל-DUT עוברים דרך יציאה זו.
  • מכשיר אנדרואיד שני עם יישום ידוע של Bluetooth, Wi-Fi Direct, Wi-Fi Aware, UWB (אם ה-DUT תומך ב-UWB), ויישום NFC Host Card Emulation (HCE).
  • נתב Wi-Fi מוגדר עם שם נקודת גישה וסיסמה. הנתב צריך להיות בעל יכולת להתנתק מהאינטרנט, אך לא כבוי.

ודא שאתה מכין גם את החצובות, מחזיקי המכשירים והמרחקים שנמדדו מראש הנדרשים עבור מבחני מדידת המרחק (קרבה) עבור UWB, Wi-Fi NAN ו-Bluetooth RSSI. לפרטים, ראה כיול נוכחות .

דרישות UICC עבור מבחני NFC

ל-CTS Verifier יש את מקרי הבדיקה הבאים של NFC:

  • Field-off (משתמש בנתוני עסקאות מ-0x54)
  • בטל בחירה (משתמש בנתוני עסקאות מ-0x52)
  • פקודת HCI (0025000000) (משתמשת בנתוני עסקאות מ-0x02)

בדיקות אירוע עסקה דורשות שני מכשירים, אחד מהם חייב להיות בעל SecureElement UICC עם כללי הגישה הבאים:

  • CtsVerifier APK hash: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
  • מזהה אפליקציה מורשה (AID) עבור גישה לאירועי NFC: 0xA000000476416E64726F696443545341

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

להכין

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

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

כדי להגדיר את סביבת הבדיקה של CTS Verifier:

  1. במחשב לינוקס:

    • הפעל את הפקודה הבאה לפני התקנת ה-CTS Verifier כדי לאפשר גישה לממשקים שאינם SDK.

      adb shell settings put global hidden_api_policy 1
      
    • התקן את אנדרואיד סטודיו .

    • הורד את ה- APK של CTS Verifier עבור גרסת אנדרואיד לבדיקה.

  2. חבר את ה-DUT למחשב לינוקס.

  3. ממסוף במחשב לינוקס, התקן CtsVerifier.apk ב-DUT.

    adb install -r -g CtsVerifier.apk
    
  4. עבור Android 10 ומעלה, הפעל את הפקודה הבאה כדי לתת הרשאה לאפליקציה ליצור את הדוח.

    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
    
  5. עבור אנדרואיד 11 ומעלה, הפעל את הפקודה הבאה כדי לאפשר שמירת דוחות בספרייה מוגדרת עצמית תחת הספרייה החיצונית ברמה העליונה של המכשיר.

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. עבור אנדרואיד 13 ומעלה, הפעל את הפקודה הבאה כדי לאפשר גישה ל-API לבדיקה עבור CTS Verifier.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
    
  7. עבור אנדרואיד 14 ומעלה, הפעל את הפקודה הבאה כדי לתת הרשאה לאפליקציה להפעיל את המסך.

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
    
  8. ודא שהתאריך והשעה של המערכת מוגדרים כהלכה ב-DUT.

הפעל את CTS Verifier

הפעל את אפליקציית CTS Verifier על ידי הקשה על סמל CTS Verifier ב-DUT.

סמל CTS Verifier במפעיל

איור 1. סמל CTS Verifier

האפליקציה מציגה מספר ערכות בדיקה זמינות לאימות ידנית.

תפריט בדיקות CTS Verifier

איור 2. CTS Verifier תפריט של בדיקות

כל בדיקה מכילה קבוצה של אלמנטים משותפים בתחתית המסך.

מאמת איכות וידאו זורם

איור 3. מסך בדיקה עם רכיבי בדיקה נפוצים מודגשים

  • עוברים (✓). הקש אם ה-DUT עומד בדרישות הבדיקה לפי הוראות המידע.
  • מידע (?). הקש כדי להציג הוראות בדיקה. מופיע גם אוטומטית בפעם הראשונה שבדיקה נפתחת.
  • נכשל (!). הקש אם ה-DUT אינו עומד בדרישות הבדיקה לפי הוראות המידע.

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

בדוק מצב אביזר USB עבור 8.0 ומעלה

בדיקת אביזרי usb של CTS Verifier

איור 4. נוהל בדיקת אביזרי USB עבור 8.0 ומעלה

בדיקת אביזרי usb של CTS Verifier

איור 5. בדיקת מצב אביזר USB עבור 8.0 ומעלה

בדוק את מצב אביזר USB עבור 7.x ומטה

בדיקת אביזרי ה-USB מחייבת מחשב לינוקס כדי להפעיל את תוכנית המחשב השולחני USB (מארח).

  1. חבר את ה-DUT למחשב לינוקס.
  2. במחשב, הפעל את תוכנית cts-usb-accessory מחבילת CTS Verifier:

    ./cts-usb-accessory
  3. המתן להופעת הודעה קופצת ב-DUT, ולאחר מכן בחר אישור .
    בדיקת אביזרי usb של CTS Verifier

    איור 6. בדיקת אביזרי USB

  4. עבור לבדיקת אביזרי USB באפליקציית CTS Verifier ב-DUT.

  5. במחשב, סקור את הפלט מהמסוף. פלט לדוגמה:

    CTS USB Accessory Tester
    Found possible Android device (413c:2106) - attempting to switch to accessory
    mode...
    Failed to read protocol versionfigure3
    Found Android device in accessory mode (18d1:2d01)...
    [RECV] Message from Android device #0
    [SENT] Message from Android accessory #0
    [RECV] Message from Android device #1
    [SENT] Message from Android accessory #1
    [RECV] Message from Android device #2
    [SENT] Message from Android accessory #2
    [RECV] Message from Android device #3
    [SENT] Message from Android accessory #3
    [RECV] Message from Android device #4
    [SENT] Message from Android accessory #4
    [RECV] Message from Android device #5
    [SENT] Message from Android accessory #5
    [RECV] Message from Android device #6
    [SENT] Message from Android accessory #6
    [RECV] Message from Android device #7
    [SENT] Message from Android accessory #7
    [RECV] Message from Android device #8
    [SENT] Message from Android accessory #8
    [RECV] Message from Android device #9
    [SENT] Message from Android accessory #9
    [RECV] Message from Android device #10
    [SENT] Message from Android accessory #10
    

כייל שדה ראייה של המצלמה

השתמש בהליך כיול שדה הראייה כדי לקבוע במהירות את שדה הראייה של המכשיר בדיוק בינוני.

  1. הגדר את סביבת הבדיקה:

    1. הדפס את קובץ היעד calibration-pattern.pdf על נייר בגודל 11 אינץ' x 17 אינץ' או A3.
    2. הרכיבו את הדוגמה המודפסת על גב קשיח.
    3. כוון את התקן המצלמה ואת המטרה המודפסת כפי שמוצג בתרשים הבא.
      מטרה מודפסת במצלמה

      איור 7. יעד מודפס במצלמה

  2. הגדר את רוחב היעד:

    1. מדוד את המרחק (בסנטימטרים) בין הקווים המוצקים בתבנית היעד כדי לקחת בחשבון אי דיוקים בהדפסה (~38 ס"מ).
    2. הפעל את אפליקציית הכיול.
    3. לחץ על לחצן ההגדרה ובחר מרחק סמן .
    4. מדוד והזן את המרחק לדפוס היעד (~100 ס"מ).
    5. לחץ על לחצן החזרה כדי לחזור לתצוגה המקדימה של הכיול.
  3. ודא שהמכשיר והמטרה ממוקמים כפי שמוצג באיור והמרחקים הנכונים הוזנו בתיבת הדו-שיח של ההגדרה. התצוגה המקדימה מציגה את התמונה עם קו אנכי מכוסה עליה; קו זה צריך להתיישר עם קו האמצע של תבנית היעד. ניתן להשתמש ברשת השקופה עם הקווים האנכיים האחרים כדי להבטיח שהציר האופטי יהיה אורתוגונלי למטרה.

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

    1. בחר רזולוציית תמונה (באמצעות הבורר בפינה השמאלית התחתונה), ולאחר מכן הקש על המסך כדי לצלם תמונה. הבדיקה נכנסת למצב כיול ומציגה את התמונה עם שני קווים אנכיים על גבי התמונה.
    2. קבע את הדיוק:
      • אם הקווים מתיישרים עם הקווים האנכיים בתבנית היעד בתוך כמה סנטימטרים, שדה הראייה המדווח עבור הרזולוציה שנבחרה מדויק.
      • אם הקווים אינם מיושרים, שדה הראייה המדווח אינו מדויק. כדי לתקן זאת, כוונן את המחוון בתחתית המסך עד שהשכבה תתיישר עם תבנית היעד קרוב ככל האפשר. כאשר שכבת העל ותמונת תבנית היעד מיושרים, שדה הראייה המוצג הוא קירוב קרוב לערך הנכון. שדה הראייה המדווח צריך להיות בטווח של +/-2 מעלות מערך הכיול.
    3. לחץ על לחצן החזרה וחזור על בדיקת הכיול עבור כל רזולוציות התמונה הנתמכות על ידי DUT.

הפעל את CTS Verifier עבור מצבים חלופיים

מתחילת מהדורות CTS 10 R6 ו-CTS 11 R2, CTS Verifier תומך בבדיקות הנדרשות עבור מכשירים עם מצבים חלופיים, או עבור מכשירים עם יותר ממצב מסך אחד.

בחלק העליון של תצוגת הרשימה הראשית ב-CTS Verifier מוצג כפתור המאפשר למשתמשים לעבור בין מצב תצוגה לא מקופל ומקופל. CTS Verifier יציג את הבדיקות הדרושות עבור מצב התצוגה שנבחר. כדי להפעיל את המצבים החלופיים ב-CTS Verifier, יש להעביר את הכפתור למצב התצוגה המתאים ולהריץ את רשימת הבדיקות המוצגות.

מתג CTS-V

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

<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
  <RunHistory subtest="CREATE_ALARM[folded]">
    <Run start="1594176663973" end="1594176665841" isAutomated="false" />
  </RunHistory>
</Test>

ייצוא תוצאות

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

  1. כדי לשמור את תוצאות הבדיקה, הקש על סמל השמירה (דיסק) בראש רשימת קטגוריות הבדיקה.

  2. המתן להודעה קופצת שמציגה את נתיב הקובץ לדוח השמור (לדוגמה, /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), ואז רשום את הנתיב.

  3. חבר את ה-DUT למחשב לינוקס.

  4. מהתקנת Android SDK במחשב Linux, הורד דוחות מהמכשיר המחובר באמצעות adb shell content read או adb pull CTSVerifierReportPath .

    • עבור Android 7.x ומעלה, הורד את כל הדוחות באמצעות הפקודה הבאה:

      adb pull /sdcard/verifierReports
      
    • עבור אנדרואיד 6.0 ומטה, הורד את כל הדוחות באמצעות הפקודה הבאה:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • עבור Android 10 ואילך, הטמעת רכב ומכשירים הפועלים כמשתמש משני , הורד את הדוח האחרון באמצעות הפקודה הבאה:

      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
      

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

      adb shell content query --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports
      

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

      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
      
      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip >
      report.zip
      
  5. כדי למחוק תוצאות מעבר/נכשל, בחר את התוצאות באפליקציית CTS Verifier ובחר תפריט > נקה .