כדי לאפשר לצוותים שמוסיפים קוד שאינו קוד ליבה למאגרי tradefederation לקבל בעלות מלאה על תהליך הבדיקה, יצרנו את הפרויקטים הבאים עם הרשאות פתוחות של +2 לכל הצוותים. כך צוות הליבה של Tradefederation לא צריך לבצע את כל בדיקות הקוד שלא קשורות למסגרת הליבה, וגם הצוותים האחרים יכולים לבצע איטרציות מהירות יותר בתהליך הבדיקה שלהם.
Non-core src מוגדר כקוד שלא נדרש על ידי המסגרת tradefederation כדי לפעול (למשל, בדיקות מותאמות אישית, הגדרות, כלי בדיקה ספציפיים).
חשוב: מחלקות src שאינן ליבה לא צריכות להרחיב מחלקות ליבה של tradefederation. הפעולה הזו משפיעה על שינוי מבנה הקוד או על ניקוי שלו בעתיד. אם אתם לא בטוחים אם הקוד שלכם שייך ל-core או ל-contrib, אתם יכולים לפנות לכתובת android-tradefed@ כדי לקבל הבהרה. הצוות המרכזי של Tradefedration ישמח לייעץ ולקבל בקשות לתכונות.
דוגמה למחלקה מרכזית של Tradefed: כל מחלקה בחבילה
com.google.android.tradefed.build, כמו:com.google.android.tradefed.build.LaunchControlProviderאם לא ברור לך מה נחשב כ-core class ב-android-tradefed@, אפשר לפנות אלינו.
[TOC]
נתיבים של פרויקטים של תרומות
למי מיועדים פרויקטים של תרומות?
אם אתם עובדים כרגע בפרויקטים של tradefederation בכתיבת בדיקות/כלי בדיקה/הגדרות, הפרויקטים האלה נוצרו בשבילכם.
בקרות קוד בפרויקטים של תורמים
המטרה של פרויקטים של תורמים היא לאפשר לכם לפתח ב-Tradefed בלי שתצטרכו לקבל אישור מצוות הליבה (android-tradefed@). לכן אנחנו מצפים שהצוות שלך או כל מי שמכיר את ההקשר שלך יבצעו את בדיקות הקוד ב-CL שלך.
אם נתקעתם או שאתם צריכים הדרכה לגבי מקרה מסוים, אתם תמיד יכולים לפנות לכתובת android-tradefed@, אבל אל תסתמכו על כך כברירת מחדל כדי לבדוק את הקוד שלכם ב-contrib. לצוות Tradefed אין SLO בכל הנוגע לבדיקות קוד ב-contrib.
איפה אפשר להתחיל לעבוד על הפרויקטים האלה?
הם נוספו למניפסטים של הענפים הבאים וכבר מהווים חלק מתהליך התשלום בפלטפורמה הראשית, כך שאם אתם לא רואים את הפרויקטים בסביבה שלכם, אתם במרחק של סנכרון מאגר מלתרום.
- ראשי
- tradefed
- oc-dev
- oc-dev-plus-aosp
- nyc-mr2-dev-plus-aosp
- main-daydream-dev
- main-without-vendor
- wear-main
פיתוח ובדיקה
הפיתוח ב-contrib צריך לעמוד באותם סטנדרטים של איכות כמו בכל מקום אחר במאגרי Android:
- פועלים בהתאם להנחיות הפורמט של Android
- הקוד נבדק ונשלח עם בדיקות
- העיצוב מוקפד והגיוני
איך בודקים באופן מקומי ב-contrib?
AOSP
ב-AOSP, בדיקות היחידה של contrib ממוקמות ב-platform/tools/tradefederation/contrib/tests/src/, ובדיקות היחידה צריכות להתווסף ל-com.android.tradefed.prodtests.UnitTests כדי שהן יזוהו בסקריפטים של בדיקות מקומיות ולפני שליחה.
סקריפטים מקומיים של AOSP אחרי הפעלת lunch:
tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh
עדכון כללים לפרויקטים של תרומות
כללי הבנייה (קבצי makefile) נמצאים בתיקייה משלהם, build/, ונעולים על ידי קובץ OWNERS. הקובץ הזה ימנע מכם לשנות אותם בלי בדיקה נוספת מצוות הליבה. זו ההגבלה היחידה על פרויקט התרומה.
אנחנו צריכים לבצע את הבדיקה הזו כדי לוודא שלא נוספו תלויות לא צפויות לפרויקטים הכלליים של Tradefed בלי שהצוות המרכזי ידע על כך או יסכים לכך.
אם אתם באמת צריכים להוסיף תלות חדשה, אתם יכולים לפנות אל android-tradefed@ כדי לבדוק את תרחישי השימוש שלכם ולקבל ייעוץ.