اتبع هذه الخطوات لإعداد Tradefed باستخدام Eclipse.
أنشئ مساحة عمل منفصلة لتطوير Trade Federation، ولا تُعيد استخدام التي تم استخدامها من قبل لتطوير أجهزة Android.
إذا لزم الأمر، يمكنك تنزيل Eclipse IDE لمطوّري Java من: eclipse.org/downloads
إنشاء المشاريع
- شغّل Make مرة واحدة من سطر الأوامر. سيؤدي ذلك إلى إنشاء مكتبات خارجية تعتمد على المشروعات أدناه.
- اضبط متغيّر مسار الفئة 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 لضبط أداة التنسيق تلقائيًا على دليل استخدام Android. لإجراء ذلك في "استوديو YouTube"، يُرجى اتّباع الخطوات التالية:
- انتقِل إلى نافذة >. التفضيلات > Java > نمط الرمز:
- ضمن المنسق، استورد الملف
android-formatting.xml
. - ضمن تنظيم > الاستيراد، قم باستيراد الملف
android.importorder
.
إزالة المسافات البيضاء اللاحقة
لفرض إيقاف Eclipse لإزالة جميع المسافات البيضاء اللاحقة:
- انتقِل إلى نافذة >. التفضيلات -> Java -> المحرر -> حفظ الإجراءات.
- ثم إجراءات إضافية -> ضبط -> الرمز > علامة التبويب "تنظيم" -> التنسيق:
- حدد إزالة المسافة البيضاء اللاحقة.
- انقر على تطبيق وإغلاق.
التحقّق من نمط الرمز البرمجي
عند إرسال قائمة تغييرات، سيتم تشغيل عنصر جذب تلقائي للتحميل المسبق للتحقق من
تنسيق الرمز: google-java-format
يساعد هذا في تنسيق التعليمة البرمجية وفقًا للمعيار الشائع.
خطأ تصحيح الأخطاء
إذا كنت تريد تشغيل رمز TF من خلال برنامج تصحيح أخطاء في Eclipse، ننصحك قم أولاً بإنشاء اختبار وحدة للكود المعني حيث سيكون هذا أبسط والأسرع في ممارسة الوظائف.
لتصحيح أخطاء اختبار وحدة TF، ما عليك سوى النقر بزر الماوس الأيمن عليها واختيار Debug As > (تصحيح الأخطاء باسم) وحدة الاختبار.
لتصحيح أخطاء اختبار TF الوظيفي، اتّبِع التعليمات الواردة في القسم السابق. لإجراء اختبار وظيفي، ولكن استخدم القائمة تشغيل > قائمة عمليات ضبط تصحيح الأخطاء.
لتصحيح أخطاء برنامج TF نفسه، اتّبِع الخطوات التالية عند تشغيل أي عملية ضبط.
التعليمات الواردة في القسم السابق لإجراء اختبار وظيفي ولكنها تقدم
وسيطات سطر الأوامر للتهيئة التي تريد تشغيلها في الخطوة 4. إذًا،
لتصحيح أخطاء "الأداة" التهيئة، انتقل إلى تشغيل > ضبط تصحيح الأخطاء
وضبط علامة التبويب الوسيطات في إعداد تصحيح أخطاء Eclipse على
-- package <package to run> instrument
تصحيح الأخطاء عن بُعد باستخدام Eclipse
اتّبِع هذه الخطوات لتصحيح الأخطاء عن بُعد في جلسة مقايضة بدأت من
سطر الأوامر tradefed.sh
:
- ابدأ Tradefed.sh باستخدام علامة تصحيح الأخطاء:
TF_DEBUG=1 tradefed.sh
. - انتظِر إلى أن يظهر لك هذا الطلب من JVM:
Listening for transport dt_socket at address: 10088
، ما يعني أنّ JVM ينتظر برنامج تصحيح الأخطاء إرفاقها في المنفذ10088
- الإرفاق باستخدام تصحيح الأخطاء عن بُعد في Eclipse من القائمة الرئيسية: اختَر تشغيل > تصحيح الأخطاء الإعدادات....
- في مربع الحوار المنبثق، اختَر تطبيق Java عن بُعد من القائمة اليمنى.
- انقر على رمز إعدادات الإطلاق الجديدة في شريط الإجراءات.
- أدخِل اسمًا للإعدادات كما تريد واختَر tradefederation على أنّها مشروعك.
- عليك تعبئة المنفذ باستخدام العنوان الذي قدّمته سابقًا.
- بدِّل إلى علامة التبويب Source (المصدر) وأضِف tradefederation للمشروعات نقلت google إلى مسار البحث عن المصدر.
- انقر على تصحيح الأخطاء لبدء جلسة تصحيح الأخطاء.
يتم ربط برنامج تصحيح الأخطاء بعملية JVM للاستماع وتشغيل الوحدة الطرفية.
يعرض tradefed.sh
الطلب tf>
.
للتنقّل عبر الرمز في وضع تصحيح الأخطاء، اضبِط نقطة فاصل في Eclipse واستدعِها.
أمر مقايضة (أي run <test>
) في الوحدة الطرفية. لتصحيح أي أخطاء
أثناء بدء تشغيل TF، يمكنك تعيين نقطة الفاصل أولاً ثم إرفاق عرض الكسوف
برنامج تصحيح الأخطاء.
ملاحظة: لاستخدام منفذ بديل، أضِف TF_DEBUG_PORT=nnn
إلى الأمر في الخطوة 1.
أعلاه. يمكنك أيضًا استخدام هذا في بيئة الإنتاج إذا كانت لديك معلومات
يُرجى وضع علامة على الأخطاء للتحقيق فيها: تغيير suspend=y
إلى suspend=n
في tradefed.sh
و
ابدأ بعلامة تصحيح الأخطاء. لن ينتظر آلة متجه الدعم
حتى يتم إرفاق برنامج تصحيح الأخطاء، ولكن يمكنك إجراء ذلك
لذلك في أي وقت ما دامت العملية مستمرة.
تصحيح الأخطاء عن بُعد باستخدام JDB
لاستخدام Java Debugger JDB، اتّبِع الخطوات المشابهة لتلك الخاصة بـ Eclipse:
- بدء
tradefed.sh
بعلامة تصحيح الأخطاء:TF_DEBUG=1 tradefed.sh
- انتظِر إلى أن يظهر لك إشعار من JVM:
Listening for transport dt_socket at address: 10088
. الربط بـ "
jdb
" على سبيل المثال، من تشغيل croot:jdb -attach 10088 \ -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src
يُرجى انتظار الاتصال بالإنترنت وتصحيح الأخطاء. يمكنك تشغيل
man jdb
للحصول على مزيد من المساعدة.
فحص تغطية الرمز البرمجي
- ثبِّت المكوّن الإضافي Eclemma.
- انتقل إلى مساعدة > ثبِّت برنامجًا جديدًا ووجِّه المعالج لإجراء ما يلي: http://update.eclemma.org/
- بعد التثبيت، اختَر التغطية باسم > لإجراء اختبار JUnit تشغيل تغطية التعليمة البرمجية.