Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Đóng góp cho dự án WebRTC

Thỏa thuận cấp phép

WebRTC hoan nghênh các bản vá / kéo cho các tính năng và sửa lỗi!

Đối với các cộng tác viên bên ngoài Google, hãy làm theo các hướng dẫn trong Thỏa thuận cấp phép cộng tác viên cá nhân của Google . Trong mọi trường hợp, những người đóng góp phải ký một thỏa thuận cấp phép cộng tác viên trước khi một đóng góp có thể được chấp nhận. Vui lòng hoàn thành thỏa thuận cho một cá nhân hoặc một công ty nếu thích hợp.

Nếu bạn định thêm một mẫu mới hoặc thực hiện các thay đổi quan trọng đối với một mẫu hiện có, chúng tôi khuyên bạn nên bắt đầu bằng cách tạo một vấn đề mới để chúng ta có thể thảo luận chi tiết.

Khi tạo mẫu mới hoặc cập nhật mẫu hiện có, hãy đảm bảo rằng bạn cũng tạo hoặc cập nhật bất kỳ thử nghiệm hiện có nào. Tất cả các bài kiểm tra trong kho này đều được thực hiện dưới dạng bài kiểm tra giao diện người dùng của Nightwatch.JS, vì vậy hãy làm theo cùng một thiết kế của riêng bạn.

Hướng dẫn

Đóng góp bản vá đầu tiên của bạn

Bạn phải chuẩn bị một số để tải lên CL đầu tiên của mình:

  • Kiểm tra và xây dựng mã
  • Điền vào thỏa thuận Người đóng góp (xem ở trên)
  • Nếu bạn chưa từng gửi mã trước đây, bạn phải thêm tên của mình (hoặc tổ chức của bạn trong trường hợp thỏa thuận cộng tác viên được tổ chức của bạn ký) và thông tin liên hệ vào tệp AUTHORS
  • Truy cập https://webrtc.googlesource.com/new-password và đăng nhập bằng tài khoản email của bạn. Đây phải là tài khoản giống như được trả về bởi git config user.email
  • Sau đó, chạy: git cl creds-check . Nếu bạn gặp bất kỳ lỗi nào, hãy yêu cầu trợ giúp trên thảo luận-webrtc

Bạn sẽ không phải lặp lại những điều trên. Sau tất cả những điều đó, bạn đã sẵn sàng tải lên:

Tải lên bản vá đầu tiên của bạn

Bây giờ bạn đã thiết lập tài khoản của mình, bạn có thể thực hiện tải lên thực tế:

  • Làm cái này:

    • Giả sử bạn đang ở nhánh chính:
      • git checkout -b my-work-branch
    • Thực hiện thay đổi, xây dựng cục bộ, chạy thử nghiệm cục bộ

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

      Thao tác này sẽ mở một trình soạn thảo văn bản hiển thị tất cả các thông báo cam kết cục bộ, cho phép bạn sửa đổi nó trước khi nó trở thành mô tả CL.

      Điền đúng vào mục lỗi. Vui lòng chỉ định tiền tố trình theo dõi vấn đề và số vấn đề, được phân tách bằng dấu hai chấm, ví dụ: webrtc:123 hoặc chromium:12345 . Nếu bạn không có tiền tố trình theo dõi vấn đề và số vấn đề, chỉ cần thêm None .

      Lưu và đóng tệp để tiếp tục tải lên máy chủ duyệt mã WebRTC.

      Lệnh sẽ in ra một liên kết như https://webrtc-review.googlesource.com/c/src/+/53121 . Nếu mọi thứ trở nên tốt đẹp.

  • Nhấp vào Liên kết CL này

  • Nếu bạn chưa đăng nhập, hãy nhấp vào nút Đăng nhập ở trên cùng bên phải và đăng nhập bằng email của bạn

  • Nhấp vào Bắt đầu đánh giá và thêm người đánh giá. Bạn có thể tìm người đánh giá trong các tệp CHỦ SỞ HỮU xung quanh kho lưu trữ (lấy người đánh giá gần nhất với các thay đổi của bạn)

  • Giải quyết bất kỳ phản hồi nào của người đánh giá:

    • Thực hiện thay đổi, xây dựng cục bộ, chạy thử nghiệm cục bộ
      • git commit -am "Fixed X and Y"
      • git cl upload
  • Sau khi người đánh giá LGTMs (phê duyệt) bản vá, hãy yêu cầu họ đưa nó vào hàng đợi cam kết

LƯU Ý: Trên Windows, bạn sẽ cần chạy phần trên trong Git bash shell để gclient tìm thấy tệp .gitcookies .

Trybots

Nếu bạn đang làm việc nhiều trong WebRTC, bạn có thể đăng ký quyền dùng thử . Điều này có nghĩa là bạn có thể chạy trybots , chạy tất cả các thử nghiệm trên tất cả các nền tảng. Để thực hiện việc này, hãy gửi lỗi trên bug.webrtc.org và yêu cầu nhóm EngProd cấp cho bạn quyền dùng thử.

Để chạy tryjob, hãy tải lên CL như được mô tả ở trên và nhấp vào chạy khô CQ hoặc Chọn Trybots trong giao diện người dùng Gerrit. Bạn cần có quyền thử cho việc này. Nếu không, hãy yêu cầu người đánh giá khởi động chương trình cho bạn.