דף זה תורגם על ידי Cloud Translation API.

תחנת בדיקה של אנדרואיד

Android Test Station הוא כלי בדיקה שמפתחי אנדרואיד ומהנדסי בדיקה יכולים להשתמש בו כדי להפעיל ממשק משתמש להפעלת חבילות בדיקה סטנדרטיות של אנדרואיד, כגון Android Compatibility Test Suite (CTS) . כלי זה פועל כממשק אינטרנט עבור Trade Federation (TF) , ומאפשר לך להריץ בקלות CTS על קבוצה של התקני בדיקה עם הגדרה מינימלית, כמו גם לקבוע לוח זמנים להרצת בדיקות באופן רציף.

הגדר את תחנת הבדיקה של אנדרואיד

סעיף זה מסביר כיצד להתקין ולהגדיר את Android Test Station.

Android Test Station משתמש בקוד מקור מהמיקומים הבאים:

קוד המקור של תחנת הבדיקה של אנדרואיד
קוד המקור של TradeFed Cluster

התקן את Android Test Station

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

הדרישות ל-CTS נמצאות ב- source.android.com .

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

ישנן שתי דרכים להתקין את Android Test Station:

הפעל את תוכנית ההתקנה .
התקן אותו באופן ידני , אשר דורש התקנת תוכניות ומשאבים מרובים.

התקן עם תוכנית ההתקנה

ב-Ubuntu 20.04+, תוכנית ההתקנה מתקינה ומגדירה את כל התוכניות והמשאבים הדרושים להפעלת Android Test Station.

כדי להשתמש בתוכנת ההתקנה:

הפעל את תוכנית ההתקנה:

curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash

הפעל mtt version כדי לבדוק את הגרסה המותקנת של Android Test Station CLI.

התקן ידנית

התקן את Docker

עקוב אחר ההוראות להתקנת Docker Community Edition (CE) במחשב הלינוקס שלך.
בצע את השלבים שלאחר ההתקנה כדי לנהל את Docker כמשתמש שאינו שורש .
ייתכן שיהיה עליך להפעיל מחדש את חלון המסוף שלך או להתנתק ולהיכנס שוב כדי ששינויי ההרשאה ייכנסו לתוקף.

התקן את Python 3

ה-Android Test Station CLI מאומת מול גרסאות Python 3.7 עד 3.10.

עבור אובונטו 16.04 ומעלה, תחילה הוסף את המאגר עבור Python 3 על ידי ביצוע אחת מהפעולות הבאות:

הפעל את הפקודה הזו:

sudo add-apt-repository ppa:deadsnakes/ppa

בנה והתקן את המאגר מהמקור .

כדי להתקין Python 3, הפעל את הפקודות הבאות:

sudo apt-get update
sudo apt install python3 python3-distutils

כדי להתקין גירסת Python 3 ספציפית (לדוגמה, 3.10), הפעל את הפקודות הבאות במקום זאת:

sudo apt-get update
sudo apt install python3.10 python3.10-distutils

קבל את ה-Android Test Station CLI

הורד את חבילת ממשק שורת הפקודה (CLI) כאן.

הפעל את Android Test Station

הפעל את Android Test Station עם הפקודה הבאה:

mtt start

בפעם הראשונה שממשק המשתמש מופעל, ייתכן שיחלפו מספר דקות עד להופעתו. ה-CLI מציג כתובת אתר אינטרנט לגישה לממשק המשתמש בדפדפן. כברירת מחדל, כתובת האתר היא localhost:8000 . במידת הצורך, תוכל לשנות את יציאת ברירת המחדל בעת ההפעלה עם דגל --port .

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

כדי לעדכן לגרסה הנוכחית, הפעל:

mtt start --force_update

כדי לעצור את האפליקציה, הפעל:

mtt stop

כדי להציג רשימה של פקודות אחרות, השתמש ב:

mtt --help

גבה ושחזר את מסד הנתונים

כדי לגבות את מסד הנתונים של ATS, עצור את האפליקציה והפעל את הפקודה הבאה, המגבה את מסד הנתונים הנוכחי לקובץ TAR בשם mtt-backup.tar בספריית הבית שלך:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."

