إعداد Eclipse

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

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

إذا لزم الأمر، يمكنك تنزيل Eclipse IDE لمطوّري Java من: eclipse.org/downloads

إنشاء المشاريع

1. تشغيل make مرة واحدة من سطر الأوامر سيؤدي ذلك إلى إنشاء مكتبات خارجية تعتمد عليها المشاريع أدناه.
2. اضبط متغيّر مسار الفئة TRADEFED_ROOT في Window > Preferences > Java > Build Path> Classpath Variables ووجِّهه إلى جذر المصدر المتداول
3. اضبط متغيّر مسار TRADEFED_ROOT في Window > Preferences > General > Workspace > Linked Resources ووجِّهه إلى جذر مصدر tradefed.

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. لإجراء ذلك في "استوديو YouTube"، يُرجى اتّباع الخطوات التالية:

1. انتقِل إلى نافذة > الإعدادات المفضّلة > Java > نمط الرمز البرمجي.
2. ضمن المنسق، استورِد الملف android-formatting.xml.
3. ضمن تنظيم > عمليات الاستيراد، استورِد الملف android.importorder.

إزالة المسافات البيضاء اللاحقة

لفرض إزالة Eclipse لجميع المسافات البيضاء اللاحقة:

1. انتقِل إلى Window (النافذة) > Preferences (الإعدادات المفضّلة) -> Java (جافا) -> Editor (المحرِّر) -> Save Actions (حفظ الإجراءات).
2. بعد ذلك، انقر على الإجراءات الإضافية -> الضبط -> الرمز البرمجي -> علامة التبويب "التنظيم" -> المنسق.
3. ضَع علامة في المربّع بجانب إزالة المسافة الفارغة اللاحقة.
4. انقر على تطبيق وإغلاق.

التحقّق من نمط الرمز

عند إرسال قائمة تغييرات، سيتم تشغيل عنصر جذب تلقائي للتحميل المسبق للتحقّق من تنسيق الرمز: google-java-format

يساعد ذلك في تنسيق الرمز البرمجي وفقًا للمعيار الشائع.

تصحيح أخطاء Eclipse

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

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

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

لتصحيح أخطاء برنامج TF نفسه، اتّبِع عند تنفيذ أيّ إعدادات التعليمات الواردة في القسم السابق لإجراء اختبار وظيفي، ولكن قدِّم وسيطات سطر الأوامر للإعدادات التي تريد تنفيذها في الخطوة 4. لتصحيح أخطاء إعداد "الأداة"، انتقِل إلى القائمة تشغيل > إعداد تصحيح الأخطاء، واضبط علامة التبويب الوسيطات في إعداد تصحيح أخطاء 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. في مربّع الحوار المنبثق، اختَر تطبيق Java عن بُعد من القائمة اليمنى.
5. انقر على رمز إعدادات إطلاق جديدة في شريط الإجراءات.
6. أدخِل اسمًا للإعدادات كما تريد واختَر tradefederation لتكون المشروع.
7. املأ المنفذ باستخدام العنوان المقدَّم سابقًا.
8. انتقِل إلى علامة التبويب Source (المصدر) وأضِف المشروعين tradefederation وgoogle-tradefed إلى مسار البحث عن المصدر.
9. انقر على تصحيح الأخطاء لبدء جلسة تصحيح الأخطاء.

يتم إرفاق أداة تصحيح الأخطاء بعملية JVM التي تستمع إلى الطلبات، وتعرض الوحدة الطرفية التي تعمل tradefed.sh طلب tf>.

للتنقُّل في الرمز البرمجي في وضع تصحيح الأخطاء، اضبط نقطة فاصل في Eclipse واستدعِ الأمر Tradefed (أي run <test>) في الوحدة الطرفية. لتصحيح أي أخطاء أثناء بدء TF، يمكنك ضبط نقطة التوقف أولاً ثم إرفاق Eclipse IDE IDE debugging tool.

ملاحظة: لاستخدام منفذ بديل، أضِف TF_DEBUG_PORT=nnn إلى الأمر في الخطوة 1 أعلاه. يمكنك أيضًا استخدام هذا الإجراء في بيئة الإنتاج إذا كانت لديك أخطاء تتعلّق بالتعليق المفاجئ وكنت تريد التحقيق فيها: غيِّر suspend=y إلى suspend=n في tradefed.sh و ابدأ باستخدام علامة تصحيح الأخطاء. لن تنتظر آلة Java الافتراضية ربط أداة تصحيح الأخطاء، ولكن يمكنك إجراء ذلك في أي وقت طالما أنّ العملية لا تزال جارية.

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

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

4. انتظِر اكتمال الاتصال ويمكنك تصحيح الأخطاء. يمكنك تنفيذ man jdb للحصول على مزيد من المساعدة.

فحص نسبة استخدام رموز الصفحة

1. ثبِّت مكوّن Eclemma الإضافي.
2. انتقِل إلى المساعدة > تثبيت برنامج جديد ووجِّه المعالج إلى: http://update.eclemma.org/
3. بعد التثبيت، اختَر خيار الاختبار التغطية على أنّها > JUnit لإجراء عملية تغطية للرمز البرمجي.