Google is committed to advancing racial equity for Black communities. See how.
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á / pull cho các tính năng và sửa lỗi!

Đối với những người đóng góp bên ngoài Google, hãy làm theo các hướng dẫn được đưa ra 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, người đóng góp phải ký thỏa thuận cấp phép người đóng góp trước khi đó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 khi thích hợp.

Nếu bạn dự đị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 tôi 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ó, vui lòng đảm bảo bạn cũng tạo hoặc cập nhật mọi thử nghiệm hiện có. Tất cả các thử nghiệm trong kho lưu trữ này được triển khai dưới dạng các thử nghiệm UI của Nightwatch.JS, vì vậy vui lòng thực hiện theo cùng một thiết kế.

Hướng dẫn

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

Bạn phải thực hiện một số chuẩn bị để 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 cộng tác viên (xem ở trên)
  • Nếu bạn chưa bao giờ gửi mã trước đó, bạn phải thêm (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 ký bởi tên tổ chức của bạn) 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à cùng một tài khoản đượ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 về 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ả, bạn đã sẵn sàng để tải lên:

Đang 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 ở trong nhánh chính:
      • git checkout -b my-work-branch
    • 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

      Điều 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 điệp 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 vào các mục lỗi đúng. Vui lòng chỉ định tiền tố 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ố theo dõi vấn đề và số vấn đề chỉ cần thêm None .

      Lưu và đóng tệp để tiến hành tải lên máy chủ xem xét mã WebRTC.

      Lệnh sẽ in 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 một người đánh giá. Bạn có thể tìm thấy người đánh giá trong các tệp OWNERS xung quanh kho lưu trữ (lấy cái gần nhất với các thay đổi của bạn)

  • Địa chỉ bất kỳ phản hồi của người đánh giá:

    • 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

THÔNG BÁO: Trên Windows, bạn sẽ cần chạy phần trên trong vỏ bash Git để gclient tìm tệp .gitcookies .

Cố gắng

Nếu bạn đang làm việc nhiều trong WebRTC, bạn có thể đăng ký quyền 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 một lỗi trên bug.webrtc.org và yêu cầu nhóm EngProd cấp cho bạn quyền 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 phải có quyền thử cho điều này. Nếu không, yêu cầu người đánh giá của bạn khởi động các bot cho bạn.