כדי לשחזר, הפעל את הפקודה הבאה לפני הפעלת האפליקציה:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"

אשף התקנה

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

שחזר גיבוי תצורה

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

שחזר גיבוי תצורה

איור 1. שחזור גיבוי תצורה.

הגדר את חשבון השירות המוגדר כברירת מחדל

אתה יכול להגדיר חשבון שירות שבו Android Test Station משתמש כברירת מחדל בעת גישה למשאבים שלך (לדוגמה, Google Cloud Storage, Google Drive). כדי לאמת את חשבון השירות שלך, לחץ על העלה מפתח חשבון שירות ובחר בקובץ מפתח JSON של חשבון השירות שלך.

הגדר חשבון שירות

איור 2. הגדרת חשבון השירות.

כאשר חשבון השירות מאומת בהצלחה, כתובת הדוא"ל של החשבון מופיעה בפינה השמאלית העליונה של הדף. כדי לשנות את חשבון השירות, לחץ על שם החשבון, הסר את חשבון ברירת המחדל הנוכחי והעלה מפתח חשבון שירות חדש.

שנה חשבון שירות

איור 3. שינוי חשבון השירות.

יבא ערכות תצורה

ערכת תצורה היא חבילה של תצורות להפעלת חבילות בדיקה, כולל פעולות מכשיר קשורות וערוצים לבנות. ערכות הגדרות מתארחות בדלי ספציפי של Google Cloud Storage (GCS). לאחר אימות ערוץ GCS build עם חשבון Google שלך, אתה רואה רשימה של כל ערכות התצורה הזמינות עבורך.

בחר ערכות תצורה שתרצה להוסיף למארח תחנת הבדיקה שלך ולחץ על ייבא נבחרים .

ייבוא ערכות תצורה

איור 4. ייבוא ערכת תצורה.

כלול הגדרות Wi-Fi

בדיקות CTS מסוימות מחייבות את המכשיר שלך להתחבר לנקודה חמה של Wi-Fi. כדי לבחור את רשת ה-Wi-Fi שלך, הזן את ה- WiFi SSID ואת WiFi PSK אופציונלי.

הגדרות אינטרנט אלחוטי

איור 5. הגדרות נקודה חמה של Wi-Fi.

לאחר השלמת אשף ההתקנה, הדף נטען מחדש עם ההגדרות החדשות שהוחלו.

חבר מכשיר

יש להפעיל איתור באגים ב-USB כדי להשתמש במכשיר לצורך בדיקה. כדי לאפשר איתור באגים:

עקוב אחר ההוראות ב'אפשר אפשרויות מפתח וניפוי באגים' .
אם אתה מתכנן להשתמש ב-Builds לניסיון של אנדרואיד שהוטען מראש עם מפתחות ADB מותאמים אישית, הכנס את קבצי .adb_key המותאמים אישית תחת הספרייה ~/.android/ .
הקבצים נטענים אוטומטית ומועברים ל-ADB כדי להפעיל אוטומטית איתור באגים ב-USB לאחר הבזק של ההתקן עבור מכשירים המריצים את ה-builds הללו.
הערה: כדי להוסיף מפתחות ADB מותאמים אישית ל-builds לניפוי באגים של Android, עיין בשינוי להוספת PRODUCT_ADB_KEYS .
חבר את ההתקן למחשב המארח באמצעות USB.
המכשיר יופיע בלשונית Android Test Station Devices תוך דקה אחת לאחר רענון ממשק האינטרנט. תוכל גם להציג את מצב המכשירים בכרטיסייה זו.
איור 6. חיבור התקן.

מצבי המכשיר השונים הם:

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

הרץ בדיקה

בחר מבחן

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

בחר מבחן

איור 7. בחירת מבחן.

כדי לערוך או להוסיף בדיקות חדשות, ראה הוספת בדיקות .

הגדר את הפעלת הבדיקה

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

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

הגדר את הפעלת מבחן

איור 8. הגדרת הפעלת ניסיון.

