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.

BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

알려진 직접 서브클래스

AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo

AppBuildInfo	Android 애플리케이션과 테스트 패키지를 나타내는 `IBuildInfo`입니다.
DeviceBuildInfo	완전한 Android 기기 빌드와 테스트 (선택사항)를 나타내는 `IBuildInfo`입니다.
FolderBuildInfo	`IFolderBuildInfo`의 구체적인 구현입니다.
OtatoolsBuildInfo	otatools 아티팩트가 포함된 `IBuildInfo`

알려진 간접 하위 클래스

AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo

AppDeviceBuildInfo	이 클래스는 지원 중단되었습니다. `IDeviceBuildInfo`를 직접 사용합니다.
ClusterBuildInfo	TFC에서 파이프된 빌드의 `IBuildInfo` 클래스입니다.
DeviceFolderBuildInfo	로컬 파일 시스템의 디렉터리에 포함된 다른 빌드 아티팩트도 포함하는 `IDeviceBuildInfo`
OtaDeviceBuildInfo	무선 업데이트 테스트에 사용되는 `IDeviceBuildInfo`입니다.

ITestDevice과 연결되어야 하는 IBuildInfo의 일반 구현

요약

공개 생성자
`BuildInfo()` 기본 속성 값을 사용하여 `BuildInfo`를 만듭니다.
`BuildInfo(String buildId, String buildTargetName)` `BuildInfo`를 만듭니다.

