CTS המופעל על ידי מפתח

דף זה מתאר את הנחיות השימוש עבור CTS המופעל על ידי מפתחים (CTS-D).

כיסוי מבחן

CTS-D, כמו CTS ו-CTS Verifier, יכול לאכוף רק את הדברים הבאים:

  • כל ממשקי ה-API הציבוריים המתוארים ב-SDK למפתחים (developer.android.com) עבור רמת API מסוימת.
  • כל דרישות ה-MUST הכלולות במסמך הגדרת התאימות של Android (CDD) עבור רמת API מסוימת.

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

מכיוון שכל ממשקי ה-API ודרישות ה-CDD קשורות לרמת API ספציפית, כל מבחני ה-CTS (CTS, CTS-D ו-CTS Verifier) ​​קשורים לאותה רמת API כמו ממשקי ה-API או הדרישות המשויכות להם. אם ממשק API ספציפי הוצא משימוש או משתנה, יש להוציא או לעדכן את הבדיקה התואמת שלו.

כללי יצירת מבחן CTS

  • מבחן חייב להפיק את אותה תוצאה אובייקטיבית באופן עקבי.
  • בדיקה חייבת לקבוע אם מכשיר עובר או נכשל על ידי בדיקת מכשיר זה פעם אחת מחוץ לקופסה.
  • יוצרי הבדיקה חייבים להסיר את כל הגורמים האפשריים שעלולים להשפיע על תוצאות הבדיקה.
  • אם מכשיר צריך מצב/סביבה/הגדרה מסויימת של חומרה, ההגדרה הזו חייבת להיות מוגדרת בבירור בהודעת ה-commit. לדוגמה הוראות הגדרה, ראה הגדרת CTS .
  • הבדיקה לא צריכה להימשך יותר מ-6 שעות בכל פעם. אם הוא צריך להימשך זמן רב יותר, אנא כלול את הנימוקים בהצעת הבדיקה שלך כדי שנוכל לבדוק אותו.

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

  • Wifi יציב (לבדיקה שמסתמכת על Wifi).
  • המכשיר נשאר נייח במהלך הבדיקה (או שלא, תלוי בבדיקה).
  • המכשיר מנותק מכל מקור מתח עם X אחוזים מרמת הסוללה.
  • אין אפליקציות, שירותי חזית או שירותי רקע פועלים, מלבד CTS.
  • המסך כבוי בזמן הפעלת CTS.
  • המכשיר אינו isLowRamDevice .
  • הגבלות חיסכון בסוללה/אפליקציה לא שונו ממצב "מחוץ לקופסה".

זכאות למבחן

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

תהליך הגשת CTS

  1. כתוב הצעת בדיקה: מפתח אפליקציה מגיש הצעת בדיקה באמצעות Google Issue Tracker , מתאר את הבעיה שזוהתה ומציע בדיקה לבדיקתה. ההצעה חייבת לכלול את מזהה דרישת ה-CDD המשויך. צוות אנדרואיד בוחן את ההצעה.
  2. פתח מבחן CTS: לאחר אישור הצעה, המגיש שלה יוצר מבחן CTS על AOSP בסניף הראשי (AOSP/ראשי). צוות אנדרואיד סוקר את הקוד.
  3. פרסם מבחן: שלח את ה-CL שלך ב- AOSP/main ולאחר מכן בחר אותו לסניף העדכני ביותר androidx-tests-dev . הבדיקה זמינה כעת לציבור.

הנחיות כתיבת מבחן CTS-D

  • עקוב אחר המדריך לסגנון קוד Java .
  • בצע את כל השלבים המתוארים ב- CTS פיתוח .
  • הוסף את הבדיקות שלך לתוכנית הבדיקה המתאימה:
    • השתמש include-filters כדי להוסיף את הבדיקות החדשות שלך לתוכנית הבדיקה של CTS-D: platform/cts/tools/cts-tradefed/res/config/cts-developer.xml .
    • השתמש exclude-filters כדי לא לכלול את הבדיקות החדשות שלך מתוכנית הבדיקה הראשית של CTS: platform/cts/tools/cts-tradefed/res/config/cts-developer-exclude.xml .
  • טפל בכל errorprone וההצעות המועדות לשגיאות ב- build_error.log .
  • בסיס מחדש את השינויים שלך head . זה כולל את תוכניות הבדיקה cts-developer.xml ו- cts-developer-exclude.xml .
  • עבוד עם איש הקשר ההנדסי שלך ב-Google כדי לקבוע אם ניתן לכלול את מקרה המבחן שלך במודול CTS קיים. אם זה לא יכול, הם יעזרו לך ליצור מודול חדש.
  • עבור כל מודול בדיקה חדש שנוצר, צור קובץ OWNERS בספריית מודול הבדיקה החדשה.
    • קובץ ה-OWNERS שלך צריך להכיל את המידע הבא, שהתקבל מבעל הבדיקה של Google שאיתו אתה עובד:
    • # Bug component: xxx
    • ldap בעל מבחן גוגל
  • ב- AndroidTest.xml , ציין את הפרמטרים הבאים. עיין בקבצים לדוגמה ( 1 , 2 ) לדוגמאות:
    • Instant_app או not_instant_app
    • secondary_user או not_secondary_user
    • all_foldable_states או no_foldable_states
  • כדי לציין את ה-minSDK הנכון, עיין בתיעוד <uses-sdk> .
  • בעת בדיקת שיטות בדיקה, מחלקות או מודולים חדשים, הוסף אותם לתוכנית הבדיקה של CTS-D והסר אותם מתוכנית הבדיקה הראשית של CTS באותו אופן כמו עבור מבחנים חדשים.

הפעל את מבחן ה-CTS-D שלך

הפעל את תוכנית הבדיקה של CTS-D משורת הפקודה באמצעות run cts --plan cts-developer .

כדי להפעיל מקרה בדיקה ספציפי, השתמש run cts --include-filter "test_module_name test_name" .

למידע על הפעלת ה-CTS המלא, ראה הפעלת בדיקות CTS .

קבלה ושחרור

לאחר הגשת בקשת בדיקה, צוות פנימי יבדוק אותה כדי לוודא שהיא בודקת דרישת CDD או התנהגות API מתועדת. אם נקבע שהבדיקה בודקת דרישה או התנהגות חוקיים, הצוות יעביר מקרה בדיקה זה למהנדס Google לבדיקה נוספת. מהנדס גוגל יפנה אליך עם משוב כיצד ניתן לשפר את המבחן לפני שניתן יהיה להתקבל ל-CTS.

ראה לוח זמנים לשחרור ומידע על הסניף לפרטים על לוח הזמנים של שחרור CTS.