בצע את השלבים הבאים כדי להגדיר את Tradefed באמצעות Eclipse.
צור סביבת עבודה נפרדת לפיתוח Trade Federation, אל תעשה שימוש חוזר בסביבת עבודה שכבר הועסקה לפיתוח מכשירי אנדרואיד.
במידת הצורך, תוכל להוריד את Eclipse IDE למפתחי Java מהכתובת: eclipse.org/downloads
יצירת פרויקטים
- הפעל make פעם אחת משורת הפקודה. פעולה זו תבנה ספריות חיצוניות בהתאם לפרויקטים שלהלן.
- הגדר משתנה classpath TRADEFED_ROOT
Window > Preferences > Java > Build Path> Classpath Variables
והפנה אותו לשורש המקור המוזן שלך - הגדר את משתנה הנתיב TRADEFED_ROOT
Window > Preferences > General > Workspace > Linked Resources
והפנה אותו לשורש המקור המוזן שלך השתמש באשף
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
לחלופין, אם ברצונך לראות את קוד המקור
ddmlib
, צרף את קוד המקור מענף כלים לא מצרפים, כגון /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java .לחלופין, אם אתה רוצה גם את פרויקטי הרתמה של 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 כדי להגדיר אוטומטית את הפורמט למדריך הסגנונות של אנדרואיד. כדי לעשות זאת בסטודיו:
- עבור אל חלון > העדפות > Java > סגנון קוד .
- תחת מעצב , ייבא את הקובץ
android-formatting.xml
. - תחת ארגון > יבוא , ייבא את הקובץ
android.importorder
.
הסר רווחים לבנים נגררים
כדי לאלץ את Eclipse להסיר את כל הרווחים הלבנים:
- עבור אל חלון > העדפות -> Java -> עורך -> שמור פעולות .
- לאחר מכן פעולות נוספות -> הגדר -> קוד> הכרטיסייה ארגון -> מעצב .
- סמן הסר רווח לבן נגרר .
- לחץ על החל וסגור .
בדוק את סגנון הקוד
בעת שליחת רשימת שינויים, יופעל הוק אוטומטי להעלאה מראש כדי לבדוק את פורמט הקוד שלך: 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
:
- התחל tradefed.sh עם דגל ניפוי הבאגים:
TF_DEBUG=1 tradefed.sh
- המתן עד שתראה את ההנחיה הזו מה-JVM:
Listening for transport dt_socket at address: 10088
משמעות הדבר היא שה-JVM ממתין ל-debugger לחיבור ביציאה10088
. - צרף עם איתור באגים מרחוק של Eclipse מהתפריט הראשי: בחר הפעלה > איתור באגים... .
- בתיבת הדו-שיח המוקפצת, בחר יישום Java מרחוק מהתפריט השמאלי.
- לחץ על סמל תצורת השקה חדשה בסרגל הפעולות.
- תן שם לתצורה כרצונך ובחר Tradefederation כפרויקט.
- אכלס את הנמל באמצעות הכתובת שסופקה קודם לכן.
- עבור לכרטיסייה מקור והוסף את הפרויקטים tradefederation ו- google-tradefed לנתיב בדיקת המקור .
- לחץ על איתור באגים כדי להתחיל את הפעלת איתור באגים.
מאתר הבאגים מתחבר לתהליך ה-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:
- התחל
tradefed.sh
עם דגל ניפוי הבאגים:TF_DEBUG=1 tradefed.sh
- המתן עד שתראה את ההנחיה מ-JVM:
Listening for transport dt_socket at address: 10088
. חבר
jdb
. לדוגמה, מ-root run:jdb -attach 10088 \ -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src
המתן לחיבור והרחק את הבאגים! הפעל
man jdb
לעזרה נוספת.
בדוק את כיסוי הקוד
- התקן את הפלאגין Eclemma .
- עבור אל עזרה > התקן תוכנה חדשה והפנה את האשף אל: http://update.eclemma.org/
- לאחר ההתקנה, בחר באפשרות Coverage As > JUnit test כדי לבצע ריצת כיסוי קוד.