Để cho phép các nhóm đóng góp src không phải cốt lõi vào dự án tradefederation có toàn quyền sở hữu quy trình xem xét, các dự án sau đây đã được tạo với quyền mở +2 cho tất cả các nhóm. Điều này giúp nhóm tradefederation cốt lõi giảm bớt gánh nặng của tất cả các bài đánh giá mã không liên quan đến khung cốt lõi, đồng thời cho phép các nhóm khác lặp lại nhanh hơn trong chu kỳ đánh giá.
src không cốt lõi được định nghĩa là mã không bắt buộc theo yêu cầu của liên đoàn thương mại khung hoạt động (ví dụ: kiểm thử tuỳ chỉnh, cấu hình, kiểm thử cụ thể) tiện ích).
LƯU Ý QUAN TRỌNG Src không phải lõi không được mở rộng các lớp tradefederation cốt lõi. Việc này sẽ ảnh hưởng đến việc tái cấu trúc/dọn dẹp trong tương lai. Nếu bạn không chắc liệu mã của mình thuộc phần core hay contrib, hãy liên hệ với android-tradefed@ để được giải thích rõ ràng. Nhóm cốt lõi của tradefederation rất sẵn lòng tư vấn và tiếp nhận yêu cầu về tính năng.
Ví dụ về lớp tradefederation cốt lõi là bất kỳ lớp nào trong gói
com.google.android.tradefed.buildnhư:com.google.android.tradefed.build.LaunchControlProviderMột lần nữa, vui lòng liên hệ nếu bạn không rõ lớp nào được coi là lớp cốt lõi đối với android-tradefed@.
[MỤC LỤC]
Đường dẫn của dự án Contrib
Những dự án đóng góp này dành cho ai?
Nếu bạn hiện đang làm việc trong các dự án tradefederation viết kiểm thử/tiện ích kiểm thử/cấu hình, thì các dự án này được tạo cho bạn.
Xem xét mã trong các dự án đóng góp
Mục tiêu của các dự án đóng góp là cho phép bạn phát triển trong Tradefed mà không cần nhóm cốt lõi xem xét (android-tradefed@). Vì vậy, chúng tôi mong đợi nhóm của bạn hoặc bất kỳ ai quen thuộc với ngữ cảnh của bạn sẽ thực hiện việc xem xét mã trên các thay đổi mã của bạn.
Đừng ngại liên hệ với android-tradefed@ nếu bạn gặp khó khăn hoặc cần hướng dẫn về một trường hợp cụ thể, nhưng đừng dựa vào tuỳ chọn đó theo mặc định để xem xét mã trong đóng góp. Nhóm Tradefed không có SLO nào liên quan đến việc xem xét mã trong contrib.
Tôi có thể bắt đầu thực hiện các dự án này từ đâu?
Các tệp này đã được thêm vào các tệp kê khai nhánh sau đây và đã là một phần của thanh toán trên nền tảng chính, vì vậy, nếu bạn không thấy các dự án trong môi trường của mình, bạn sẽ có một kho lưu trữ để đóng góp.
- chính
- tradefed
- oc-dev
- oc-dev-plus-aosp
- nyc-mr2-dev-plus-aosp
- main-daydream-dev
- main-without-vendor
- wear-main
Phát triển và kiểm thử
Dự kiến, hoạt động phát triển trong contrib sẽ có cùng tiêu chuẩn chất lượng như mọi nơi khác trong kho lưu trữ Android:
- Tuân thủ nguyên tắc định dạng của Android
- Mã được kiểm thử và gửi cùng với các bài kiểm thử
- Thiết kế được cân nhắc kỹ lưỡng và hợp lý
Làm cách nào để kiểm thử cục bộ trong contrib?
AOSP (Dự án nguồn mở Android)
Trong aosp, các bài kiểm thử đơn vị của contrib nằm trong platform/tools/tradefederation/contrib/tests/src/ và bạn nên thêm các bài kiểm thử đơn vị vào com.android.tradefed.prodtests.UnitTests để được chọn trong các tập lệnh kiểm thử cục bộ và trước khi gửi.
Tập lệnh cục bộ Aosp sau khi chạy bữa trưa:
tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh
Cập nhật quy tắc xây dựng cho các dự án đóng góp
Các quy tắc bản dựng (tệp bản dựng) nằm trong thư mục build/ riêng và được khoá bằng tệp OWNERS. Tệp này sẽ ngăn bạn sửa đổi các quy tắc đó mà không cần nhóm cốt lõi xem xét thêm. Đây là giới hạn duy nhất đối với dự án đóng góp.
Chúng tôi cần quy trình xem xét này để đảm bảo không có phần phụ thuộc nào ngoài dự kiến được thêm vào các dự án Tradefed tổng thể mà không có sự hiểu biết hoặc đồng ý của nhóm cốt lõi.
Nếu bạn thực sự cần thêm một số phần phụ thuộc mới, vui lòng liên hệ với
android-tradefed@ để xem xét các trường hợp sử dụng của bạn và đưa ra lời khuyên cho bạn.