إعداد 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 ووجِّهه إلى جذر المصدر التبادلي

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. انتقِل إلى نافذة >. التفضيلات -> Java -> المحرر -> حفظ الإجراءات.
2. ثم إجراءات إضافية -> ضبط -> الرمز > علامة التبويب "تنظيم" -> التنسيق:
3. حدد إزالة المسافة البيضاء اللاحقة.
4. انقر على تطبيق وإغلاق.

التحقّق من نمط الرمز البرمجي

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

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

خطأ تصحيح الأخطاء

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

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

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

لتصحيح أخطاء برنامج TF نفسه، اتّبِع الخطوات التالية عند تشغيل أي عملية ضبط. التعليمات الواردة في القسم السابق لإجراء اختبار وظيفي ولكنها تقدم وسيطات سطر الأوامر للتهيئة التي تريد تشغيلها في الخطوة 4. إذًا، لتصحيح أخطاء "الأداة" التهيئة، انتقل إلى تشغيل > ضبط تصحيح الأخطاء وضبط علامة التبويب الوسيطات في إعداد تصحيح أخطاء Eclipse على -- package <package to run> instrument

تصحيح الأخطاء عن بُعد باستخدام Eclipse

اتّبِع هذه الخطوات لتصحيح الأخطاء عن بُعد في جلسة مقايضة بدأت من سطر الأوامر 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 إلى مسار البحث عن المصدر.
9. انقر على تصحيح الأخطاء لبدء جلسة تصحيح الأخطاء.

يتم ربط برنامج تصحيح الأخطاء بعملية JVM للاستماع وتشغيل الوحدة الطرفية. يعرض tradefed.sh الطلب tf>.

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

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

تصحيح الأخطاء عن بُعد باستخدام 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 تشغيل تغطية التعليمة البرمجية.