הסכם רישיון
ב-WebRTC מוזמנים לקבל תיקונים/תמריצים עבור תכונות ותיקוני באגים.
לשותפי תוכן שאינם מהארגון של Google, יש לפעול לפי ההוראות שמפורטות בהסכם הרישיון של Google Individual Contributor . בכל המקרים, מי שתורם תוכן חייב לחתום על הסכם רישיון של השותף לפני אישור התרומה. יש להשלים את ההסכם עבור אדם פרטי או תאגיד מתאים.
דוגמאות לתרומה
אם תכננת להוסיף דגימה חדשה או לבצע שינויים משמעותיים בדוגמית קיימת, מומלץ להתחיל בבעיה חדשה שבה נוכל לדון בפרטים.
כשיוצרים דוגמה חדשה או מעדכנים דגימה קיימת, חשוב גם ליצור או לעדכן בדיקות קיימות. כל הבדיקות במאגר זה מוטמעות כבדיקות ממשק משתמש של Nightwatch.JS, ולכן עליכם ליישם את אותו עיצוב בעצמכם.
הוראות
תרומה של התיקון הראשון שלך
עליך לבצע הכנה כלשהי כדי להעלות את קובץ ה-CL הראשון שלך:
- בודקים את הקוד ויוצרים אותו
- ממלאים את הסכם ה'תורם' (ראו למעלה)
- אם לא שלחת את הקוד בעבר, עליך להוסיף את (או הארגון שלך במקרים שבהם הסכם המחבר נחתם על ידי הארגון) ולציין את הפרטים ליצירת קשר בקובץ AUTHORS
- עוברים אל
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
פעולה זו תפתח עורך טקסט שיראה את כל ההודעות של העמלה המקומית. כך תוכלו לשנות אותה לפני שהיא תהפוך לתיאור של 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
- לערוך שינויים, לבנות באופן מקומי ולהריץ בדיקות באופן מקומי
לאחר שהבודק LGTM (מאשר) את התיקון, מבקשים ממנו להכניס אותו ל'תור'
הודעה: ב-Windows, צריך להפעיל את שלמעלה במעטפת Git bash כדי ש-Gclient יוכל למצוא את הקובץ .gitcookies.
בוטים
אם אתם עובדים הרבה ב-WebRTC, תוכלו להגיש בקשה לזכויות ניסיון. כלומר, אפשר להפעיל את trybots שמריצים את כל הבדיקות בכל הפלטפורמות. לשם כך, יש לדווח על באג ב-Bugs.webrtc.org ולבקש מהצוות של EngProd להעניק לך זכויות.
כדי להריץ ניסיון, יש להעלות קוד CL כמתואר למעלה וללחוץ על 'הרצת יבשה' (CQ) או על 'בחר בוטים' בממשק המשתמש של Gerrit. אתם צריכים הרשאות של ניסיון לכך. אחרת, אפשר לבקש מהבודק להפעיל את הבוטים בשבילך.