Thoả thuận cấp phép
WebRTC hoan nghênh các bản vá/bản kéo 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 Thoả thuận cấp phép cho người đóng góp cá nhân của Google. Trong mọi trường hợp, người đóng góp phải ký thoả thuận cấp phép cho người đóng góp thì mới có thể chấp nhận nội dung đóng góp. Vui lòng hoàn tất thoả thuận cho một cá nhân hoặc một công ty phù hợp.
Đóng góp mẫu
Nếu dự định thêm một mẫu mới hoặc thực hiện thay đổi đáng kể đối với một mẫu hiện có, 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 về thông tin chi tiết.
Khi tạo một mẫu mới hoặc cập nhật một mẫu hiện có, hãy nhớ tạo hoặc cập nhật mọi chương trình kiểm thử hiện có. Tất cả các kiểm thử trong kho lưu trữ đó đều được triển khai dưới dạng kiểm thử giao diện người dùng Nightwatch.JS, vì vậy, vui lòng làm theo thiết kế tương tự trong kiểm thử của riêng bạn.
Hướng dẫn
Đóng góp bản vá đầu tiên
Bạn phải chuẩn bị một số việc để tải CL đầu tiên lên:
- Kiểm tra và tạo mã
- Điền vào Thoả thuận với cộng tác viên (xem ở trên)
- Nếu chưa từng gửi mã, bạn phải thêm tên và thông tin liên hệ của mình (hoặc của tổ chức trong trường hợp thoả thuận đóng góp do tổ chức của bạn ký) 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. Đây phải là tài khoản 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 trên discuss-webrtc
Bạn sẽ không phải lặp lại các bước trên. Sau khi hoàn tất tất cả các bước trên, bạn có thể tải lên:
Tải bản vá đầu tiên lên
Giờ đây, khi đã thiết lập tài khoản, bạn có thể thực hiện việc tải lên:
Thực hiện hành động này:
- Giả sử bạn đang ở nhánh chính:
git checkout -b my-work-branch
Thực hiện thay đổi, tạo bản dựng cục bộ, chạy kiểm thử 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ả thông báo cam kết cục bộ, cho phép bạn chỉnh sửa thông báo đó trước khi nó trở thành nội dung mô tả CL.
Điền thông tin vào mục nhập lỗi đúng cách. Vui lòng chỉ định tiền tố của công cụ theo dõi lỗi và số lỗi, phân tách bằng dấu hai chấm, ví dụ:
webrtc:123hoặcchromium:12345. Nếu bạn không có tiền tố công cụ theo dõi lỗi và số vấ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ứ diễn ra suôn sẻ.
- Giả sử bạn đang ở nhánh chính:
Nhấp vào đường 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 rồi đăng nhập bằng email của bạn
Nhấp vào Bắt đầu xem xét rồi thêm người đánh giá. Bạn có thể tìm thấy người xem xét trong các tệp OWNERS xung quanh kho lưu trữ (lấy tệp gần nhất với nội dung thay đổi của bạn)
Giải quyết mọi ý kiến phản hồi của nhân viên đánh giá:
- Thực hiện thay đổi, tạo bản dựng cục bộ, chạy kiểm thử cục bộ
git commit -am "Fixed X and Y"git cl upload
- Thực hiện thay đổi, tạo bản dựng cục bộ, chạy kiểm thử cục bộ
Sau khi người đánh giá LGTM (phê duyệt) bản vá, hãy yêu cầu họ đưa bản vá đó vào hàng đợi cam kết
LƯU Ý: Trên Windows, bạn cần chạy nội dung ở trên trong một shell bash Git để gclient tìm thấy tệp .gitcookies.
Trybots
Nếu thường xuyên làm việc 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 (trình thử nghiệm) để chạy tất cả các chương trình kiểm thử trên mọi nền tảng. Để thực hiện việc này, hãy báo lỗi trên bugs.webrtc.org và yêu cầu nhóm EngProd cấp cho bạn quyền dùng thử.
Để chạy một công việc thử nghiệm, hãy tải một CL lên như mô tả ở trên rồi nhấp vào Chạy thử CQ hoặc chọn Trybots trong giao diện người dùng Gerrit. Bạn cần có quyền thử để thực hiện việc này. Nếu không, hãy yêu cầu người đánh giá loại bỏ các bot cho bạn.