Để cho phép các nhóm đóng góp src không phải là src cốt lõi cho các dự án tradefederation có toàn quyền sở hữu quy trình đánh giá, các dự án sau đã được tạo với quyền +2 mở 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 quy trình đá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á của họ.
Src không phải là cốt lõi được xác định là mã mà khung tradefederation không yêu cầu phải hoạt động (ví dụ: các kiểm thử tuỳ chỉnh, cấu hình, tiện ích kiểm thử cụ thể).
QUAN TRỌNG src không phải là lõi không được mở rộng các lớp tradefederation lõi. Làm như vậ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 chắn liệu mã của mình có thuộc về core hay contrib, hãy liên hệ với android-tradefed@ để được giải thích rõ. Nhóm Tradefederation cốt lõi sẵn sàng tư vấn và tiếp nhận các yêu cầu về tính năng.
Ví dụ về lớp tradefederation cốt lõi sẽ là bất kỳ lớp nào trong gói
com.google.android.tradefed.build, chẳng hạn như:com.google.android.tradefed.build.LaunchControlProviderMột lần nữa, vui lòng liên hệ nếu bạn không rõ điều gì sẽ được coi là một lớp cốt lõi đối với android-tradefed@.
[TOC]
Đường dẫn của dự án đóng góp
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 các tiện ích/cấu hình kiểm thử/kiểm thử, 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 nòng cốt xem xét (android-tradefed@). Vì vậy, chúng tôi mong muốn nhóm của bạn hoặc bất kỳ ai quen thuộc với bối cảnh của bạn sẽ thực hiện quy trình đánh giá mã trên các CL 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 mặc định dựa vào địa chỉ này để thực hiện quy trình đánh giá 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 những dự án này ở đâu?
Các dự án này đã được thêm vào các tệp kê khai nhánh sau và đã là một phần của quy trình thanh toán trên nền tảng chính. Vì vậy, nếu không thấy các dự án này trong môi trường của mình, thì 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ử
Hoạt động phát triển trong contrib dự kiến sẽ có chất lượng tương đương với mọi nơi khác trong kho lưu trữ Android:
- Tuân thủ các nguyên tắc định dạng của Android
- Mã được kiểm thử và gửi cùng với các kiểm thử
- Thiết kế chu đáo 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 kiểm thử đơn vị của contrib nằm trong platform/tools/tradefederation/contrib/tests/src/ và các kiểm thử đơn vị phải được thêm 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.
Các 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 xây dựng (makefile) nằm trong thư mục build/ riêng và bị 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 nòng cốt xem xét thêm. Đây là hạn chế duy nhất đối với dự án contrib.
Chúng tôi cần xem xét để đảm bảo không có phần phụ thuộc không mong muốn nào được thêm vào các dự án Tradefed tổng thể mà không có sự hiểu biết hoặc thoả thuận của nhóm nòng cốt.
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.