มีส่วนร่วมในโครงการ WebRTC

ข้อตกลงการอนุญาตให้ใช้สิทธิ

WebRTC ยินดีต้อนรับแพตช์/แพตช์สําหรับฟีเจอร์และการแก้ไขข้อบกพร่อง

สําหรับผู้ร่วมให้ข้อมูลภายนอก Google ให้ทําตามวิธีการที่ระบุในข้อตกลงการอนุญาตให้ใช้สิทธิของ Google Individual Contributor ในทุกกรณี ผู้ให้ข้อมูลร่วมกันจะต้องลงชื่อในข้อตกลงใบอนุญาตของผู้ให้ข้อมูลร่วมกันก่อนจึงจะยอมรับการมีส่วนร่วมได้ โปรดกรอกข้อตกลงสําหรับบุคคลธรรมดาหรือบริษัทตามความเหมาะสม

ตัวอย่างทําให้เกิดการมีส่วนร่วม

หากคุณวางแผนที่จะเพิ่มตัวอย่างใหม่หรือเปลี่ยนแปลงตัวอย่างที่มีอยู่อย่างมีนัยสําคัญ เราขอแนะนําให้เริ่มต้นด้วยการสร้างปัญหาใหม่ซึ่งเราจะดูรายละเอียดได้

เมื่อสร้างตัวอย่างใหม่หรืออัปเดตตัวอย่างที่มีอยู่ โปรดตรวจสอบว่าคุณสร้างหรืออัปเดตการทดสอบที่มีอยู่ด้วย การทดสอบทั้งหมดในที่เก็บนั้นจะนํามาใช้เป็นการทดสอบ UI ของ Nightwatch.JS ดังนั้นโปรดดําเนินการออกแบบด้วยตัวเอง

วิธีการ

ร่วมสนับสนุนแพตช์แรก

คุณต้องเตรียมการเล็กน้อยจึงจะอัปโหลด CL แรกได้

  • ชําระเงินและสร้างโค้ด
  • กรอกข้อตกลงของ Contributor (ดูด้านบน)
  • หากยังไม่เคยส่งรหัสมา คุณจะต้องเพิ่มชื่อ (หรือองค์กรของคุณในกรณีที่องค์กรได้ลงนามในข้อตกลงของผู้ให้ข้อมูลร่วมกัน) และข้อมูลติดต่อลงในไฟล์ AUTHORS
  • ไปที่ https://webrtc.googlesource.com/new-password และเข้าสู่ระบบด้วยบัญชีอีเมล โดยบัญชีดังกล่าวควรเป็นบัญชีเดียวกับที่ git config user.email ส่งคืน
  • จากนั้นเรียกใช้ git cl creds-check หากคุณพบข้อผิดพลาด โปรดขอความช่วยเหลือที่ ซอร์บ-เว็บคอร์ค

คุณไม่ต้องทําตามขั้นตอนข้างต้นซ้ํา หลังจากนั้น คุณก็พร้อมที่จะอัปโหลด:

กําลังอัปโหลดแพตช์แรก

เมื่อตั้งค่าบัญชีแล้ว คุณจะอัปโหลดจริงได้ดังนี้

  • ทำดังนี้:

    • สมมติว่าคุณอยู่ในสาขาหลัก
      • 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 นี้

  • หากยังไม่ได้ลงชื่อเข้าใช้ ให้คลิกปุ่มลงชื่อเข้าใช้ที่ด้านขวาบนและลงชื่อเข้าใช้ด้วยอีเมล

  • คลิก "เริ่มตรวจสอบ" แล้วเพิ่มผู้ตรวจสอบ คุณสามารถค้นหาผู้ตรวจสอบในไฟล์ "เจ้าของ" ทั่วทั้งที่เก็บ (ใช้การเปลี่ยนแปลงที่ใกล้เคียงที่สุดได้)

  • วิธีรับมือกับความคิดเห็นจากผู้ตรวจสอบ

    • ทําการเปลี่ยนแปลง สร้างในเครื่อง เรียกใช้การทดสอบในพื้นที่
      • git commit -am "Fixed X and Y"
      • git cl upload
  • เมื่อผู้รีวิว LGTM (อนุมัติ) แพตช์ ให้ขอให้บุคคลดังกล่าวอยู่ในคิวสัญญาผูกมัด

ประกาศ: ใน Windows คุณจะต้องเรียกใช้โค้ดข้างต้นใน Shell ของ Bash Bash เพื่อให้ Gclient ค้นหาไฟล์ .gitcookies ได้

ลองดูบ็อต

หากทํางานใน WebRTC เป็นจํานวนมาก คุณจะสมัครรับสิทธิ์ทดลองใช้ได้ ซึ่งหมายความว่าคุณจะเรียกใช้ trialbots ได้ ซึ่งจะทําการทดสอบทั้งหมดในทุกแพลตฟอร์ม โดยรายงานข้อบกพร่องไปที่ Bug.webrtc.org แล้วขอให้ทีม EngProd ให้สิทธิ์คุณได้

หากต้องการเรียกใช้ Tryjob ให้อัปโหลด CL ตามที่อธิบายไว้ข้างต้น แล้วคลิก "เรียกใช้การทดลองใช้ CQ" หรือเลือก ลองใช้บ็อตใน UI ของ Gerrit คุณต้องมีสิทธิ์ดําเนินการนี้ หากไม่มี ให้ขอให้ผู้รีวิวเริ่มบ็อตให้คุณ