Để cho phép các nhóm đóng góp src không cốt lõi cho các dự án liên đoàn thương mại có toàn quyền sở hữu quy trình xem xét, các dự án sau đã đượ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 liên đoàn thương mại cốt lõi thoát khỏi gánh nặng của tất cả các đá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 cốt lõi được định nghĩa là mã không được khuôn khổ liên đoàn thương mại yêu cầu phải hoạt động (ví dụ: kiểm tra tùy chỉnh, cấu hình, tiện ích kiểm tra cụ thể).
QUAN TRỌNG Các src không cốt lõi không được mở rộng các lớp liên đoàn thương mại cốt lõi. Làm như vậy sẽ tác độ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 mã của mình thuộc về lõi hay đóng góp, hãy liên hệ với android-tradefed@ để được giải thích. Nhóm liên đoàn thương mại cốt lõi sẵn lòng tư vấn và nhận các yêu cầu về tính năng.
Một lớp liên minh thương mại cốt lõi mẫu sẽ 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 sẽ được coi là lớp cốt lõi của android-tradefed@.
[TOC]
Đóng góp đường dẫn của dự án
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 liên đoàn thương mại viết bài kiểm tra/tiện ích kiểm tra/cấu hình thì những dự án này được tạo cho bạn.
Đánh giá 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 sự xem xét của nhóm nòng cố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 ngữ cảnh của bạn thực hiện đánh giá mã trên CL của bạn.
Hãy luôn thoải mái 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 đó theo mặc định để đánh giá mã của bạn trong đóng góp. Nhóm Tradefed không có SLO khi nói đến đánh giá mã trong đóng góp.
Tôi có thể bắt đầu thực hiện những dự án này ở đâu?
Chúng đã được thêm vào các bảng kê khai chi nhánh sau đây và đã là một phần của quá trình thanh toá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 thì bạn sẽ không còn được đồng bộ hóa kho nữa để đóng góp.
- chủ yếu
- trao đổi
- oc-dev
- oc-dev-plus-aosp
- nyc-mr2-dev-plus-aosp
- chính-daydream-dev
- chính không có nhà cung cấp
- mặc chính
Phát triển và thử nghiệm
Quá trình phát triển trong phần đóng góp dự kiến sẽ có cùng chất lượng như bất kỳ nơi nào khác trong kho Android:
- Tôn trọng các nguyên tắc định dạng của Android
- Mã được kiểm tra và gửi cùng với các bài kiểm tra
- Thiết kế chu đáo và có ý nghĩa
Làm cách nào để kiểm tra cục bộ trong đóng góp?
AOSP
Trong aosp, các bài kiểm tra đơn vị đóng góp được đặt trong platform/tools/tradefederation/contrib/tests/src/ và các bài kiểm tra đơn vị phải được thêm vào com.android.tradefed.prodtests.UnitTests để được chọn trong các tập lệnh thử nghiệm gửi trước và thử nghiệm cục bộ.
Tập lệnh địa phương của Aosp sau khi chạy bữa trưa:
tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh
Xây dựng cập nhật quy tắc để đóng góp dự án
Các quy tắc xây dựng (tệp tạo) nằm trong thư mục build/ của riêng chúng và bị khóa bởi tệp OWNERS Điều này sẽ ngăn bạn sửa đổi chúng mà không có sự xem xét bổ sung từ nhóm cốt lõi. Đây là hạn chế duy nhất đối với dự án đóng góp.
Chúng tôi cần đánh giá này để đảm bảo không có sự 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 thỏa thuận từ 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.