2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main
대신 android-latest-release
를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
Tradefed를 통한 테스트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Tradefed에서의 테스트 실행은 필요한 테스트 단계와 관련하여 Android 기기의 제어를 허용하는 테스트 실행기에 의해 실행됩니다. 다음 섹션을 순서대로 따르세요.
1. 새 테스트 실행기 작성
여기서는 새로운 Tradefed 테스트 실행기를 작성하는 데 필요한 기본적인 내용을 배울 수 있습니다.
이는 완전히 새로운 유형의 테스트를 지원할 계획이고 새로운 실행기를 처음부터 개발해야 하는 경우에 특히 유용합니다.
Tradefed 테스트 실행기 작성에서 안내를 확인하세요.
2. 샤딩 가능한 테스트 실행기 작성
테스트 실행기를 샤딩 가능하게 만드는 방법도 알아볼 수 있습니다. 샤딩 가능한 테스트 실행기를 사용하면 인프라에서 병치 여부와 상관없이 여러 기기에 걸쳐 온전한 테스트 실행을 배포할 수 있습니다. 이는 테스트 자료가 방대한 경우에 유용하며, 실행 및 빠른 완료를 병렬화하는 것이 좋습니다.
단계를 보려면 샤딩된 IRemoteTest 테스트 실행기를 참고하세요.
3. 호스트 기반 테스트 작성
호스트 기반 테스트는 테스트 실행이 호스트 측에 기반하고 테스트에 필요할 경우 기기를 쿼리하는 일반적인 사용 사례입니다. 이는 테스트에서 요구하는 기기 작업이 기기 상태 자체에 영향을 미치는 경우(예: 기기 재부팅)에 유용합니다.
테스트 실행기 유형은 Tradefed 내에서 사용하거나 도구 모음을 통해 실행할 때 사용할 수 있습니다.
Trade Federation에서 호스트 기반 테스트 작성에서 안내를 확인하세요.
4. 테스트 측정항목 보고
테스트에서 실행 결과 외에 측정항목까지 보고하는 경우를 어렵지 않게 볼 수 있습니다. 테스트 실행기에 따라 측정항목을 보고할 수 있는 여러 가지 방법이 있습니다.
Tradefed 테스트의 측정항목 또는 데이터 보고에서 예시를 확인하세요.
5 자동 로그 수집
일부 로그는 보통 Logcat과 같은 디버깅 문제에 사용됩니다. 따라서 Tradefed는 이를 쉽게 수집할 수 있도록 자동화된 메커니즘을 제공합니다.
사용 방법은 불합격 모음에 관한 로그 자동화를 참조하세요.
6. 자동 테스트 재시도
Tradefed가 불합격을 자동으로 재시도하거나 일부 테스트를 반복적으로 여러 차례 실행하도록 사용 설정할 수 있습니다.
자세한 내용은 자동 테스트 재시도를 참고하세요.
7. 격리 재시도
Tradefed를 사용 설정하여 재시도 사이에 테스트 실행을 격리하도록 시도할 수 있습니다.
자세한 내용은 격리 재시도를 참고하세요.
8. 셸 테스트 작성
Trade Federation에서 셸 테스트 작성을 참고하세요.
Trade Federation의 전역 필터를 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 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 Tradefed\n\nExecution of tests in Tradefed is conducted by *test runners* that allow the\ncontrol of Android *devices* for necessary testing steps. Follow these sections in order.\n\n1. Write a new test runner\n--------------------------\n\nHere you will learn the basics that go into writing a new Tradefed test runner.\nThis is particularly useful if you plan to support a brand new type of test, and\nyou need a new runner to be developed from scratch.\n\nSee [Write a Tradefed test runner](/docs/core/tests/tradefed/testing/through-tf/new-test-runner) for instructions.\n\n2. Write a shardable test runner\n--------------------------------\n\nYou may also learn how to make your test runner shardable. A shardable test\nrunner allows the infrastructure to distribute the full test execution over\nseveral devices (collocated or not). This is useful when the corpus of\ntests is large, and you want to parallelize the execution and speed completion.\n\nSee [Write a sharded IRemoteTest test runner](/docs/core/tests/tradefed/testing/through-tf/sharded-runner) for\nsteps.\n\n3. Write a host-driven test\n---------------------------\n\nHost-driven tests are a common use case where test execution is driven from\nthe host-side and queries the device as needed for the test. This is useful when\ndevice operation required by the test affects the device state itself, for\nexample rebooting the device.\n\nThe test runner type can be used within Tradefed or when running through a\nsuite.\n\nSee [Write a host-driven test in Trade Federation](/docs/core/tests/tradefed/testing/through-tf/host-driven-test) for\ninstructions.\n\n4. Report metrics from tests\n----------------------------\n\nIt's fairly common for a test to report metrics in addition to the execution\nresults. Depending on the test runner, there are several methods to report the\nmetrics.\n\nSee [Report metrics or data from a Tradefed test](/docs/core/tests/tradefed/testing/through-tf/report-metrics) for examples.\n\n5. Automated log collection\n---------------------------\n\nSome logs are commonly used for debugging issues, for example: Logcat. So\nTradefed offers an automated mechanism to collect them easily.\n\nSee [Automated log on failure collection](/docs/core/tests/tradefed/testing/through-tf/log-on-failure) for use.\n\n6. Automatic test retry\n-----------------------\n\nYou may enable Tradefed to automatically retry failures or run some tests\nseveral times in iterations.\n\nSee [Automatic test retry](/docs/core/tests/tradefed/testing/through-tf/auto-retry) for more details.\n\n7. Retry isolation\n------------------\n\nYou may enable Tradefed to attempt to isolate the test execution between retry\nattempts.\n\nSee [Retry isolation](/docs/core/tests/tradefed/testing/through-tf/retry-isolation) for more details.\n\n8. Write a shell test\n---------------------\n\nSee [Write a shell test in Trade Federation](/docs/core/tests/tradefed/testing/through-tf/shell-test).\n\n9. Configure global test filters\n--------------------------------\n\nSee [Global filters in Trade Federation](/docs/core/tests/tradefed/testing/through-tf/global-filters)."]]