لتمكين الفرق التي تساهم بـ src غير أساسية في مشروعات الاتحاد التجاري الملكية الكاملة لعملية المراجعة، تم إنشاء المشروعات التالية مع توفير حقوق +2 مفتوحة لجميع الفرق. وهذا يخفف من فريق الاتحاد التجاري الأساسي من عبء جميع مراجعات التعليمات البرمجية غير المرتبطة بإطار العمل الأساسي مما يسمح للفرق الأخرى بالتكرار بشكل أسرع في دورة المراجعة.
يتم تعريف src غير الأساسية على أنّها الرمز البرمجي الذي لا يتطلّب إطار عمل tradefederation أن يكون وظيفيًا (مثل الاختبارات المخصّصة والإعدادات وأدوات اختبار معيّنة).
ملاحظة مهمّة: يجب ألا يوسِّع نطاق src غير الأساسي فئات الاتحادات التجارية الأساسية. ويؤثّر ذلك في عمليات إعادة التنظيم أو التنظيف المستقبلية. إذا لم تكن متأكدًا من أنّ الرمز الخاص بك الأساسية أو المساعدة، يُرجى التواصل مع android-tradefed@ لمزيد من التوضيح. ويسعد فريق الاتحاد التجاري الأساسي تقديم المشورة بشأن طلبات الميزات وتلقّيها.
ومن الأمثلة على فئات الاتحاد التجاري الأساسية أي فئة في حزمة
com.google.android.tradefed.buildمثل:com.google.android.tradefed.build.LaunchControlProviderمرة أخرى، يُرجى التواصل معنا إذا لم تكن متأكدًا مما يمكن اعتباره ملفًا أساسيًا في ملف الالتماس على android-tradefed@.
[جدول المحتويات]
المساهمة في المشروعات المسارات
لمن تقدّم هذه المشاريع المخصّصة للمساهمين؟
إذا كنت تعمل حاليًا في مشروعات الاتحاد التجاري، تكتب الاختبارات/الاختبار المرافق/الإعدادات، تم إنشاء هذه المشاريع من أجلك.
مراجعات التعليمة البرمجية في مشروعات المساهمة
الهدف من مشروعات المساهمة هو السماح لك بالقيام بالتنمية في Tradefed بدون الحاجة إلى مراجعة الفريق الأساسي (android-tradefed@). لذلك، نتوقع أن يُجري فريقك أو أي شخص على دراية بالسياق مراجعات الرموز البرمجية على طلبات الدمج.
يُرجى عدم التردّد في التواصل مع android-tradefed@ في حال واجهت مشكلة أو كنت بحاجة إلى إرشادات بشأن في حالة معينة، ولكن لا تعتمد عليها افتراضيًا لإجراء مراجعة التعليمات البرمجية في مساهمة ليس لدى الفريق المعني هدف ذات صلة عندما يتعلق الأمر بمراجعات الرموز البرمجية من خلال المساهمة.
أين يمكنني بدء العمل على هذه المشاريع؟
تمت إضافتها إلى بيانات الإصدارات الفرعية التالية وهي جزء من الإصدار الرئيسي للمنصة، لذا إذا لم تظهر لك المشاريع في بيئتك، عليك مزامنة المستودع قبل المساهمة.
- الرئيسي
- مقايضة
- oc-dev
- oc-dev-plus-aosp
- nyc-mr2-dev-plus-aosp
- تطوير-daydream
- الرئيسي بدون بائع
- واجهة ارتداء الجهاز
التطوير والاختبار
من المتوقع أن يكون للتطوير في المساهمة نفس مستوى الجودة مثل أي مكان آخر في مستودعات Android:
- الالتزام بإرشادات التنسيق في Android
- تمّ اختبار الرمز وإرساله مع الاختبارات.
- التصميم مدروس ومنطقي
كيف يمكنني إجراء الاختبار على الجهاز المحلي في contrib؟
مشروع مفتوح المصدر لنظام Android (AOSP)
في Aosp، توجد اختبارات وحدة المساهمة في platform/tools/tradefederation/contrib/tests/src/ وينبغي إضافة اختبارات الوحدة إلى com.android.tradefed.prodtests.UnitTests ليتم الاختيار في النصوص البرمجية للإرسال المسبق والاختبار المحلي.
النصوص البرمجية المحلية في نظام التشغيل Aosp بعد تشغيل lunch:
tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh
تحديث القواعد للمساهمة في المشاريع
تتوفّر قواعد التصميم (makefiles) ضِمن مجلد "build/" الخاص بها ومقفلة بواسطة
ملف واحد (OWNERS) سيؤدي إلى منعك من تعديلها بدون إجراء مراجعة إضافية
من الفريق الأساسي. هذا هو الحدّ الوحيد المفروض على مشروع المساهمين.
نحتاج إلى إجراء هذه المراجعة للتأكد من عدم إضافة تبعيات غير متوقعة إلى
إجمالي المشروعات المقايضة دون معرفة أو موافقة من الفريق الأساسي.
إذا كنت حقًا بحاجة إلى إضافة بعض التبعيات الجديدة، فيرجى الاتصال
android-tradefed@ للنظر في حالات الاستخدام وتقديم المشورة لك.