اتفاقية الترخيص
نرحب في WebRTC بتلقّي الإصلاحات أو عمليات الطرح للميزات وإصلاح الأخطاء.
بالنسبة إلى المساهمين الخارجيين عن Google، يُرجى اتّباع التعليمات الواردة في اتفاقية تراخيص المساهمين الفرديين في Google. في جميع الحالات، على المساهمين توقيع اتفاقية ترخيص المساهم قبل قبول المساهمة. يُرجى إكمال الاتفاقية الخاصة بأحد الأفراد أو أحد المؤسسات كما هو مناسب.
تقديم عيّنات
إذا كنت تخطّط لإضافة نموذج جديد أو إجراء تغييرات كبيرة على ملف هبوطحالي، ننصحك بالبدء بإنشاء مشكلة جديدة لنتمكّن من مناقشة التفاصيل.
عند إنشاء عيّنة جديدة أو تعديل عيّنة حالية، يُرجى التأكّد من إنشاء أي اختبارات حالية أو تعديلها أيضًا. يتم تنفيذ جميع الاختبارات في هذا المستودع كاختبارات واجهة مستخدم Nightwatch.JS، لذا يُرجى اتّباع التصميم نفسه في اختباراتك.
التعليمات
المساهمة بأول تصحيح
عليك إجراء بعض الاستعدادات لتحميل قائمة العملاء المحتملين الأولى:
- الاطّلاع على الرمز البرمجي وإنشاؤه
- ملء اتفاقية المساهم (انظر أعلاه)
- إذا لم يسبق لك إرسال رمز برمجي، عليك إضافة اسمك (أو اسم مؤسستك في حال توقيع مؤسستك على اتفاقية المساهمين) ومعلومات الاتصال إلى ملف AUTHORS.
- انتقِل إلى
https://webrtc.googlesource.com/new-password
وسجِّل الدخول باستخدام حساب بريدك الإلكتروني. يجب أن يكون هذا هو الحساب نفسه الذي
git config user.emailعرضه. - بعد ذلك، استخدِم الأمر التالي:
git cl creds-check. إذا ظهرت لك أي أخطاء، يمكنك طلب المساعدة على discuss-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
- إجراء تغييرات وإنشاء تطبيق على الجهاز وإجراء الاختبارات على الجهاز
بعد أن يوافق المراجع على التصحيح، اطلب منه وضعه في ملف التحديثات المُرسَلة.
ملاحظة: على نظام التشغيل Windows، عليك تنفيذ ما سبق في بيئة Git bash shell لكي تتمكّن أداة gclient من العثور على ملف .gitcookies.
Trybots
إذا كنت تستخدم WebRTC كثيرًا، يمكنك طلب حقوق التجربة. وهذا يعني أنّه يمكنك تشغيل trybots التي تُجري جميع الاختبارات على جميع المنصات. لإجراء ذلك، يُرجى الإبلاغ عن خطأ على bugs.webrtc.org وطلب من فريق EngProd منحك حقوق التجربة.
لتشغيل مهمة تجريبية، حمِّل طلبًا لتغيير الرمز البرمجي كما هو موضّح أعلاه وانقر على "التشغيل التجريبي لميزة "الجودة المستمرة" أو اختيار "البرامج التجريبية" في واجهة مستخدم Gerrit. يجب أن تكون لديك أذونات تجريبية لإجراء ذلك. بخلاف ذلك، اطلب من المُراجع إيقاف برامج التتبّع نيابةً عنك.