הפרמטרים של ריצת הבדיקה הם:

שם - שם חבילת הבדיקה שברצונך להפעיל.
ספירת ריצות - מספר הפעמים שהרצת בדיקה זו צריכה להתבצע כשהיא מתוזמנת. ריצות מבחן מתוזמנות באמצעות Trade Federation , אשר מריץ עד 20 ריצות מבחן במקביל אם יש יכולת לעשות זאת.
מקסימום ניסיון חוזר - מספר הפעמים המרבי לניסיון חוזר של ריצת בדיקה אם לפחות בדיקה אחת נכשלת. זה בדרך כלל מוגדר ל-4-6 ניסיונות חוזרים עבור ריצת CTS מלאה לטיפול בבדיקות מתקלפות.
זמן קצוב לתור - אם ריצת בדיקה נשארת במצב בתור זמן רב מדי, היא מבוטלת אוטומטית. ציין את משך הזמן שיש להמתין לפני הביטול כאן. ברירת המחדל היא 24 שעות.
Command - הפקודה להפעלת חבילת הבדיקה. אתה יכול להזין ארגומנטים נוספים של שורת הפקודה כאן. לדוגמה, הפעל מודול ספציפי ב-CTS 8.1 עם:
```
cts-suite -m ShortModuleName
```
Retry Command - הפקודה לניסיון חוזר של חבילת בדיקה. אתה יכול להוסיף ארגומנטים נוספים של שורת הפקודה כאן. לדוגמה, כדי לנסות שוב רק מודול ספציפי ב-CTS 8.1, השתמש ב:
```
cts --retry 0 -m ShortModuleName
```
ארגומנטים של ניסיון חוזר עשויים להיות שונים מאלה הזמינים בפקודה הראשונית, אז בדוק את הפרמטרים הנתמכים באתר הרשמי עבור חבילת הבדיקה שנבחרה.
ריצת מבחן קודמת - אם ברצונך להפעיל מחדש ריצת מבחן קודמת:
- מקומי - אם הריצה התחילה על המארח הנוכחי, הזן את מזהה ריצת הבדיקה שנראה בעת הצגת הפרטים של ריצת הבדיקה.
  איור 9. ריצת בדיקה קודמת מקומית.
- מרחוק - אם ההרצה החלה על מארח אחר, העלה את קובץ תוצאות הבדיקה על ידי בחירה מרחוק , לחיצה על העלה קובץ תוצאות בדיקה ובחירה בקובץ מהאחסון המקומי שלך.
  איור 10. ריצת בדיקה קודמת מרחוק.

בחר מכשירים

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

בחר התקנים

איור 11. בחירת התקנים.

כדי לבחור מכשירים לפי תכונות שאינן סדרות המכשירים, אתה יכול להזין באופן ידני "מפרט מכשיר". לדוגמה, כדי לבחור 3 מכשירים ששם המוצר שלהם הוא "bramble", הזן את הדברים הבאים:

product:bramble;product:bramble;product:bramble

התכונות הנתמכות הן:

build_id
device_serial
סוג מכשיר
שם מארח
מוצר
המוצר_variant
sim_state

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

הוסף פעולות במכשיר

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

פעולות מכשיר

איור 12. פעולות ההתקן.

כדי להוסיף פעולת מכשיר לריצת ניסיון, לחץ על הוסף פעולה חדשה , בחר את תיבות הסימון של הפעולות להוספה ולחץ על הוסף פעולה(ות) . פעולות המכשיר מבוצעות ברצף. ניתן לסדר מחדש את הפעולות על ידי גרירתן.

הוסף פעולות

איור 13. סידור מחדש של פעולות.

הגדר משאבי בדיקה

משאבי בדיקה הם קבצים הנדרשים לביצוע ריצת בדיקה. לדוגמה, הפעלת CTS דורשת קובץ android-cts*.zip , והבהב של מכשיר מחייב אותך לספק את תמונת ה-build.

