2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main
대신 android-latest-release
를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
도구 모음을 통한 테스트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
1. 도구 모음 설정
도구 모음을 통해 실행되는 테스트는 Tradefed 테스트 실행기를 통해 직접적으로 실행되는 일반 테스트와 차이가 있습니다.
도구 모음 설정에서 정의 및 지침을 확인하세요.
2. 옵션과 필터를 도구 모음 및 모듈에 전달
다양한 명령줄과 인수를 사용하여 옵션과 필터를 도구 모음 수준 또는 모듈 수준으로 전달할 수 있습니다.
옵션과 필터를 도구 모음 및 모듈에 전달에서 지침을 확인하세요.
3. 시스템 상태 검사기
시스템 상태 검사기는 각 모듈 간에 실행되는 구성요소이며, 모듈에서 누락되어 정리되지 않은 일부 상태를 확인하고 정리할 수 있습니다(에: 키가드를 켜 놓은 모듈).
구현 및 사용 방법은 시스템 상태 검사기를 참고하세요.
4. AndroidTest.xml 구조
각 AndroidTest.xml
파일은 단일 테스트 모듈을 나타냅니다. 이 섹션에서는 AndroidTest.xml
구성 파일의 구조, 일반 Tradefed 구성과의 차이점 및 허용되는 사항과 허용되지 않는 사항을 설명합니다.
허용되는 태그와 구성 예시는 AndroidTest.xml 구조를 참고하세요.
5. 샤딩 구성 조정
이 섹션에서는 모듈 구성의 샤딩에 관한 측면을 조정하는 방법과 각 측면에 관한 이점을 설명합니다.
- 모듈의 샤딩 가능 여부를 선언
- 모듈의 가능한 샤드 수를 조정
자세한 내용은 AndroidTest.xml 모듈을 참조하세요.
6. 컨트롤러
모듈 컨트롤러는 모듈 동작의 일부 측면을 변경하기 위해 AndroidTest.xml
에 지정 가능한 특수 객체입니다. 예를 들면 일부 조건이 충족되지 않을 경우 모듈을 완전히 건너뛸 수 있습니다.
모듈 컨트롤러에서 구현 및 로깅을 확인하세요.
7 다시 시도
도구 모음 재시도는 불합격한 테스트의 이전 호출을 재실행하여 최초 불합격의 원인이 된 결함이나 격리 불량을 제거할 수 있게 해줍니다.
예시 및 사용 방법은 도구 모음 재시도를 참고하세요.
8. 멀티스크린 도구 모음
이제 최신 버전에서는 테스트 흐름에서 여러 기기 간에 테스트가 조정되도록 하는 멀티스크린 도구 모음과 모듈을 지원합니다.
자세한 내용은 멀티스크린 도구 모음을 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Test through a suite\n\n1. Set up suite\n---------------\n\nTests running through a suite differs from a standard test running directly\nthrough Tradefed test runner.\n\nSee [Set up Suite](/docs/core/tests/tradefed/testing/through-suite/setup) for definitions and instructions.\n\n2. Pass options and filters to suite and modules\n------------------------------------------------\n\nVarious command lines and arguments can be used to pass options and filters to\nthe suite-level or the module-levels.\n\nSee [Pass options and filters to the suite and the modules](/docs/core/tests/tradefed/testing/through-suite/option-passing)\nfor instructions.\n\n3. System Status Checker\n------------------------\n\nSystem Status Checker is a component running between each module that can check\nand clean up some states that the module might have forgotten to clean, for\nexample a module leaving a keyguard on.\n\nSee [System status checker](/docs/core/tests/tradefed/testing/through-suite/system-status-checker) for implementation and\nuse.\n\n4. AndroidTest.xml structure\n----------------------------\n\nEach `AndroidTest.xml` file represents one test module. This section describes\nthe structure of an `AndroidTest.xml` configuration file, how they differ from\nregular Tradefed configuration, and what is allowed and not allowed.\n\nSee [AndroidTest.xml structure](/docs/core/tests/tradefed/testing/through-suite/android-test-structure) for allowed tags and\nan example configuration.\n\n5. Tune sharding configuration\n------------------------------\n\nThis section explains how to tune sharding aspects of your module configuration\nand describes the benefits associated with each of them:\n\n- Declare your module shardable or not\n- Tune the possible number of shards for your module\n\nSee [Tune AndroidTest.xml modules](/docs/core/tests/tradefed/testing/through-suite/android-test-tuning) for details.\n\n6. Controller\n-------------\n\nModule controllers are special objects that can be specified in\n`AndroidTest.xml` to alter some aspect of the module's behavior. For example,\nyou may completely skip the module if some conditions are not met.\n\nSee [Module controllers](/docs/core/tests/tradefed/testing/through-suite/module-controller) for implementation and logging.\n\n7. Retry\n--------\n\nSuite Retry allows you to re-run a previous invocation of failed tests in order\nto rule out flakiness or poor isolation that may have caused the first failure.\n\nSee [Suite Retry](/docs/core/tests/tradefed/testing/through-suite/suite-retry) for examples and use.\n\n8. Multi devices suites\n-----------------------\n\nNewer releases now support multi-devices suites and modules which allow for a\ntest to coordinate between multiple devices in its test flow.\n\nSee [Multi-devices suites](/docs/core/tests/tradefed/testing/through-suite/multi-devices-suites) for more details."]]