שימוש ב-CTS Verifier

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

הדרישות

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

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

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

דרישות UICC לבדיקות NFC

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

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

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

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

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

הגדרה

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

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

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

  1. במחשב Linux:

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

      adb shell settings put global hidden_api_policy 1

    • מתקינים את Android Studio.

    • מורידים את CTS Verifier APK עבור את גרסת Android לבדיקה.

  2. מחברים את מכשיר ה-DUT למחשב Linux.

  3. בטרמינל במחשב Linux, מתקינים את 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. ב-Android מגרסה 11 ואילך, צריך להריץ את הפקודה הבאה מאפשרת לשמור דוחות בספרייה שהוגדרה באופן עצמאי, הספרייה החיצונית ברמה העליונה של המכשיר.

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0

  6. ב-Android מגרסה 13 ואילך, מריצים את הקוד הבא כדי לאפשר גישת API לבדיקה עבור CTS Verifier.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier

  7. ב-Android מגרסה 14 ואילך, מריצים את הקוד הבא פקודה כדי לתת לאפליקציה הרשאה להפעיל את המסך.

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0

  8. מוודאים שהתאריך והשעה של המערכת מוגדרים כמו שצריך ב-DUT.

הפעלת CTS Verifier

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

סמל לאימות CTS במרכז האפליקציות

איור 1. סמל של מאמת CTS

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

תפריט מאמת CTS של בדיקות

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

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

מאמת איכות של וידאו בסטרימינג

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

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

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

בדיקת מצב אביזר USB בגרסה 8.0 ואילך

בדיקת אביזר USB לאימות CTS

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

בדיקת אביזר USB לאימות CTS

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

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

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

  1. מחברים את מכשיר ה-DUT למחשב Linux.

  2. במחשב, מפעילים את התוכנית cts-usb-accessory מה-CTS חבילת המאמת:

    ./cts-usb-accessory

  3. ממתינים להופעת הודעה קופצת ב-DUT ולאחר מכן לוחצים על OK (אישור).
    בדיקת אביזר USB לאימות CTS

    איור 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 על נייר בגודל 11x17 אינץ' או על נייר בגודל 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' תוצג את הבדיקות הנחוצות למצב התצוגה שנבחר. כדי להפעיל את החלופה במצבים ב-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 למחשב Linux.

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

    • במכשירים עם Android מגרסה 7.x ואילך, יש להוריד את כל הדוחות באמצעות הפקודה הבאה:

      adb pull /sdcard/verifierReports

    • ב-Android 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. בוחרים תפריט > ניקוי.