Để 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 phải cốt lõi được xác định là mã không bắt buộc phải có trong khung liên minh thương mại để hoạt động (ví dụ: kiểm thử tuỳ chỉnh, cấu hình, tiện ích kiểm thử cụ thể).
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 tradefederation cốt lõi 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 của 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.
Bạn luôn có thể liên hệ với android-tradefed@ nếu 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 kênh này theo mặc định để xem xét mã trong contrib. Nhóm Tradefed không có SLO khi nói đến việc xem xét mã trong contrib.
Tôi có thể bắt đầu làm việc trên các dự án này ở đâu?
Các dự án này đã được thêm vào tệp kê khai nhánh sau và đã có trong quy trình thanh toán của nền tảng chính. Vì vậy, nếu không thấy các dự án trong môi trường của mình, bạn chỉ cần đồng bộ hoá kho lưu trữ là có thể đó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ế hợp lý và có ý nghĩa
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 lunch:
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 đó nếu không có thêm quy trình xem xét của nhóm cốt lõi. Đây là giới hạn duy nhất đối với dự án contrib.
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à tư vấn cho bạn.