การมีส่วนร่วมในโปรเจ็กต์ WebRTC

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

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

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

การส่งตัวอย่าง

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

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

วิธีการ

การมีส่วนร่วมในการแก้ไขครั้งแรก

คุณต้องเตรียมข้อมูลบางอย่างเพื่ออัปโหลด CL รายการแรก

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

คุณไม่จำเป็นต้องทำตามขั้นตอนข้างต้นซ้ำ หลังจากดำเนินการทั้งหมดแล้ว คุณก็พร้อมอัปโหลด

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

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

• ทำดังนี้:

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

Trybots

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

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