הגדר את Eclipse

בצע את השלבים הבאים כדי להגדיר את Tradefed באמצעות Eclipse.

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

במידת הצורך, תוכל להוריד את Eclipse IDE למפתחי Java מהכתובת: eclipse.org/downloads

יצירת פרויקטים

1. הפעל make פעם אחת משורת הפקודה. פעולה זו תבנה ספריות חיצוניות בהתאם לפרויקטים שלהלן.
2. הגדר משתנה classpath TRADEFED_ROOT Window > Preferences > Java > Build Path> Classpath Variables והפנה אותו לשורש המקור המוזן שלך
3. הגדר את משתנה הנתיב TRADEFED_ROOT Window > Preferences > General > Workspace > Linked Resources והפנה אותו לשורש המקור המוזן שלך

4. השתמש באשף File > Import...-> General > Existing Projects into workspace" כדי להכניס את פרויקטי הקוד הפתוח של Java תחת הנתיבים הבאים:

   prebuilts/misc/common/ddmlib\*
   tools/loganalysis
   tools/loganalysis/tests
   tools/tradefederation/core
   tools/tradefederation/core/tests
   tools/tradefederation/contrib
   tools/tradefederation/core/remote
   platform_testing/libraries/health/runners/longevity/host
   platform_testing/libraries/annotations
   platform_testing/libraries/health/composers/host
   

5. לחלופין, אם ברצונך לראות את קוד המקור ddmlib , צרף את קוד המקור מענף כלים לא מצרפים, כגון /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java .

6. לחלופין, אם אתה רוצה גם את פרויקטי הרתמה של CTS נטענים, ייבא:

   test/suite_harness/common/util
   test/suite_harness/common/host-side/util
   test/suite_harness/common/host-side/tradefed
   

פורמט אוטומטי

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

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

1. עבור אל חלון > העדפות > Java > סגנון קוד .
2. תחת מעצב , ייבא את הקובץ android-formatting.xml .
3. תחת ארגון > יבוא , ייבא את הקובץ android.importorder .

הסר רווחים לבנים נגררים

כדי לאלץ את Eclipse להסיר את כל הרווחים הלבנים:

1. עבור אל חלון > העדפות -> Java -> עורך -> שמור פעולות .
2. לאחר מכן פעולות נוספות -> הגדר -> קוד> הכרטיסייה ארגון -> מעצב .
3. סמן הסר רווח לבן נגרר .
4. לחץ על החל וסגור .

בדוק את סגנון הקוד

בעת שליחת רשימת שינויים, יופעל הוק אוטומטי להעלאה מראש כדי לבדוק את פורמט הקוד שלך: google-java-format

זה עוזר לעצב את הקוד שלך לתקן הנפוץ.

ניפוי באגים Eclipse

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

כדי לנפות באגים בבדיקת יחידת TF, פשוט לחץ עליה באמצעות לחצן העכבר הימני ובחר Debug As > JUnit test .

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

כדי לנפות באגים בתוכנית TF עצמה, בעת הפעלת תצורה כלשהי, עקוב אחר ההוראות בסעיף הקודם להפעלת בדיקה פונקציונלית אך ספק את הארגומנטים של שורת הפקודה עבור התצורה שברצונך להפעיל בשלב 4. אז כדי לנפות באגים בתצורת 'מכשיר', עבור לתפריט Run > Debug Configuration והגדר את הכרטיסייה Arguments בתצורת Debug של Eclipse ל-- -- package <package to run> instrument .

איתור באגים מרחוק עם Eclipse

בצע את השלבים הבאים כדי לבצע ניפוי באגים מרחוק בהפעלה של tradefed שהתחילה משורת הפקודה tradefed.sh :

1. התחל tradefed.sh עם דגל ניפוי הבאגים: TF_DEBUG=1 tradefed.sh
2. המתן עד שתראה את ההנחיה הזו מה-JVM: Listening for transport dt_socket at address: 10088 משמעות הדבר היא שה-JVM ממתין ל-debugger לחיבור ביציאה 10088 .
3. צרף עם איתור באגים מרחוק של Eclipse מהתפריט הראשי: בחר הפעלה > איתור באגים... .
4. בתיבת הדו-שיח המוקפצת, בחר יישום Java מרחוק מהתפריט השמאלי.
5. לחץ על סמל תצורת השקה חדשה בסרגל הפעולות.
6. תן שם לתצורה כרצונך ובחר Tradefederation כפרויקט.
7. אכלס את הנמל באמצעות הכתובת שסופקה קודם לכן.
8. עבור לכרטיסייה מקור והוסף את הפרויקטים tradefederation ו- google-tradefed לנתיב בדיקת המקור .
9. לחץ על איתור באגים כדי להתחיל את הפעלת איתור באגים.

מאתר הבאגים מתחבר לתהליך ה-JVM ההאזנה, והמסוף הפועל tradefed.sh מציג את ההנחיה tf> .

כדי לעבור דרך הקוד שלך במצב ניפוי באגים, הגדר נקודת שבירה ב-Eclipse והפעל את פקודת Tradefed שלך (כלומר run <test> ) בטרמינל. כדי לנפות כל דבר במהלך אתחול TF, אתה יכול להגדיר תחילה את נקודת השבירה ולאחר מכן לצרף את ניפוי הבאגים של Eclipse.

טיפ: כדי להשתמש ביציאה חלופית, הוסף את TF_DEBUG_PORT=nnn לפקודה בשלב 1 למעלה. אתה יכול אפילו להשתמש בזה בסביבת ייצור אם יש לך באגים מסתוריים לתלות לחקור: שנה suspend=y ל- suspend=n ב- tradefed.sh והתחל עם דגל ניפוי באגים. ה-JVM לא ימתין לחיבור מאתר הבאגים, אבל אתה יכול לעשות זאת בכל עת כל עוד התהליך עדיין פועל.

איתור באגים מרחוק באמצעות JDB

כדי להשתמש ב-Java Debugger JDB, בצע את השלבים הדומים לאלה של Eclipse:

1. התחל tradefed.sh עם דגל ניפוי הבאגים: TF_DEBUG=1 tradefed.sh
2. המתן עד שתראה את ההנחיה מ-JVM: Listening for transport dt_socket at address: 10088 .

3. חבר jdb . לדוגמה, מ-root run:

   jdb -attach 10088 \
       -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src
   

4. המתן לחיבור והרחק את הבאגים! הפעל man jdb לעזרה נוספת.

בדוק את כיסוי הקוד

1. התקן את הפלאגין Eclemma .
2. עבור אל עזרה > התקן תוכנה חדשה והפנה את האשף אל: http://update.eclemma.org/
3. לאחר ההתקנה, בחר באפשרות Coverage As > JUnit test כדי לבצע ריצת כיסוי קוד.