Sử dụng trình điều khiển mô-đun

Mỗi mô-đun bộ kiểm thử (do AndroidTest.xml xác định) có thể chứa một đối tượng module_controller đặc biệt có thể thay đổi một số hành vi của mô-đun:

Có chạy mô-đun hay không dựa trên một số điều kiện

Bằng cách triển khai BaseModuleController và thêm đối tượng này vào AndroidTest.xml như sau:

<object type="module_controller" class="com.android.tradefed.testtype.suite.module.<NAME>" />

Bộ điều khiển mô-đun sẽ được dùng để xác định xem mô-đun có nên chạy hay không, dựa trên việc triển khai public abstract RunStrategy shouldRun(IInvocationContext context);.

Có thu thập một số nhật ký hay không khi xảy ra lỗi

Khi chạy một bộ kiểm thử đầy đủ, bạn có thể yêu cầu ở cấp bộ kiểm thử việc thu thập một số nhật ký về các lỗi (ảnh chụp màn hình, báo cáo lỗi, logcat). Nhưng đối với một số mô-đun, một nhật ký cụ thể được yêu cầu có thể không có giá trị nào và sẽ chỉ lãng phí thời gian thu thập. Trong trường hợp đó, một mô-đun có thể chỉ định rõ ràng những nhật ký mà mô-đun đó quan tâm:

<object type="module_controller"
        class="com.android.tradefed.testtype.suite.module.TestFailureModuleController">
    <option name="screenshot-on-failure" value="<true OR false>" />
    <option name="bugreportz-on-failure" value="<true OR false>" />
    <option name="logcat-on-failure" value="<true OR false>" />
</object>

LƯU Ý: Nếu có thể, bạn nên triển khai các bộ điều khiển theo cách chung để tối đa hoá khả năng sử dụng lại. Và chủ sở hữu mô-đun phải xem xét việc bỏ qua một mô-đun dựa trên điều kiện của mô-đun đó để được phê duyệt rằng việc bỏ qua một mô-đun là hành vi phù hợp đối với họ.