اتفاقية الترخيص
يلبّي WebRTC رموز تصحيح/سحب الميزات وإصلاح الأخطاء.
بالنسبة إلى المساهمين خارج Google، اتّبع التعليمات الواردة في اتفاقية ترخيص المساهم الفردي من Google. وفي جميع الحالات، يجب أن يوقّع المساهمون على اتفاقية ترخيص المساهمين قبل قبول المساهمة. يُرجى إكمال اتفاقية فردي أو مؤسسة حسبما تقتضي الحاجة.
عينات مُساهِمة
إذا كنت تخطط لإضافة نموذج جديد أو إجراء تغييرات كبيرة على عيّنة حالية، ننصحك بالبدء في إنشاء مشكلة جديدة يمكننا من خلالها مناقشة التفاصيل.
عند إنشاء نموذج جديد أو تحديث نموذج حالي، يُرجى التأكد من إنشاء أي اختبارات حالية أو تحديثها أيضًا. يتم تنفيذ جميع الاختبارات في ذلك المستودع مثل اختبارات واجهة مستخدم Watchwatch.JS، لذا يُرجى اتباع التصميم نفسه في جهازك.
التعليمات
المساهمة في التصحيح الأول
يجب إجراء بعض التحضير لتحميل أول قيمة ترخيص:
- الاطّلاع على الرمز وإنشائه
- املأ اتفاقية المساهم (انظر أعلاه)
- إذا لم ترسل رمزًا من قبل، عليك إضافة اسمك (أو اسم مؤسستك) في حال توقيع اتفاقية المساهم من قِبل مؤسستك ومعلومات الاتصال إلى ملف المؤلفين
- انتقل إلى
https://webrtc.googlesource.com/new-password
وسجّل الدخول باستخدام حساب بريدك الإلكتروني. يجب أن يكون هذا الحساب هو نفسه الذي تم إرجاعه بحلول
git config user.email. - بعد ذلك، استخدِم:
git cl creds-check. في حال الحصول على أي أخطاء، يمكنك طلب المساعدة على talk-webrtc
لن تضطر إلى تكرار ما سبق. بعد ذلك، تكون جاهزًا للتحميل:
جارٍ تحميل أول شارة
الآن وبعد إعداد حسابك، يمكنك إجراء التحميل الفعلي:
القيام بما يلي:
- لنفترض أنّك في الفرع الرئيسي:
git checkout -b my-work-branch
إجراء التغييرات وإنشاءها محليًا وإجراء الاختبارات محليًا
git commit -am "Changed x, and it is working"git cl upload
سيؤدّي ذلك إلى فتح محرِّر نصوص يعرض جميع الرسائل المُلتَزَم بها محليًا، ما يتيح لك تعديلها قبل أن تصبح وصفًا لقائمة العناوين.
املأ إدخال الخطأ بشكل صحيح. يُرجى تحديد بادئة أداة حل المشاكل ورقم المشكلة، مع الفصل بينهما بنقطتين مثل
webrtc:123أوchromium:12345. إذا لم يكن لديك بادئة أداة تتبّع المشاكل ورقم المشكلة، ما عليك سوى إضافةNone.احفظ الملف وأغلقه لمتابعة التحميل إلى خادم مراجعة الرموز في WebRTC.
سيطبع الأمر رابطًا مثل https://webrtc-review.googlesource.com/c/src/+/53121. إذا كان كل شيء على ما يرام.
- لنفترض أنّك في الفرع الرئيسي:
انقر على رابط CL هذا.
إذا لم تكن مسجّلاً الدخول، انقر على زر "تسجيل الدخول" في أعلى يسار الشاشة، وسجِّل الدخول باستخدام بريدك الإلكتروني
انقر على "بدء المراجعة" وأضِف مُراجعًا. يمكنك العثور على مراجعين في ملفات OWNERS حول المستودع (عليك اختيار أقرب المراجعين)
الردّ على أي ملاحظات وآراء من المراجعين:
- إجراء التغييرات وإنشاءها محليًا وإجراء الاختبارات محليًا
git commit -am "Fixed X and Y"git cl upload
- إجراء التغييرات وإنشاءها محليًا وإجراء الاختبارات محليًا
بعد أن يتحقّق المراجعون من LGTM (يوافقون) على التصحيح، اطلب منهم وضعه في قائمة انتظار التنفيذ.
ملاحظة: على نظام التشغيل Windows، يجب تنفيذ الخطوات المذكورة أعلاه في واجهة Git Bash حتى يتمكن gclient من العثور على ملف .gitcookies.
برامج التتبُّع
في حال كنت تمارس أعمالاً كثيرة في WebRTC، يمكنك التقدم بطلب للحصول على تجربة الحقوق. وهذا يعني أنه يمكنك تشغيل برامج التتبع التي تُجري جميع الاختبارات على جميع الأنظمة الأساسية. لإجراء ذلك، يمكنك الإبلاغ عن الخطأ على bugs.webrtc.org وطلب الحصول على حقوق من فريق EngProd.
لتشغيل وظيفة تجريبية، حمِّل متغيّرًا متغيّرًا كما هو موضّح أعلاه وانقر على رمز التشغيل التجريبي لـ CQ أو اختر Usebots في واجهة مستخدم Gerrit. يجب أن تكون لديك حقوق محاولة تنفيذ هذا الإجراء. وبخلاف ذلك، يمكنك أن تطلب من المُراجع أن تبدأ برامج التتبُّع نيابةً عنك.