قم بإعداد Eclipse

اتبع هذه الخطوات لإعداد Tradefed باستخدام Eclipse.

قم بإنشاء مساحة عمل منفصلة لتطوير Trade Union، ولا تقم بإعادة استخدام مساحة العمل المستخدمة بالفعل لتطوير أجهزة Android.

إذا لزم الأمر، يمكنك تنزيل 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 لتعيين المنسق تلقائيًا على دليل نمط Android. للقيام بذلك في الاستوديو:

1. انتقل إلى Window > Preferences > Java > Code Style .
2. ضمن Formatter ، قم باستيراد الملف android-formatting.xml .
3. ضمن تنظيم > الواردات ، قم باستيراد الملف android.importorder .

إزالة المسافات البيضاء الزائدة

لإجبار Eclipse على إزالة جميع المسافات البيضاء الزائدة:

1. انتقل إلى نافذة > التفضيلات -> جافا -> المحرر -> حفظ الإجراءات .
2. ثم إجراءات إضافية -> تكوين -> الكود - علامة التبويب تنظيم -> المنسق .
3. تحقق من إزالة المسافة البيضاء الزائدة .
4. انقر فوق تطبيق وإغلاق .

تحقق من نمط الكود

عند إرسال قائمة التغيير، سيتم تشغيل رابط التحميل المسبق التلقائي للتحقق من تنسيق الكود الخاص بك: google-java-format

يساعد هذا في تنسيق التعليمات البرمجية الخاصة بك وفقًا للمعايير المشتركة.

تصحيح الكسوف

إذا كنت تريد تشغيل كود TF من خلال مصحح أخطاء في Eclipse، فمن المستحسن أن تقوم أولاً بإنشاء اختبار وحدة للكود المعني لأن هذه ستكون أبسط وأسرع طريقة لممارسة الوظيفة.

لتصحيح اختبار وحدة TF، ما عليك سوى النقر بزر الماوس الأيمن عليه وتحديد Debug As > JUnit test .

لتصحيح اختبار وظيفي لـ TF، اتبع الإرشادات الواردة في القسم السابق لتشغيل اختبار وظيفي ولكن استخدم قائمة تشغيل > تكوينات التصحيح .

لتصحيح أخطاء برنامج TF نفسه، عند تشغيل أي تكوين، اتبع الإرشادات الواردة في القسم السابق لتشغيل اختبار وظيفي ولكن قم بتوفير وسيطات سطر الأوامر للتكوين الذي ترغب في تشغيله في الخطوة 4. لذا لتصحيح أخطاء تكوين "الأداة"، انتقل إلى قائمة تكوين Run > 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 ينتظر إرفاق مصحح الأخطاء في المنفذ 10088 .
3. أرفق مع تصحيح الأخطاء عن بعد لـ Eclipse من القائمة الرئيسية: حدد تشغيل > تكوينات التصحيح... .
4. في مربع الحوار المنبثق، حدد Remote Java Application من القائمة اليسرى.
5. انقر فوق أيقونة تكوين التشغيل الجديد على شريط الإجراءات.
6. قم بتسمية التكوين كما تريد وحدد tradefederation كمشروع.
7. قم بملء المنفذ باستخدام العنوان المقدم مسبقًا.
8. قم بالتبديل إلى علامة التبويب المصدر وأضف المشروعات tradefederation و google-tradefed إلى مسار البحث عن المصدر .
9. انقر فوق Debug لبدء جلسة تصحيح الأخطاء.

يتصل مصحح الأخطاء بعملية الاستماع 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 . على سبيل المثال، من تشغيل crroot:

   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 لإجراء تشغيل تغطية التعليمات البرمجية.