כתובת האתר להורדה של קובץ ה-zip של חבילת הבדיקה צריכה להיות ברירת המחדל לקישורי Google Drive שניתנו לשותפים. אתה יכול לבחור קובץ אחר על ידי לחיצה על עיון . בחלון הקופץ, אתה יכול להזין קישור להורדת קובץ, להשתמש בקובץ מערוץ בנייה מאומת, או להעלות קובץ לשימוש מאחסון מקומי.

משאבי בדיקה

איור 14. משאבי בדיקה.

להלן החלון הקופץ לבחירת משאב בדיקה לפי כתובת אתר אינטרנט. אתה יכול פשוט להזין את הקישור להורדה, וללחוץ על כפתור הבחירה כדי לאשר את הבחירה.

בורר משאבי בדיקה - כתובת אתר אינטרנט

איור 15. בורר משאבי בדיקה - כתובת אתר אינטרנט.

אם העלית משאבים ל-Google Grive, Google Cloud Storage (GCS) או לערוצים אחרים, תוכל גם לנווט ללשונית הערוץ הספציפי ולבחור משאבים שם. הנה דוגמה לבחירת משאב מ-Google Drive.

בורר משאבים בדוק - Google Drive

איור 16. בורר משאבים לבדיקה - Google Drive.

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

בורר משאבים לבדיקה - תמיכה בדפוסי תווים כלליים

איור 17. בורר משאבי בדיקה - תמיכה בדפוסי תווים כלליים.

אתה יכול גם לבחור קובץ מאחסון הקבצים המקומי של Android Test Station. אתה יכול להעלות קבצים לאחסון זה, או להשתמש ישירות בקבצים ובספריות מקומיות .

בורר משאבים לבדיקה - מאגר קבצים מקומי

איור 18. בורר משאבי בדיקה - מאגר קבצים מקומי.

הוסף תצורות הפעלה מחדש

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

הוסף תצורות הפעלה מחדש

איור 19. הוספת תצורות הפעלה מחדש.

התחל ריצת מבחן

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

התחל ריצת מבחן

איור 20. התחלת ריצת מבחן.

צור תוכנית בדיקה

תוכניות בדיקה משמשות ליצירת ריצות בדיקה על פי לוח זמנים תקופתי. לדוגמה, הפעלת CTS 9.0 כל יום בשעה 17:00. כדי ליצור תוכנית בדיקה חדשה, לחץ על צור תוכנית בדיקה חדשה .

צור תוכנית בדיקה

איור 21. יצירת תוכנית בדיקה.

הגדר תוכנית בדיקה

הזן את שם תוכנית הבדיקה ואת כל התוויות שברצונך להוסיף. לאחר מכן בחר לוח זמנים לשימוש.

ידני - תוכנית הבדיקה יוצרת ריצות בדיקה רק כאשר משתמש לוחץ על הפעל תוכנית בדיקה בדף רשימת תוכנית הבדיקה.
תקופתי - תוכנית הבדיקה מתזמנת אוטומטית ריצות בדיקה לפי לוח הזמנים התקופתי שנבחר. לדוגמה, תזמון ריצת מבחן כל יום בשעה 17:00.
מותאם אישית - תוכנית הבדיקה מתזמנת באופן אוטומטי ריצות בדיקה על סמך ביטוי ה-cron שהוזן. לדוגמה, כדי לתזמן ריצת בדיקה כל יום בשעה 17:00, ביטוי ה-cron הוא 0 17 * * * .

הגדר תוכנית בדיקה

איור 22. הגדרת תוכנית בדיקה.

הוסף חבילות בדיקה

הוסף חבילות בדיקות שברצונך שיתזמנו לפי תוכנית הבדיקה על ידי לחיצה על + הוסף תצורת ריצת בדיקה . בחר חבילת בדיקה מהתפריט הנפתח שם ולחץ על השלב הבא . לאחר מכן בחר את המכשירים שבהם תרצה להפעיל את הבדיקה ולחץ על הוסף תצורה . אתה יכול להוסיף תצורות מרובות עבור כל תוכנית בדיקה.

הגדר את הפעלת מבחן

איור 23. הגדרת הפעלת ניסיון.

הוסף פעולות במכשיר

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

הוסף פעולות מכשיר

