IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

알려진 간접 하위 클래스 AppBuildInfo, AppDeviceBuildInfo, BuildInfo, ClusterBuildInfo, DeviceBuildInfo, DeviceFolderBuildInfo, FolderBuildInfo, IAppBuildInfo, IDeviceBuildInfo, IFolderBuildInfo, OtaDeviceBuildInfo, OtatoolsBuildInfo AppBuildInfo Android 애플리케이션과 테스트 패키지를 나타내는 IBuildInfo입니다.  AppDeviceBuildInfo 이 클래스는 지원 중단되었습니다. IDeviceBuildInfo를 직접 사용합니다.  BuildInfo ITestDevice와 연결되어야 하는 IBuildInfo의 일반 구현입니다.  ClusterBuildInfo TFC에서 파이프된 빌드용 IBuildInfo 클래스입니다.  DeviceBuildInfo 전체 Android 기기 빌드 및 (선택적으로) 테스트를 나타내는 IBuildInfo입니다.  DeviceFolderBuildInfo 로컬 파일 시스템의 디렉터리에 포함된 다른 빌드 아티팩트도 포함된 IDeviceBuildInfo  FolderBuildInfo IFolderBuildInfo의 구체적인 구현입니다.  IAppBuildInfo 이 인터페이스는 지원 중단되었습니다. IBuildInfo를 직접 사용합니다.  IDeviceBuildInfo 전체 Android 기기 빌드 및 (선택적으로) 테스트를 나타내는 IBuildInfo입니다.  IFolderBuildInfo 빌드 아티팩트가 로컬 파일 시스템 디렉터리에 포함된 간단한 추상 IBuildInfo입니다.  OtaDeviceBuildInfo 무선 업데이트 테스트에 사용되는 IDeviceBuildInfo입니다.  OtatoolsBuildInfo otatools 아티팩트가 포함된 IBuildInfo

---

테스트 중인 빌드에 관한 정보를 보관합니다.

요약

상수
String	REMOTE_FILE_PREFIX 파일이 지연된 다운로드로 설정되었음을 나타내기 위해 이름에 사용되는 접두사입니다.
String	REMOTE_FILE_VERSION 원격 파일에 버전이 없습니다.
String	UNKNOWN_BUILD_ID 빌드 ID를 알 수 없는 경우의 기본값입니다.

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

상수

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

파일의 다운로드가 지연되도록 설정되었음을 나타내기 위해 이름에 사용되는 접두사입니다.

상수 값: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

원격 파일에 버전이 없습니다.

상수 값: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

빌드 ID를 알 수 없는 경우의 기본값입니다.

상수 값: "-1"

공개 메서드

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

매개변수
appPackageFile	File
version	String

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

빌드 속성 추가

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

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

매개변수
stageRemoteFile	boolean

cleanUp

public abstract void cleanUp ()

임시 빌드 파일 정리

cleanUp

public abstract void cleanUp ( doNotDelete)

일부 파일이 삭제되지 않는 cleanUp() 버전입니다.

매개변수
doNotDelete

clone

public abstract IBuildInfo clone ()

IBuildInfo 객체를 클론합니다.

반환 값
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

반환 값

getBuildAttributes

public abstract  getBuildAttributes ()

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

반환 값
	빌드 속성의 ERROR(/Map) null가 아니지만 비어 있을 수 있습니다.

getBuildBranch

public abstract String getBuildBranch ()

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

반환 값
String	빌드 버전 또는 설정되지 않았거나 해당하지 않는 경우 null

getBuildId

public abstract String getBuildId ()

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

반환 값
String

getBuildTargetName

public abstract String getBuildTargetName ()

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

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

반환 값
String

getDeviceSerial

public abstract String getDeviceSerial ()

반환 값
String	이 빌드가 실행된 ITestDevice 일련번호입니다. 이 빌드와 연결된 기기가 없는 경우 null 을 반환합니다.

getFile

public abstract File getFile (String name)

지정된 이름의 파일을 검색하는 도우미 메서드입니다.

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

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

지정된 BuildInfoFileKey로 파일을 검색하는 도우미 메서드입니다.

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

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

getFiles

public abstract  getFiles ()

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

반환 값

getProperties

public abstract  getProperties ()

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

반환 값

getRemoteFiles

public  getRemoteFiles ()

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

반환 값

getTestTag

public abstract String getTestTag ()

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

반환 값
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

지정된 BuildInfoFileKey로 파일 버전을 검색하는 도우미 메서드입니다.

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

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

getVersion

public abstract String getVersion (String name)

지정된 이름의 파일 버전을 검색하는 도우미 메서드입니다.

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

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

지정된 BuildInfoFileKey로 VersionedFile를 검색하는 도우미 메서드입니다.

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

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

getVersionedFile

public VersionedFile getVersionedFile (String name)

지정된 이름으로 VersionedFile를 검색하는 도우미 메서드입니다.

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

getVersionedFileKeys

public  getVersionedFileKeys ()

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

반환 값

getVersionedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

지정된 BuildInfoFileKey와 연결된 VersionedFile 목록을 검색하는 도우미 메서드입니다. 키가 목록 저장을 허용하는 경우

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

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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

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

매개변수
attributeName	String: 추적을 중지할 속성입니다.

setBuildBranch

public abstract void setBuildBranch (String branch)

빌드 브랜치 설정

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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

빌드 버전을 설정합니다.

setBuildId

public abstract void setBuildId (String buildId)

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

매개변수
buildId	String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

이 빌드와 연결된 ITestDevice 일련번호를 설정합니다.

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

setFile

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

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

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

setFile

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

이 빌드 정보에 BuildInfoFileKey가 주어진 파일을 저장합니다.

매개변수
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey를 기반으로 하는 파일의 고유한 이름입니다.
file	File: 로컬 ERROR(/File)
version	String: 파일 버전

setProperties

public abstract void setProperties (BuildInfoProperties... properties)

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

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

setTestTag

public abstract void setTestTag (String testTag)

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

매개변수
testTag	String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

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

TODO(b/138416078): 테스트에 필요한 모듈을 테스트 모듈 디렉터리 자체에 올바르게 빌드된 출력으로 사용할 수 있는 경우 이 인터페이스와 호출자를 삭제합니다.

매개변수
fileName	String: 원격 파일에 위치할 파일의 이름입니다.
workingDir	File: 파일을 스테이징할 디렉터리의 ERROR(/File) 객체입니다.

반환 값
File	로컬 workingDir에 스테이징된 파일의 ERROR(/File) 객체입니다.

toProto

public BuildInformation.BuildInfo toProto ()

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

반환 값
BuildInformation.BuildInfo