Để 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 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 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 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 Tradefeed 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 đợ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 nào liên quan đế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ử
Quá trình phát triển trong contrib dự kiến 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 lunch:
tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh
Xây dựng bản cập nhật quy tắc để đóng góp dự án
Các quy tắc xây dựng (makefile) nằm trong thư mục build/ của riêng chúng và được khoá bằng một tệp OWNERS. Tệp này sẽ ngăn bạn sửa đổi những quy tắc này mà không cần xem xét thêm từ nhóm chính. Đâ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à được tư vấn.