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