공개 메서드
`void`	`addAppPackageFile(File appPackageFile, String version)` 로컬 APK 파일과 연결된 버전을 추가합니다.
`void`	`addBuildAttribute(String attributeName, String attributeValue)` 빌드 속성을 추가합니다.
`void`	`addBuildAttributes(Map<String, String> buildAttributes)` 빌드 속성 추가
`void`	`allowStagingRemoteFile(boolean stageRemoteFile)` 원격 파일 스테이징을 허용하는 권한을 설정합니다.
`void`	`cleanUp()` 임시 빌드 파일 정리
`void`	`cleanUp(List<File> doNotClean)` 일부 파일이 삭제되지 않은 `cleanUp()` 버전
`IBuildInfo`	`clone()`
`final void`	`copyAllFileFrom(BuildInfo build)` 지정된 빌드에서 이 빌드로 모든 `VersionedFile`를 복사합니다.
`boolean`	`equals(Object obj)`
`static IBuildInfo`	`fromProto(BuildInformation.BuildInfo protoBuild)` 인스턴스를 다시 가져오기 위해 `toProto()`의 역 연산입니다.
`List<VersionedFile>`	`getAppPackageFiles()` 로컬 앱 APK 파일 및 버전의 사본을 가져옵니다.
`Map<String, String>`	`getBuildAttributes()` 빌드를 설명하는 추가 속성의 이름-값 쌍 집합을 가져옵니다.
`String`	`getBuildBranch()` 테스트 중인 빌드가 생성된 소스 제어 브랜치를 반환하는 선택적 메서드입니다.
`String`	`getBuildFlavor()` 테스트 중인 빌드 유형을 반환하는 선택적 메서드입니다.
`String`	`getBuildId()` 테스트 중인 빌드의 고유 식별자를 반환합니다.
`String`	`getBuildTargetName()` 테스트 중인 빌드의 전체 이름을 반환합니다.
`String`	`getDeviceSerial()`
`File`	`getFile(String name)` 지정된 이름의 파일을 가져오는 도우미 메서드
`File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` `BuildInfoFileKey`가 지정된 파일을 가져오는 도우미 메서드
`Collection<VersionedFile>`	`getFiles()` 이 `BuildInfo`에 저장된 모든 `VersionedFile`를 반환합니다.
`Set<IBuildInfo.BuildInfoProperties>`	`getProperties()` `IBuildInfo`에 현재 설정된 속성의 사본을 반환합니다.
`Set<File>`	`getRemoteFiles()` 다운로드가 지연된 빌드 아티팩트의 경로를 가져옵니다.
`String`	`getTestTag()` 실행 중인 테스트의 고유한 이름을 반환합니다.
`String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` `BuildInfoFileKey`가 지정된 파일 버전을 가져오는 도우미 메서드
`String`	`getVersion(String name)` 지정된 이름으로 파일 버전을 가져오는 도우미 메서드
`VersionedFile`	`getVersionedFile(BuildInfoKey.BuildInfoFileKey key)` 지정된 `BuildInfoFileKey`로 `VersionedFile`를 가져오는 도우미 메서드
`final VersionedFile`	`getVersionedFile(String name)` 지정된 이름으로 `VersionedFile`를 가져오는 도우미 메서드
`Set<String>`	`getVersionedFileKeys()` `getFile(BuildInfoFileKey)`을 통해 `VersionedFile`를 쿼리하는 데 사용할 수 있는 키 집합을 반환합니다.
`final List<VersionedFile>`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` 지정된 `BuildInfoFileKey`과 연결된 `VersionedFile` 목록을 가져오는 도우미 메서드
`int`	`hashCode()`
`void`	`removeBuildAttribute(String attributeName)` 추적에서 지정된 attributeName을 삭제합니다.
`void`	`setBuildBranch(String branch)` 빌드 브랜치 설정
`void`	`setBuildFlavor(String buildFlavor)` 빌드 버전을 설정합니다.
`void`	`setBuildId(String buildId)` 테스트 중인 빌드의 고유 식별자를 설정합니다.
`void`	`setDeviceSerial(String serial)` 이 빌드와 연결된 `ITestDevice` 시리얼을 설정합니다.
`void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` 이 빌드 정보에 `BuildInfoFileKey`가 지정된 파일을 저장합니다.
`void`	`setFile(String name, File file, String version)` 이 빌드 정보에 지정된 이름의 파일을 저장합니다.
`void`	`setProperties(BuildInfoProperties... properties)` `IBuildInfo` 인스턴스의 `BuildInfoProperties`을 설정합니다.
`void`	`setTestTag(String testTag)` 실행 중인 테스트의 고유한 이름을 설정합니다.
`File`	`stageRemoteFile(String fileName, File workingDir)` 빌드 정보의 루트 디렉터리에 있는 원격 파일의 일부인 파일을 스테이징합니다.
`BuildInformation.BuildInfo`	`toProto()` BuildInfo 인스턴스를 protobuf로 직렬화합니다.
`String`	`toString()`

보호된 메서드
`void`	`addAllBuildAttributes(BuildInfo build)` 다른 빌드에서 빌드 속성, 브랜치, 버전을 복사하는 도우미 메서드
`void`	`addAllFiles(BuildInfo build)` 다른 빌드에서 모든 파일을 복사하는 도우미 메서드
`boolean`	`applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)` 일부 `IBuildInfo.BuildInfoProperties`를 적용하고 다른 처리를 할 수 있도록 허용
`MultiMap<String, String>`	`getAttributesMultiMap()`
`Map<String, VersionedFile>`	`getVersionedFileMap()`
`MultiMap<String, VersionedFile>`	`getVersionedFileMapFull()`

공개 생성자

BuildInfo

public BuildInfo ()

기본 속성 값을 사용하여 BuildInfo를 만듭니다.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

BuildInfo를 만듭니다.

매개변수
`buildId`	`String`: 빌드 ID
`buildTargetName`	`String`: 빌드 타겟 이름

공개 메서드

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

로컬 APK 파일과 연결된 버전을 추가합니다. APK는 이 메서드로 추가된 순서대로 getAppPackageFiles()에서 반환됩니다.

매개변수
`appPackageFile`	`File`
`version`	`String`

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

빌드 속성을 추가합니다. 이렇게 하면 기존 attributeName을 재정의할 수 없습니다.

매개변수
`attributeName`	`String`: 고유한 속성 이름
`attributeValue`	`String`: 속성 값

addBuildAttributes

public void addBuildAttributes (Map<String, String> buildAttributes)

빌드 속성 추가

매개변수
`buildAttributes`	`Map`: 추가할 속성의 맵

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

원격 파일 스테이징을 허용하는 권한을 설정합니다.

매개변수
`stageRemoteFile`	`boolean`

cleanUp

public void cleanUp ()

임시 빌드 파일 정리

cleanUp

public void cleanUp (List<File> doNotClean)

일부 파일이 삭제되지 않은 cleanUp() 버전

매개변수
`doNotClean`	`List`

clone

public IBuildInfo clone ()

반환
`IBuildInfo`

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

지정된 빌드에서 이 빌드로 모든 VersionedFile를 복사합니다.

매개변수
`build`	`BuildInfo`

같음

public boolean equals (Object obj)

매개변수
`obj`	`Object`

반환
`boolean`

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

인스턴스를 다시 가져오기 위해 toProto()의 역 연산입니다.

매개변수
`protoBuild`	`BuildInformation.BuildInfo`

반환
`IBuildInfo`

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

로컬 앱 APK 파일 및 버전의 사본을 가져옵니다. 반환된 순서는 APK가 IAppBuildInfo에 추가된 순서와 일치합니다.

반환
`List<VersionedFile>`

getBuildAttributes

public Map<String, String> getBuildAttributes ()

빌드를 설명하는 추가 속성의 이름-값 쌍 집합을 가져옵니다.

반환
`Map<String, String>`	빌드 속성의 `Map` `null`이 아니지만 비어 있을 수 있습니다.

getBuildBranch

public String getBuildBranch ()

테스트 중인 빌드가 생성된 소스 제어 브랜치를 반환하는 선택적 메서드입니다.

반환
`String`	설정되지 않았거나 해당하지 않는 경우 빌드 브랜치 또는 `null`

getBuildFlavor

public String getBuildFlavor ()

테스트 중인 빌드 유형을 반환하는 선택적 메서드입니다.

Android 플랫폼 빌드의 일반적인 구현은 (빌드 제품)-(빌드 OS)-(빌드 변형)을 반환하는 것입니다. ie generic-linux-userdebug

반환
`String`	설정되지 않았거나 적용되지 않는 경우 빌드 버전 또는 `null`

getBuildId

public String getBuildId ()

테스트 중인 빌드의 고유 식별자를 반환합니다. null이면 안 됩니다. 기본값은 UNKNOWN_BUILD_ID입니다.

반환
`String`

getBuildTargetName

public String getBuildTargetName ()

테스트 중인 빌드의 전체 이름을 반환합니다.

일반적인 구현은 빌드 버전과 브랜치 이름의 조합에서 빌드 타겟 이름을 구성하는 것입니다. [예: (브랜치 이름)-(빌드 버전)]

반환
`String`

getDeviceSerial

public String getDeviceSerial ()

반환
`String`

getFile

public File getFile (String name)

지정된 이름의 파일을 가져오는 도우미 메서드

반환
`File`	이미지 파일 또는 찾을 수 없는 경우 `null`

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

BuildInfoFileKey가 지정된 파일을 가져오는 도우미 메서드

매개변수
`key`	`BuildInfoKey.BuildInfoFileKey`: 요청된 `BuildInfoFileKey`입니다.

반환
`File`	이미지 파일 또는 찾을 수 없는 경우 `null`

getFiles

public Collection<VersionedFile> getFiles ()

이 BuildInfo에 저장된 모든 VersionedFile를 반환합니다.

반환
`Collection<VersionedFile>`

getProperties

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

IBuildInfo에 현재 설정된 속성의 사본을 반환합니다.

반환
`Set<IBuildInfo.BuildInfoProperties>`

getRemoteFiles

public Set<File> getRemoteFiles ()

다운로드가 지연된 빌드 아티팩트의 경로를 가져옵니다.

반환
`Set<File>`

getTestTag

public String getTestTag ()

실행 중인 테스트의 고유한 이름을 반환합니다.

반환
`String`

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

BuildInfoFileKey가 지정된 파일 버전을 가져오는 도우미 메서드

매개변수
`key`	`BuildInfoKey.BuildInfoFileKey`: 요청된 `BuildInfoFileKey`입니다.

반환
`String`	이미지 버전 또는 찾을 수 없는 경우 `null`

getVersion

public String getVersion (String name)

지정된 이름으로 파일 버전을 가져오는 도우미 메서드

반환
`String`	이미지 버전 또는 찾을 수 없는 경우 `null`

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

지정된 BuildInfoFileKey로 VersionedFile를 가져오는 도우미 메서드

매개변수
`key`	`BuildInfoKey.BuildInfoFileKey`: 요청된 `BuildInfoFileKey`입니다.

반환
`VersionedFile`	버전이 지정된 파일 또는 찾을 수 없는 경우 `null`

getVersionedFile

public final VersionedFile getVersionedFile (String name)

지정된 이름으로 VersionedFile를 가져오는 도우미 메서드

반환
`VersionedFile`	버전이 지정된 파일 또는 찾을 수 없는 경우 `null`

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

getFile(BuildInfoFileKey)을 통해 VersionedFile를 쿼리하는 데 사용할 수 있는 키 집합을 반환합니다.

반환
`Set<String>`

getVersionedFiles

public final List<VersionedFile> getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

지정된 BuildInfoFileKey과 연결된 VersionedFile 목록을 가져오는 도우미 메서드 키가 목록을 저장할 수 있는지 여부입니다.

매개변수
`key`	`BuildInfoKey.BuildInfoFileKey`: 요청된 `BuildInfoFileKey`입니다.

반환
`List<VersionedFile>`	버전이 지정된 파일 또는 찾을 수 없는 경우 `null`

hashCode

public int hashCode ()

반환
`int`

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

추적에서 지정된 attributeName을 삭제합니다.

매개변수
`attributeName`	`String`: 추적을 중지할 속성

setBuildBranch

public void setBuildBranch (String branch)

빌드 브랜치 설정

매개변수
`branch`	`String`: 브랜치 이름

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

빌드 버전을 설정합니다.

setBuildId

public void setBuildId (String buildId)

테스트 중인 빌드의 고유 식별자를 설정합니다. null이면 안 됩니다.

매개변수
`buildId`	`String`

setDeviceSerial

public void setDeviceSerial (String serial)

이 빌드와 연결된 ITestDevice 시리얼을 설정합니다.

매개변수
`serial`	`String`: 이 빌드가 실행된 `ITestDevice`의 일련번호입니다.

setFile

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

이 빌드 정보에 BuildInfoFileKey가 지정된 파일을 저장합니다.

매개변수
`key`	`BuildInfoKey.BuildInfoFileKey`: `BuildInfoFileKey`에 기반한 파일의 고유한 이름입니다.
`file`	`File`: 로컬 `File`
`version`	`String`: 파일 버전

setFile

public void setFile (String name, 
                File file, 
                String version)

이 빌드 정보에 지정된 이름의 파일을 저장합니다.

매개변수
`name`	`String`: 파일의 고유한 이름
`file`	`File`: 로컬 `File`
`version`	`String`: 파일 버전

setProperties

public void setProperties (BuildInfoProperties... properties)

IBuildInfo 인스턴스의 BuildInfoProperties을 설정합니다. 이전에 설정된 기존 속성을 재정의합니다.

매개변수
`properties`	`BuildInfoProperties`: 추가할 속성 목록입니다.

setTestTag

public void setTestTag (String testTag)

실행 중인 테스트의 고유한 이름을 설정합니다.

매개변수
`testTag`	`String`

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

빌드 정보의 루트 디렉터리에 있는 원격 파일의 일부인 파일을 스테이징합니다.

TODO(b/138416078): 테스트에 필요한 모듈을 테스트 모듈의 디렉터리에 제대로 빌드할 수 있는 경우 이 인터페이스와 호출자를 삭제합니다.

매개변수
`fileName`	`String`: 원격 파일에서 찾을 파일의 이름입니다.
`workingDir`	`File`: 파일을 스테이징할 디렉터리의 `File` 객체입니다.

반환
`File`	로컬 workingDir에 스테이징된 파일의 `File` 객체

toProto

public BuildInformation.BuildInfo toProto ()

BuildInfo 인스턴스를 protobuf로 직렬화합니다.

반환
`BuildInformation.BuildInfo`

toString

public String toString ()

반환
`String`

보호된 메서드

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

다른 빌드에서 빌드 속성, 브랜치, 버전을 복사하는 도우미 메서드

매개변수
`build`	`BuildInfo`

addAllFiles

protected void addAllFiles (BuildInfo build)

다른 빌드에서 모든 파일을 복사하는 도우미 메서드

각 빌드에 파일의 고유한 파일 경로가 있도록 파일에 대한 새 하드링크를 만듭니다.

매개변수
`build`	`BuildInfo`

생성 값
`IOException`	하드링크를 만들 때 예외가 발생한 경우

applyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

일부 IBuildInfo.BuildInfoProperties를 적용하고 다른 처리를 할 수 있도록 허용

매개변수
`origFileConsidered`	`VersionedFile`: 현재 살펴보고 있는 `VersionedFile`입니다.
`build`	`IBuildInfo`: 클론되는 원래 빌드
`receiver`	`IBuildInfo`: 정보를 수신하는 빌드입니다.

반환
`boolean`	속성을 적용했고 추가 처리를 건너뛰어야 하는 경우 true입니다. 그렇지 않으면 false입니다.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

반환
`MultiMap<String, String>`

getVersionedFileMap

protected Map<String, VersionedFile> getVersionedFileMap ()

반환
`Map<String, VersionedFile>`

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

반환
`MultiMap<String, VersionedFile>`