איור 24. הוספת פעולות המכשיר.

הגדר משאבי בדיקה

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

הגדר משאבי בדיקה

איור 25. הגדרת משאבי בדיקה.

צפה בריצות מבחן

רשימת ריצת מבחן

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

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

מסנן ריק מחזיר את כל השורות. כרגע אין דרך לסנן שורות עם ערכים ריקים.

רשימת ריצת מבחן

איור 26. רשימת ריצת מבחן.

פרטי ריצת מבחן

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

פרטי ריצת מבחן

איור 27. פרטי ריצת מבחן.

מצב ריצת מבחן

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

סטטוס ריצת מבחן

איור 28. מצב ריצת מבחן.

מצבי ריצת המבחן הם:

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

בטל ריצת מבחן

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

בטל ריצת מבחן

איור 29. ביטול ריצת מבחן.

תוצאות ריצת מבחן

לאחר סיום ריצת הבדיקה, התוצאות נאספות ומוצגות. תוכל להציג פרטים נוספים על ידי לחיצה על החץ עבור כל ריצה. לחץ על הצג קבצי פלט כדי לראות את חפצי הבדיקה שנאספו, כגון test_result.xml ו- test_result_failures.html .

תוצאות ריצת מבחן

איור 30. תוצאות ריצת מבחן.

אתה יכול לצפות ביומני מארח חי ו-Tradefed בכרטיסייה יומנים.

יומני ריצת בדיקה

איור 31. לשונית יומנים.

התוצאות עבור מודולים בודדים נמצאות בכרטיסייה תוצאות מבחן.

כרטיסיית תוצאות בדיקה

איור 32. הכרטיסייה תוצאות בדיקה.

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

כרטיסיית משאבי בדיקה

איור 33. הכרטיסייה משאבי בדיקה.

כדי לראות את הפרטים של הפעלת הבדיקה, כגון create_time , עבור ללשונית Config.

כרטיסיית בדיקת תצורה

איור 34. לשונית Config.

מאפיינים מתקדמים

נהל קבצי תצורה

Android Test Station משתמש בקובצי תצורה שנכתבו ב- YAML כדי לטעון אפשרויות מוגדרות מראש כגון בדיקות, בניית ערוצים ופעולות המכשיר. קובץ תצורה לדוגמה עבור כמה אפשרויות מוצג להלן.

// example_file.yaml
tests:
- id : android.cts.9_0.arm
  name: CTS 9.0 (ARM)
  test_resource_defs:
  - name: android-cts.zip
    default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
    test_resource_type: TEST_PACKAGE
  command: cts
  env_vars:
  - name: TF_PATH
    value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
  - name: LD_LIBRARY_PATH
    value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
  setup_scripts:
  output_file_patterns:
  - android-cts/logs/latest/.*
  - android-cts/results/latest/.*\.html
  - android-cts/results/latest/compatibility_result\..*
  - android-cts/results/latest/logo.png
  - android-cts/results/latest/test_result.xml
  result_file: test_result.xml
  java_properties:
  - name: CTS_ROOT
    value: ${TF_WORK_DIR}
  context_file_dir: android-cts/results/
  context_file_pattern: '[\d_\.]+\.zip'
  retry_command_line: retry --retry 0
  runner_sharding_args: --shard-count ${TF_SHARD_COUNT}

build_channels:
- id: google_drive
  name: Google Drive
  provider_name: Google Drive

device_actions:
- id: flash
  name: Flash
  test_resource_defs:
  - name: bootloader.img
    test_resource_type: DEVICE_IMAGE
  - name: radio.img
    test_resource_type: DEVICE_IMAGE
  - name: img.zip
    test_resource_type: DEVICE_IMAGE
  tradefed_target_preparers:
  - class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
    option_values:
    - name: work-dir
      values:
      - ${TF_WORK_DIR}
    - name: host-setup-command
      values:
      - adb -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL flash bootloader bootloader.img
      - fastboot -s $SERIAL flash radio radio.img
      - fastboot -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL -w update img.zip
      - adb -s $SERIAL wait-for-device
    - name: host-cmd-timeout
      values:
      - 10m

