Thỏa thuận cấp phép
WebRTC chào mừng các bản vá/lấy cho các tính năng và bản sửa lỗi!
Đối với những người đóng góp bên ngoài Google, hãy làm theo 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, cộng tác viên phải ký thỏa thuận cấp phép cộng tác viên trước khi có thể chấp nhận đóng góp. Vui lòng hoàn tất thỏa thuận cho một cá nhân hoặc một công ty phù hợp.
Mẫu đóng góp
Nếu có dự định thêm một mẫu mới hoặc thay đổi đáng kể đối với mẫu hiện có, thì 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 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ữ đó đều được triển khai dưới dạng thử nghiệm giao diện người dùng Nightwatch.JS, vì vậy, vui lòng tuân theo thiết kế tương tự của chính bạn.
Hướng dẫn
Đóng góp cho bản vá đầu tiên
Bạn phải thực hiện một số bước chuẩn bị để tải tệp CL đầu tiên lên:
- Kiểm tra và tạo mã
- Điền vào thỏa thuận Contributor (xem ở trên)
- Nếu chưa từng gửi mã trước đây, 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ó chữ ký của tổ chức bạn) và thông tin liên hệ vào tệp AUTHORS
- Truy cập vào
https://webrtc.googlesource.com/new-password
rồi đăng nhập bằng tài khoản email của bạn. Tài khoản này phải giống với
tài khoản mà
git config user.emailtrả về - Sau đó, hãy chạy:
git cl creds-check. Nếu bạn gặp lỗi, hãy yêu cầu trợ giúp về Thảo luận trên webrtc
Bạn sẽ không phải lặp lại các thao tác ở trên. Sau khi làm xong, bạn có thể tải lên:
Tải bản vá đầu tiên lên
Sau khi đã thiết lập tài khoản, bạn có thể tải dữ liệu thực lên:
Thực hiện hành động này:
- Giả sử bạn ở chi 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 chỉnh sửa văn bản hiển thị tất cả tin nhắn cam kết tại địa phương, cho phép bạn sửa đổi nó trước khi trở thành nội dung mô tả CL.
Điền thông tin vào mục lỗi đúng cách. Vui lòng chỉ định tiền tố trình theo dõi sự cố và số sự cố, phân cách bằng dấu hai chấm, ví dụ:
webrtc:123hoặcchromium:12345. Nếu không có tiền tố trình theo dõi vấn đề và số vấn đề, bạn chỉ cần thêmNone.Lưu và đóng tệp để tiếp tục tải lên máy chủ xem xét mã của WebRTC.
Lệnh này sẽ in một đường liên kết như https://webrtc-review.googlesource.com/c/src/+/53121. nếu mọi thứ đều ổn.
- Giả sử bạn ở chi nhánh chính:
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 bài đánh giá và thêm một người đánh giá. Bạn có thể tìm người đánh giá trong tệp OWNERS Xung quanh kho lưu trữ (lấy tệp gần nhất với các thay đổi của bạn)
Giải quyết mọi phản hồi của người đánh giá:
- Thực hiện thay đổi, tạo cục bộ, chạy thử nghiệm cục bộ
git commit -am "Fixed X and Y"git cl upload
- Thực hiện thay đổi, tạo cục bộ, chạy thử nghiệm cục bộ
Sau khi người đánh giá LGTM (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 cần chạy phần trên ở trong ô Git bash để gclient tìm tệp .gitcookies.
Bot thử
Nếu đang làm việc nhiều trong WebRTC, bạn có thể đăng ký thử quyền. Đ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ả nền tảng. Để làm điều này, hãy báo cáo lỗi trên bug.webrtc.org và yêu cầu nhóm EngProd cấp quyền thử cho bạn.
Để chạy thử việc tải ứng dụng, hãy tải một tệp CL như mô tả ở trên lên rồi nhấp vào Chạy thử nghiệm QQ hoặc chọn Chọn bot trong giao diện người dùng Gerrit. Bạn cần có quyền dùng thử tính năng này. Nếu không, hãy yêu cầu người đánh giá khởi động các bot cho bạn.