Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

المساهمة في مشروع WebRTC

اتفاقية الترخيص

يرحب WebRTC بالتصحيحات / عمليات السحب للميزات وإصلاح الأخطاء!

بالنسبة للمساهمين من خارج Google ، اتبع الإرشادات الواردة في اتفاقية ترخيص المساهم الفردي من Google . في جميع الحالات ، يجب على المساهمين التوقيع على اتفاقية ترخيص المساهم قبل قبول المساهمة. يرجى إكمال الاتفاقية للفرد أو الشركة حسب الاقتضاء.

إذا كنت تخطط لإضافة عينة جديدة أو إجراء تغييرات كبيرة على عينة موجودة ، نوصيك بالبدء من خلال إنشاء مشكلة جديدة حيث يمكننا مناقشة التفاصيل.

عند إنشاء عينة جديدة أو تحديث نموذج موجود ، يرجى التأكد أيضًا من إنشاء أو تحديث أي اختبارات موجودة. يتم تنفيذ جميع الاختبارات في هذا المستودع كاختبارات Nightwatch.JS UI ، لذا يرجى اتباع نفس التصميم بنفسك.

تعليمات

المساهمة في تصحيحك الأول

يجب عليك القيام ببعض التحضير لتحميل أول CL الخاص بك:

  • تحقق وبناء رمز
  • املأ اتفاقية المساهم (انظر أعلاه)
  • إذا لم ترسل رمزًا من قبل ، فيجب عليك إضافة اسمك (أو مؤسستك في حالة توقيع اتفاقية المساهم من قِبل مؤسستك) ومعلومات الاتصال إلى ملف AUTHORS
  • انتقل إلى https://webrtc.googlesource.com/new-password وقم بتسجيل الدخول باستخدام حساب بريدك الإلكتروني. يجب أن يكون هذا هو نفس الحساب الذي تم إرجاعه بواسطة git config user.email
  • ثم قم بتشغيل: git cl creds-check . إذا حصلت على أي أخطاء ، اطلب المساعدة في مناقشة webrtc

لن تضطر إلى تكرار ما سبق. بعد كل ذلك ، أنت جاهز للتحميل:

تحميل التصحيح الأول الخاص بك

الآن بعد أن قمت بإعداد حسابك ، يمكنك القيام بالتحميل الفعلي:

  • افعل هذا:

    • بافتراض أنك في الفرع الرئيسي:
      • git checkout -b my-work-branch
    • إجراء التغييرات ، والبناء محليًا ، وإجراء الاختبارات محليًا

      • git commit -am "Changed x, and it is working"
      • git cl upload

      سيؤدي هذا إلى فتح محرر نصوص يعرض جميع رسائل الالتزام المحلية ، مما يسمح لك بتعديله قبل أن يصبح وصف CL.

      املأ إدخال الخطأ بشكل صحيح. يُرجى تحديد بادئة متعقب المشكلة ورقم المشكلة ، مفصولة بنقطتين ، على سبيل المثال 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
  • بمجرد أن يقوم المراجع LGTMs (بالموافقة) على التصحيح ، اطلب منهم وضعه في قائمة انتظار الالتزام

إشعار: في نظام التشغيل Windows ، ستحتاج إلى تشغيل ما سبق في غلاف Git bash لكي يتمكن gclient من العثور على ملف .gitcookies .

تريبوتس

إذا كنت تعمل كثيرًا في WebRTC ، يمكنك التقدم بطلب للحصول على حقوق المحاولة . هذا يعني أنه يمكنك تشغيل برامج التريبوت ، التي تجري جميع الاختبارات على جميع الأنظمة الأساسية. للقيام بذلك ، قم بتقديم ملف على bugs.webrtc.org واطلب من فريق EngProd أن يمنحك حقوق التجربة.

لتشغيل tryjob ، قم بتحميل CL كما هو موضح أعلاه وانقر فوق تشغيل جاف CQ أو اختر Trybots في واجهة مستخدم Gerrit. يجب أن يكون لديك حقوق المحاولة لهذا. وبخلاف ذلك ، اطلب من المراجع إطلاق برامج التتبُّع لك.