2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

알려진 간접 하위 클래스

AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer, CompanionTestAppInstallSetup, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter 등 79개

AdbStopServerPreparer	adb 테스트를 실행하기 전후에 호스트에서 adb 서버를 중지하는 타겟 준비자
AllTestAppsInstallSetup	`IDeviceBuildInfo.getTestsDir()` 폴더의 모든 앱을 기기에 설치하는 `ITargetPreparer`입니다.
AoaTargetPreparer	Android Open Accessory (AOAv2) 프로토콜을 사용하여 일련의 작업 (예: 클릭 및 스와이프)을 실행하는 `ITargetPreparer`
AppSetup	APK와 테스트를 설치하는 `ITargetPreparer`
ArtChrootPreparer	ART 테스트용 chroot 디렉터리 만들기
BaseEmulatorPreparer	로컬 에뮬레이터를 실행하기 위한 공통 준비자입니다.
BaseTargetPreparer	객체가 사용 중지되었는지 여부를 제어할 수 있는 `ITargetPreparer`의 기본 구현 클래스입니다.
BuildInfoRecorder	지정된 파일에 빌드 정보 메타데이터를 쓰는 `ITargetPreparer`
CheckPairingPreparer	기본 기기와 동반 기기 간의 BT 페어링을 확인하는 `CompanionAwarePreparer`
CompanionAllocator	동반 기기 할당 및 해제를 처리하는 기본 클래스 `getCompanionDeviceSelectionOptions()`는 동반 기기를 할당하는 데 필요한 기준을 설명하도록 구현해야 합니다.
CompanionAwarePreparer	이미 할당된 동반 기기를 가져오는 로직을 캡슐화하는 `ITargetPreparer`
CompanionRunCommandTargetPreparer	할당된 동반 기기에서 지정된 명령어를 실행하는 `ITargetPreparer`
CompanionTestAppInstallSetup	할당된 동반 기기에 `IDeviceBuildInfo.getTestsDir()` 폴더에서 하나 이상의 앱을 설치하는 `ITargetPreparer`
CompileBootImageWithSpeedTargetPreparer	컴파일러 필터 'speed'를 사용하여 부트 클래스 경로와 시스템 서버를 다시 컴파일합니다.
CpuThrottlingWaiter	모든 코어의 최대 주파수가 사용 가능한 최고 수준으로 복원될 때까지 기다리는 `ITargetPreparer`
CreateAvdPreparer
CreateUserPreparer	사용자를 만들고 마지막에 정리하는 타겟 준비자
DeviceActionTargetPreparer	기기 작업을 실행하는 `ITargetPreparer`
DeviceBuildInfoBootStrapper	빌드 정보 필드를 기기에서 읽은 속성으로 대체하는 `ITargetPreparer` 이는 외부 소스에서 생성된 빌드로 기기를 테스트하는 데 유용합니다 (예:
DeviceBuildInfoInjector	`DeviceBuildDescriptor` 메타데이터를 `IBuildInfo`에 삽입하는 `ITargetPreparer`
DeviceCleaner	테스트 후 정리 작업으로 재부팅 또는 포맷을 실행하고 선택적으로 화면을 끕니다.
DeviceFlashPreparer	실제 Android 하드웨어에 이미지를 플래시하는 `ITargetPreparer`
DeviceImageZipFlashingTargetPreparer	특정 형식을 통해 제공된 기기 이미지로 기기를 플래시하는 타겟 준비자
DeviceOwnerTargetPreparer	기기 소유자 구성요소를 설정하는 `ITargetPreparer`입니다.
DeviceSetup	제공된 `Option`에 따라 테스트를 위해 기기를 구성하는 `ITargetPreparer`
DeviceStorageFiller	준비자가 저장소를 채워 일정량의 여유 공간이 있도록 합니다.
DeviceStringPusher	파일에 문자열을 쓰는 타겟 준비자
DeviceUpdateTargetPreparer	빌드 서비스가 아닌 외부 소스의 기기 이미지 파일로 기기를 업데이트하는 것과 관련된 일반적인 단계를 처리하는 추상 `ITargetPreparer`입니다.
DeviceWiper	사용자 데이터를 완전 삭제하는 `ITargetPreparer`
DisableSELinuxTargetPreparer	사용 설정된 경우 SELinux를 사용 중지하는 타겟 준비자입니다.
DynamicSystemPreparer	동적 시스템 업데이트로 기기 빌드 위에 시스템 이미지를 설정하는 `ITargetPreparer`
EraseUserDataPreparer	기기에서 사용자 데이터를 완전 삭제하는 `ITargetPreparer`
FastbootCommandPreparer	빠른 부팅을 트리거하고 빠른 부팅 명령어를 전송하는 타겟 준비자
FastbootUpdateBootstrapPreparer	지정된 파일 (부트로더, 라디오, 기기 이미지 zip)을 `IDeviceBuildInfo`에 스테이징하여 `FastbootDeviceFlasher`로 기기를 플래시한 후 결과 보고를 위해 부팅 후 기기 속성을 빌드 정보에 삽입하는 `ITargetPreparer`
FeatureFlagTargetPreparer	DeviceConfig (원격 서비스에 의해 조정된 기능 플래그)를 업데이트합니다.
FoldableModePreparer	기기의 폴더블 상태를 전환할 수 있는 타겟 준비자
FolderSaver	기기에서 디렉터리를 가져와 압축하고 로깅 백엔드에 저장하는 `ITargetPreparer`
FutilityCommandPreparer	무용성 명령어를 실행하는 준비자
GkiDeviceFlashPreparer	Android 공통 커널 일반 이미지로 기기를 플래시하는 타겟 준비자
GoogleAccountPreparer	Google 계정 구성을 지원하는 `ITargetPreparer`
GsiDeviceFlashPreparer	Android 일반 시스템 이미지로 기기를 플래시하는 타겟 준비자
ILabPreparer	실습 준비자를 위한 마커 인터페이스 이러한 인터페이스의 의도에 관한 설명은 `ITargetPreparer`를 참고하세요.
ITargetCleaner	이 인터페이스는 지원 중단되었습니다. tearDown이 기본 ITargetPreparer 인터페이스로 이동되었습니다.
InstallAllTestZipAppsSetup	테스트 zip의 모든 앱을 설치하는 `ITargetPreparer`입니다.
InstallApexModuleTargetPreparer
InstallApkSetup	파일 시스템에 있는 하나 이상의 APK를 설치하는 `ITargetPreparer`
InstallBuildEnvApkSetup	Android 플랫폼 빌드 환경에서 하나 이상의 테스트 APK를 설치하는 `ITargetPreparer`
InstallKernelModulePreparer	커널 모듈을 설치하는 타겟 준비자입니다.
InstrumentationPreparer	계측을 실행하는 `ITargetPreparer`
KillExistingEmulatorPreparer	실행 중인 에뮬레이터를 종료하는 `ITargetPreparer`
KnownFailurePreparer	알려진 실패를 재시도하지 않도록 타겟 준비자
LocalEmulatorLaunch	Android 빌드 환경에서 로컬로 에뮬레이터를 실행하는 TargetPreparer입니다.
LocalEmulatorSnapshot	Android 빌드/개발 환경에서 클린 에뮬레이터 스냅샷을 생성하기 위한 TargetPreparer
MixKernelTargetPreparer	커널 이미지를 기기 이미지와 혼합할 수 있는 `ITargetPreparer`
MixRadioTargetPreparer	라디오 이미지를 기기 이미지와 혼합할 수 있는 `ITargetPreparer`
ModuleOemTargetPreparer
NativeLeakCollector	'dumpsys meminfo --unreachable -a'를 실행하여 각 프로세스에서 현재 보유하고 있는 도달할 수 없는 네이티브 메모리를 식별하는 `ITargetPreparer`
NoApkTestSkipper	테스트할 APK가 없는 경우 호출 (준비 및 테스트)을 완전히 건너뛸 수 있는 특수 준비자입니다.
PerfettoPreparer	Perfetto 준비자는 perfetto가 액세스할 수 있는 표준 위치에 구성 파일을 기기로 푸시합니다.
ProfileTargetPreparer	프로필 사용자 `android.os.usertype.profile.XXX`의 타겟 준비자를 설정하기 위한 기본 클래스입니다.
PushFileInvoker	이 클래스는 지원 중단되었습니다. 대신 `PushFilePreparer`를 사용하세요.
PushFilePreparer	호스트 경로에서 기기 경로로 원하는 수의 파일을 푸시하려고 시도하는 `ITargetPreparer`입니다.
PythonVirtualenvPreparer	호스트에 Python virtualenv를 설정하고 패키지를 설치합니다.
RebootTargetPreparer	기기를 재부팅하는 타겟 준비자
RecoveryLogPreparer	복구 전에 로그를 수집하는 데 사용되는 타겟 준비자입니다.
RemoveSystemAppPreparer	테스트 실행 전에 시스템 파티션에서 APK를 삭제하는 `ITargetPreparer`입니다.
RestartSystemServerTargetPreparer	기기를 재부팅하지 않고 시스템 서버를 다시 시작하는 타겟 준비자
RootTargetPreparer	'force-root' 옵션에 따라 'adb root' 또는 'adb unroot'를 실행하는 타겟 준비자
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	테스트 실행 전후에 임의의 호스트 명령어를 실행하는 타겟 준비자
RunHostScriptTargetPreparer	테스트를 실행하기 전에 스크립트를 실행하는 타겟 준비자입니다.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	테스트가 SDK 샌드박스에서 실행되어야 함을 표시하는 `ITargetPreparer`입니다.
RunOnSecondaryUserTargetPreparer	테스트가 보조 사용자로 실행되도록 하는 `ITargetPreparer`
RunOnSystemUserTargetPreparer	테스트를 현재 사용자가 아닌 사용자에 대해 실행해야 함을 표시하는 `ITargetPreparer`입니다.
RunOnWorkProfileTargetPreparer	설정에서 직장 프로필을 만들고 테스트를 해당 사용자로 실행해야 한다고 표시하는 `ITargetPreparer`
SemaphoreTokenTargetPreparer	이는 토큰을 사용하여 Tradefed 호스트에서 테스트 실행을 직렬화하는 데 사용되는 준비자입니다.
SideloadOtaTargetPreparer	지정된 OTA 패키지를 사이드로드하고, 패키지를 적용하고, 기기가 부팅될 때까지 기다리고, 빌드 정보로 사용할 기기 빌드 속성을 삽입하는 타겟 준비자 이 타겟 준비자는 기기가 시작될 때 일반 adb 모드에 있다고 가정하며 기기가 동일한 모드에서 종료되지만 최신 빌드가 적용되도록 합니다.
StopServicesSetup	기기에서 서비스를 중지하는 `ITargetPreparer`
StubTargetPreparer	`ITargetPreparer`의 자리표시자 빈 구현입니다.
SuiteApkInstaller	스위트 구성에 지정된 APK를 설치합니다. $ANDROID_TARGET_OUT_TESTCASES 변수 또는 빌드 정보의 ROOT_DIR에서 설치합니다.
SwitchUserTargetPreparer	setUp에서 지정된 사용자 종류로 전환되는 `ITargetPreparer`
TearDownPassThroughPreparer	구성에서 객체로 포함된 준비자에서 tearDown을 실행할 수 있습니다.
TemperatureThrottlingWaiter	기기 온도가 목표 온도까지 내려갈 때까지 기다리는 `ITargetPreparer`
TestAppInstallSetup	`IDeviceBuildInfo.getTestsDir()` 폴더에서 하나 이상의 앱을 기기에 설치하는 `ITargetPreparer`입니다.
TestFilePushSetup	`IDeviceBuildInfo.getTestsDir()` 폴더에서 하나 이상의 파일/디렉터리를 기기에 푸시하는 `ITargetPreparer`
TestSystemAppInstallSetup	`IDeviceBuildInfo.getTestsDir()` 폴더에서 하나 이상의 앱을 기기의 /system 파티션에 설치하는 `ITargetPreparer`
TimeWaster	시간을 낭비하고 기기를 다시 시작할 수 있는 간단한 타겟 준비자입니다.
UserCleaner	테어다운 시 보조 사용자를 삭제하는 `ITargetPreparer`
VisibleBackgroundUserPreparer	백그라운드에서 표시된 상태로 시작된 사용자로 테스트를 실행하기 위한 타겟 준비자입니다.
WaitForDeviceDatetimePreparer	기기에서 datetime이 설정되기를 기다리는 `ITargetPreparer` 선택적으로 이 준비자는 시간 제한 내에 datetime이 설정되지 않은 경우 `TargetSetupError`를 강제할 수 있습니다.
WifiPreparer	필요한 경우 기기에서 Wi-Fi를 구성하는 `ITargetPreparer`입니다.

테스트 실행을 위한 테스트 환경을 준비합니다.

예를 들어 소프트웨어를 설치하고, 테스트를 위해 환경 설정을 조정하고, 타겟을 실행합니다.

구성에는 여러 ITargetPreparer를 지정할 수 있습니다. 각 ITargetPreparer는 예상되는 환경 사전 설정 및 사후 설정을 명확하게 문서화하는 것이 좋습니다. 예를 들어 테스트를 위해 기기를 구성하는 ITargetPreparer는 소프트웨어를 설치하는 ITargetPreparer 후에 실행해야 합니다.

요약

공개 메서드
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` 이 메서드는 지원 중단되었습니다. 대신 `setUp(com.android.tradefed.invoker.TestInformation)`를 사용하세요.
`default void`	`setUp(TestInformation testInformation)` 테스트를 위해 타겟 설정을 실행합니다.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` 테스트 후 타겟 정리/해체를 실행합니다.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` 이 메서드는 지원 중단되었습니다. 대신 `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`를 사용하세요.

공개 메서드

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

이 메서드는 지원 중단되었습니다.
대신 setUp(com.android.tradefed.invoker.TestInformation) 사용

테스트를 위해 타겟 설정을 실행합니다.

매개변수
`device`	`ITestDevice`: 준비할 `ITestDevice`입니다.
`buildInfo`	`IBuildInfo`: 테스트 중인 빌드에 관한 데이터입니다.

생성 값
`TargetSetupError`	환경 설정 중에 심각한 오류가 발생한 경우
`BuildError`	BuildInfo와 관련된 오류가 발생하는 경우
`DeviceNotAvailableException`	기기가 응답하지 않게 된 경우

setUp

public void setUp (TestInformation testInformation)

테스트를 위해 타겟 설정을 실행합니다.

매개변수
`testInformation`	`TestInformation`: 호출의 `TestInformation`입니다.

생성 값
`TargetSetupError`	환경 설정 중에 심각한 오류가 발생한 경우
`BuildError`	빌드가 준비 중이어서 오류가 발생하는 경우
`DeviceNotAvailableException`	기기가 응답하지 않게 된 경우

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

테스트 후 타겟 정리/해체를 실행합니다.

매개변수
`testInformation`	`TestInformation`: 호출의 `TestInformation`입니다.
`e`	`Throwable`: 호출이 예외로 종료된 경우 호출 수준에서 포착된 예외입니다. 그렇지 않으면 `null`입니다.

생성 값
`DeviceNotAvailableException`	기기가 응답하지 않게 된 경우

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

이 메서드는 지원 중단되었습니다.
대신 tearDown(com.android.tradefed.invoker.TestInformation, Throwable) 사용

테스트 후 타겟 정리/해체를 실행합니다.

매개변수
`device`	`ITestDevice`: 준비할 `ITestDevice`입니다.
`buildInfo`	`IBuildInfo`: 테스트 중인 빌드에 관한 데이터입니다.
`e`	`Throwable`: 호출이 예외로 종료된 경우 호출 수준에서 포착된 예외입니다. 그렇지 않으면 `null`입니다.

생성 값
`DeviceNotAvailableException`	기기가 응답하지 않게 된 경우