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