שימוש במאמת CTS

ה-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 ו-NFC מארח כרטיס הדמיית (HCE) תואם.
  • נתב Wi-Fi מוגדר עם שם נקודת גישה וסיסמה. הנתב צריך להיות בעל יכולת להתנתק מהאינטרנט, אך לא כבוי.

דרישות 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 עבור גירסת אנדרואיד ל מבחן.

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

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

    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. ודא שב-DUT מוגדרים כהלכה נתוני המערכת והזמן.

רץ

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

סמל CTS Verifier במפעיל

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

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

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

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

כל מבחן מכיל קבוצה של אלמנטים נפוצים (מידע, עובר, נכשל) בתחתית המסך.

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

אלמנטי איור 3. מבחן

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

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

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

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

איור 4. USB מבחן אביזר prcedure עבור 8.0 ומעלה

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

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

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

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

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

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

    מבחן אביזר USB איור 6.

  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. הדפס את הכיול-pattern.pdf קובץ היעד על 11” x 17” או נייר בגודל A3.
    2. הרכיבו את הדוגמה המודפסת על גב קשיח.
    3. כוון את התקן המצלמה ואת היעד המודפס כפי שמוצג להלן.
      מטרה מודפסת במצלמה

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

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

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

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

    1. בחר רזולוציית תמונה (באמצעות הבורר בפינה השמאלית התחתונה), ולאחר מכן הקש על המסך כדי לצלם תמונה. הבדיקה נכנסת למצב כיול ומציגה את התמונה עם שני קווים אנכיים על גבי התמונה.
    2. קבע את הדיוק:
      • אם הקווים מתיישרים עם הקווים האנכיים בתבנית היעד בתוך כמה סנטימטרים, שדה הראייה המדווח עבור התוצאה שנבחרה מדויק.
      • אם הקווים אינם מיושרים, שדה הראייה המדווח אינו מדויק. כדי לתקן זאת, כוונן את המחוון בתחתית המסך עד שהשכבה תתיישר עם תבנית היעד קרוב ככל האפשר. כאשר שכבת העל ותמונת תבנית היעד מיושרים, שדה הראייה המוצג הוא קירוב קרוב לערך הנכון. שדה הראייה המדווח צריך להיות בטווח של +/-1 מעלה מערך הכיול.
    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. הקש על סמל שמור (דיסק).
    סמל שמירה של CTS Verifier

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

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

    איור 9. CTS אימות נתיב דוח שנשמר

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

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

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

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

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • במשך 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 ובחר תפריט> נקה.