2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

TestDevice.MicrodroidBuilder

public static class TestDevice.MicrodroidBuilder
extends Object

java.lang.Object
↳	com.android.tradefed.device.TestDevice.MicrodroidBuilder

Microdroid TestDevice를 만드는 데 사용되는 빌더입니다.

요약

공개 메서드
`TestDevice.MicrodroidBuilder`	`addAssignableDevice(String sysfsNode)` microdroid에 할당할 기기를 추가합니다.
`TestDevice.MicrodroidBuilder`	`addBootFile(File localFile, String remoteFileName)` `ERROR(/#TEST_ROOT)`에 푸시할 부팅 파일을 추가합니다.
`TestDevice.MicrodroidBuilder`	`addExtraIdsigPath(String extraIdsigPath)` 목록에 추가 idsig 파일을 추가합니다.
`TestDevice.MicrodroidBuilder`	`addTestDeviceOption(String optionName, String valueText)` microdroid TestDevice의 `TestDeviceOptions`를 설정합니다.
`ITestDevice`	`build(TestDevice device)` 지정된 TestDevice에서 Micrdroid TestDevice를 시작합니다.
`TestDevice.MicrodroidBuilder`	`cpuAffinity(String affinity)` vCPU가 실행될 수 있는 호스트 CPU를 설정합니다.
`TestDevice.MicrodroidBuilder`	`cpuTopology(String cpuTopology)` CPU 토폴로지 구성을 설정합니다.
`TestDevice.MicrodroidBuilder`	`debugLevel(String debugLevel)` 디버그 수준을 설정합니다.
`TestDevice.MicrodroidBuilder`	`dumpDt(String dumpDt)` 기기 트리 Blob이 덤프될 경로를 설정합니다.
`TestDevice.MicrodroidBuilder`	`enableEarlycon(boolean enableEarlycon)` 이 VM의 earlycon 로그를 사용 설정합니다.
`TestDevice.MicrodroidBuilder`	`forceStartAdbd(boolean forceStartAdbd)` `vm run` 과 `adb forward` 사이에 `vm start-adbd`를 강제로 호출 참고: 이전 API 수준 (SDK 36 이전)에서는 이 함수가 no-op입니다.
`static TestDevice.MicrodroidBuilder`	`fromDevicePath(String apkPath, String configPath)` 지정된 apkPath와 APK의 페이로드 구성 파일의 Microdroid 빌더를 만듭니다.
`static TestDevice.MicrodroidBuilder`	`fromDevicePathWithPayloadBinaryName(String apkPath, String payloadBinaryName)` 지정된 apkPath와 APK의 페이로드 바이너리 이름으로 Microdroid 빌더를 만듭니다.
`static TestDevice.MicrodroidBuilder`	`fromFile(File apkFile, String configPath)` 주어진 APK와 APK의 페이로드 구성 파일의 Microdroid 빌더를 만듭니다.
`TestDevice.MicrodroidBuilder`	`gki(String version)` 이 메서드는 지원 중단되었습니다. `os(String)`을 사용하세요.
`TestDevice.MicrodroidBuilder`	`hugePages(boolean hintHugePages)` 투명한 대형 페이지에 커널을 힌트할지 여부를 설정합니다.
`TestDevice.MicrodroidBuilder`	`instanceIdFile(String instanceIdPath)` instance_id 경로를 설정합니다.
`TestDevice.MicrodroidBuilder`	`instanceImgFile(String instanceImgPath)` instance.img 파일 경로를 설정합니다.
`TestDevice.MicrodroidBuilder`	`memoryMib(int memoryMib)` VM에 제공할 RAM 용량을 설정합니다.
`TestDevice.MicrodroidBuilder`	`name(String name)` 이 VM의 이름을 설정합니다.
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` VM의 vCPU 수를 설정합니다.
`TestDevice.MicrodroidBuilder`	`os(String os)` 기본값이 아닌 Microdroid OS 변형을 사용합니다.
`TestDevice.MicrodroidBuilder`	`protectedVm(boolean isProtectedVm)` VM을 보호할지 여부를 설정합니다.
`TestDevice.MicrodroidBuilder`	`ramdump(boolean useRamdump)` ramdump용 비정상 종료 커널을 사용 중지할지 여부를 설정합니다.
`TestDevice.MicrodroidBuilder`	`setAdbConnectTimeoutMs(long timeoutMs)` adb가 microdroid TestDevice에 연결되는 시간 제한을 밀리초 단위로 설정합니다.

공개 메서드

addAssignableDevice

public TestDevice.MicrodroidBuilder addAssignableDevice (String sysfsNode)

microdroid에 할당할 기기를 추가합니다.

매개변수
`sysfsNode`	`String`: 할당할 sysfs 노드의 경로

반환
`TestDevice.MicrodroidBuilder`	Microdroid 빌더

addBootFile

public TestDevice.MicrodroidBuilder addBootFile (File localFile, 
                String remoteFileName)

ERROR(/#TEST_ROOT)에 푸시할 부팅 파일을 추가합니다.

microdroid를 부팅하는 데 파일이 필요한 경우 이 메서드를 사용하세요. 그렇지 않은 경우 TestDevice.pushFile를 사용합니다.

매개변수
`localFile`	`File`: 호스트의 로컬 파일
`remoteFileName`	`String`: 기기의 원격 파일 이름

반환
`TestDevice.MicrodroidBuilder`	Microdroid 빌더

addExtraIdsigPath

public TestDevice.MicrodroidBuilder addExtraIdsigPath (String extraIdsigPath)

목록에 추가 idsig 파일을 추가합니다.

매개변수
`extraIdsigPath`	`String`

반환
`TestDevice.MicrodroidBuilder`

addTestDeviceOption

public TestDevice.MicrodroidBuilder addTestDeviceOption (String optionName, 
                String valueText)

microdroid TestDevice의 TestDeviceOptions를 설정합니다.

매개변수
`optionName`	`String`: 설정할 TestDeviceOption의 이름
`valueText`	`String`: 값

반환
`TestDevice.MicrodroidBuilder`	Microdroid 빌더

build

public ITestDevice build (TestDevice device)

지정된 TestDevice에서 Micrdroid TestDevice를 시작합니다.

매개변수
`device`	`TestDevice`

반환
`ITestDevice`

생성 값
`DeviceNotAvailableException`

cpuAffinity

public TestDevice.MicrodroidBuilder cpuAffinity (String affinity)

vCPU가 실행될 수 있는 호스트 CPU를 설정합니다. 형식은 vCPU를 실행할 CPU 또는 CPU 범위의 쉼표로 구분된 목록입니다. 예를 들어 호스트 CPU 0,1,2, 3, 5를 선택하려면 '0, 1-3, 5'를 사용합니다. 또는 vCPU를 호스트 CPU 할당에 할당하는 콜론으로 구분된 목록일 수 있습니다. 예를 들어 vCPU 0을 호스트 CPU 0에 매핑하는 '0=0:1=1:2=2'입니다.

Android T에서만 지원됩니다.

매개변수
`affinity`	`String`

반환
`TestDevice.MicrodroidBuilder`

cpuTopology

public TestDevice.MicrodroidBuilder cpuTopology (String cpuTopology)

CPU 토폴로지 구성을 설정합니다. 지원되는 값은 'one_cpu' 및 'match_host'입니다.

매개변수
`cpuTopology`	`String`

반환
`TestDevice.MicrodroidBuilder`

debugLevel

public TestDevice.MicrodroidBuilder debugLevel (String debugLevel)

디버그 수준을 설정합니다.

지원되는 값: 'none', 'full' Android T는 'app_only'도 지원합니다.

매개변수
`debugLevel`	`String`

반환
`TestDevice.MicrodroidBuilder`

dumpDt

public TestDevice.MicrodroidBuilder dumpDt (String dumpDt)

기기 트리 Blob이 덤프될 경로를 설정합니다.

지원되는 값: null 및 'path'

매개변수
`dumpDt`	`String`

반환
`TestDevice.MicrodroidBuilder`

enableEarlycon

public TestDevice.MicrodroidBuilder enableEarlycon (boolean enableEarlycon)

이 VM의 earlycon 로그를 사용 설정합니다.

참고: 이전 API 수준 (SDK 36 이전)에서는 이 함수가 no-op입니다.

매개변수
`enableEarlycon`	`boolean`

반환
`TestDevice.MicrodroidBuilder`	Microdroid 빌더

forceStartAdbd

public TestDevice.MicrodroidBuilder forceStartAdbd (boolean forceStartAdbd)

`vm run` 과 `adb forward` 사이에 `vm start-adbd`를 강제로 호출

참고: 이전 API 수준 (SDK 36 이전)에서는 이 함수가 no-op입니다.

매개변수
`forceStartAdbd`	`boolean`

반환
`TestDevice.MicrodroidBuilder`	Microdroid 빌더

fromDevicePath

public static TestDevice.MicrodroidBuilder fromDevicePath (String apkPath, 
                String configPath)

지정된 apkPath와 APK의 페이로드 구성 파일의 Microdroid 빌더를 만듭니다.

매개변수
`apkPath`	`String`
`configPath`	`String`

반환
`TestDevice.MicrodroidBuilder`

fromDevicePathWithPayloadBinaryName

public static TestDevice.MicrodroidBuilder fromDevicePathWithPayloadBinaryName (String apkPath, 
                String payloadBinaryName)

지정된 apkPath와 APK의 페이로드 바이너리 이름으로 Microdroid 빌더를 만듭니다.

매개변수
`apkPath`	`String`
`payloadBinaryName`	`String`

반환
`TestDevice.MicrodroidBuilder`

fromFile

public static TestDevice.MicrodroidBuilder fromFile (File apkFile, 
                String configPath)

주어진 APK와 APK의 페이로드 구성 파일의 Microdroid 빌더를 만듭니다.

매개변수
`apkFile`	`File`
`configPath`	`String`

반환
`TestDevice.MicrodroidBuilder`

gki

public TestDevice.MicrodroidBuilder gki (String version)

이 메서드는 지원 중단되었습니다.
os(String)를 사용하세요.

microdroid 커널 대신 GKI 커널 사용

매개변수
`version`	`String`: 사용할 GKI 버전

반환
`TestDevice.MicrodroidBuilder`

hugePages

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

투명한 대형 페이지에 커널을 힌트할지 여부를 설정합니다.

매개변수
`hintHugePages`	`boolean`

반환
`TestDevice.MicrodroidBuilder`	Microdroid 빌더

instanceIdFile

public TestDevice.MicrodroidBuilder instanceIdFile (String instanceIdPath)

instance_id 경로를 설정합니다.

매개변수
`instanceIdPath`	`String`: : instanceId 경로

반환
`TestDevice.MicrodroidBuilder`

instanceImgFile

public TestDevice.MicrodroidBuilder instanceImgFile (String instanceImgPath)

instance.img 파일 경로를 설정합니다.

매개변수
`instanceImgPath`	`String`

반환
`TestDevice.MicrodroidBuilder`

memoryMib

public TestDevice.MicrodroidBuilder memoryMib (int memoryMib)

VM에 제공할 RAM 용량을 설정합니다. 0 이하이면 기본값이 사용됩니다.

매개변수
`memoryMib`	`int`

반환
`TestDevice.MicrodroidBuilder`

이름

public TestDevice.MicrodroidBuilder name (String name)

이 VM의 이름을 설정합니다.

매개변수
`name`	`String`

반환
`TestDevice.MicrodroidBuilder`	Microdroid 빌더

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

VM의 vCPU 수를 설정합니다. 기본값은 1입니다.

Android T에서만 지원됩니다.

매개변수
`num`	`int`

반환
`TestDevice.MicrodroidBuilder`

os

public TestDevice.MicrodroidBuilder os (String os)

기본값이 아닌 Microdroid OS 변형을 사용합니다.

매개변수
`os`	`String`: 사용할 Microdroid OS 버전

반환
`TestDevice.MicrodroidBuilder`

protectedVm

public TestDevice.MicrodroidBuilder protectedVm (boolean isProtectedVm)

VM을 보호할지 여부를 설정합니다.

매개변수
`isProtectedVm`	`boolean`

반환
`TestDevice.MicrodroidBuilder`

ramdump

public TestDevice.MicrodroidBuilder ramdump (boolean useRamdump)

ramdump용 비정상 종료 커널을 사용 중지할지 여부를 설정합니다.

매개변수
`useRamdump`	`boolean`

반환
`TestDevice.MicrodroidBuilder`	Microdroid 빌더

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

adb가 microdroid TestDevice에 연결되는 시간 제한을 밀리초 단위로 설정합니다.

테스트가 중단되지 않도록 양수여야 합니다.

매개변수
`timeoutMs`	`long`: 제한 시간(밀리초)

반환
`TestDevice.MicrodroidBuilder`