כדי לאפשר לצוותים שתורמים קובצי src שאינם ליבה לפרויקטים של Trade Federation להיות הבעלים המלאים של תהליך הבדיקה, הפרויקטים הבאים נוצרו עם הרשאות 'פתוח' +2 לכל הצוותים. כך הצוות המרכזי של Trade Federation לא צריך לבדוק את כל הקוד שלא קשור למסגרת הליבה, וגם הצוותים האחרים יכולים לבצע איטרציות מהר יותר במחזור הבדיקה שלהם.
Non-core src מוגדר כקוד שלא נדרש לתפקוד של מסגרת tradefederation (למשל, בדיקות בהתאמה אישית, הגדרות, כלי בדיקה ספציפיים).
חשוב: לא מומלץ להרחיב את הכיתות של tradefederation ל-src שאינן ליבה. הפעולה הזו משפיעה על רה-פירמנטציה או ניקוי עתידיים. אם אתם לא בטוחים אם הקוד הוא ליבה או לתורמים, תוכלו לפנות אל android-tradefed@ לקבלת הבהרה. צוות הליבה של Trade Federation ישמח לייעץ ולקבל בקשות להוספת תכונות.
דוגמה למחלקה ליבה של Trade Federation היא כל מחלקה בחבילה
com.google.android.tradefed.build, כמו:com.google.android.tradefed.build.LaunchControlProviderשוב, אם לא ברור לכם מה נחשב ככיתה ליבה, תוכלו לפנות אל android-tradefed@.
[תנאים והגבלות]
נתיבים של פרויקטים של תרומות
למי מיועדים פרויקטי ה-contrib האלה?
אם אתם עובדים כרגע בפרויקטים של Trade Federation וכותבים בדיקות, כלי בדיקה או הגדרות, הפרויקטים האלה נוצרו בשבילכם.
בדיקות קוד בפרויקטים של תרומות
מטרת הפרויקטים של Contrib היא לאפשר לכם פיתוח ב-Trended בלי שתצטרכו לבדוק את צוות הליבה (android-tradefed@). לכן אנחנו מצפים מהצוות שלכם או מכל מי שמכיר את ההקשר שלכם לבצע את בדיקות הקוד ב-CLs.
תמיד אפשר לפנות אל android-tradefed@ אם נתקעתם או אם אתם זקוקים להדרכה לגבי מקרה ספציפי, אבל אל תסתמכו על כך כברירת מחדל כדי לבדוק את הקוד ב-contrib. לצוות Tradefed אין יעד SLO לגבי בדיקות קוד ב-contrib.
איפה אפשר להתחיל לעבוד על הפרויקטים האלה?
הם נוספו למניפסטים הבאים של ההסתעפויות, והם כבר חלק מה-checkout הראשי של הפלטפורמה. לכן, אם אתם לא רואים את הפרויקטים בסביבה שלכם, עליכם לבצע סנכרון של המאגר כדי שתוכלו לתרום.
- ראשי
- tradefed
- oc-dev
- oc-dev-plus-aosp
- nyc-mr2-dev-plus-aosp
- Main-daydream-dev
- ראשי ללא ספק
- 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
יצירת עדכון של כללים להוספת פרויקטים
כללי ה-build (קובצי make) נמצאים בתיקייה build/ משלהם, והם נעולים באמצעות קובץ OWNERS שימנע מכם לשנות אותם בלי בדיקה נוספת מצוות הליבה. זו המגבלה היחידה בפרויקט contrib.
אנחנו צריכים את הבדיקה הזו כדי לוודא שלא נוספות יחסי תלות לא צפויים לפרויקטים הכוללים של Tradefed בלי ידיעת הצוות הליבה או הסכמתו.
אם צריך להוסיף יחסי תלות חדשים, אפשר לפנות אל android-tradefed@ כדי לבדוק את התרחישים לדוגמה ולקבל ייעוץ.