כאשר אתה מגדיר את מופע ה-Android Test Station שלך, אתה יכול לשתף את התצורה שלך עם משתמשים אחרים על ידי ייצוא שלה כקובץ. כדי לעשות זאת, עבור לדף ההגדרות ולחץ על ייצוא בפינה השמאלית העליונה.

ניהול קבצי תצורה

איור 35. ניהול קבצי תצורה.

לאחר הורדת קובץ התצורה שלך, שתף את הקובץ עם משתמשים אחרים. הם יכולים להוסיף את קובץ התצורה למופע Android Test Station שלהם על ידי לחיצה על ייבוא ובחירה בקובץ התצורה.

צור פעולת מכשיר חדשה

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

כרטיסיית פעולות מכשיר

איור 36. הכרטיסייה פעולות התקן.

הוסף פעולה חדשה במכשיר

לחץ על פעולת מכשיר חדשה .
איור 37. לחצן פעולת מכשיר חדש.
הזן שם ותיאור.
איור 38. שם פעולת ההתקן.
לחץ על הוסף מכין יעד .
הזן את שם המחלקה המלא של פדרציית יעדי המסחר , לדוגמה, com.android.tradefed.targetprep.RunHostCommandTargetPreparer .
איור 39. הוספת מכין מטרה.
ניתן למצוא רשימה של מכיני יעדים זמינים בהפניה של com.android.tradefed.targetprep .
איור 40. רשימת מכיני יעד.
הוסף אפשרויות לשימוש עם מכין היעד. כדי להציג אפשרויות זמינות, בדוק את targetprep עבור קוד המקור עבור כל מכין יעד ב-AOSP:
איור 41. דוגמה לאפשרות פעולה.
כדי להוסיף אפשרות, לחץ על Add Target Preparer Option והזן את הערכים הנדרשים.
איור 42. דוגמה לפקודת פעולה.
הגדר את משאבי הבדיקה הדרושים לביצוע פעולת המכשיר, למשל, בניית תמונות להבהוב. כדי להוסיף הגדרת משאב, לחץ על הוסף משאב בדיקה ומלא את השדות הנדרשים. אם אתה יודע היכן ממוקמים הקבצים שלך, תוכל לספק כתובת אתר להורדה כברירת מחדל על ידי לחיצה על עיון . אם מכיני היעד מקבלים ספרייה כמשאב בדיקה, בחרו Decompress . לאחר מכן ציין את ספריית היעד היחסית תחת ספריית העבודה הזמנית ואת שמות הקבצים שיש לבטל את הדחיסה. אם לא ניתנו שמות קבצים, כל הקבצים מפורקים ממשאב הבדיקה.
איור 43. משאבי בדיקת פעולה.
לחץ על עדכן .
איור 44. שמירת שינויים בפעולה.

ניהול מבחנים

ערוך מבחן

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

ערוך מבחן

איור 45. עריכת מבחן.

הוסף מבחן חדש

כדי להוסיף מבחן חדש, עבור לדף מבחנים ולחץ על צור מבחן חדש . הזן את המידע המתאים ולחץ על צור .

צור מבחן

איור 46. יצירת מבחן.

העתק מבחן

איור 47. העתקת מבחן.

ייצוא תצורות מארח

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

כדי לייצא תצורות של מארח, עבור לדף ההגדרות ולחץ על ייצוא בפינה השמאלית העליונה.

מייצא תצורות מארח

איור 48. ייצוא תצורת מארח.

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

ייבוא תצורות מארח

איור 49. ייבוא תצורת מארח.

השתמש בקבצים ובספריות מקומיות

החל מגרסה R11, קבצים בספריית $HOME/.ats_storage נגישים אוטומטית ב- Android Test Station. העתק או העבר קובץ לתוך הספרייה הזו, ואז תוכל לבחור אותו מהכרטיסייה קובץ מקומי בעת תזמון הפעלת ניסיון.

cp /path/to/file $HOME/.ats_storage

בחירת קובץ מקומי

איור 50. בחירת קובץ מספריית $HOME/.ats_storage .

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

mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2

ספריות רכובות נוספות

איור 51. ספריות נוספות מותקנות בחנות הקבצים המקומית.

אפשר מצב ריבוי מארחים

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

ארכיטקטורת מצב ריבוי מארח

איור 52. ארכיטקטורת מצב ריבוי מארח.

כדי להפעיל את בקר ה-ATS, השתמש בפקודה הבאה:
```
mtt start --operation_mode=ON_PREMISE
```
בדוק שהבקר נגיש בכתובת http://${CONTROLLER_HOSTNAME}:8000 .

כדי להפעיל את העובדים, השתמש בפקודה הבאה:

mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE

אם הרשת שלך לא מאפשרת למארחים לתקשר זה עם זה, עליך לעקוב אחר הוראות ההגדרה המתקדמות יותר למטה על ATS worker.

חבר את שני המארחים באמצעות מנהרות SSH. בחר יציאות עבור היציאות הראשיות ושרת הקבצים, לדוגמה, 9000 ו-9006.
```
ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
```

הגדר והפעל את ATS.

DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \
                --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \
                --operation_mode=ON_PREMISE

מנקה קבצים

מנקה הקבצים הוא עבודת cron שפועלת מדי שעה כדי לנקות קבצים על סמך תצורות מוגדרות על ידי המשתמש. ל-ATS יש שתי תצורות ברירת מחדל לארכיון תוצאות ריצת בדיקה ומחיקת קבצים זמניים. מדריך זה מסביר כיצד להתאים אישית את המדיניות והתצורות כדי לנהל את הקבצים שלך ביעילות.

מדיניות

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

סוג הפעולה	פרמטרים
`ARCHIVE`	`remove_file` : אם `true` , הסר את הקובץ לאחר האחסון בארכיון.
`DELETE`

הקריטריונים מבוססים על תכונות קבצים ופרטי מערכת. קריטריונים זמינים מוצגים בטבלה:

סוג קריטריון	תיאור	פרמטרים
`LAST_MODIFIED_TIME`	סנן קבצים על סמך תאריך ושעה השינוי האחרון שלהם.	`ttl` : סוגים שונים של ביטויי זמן נתמכים, למשל, `10m` , `2h` , `7 days` , `4w` . ראה `pytimeparse` לפורמטים נתמכים.
`LAST_ACCESS_TIME`	סנן קבצים על סמך תאריך ושעה אחרונים של הגישה שלהם.	זהה ל- `LAST_MODIFIED_TIME` .
`NAME_MATCH`	סנן קבצים על סמך שמם באמצעות ביטוי רגולרי.	`pattern` : ביטוי רגולרי, לדוגמה, `[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip` להתאמה רוכסנים בתוצאה.
`SYSTEM_AVAILABLE_SPACE`	הפעל פעולות על סמך השטח הפנוי במערכת.	`threshold` : הפעל פעולה כאשר השטח הפנוי יורד מתחת לסף, לדוגמה, `200` (B), `200KB` , `200MB` , `200GB` , `2TB` .

מדיניות חדשה לניקוי קבצים

איור 53. הוסף מדיניות חדשה לניקוי קבצים.

הגדרות

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

כל ספריות היעד חייבות להיות ממוקמות תחת ספריית /data . אם התצורה שלך מציינת את ספריית היעד בתור logs , היא מתפרשת כ- /data/logs .

ערוך את תצורת מנקה הקבצים

איור 54. ערוך את תצורת מנקה הקבצים.

אִתחוּל

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

אפס את הגדרות מנקה הקבצים

איור 55. אפס את הגדרות מנקה הקבצים.

תמיכה

דיווחי שגיאות

התרומה שלך ל-Android Test Station עוזרת לשפר את הפיתוח של הכלי, ואנחנו רוצים את הקלט שלך! עיין בהערות המהדורה של ATS לפרטים על המהדורה האחרונה. כדי לדווח על באגים או להציע הצעות, נא להגיש דוח באג . שותפים צריכים לדווח על באגים או הצעות דרך ערוצי השותפים שלהם.