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