إعداد Eclipse

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

اتّبِع الخطوات التالية لإعداد Tradefed باستخدام Eclipse.

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

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

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

1. تشغيل make مرة واحدة من سطر الأوامر سيؤدي ذلك إلى إنشاء مكتبات خارجية تعتمد عليها المشاريع أدناه.
2. اضبط متغيّر classpath‏ TRADEFED_ROOT في Window > Preferences > Java > Build Path> Classpath Variables وأشِره إلى جذر مصدر tradefed.
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. لذلك، لتصحيح أخطاء إعدادات "التطبيق الآلي"، انتقِل إلى القائمة Run (تشغيل) > Debug configuration (إعدادات تصحيح الأخطاء) واضبط علامة التبويب Arguments (المَعلمات) في إعدادات تصحيح الأخطاء في 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. انتقِل إلى علامة التبويب المصدر وأضِف المشروعَين 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 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. بعد التثبيت، اختَر خيار الاختبار Coverage As > JUnit لإجراء عملية تغطية للرمز البرمجي.