IBuildInfo

public interface IBuildInfo
implements Serializable

com.android.tradefed.build.IBuildInfo

Sottoclassi indirette note AppBuildInfo, AppDeviceBuildInfo, BuildInfo, ClusterBuildInfo, DeviceBuildInfo, DeviceFolderBuildInfo, FolderBuildInfo, IAppBuildInfo, IDeviceBuildInfo, IFolderBuildInfo, OtaDeviceBuildInfo, OtatoolsBuildInfo AppBuildInfo Un IBuildInfo che rappresenta un'app per Android e i relativi pacchetti di test.  AppDeviceBuildInfo Questa classe è obsoleta. Utilizza IDeviceBuildInfo direttamente.  BuildInfo Implementazione generica di un IBuildInfo che deve essere associato a un ITestDevice.  ClusterBuildInfo Una classe IBuildInfo per le build inviate tramite pipe da TFC.  DeviceBuildInfo Un IBuildInfo che rappresenta una build completa del dispositivo Android e (facoltativamente) i relativi test.  DeviceFolderBuildInfo Un IDeviceBuildInfo che contiene anche altri artefatti di build contenuti in una directory del file system locale.  FolderBuildInfo Implementazione concreta di un IFolderBuildInfo.  IAppBuildInfo Questa interfaccia è obsoleta. Utilizza IBuildInfo direttamente.  IDeviceBuildInfo Un IBuildInfo che rappresenta una build completa del dispositivo Android e (facoltativamente) i relativi test.  IFolderBuildInfo Un semplice IBuildInfo astratto i cui artefatti di build sono contenuti in una directory del filesystem locale.  OtaDeviceBuildInfo Un IDeviceBuildInfo utilizzato per i test di aggiornamento over-the-air.  OtatoolsBuildInfo Un IBuildInfo che contiene artefatti otatools.

---

Contiene informazioni sulla build in fase di test.

Riepilogo

Costanti
String	REMOTE_FILE_PREFIX Prefisso utilizzato nel nome per indicare che il download del file è impostato per essere ritardato.
String	REMOTE_FILE_VERSION Il file remoto non è sottoposto al controllo delle versioni.
String	UNKNOWN_BUILD_ID Valore predefinito quando l'ID build è sconosciuto.

Metodi pubblici
default void	addAppPackageFile(File appPackageFile, String version) Aggiunge il file APK locale e la relativa versione.
abstract void	addBuildAttribute(String attributeName, String attributeValue) Aggiungi un attributo di build.
default void	addBuildAttributes(Map<String, String> buildAttributes) Aggiungere attributi di build
default void	allowStagingRemoteFile(boolean stageRemoteFile) Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti.
abstract void	cleanUp() Libera spazio dai file di build temporanei
abstract void	cleanUp(List<File> doNotDelete) Versione di cleanUp() in cui alcuni file non vengono eliminati.
abstract IBuildInfo	clone() Clona l'oggetto IBuildInfo.
default List<VersionedFile>	getAppPackageFiles() Recupera una copia del set di file APK dell'app locale e delle relative versioni.
abstract Map<String, String>	getBuildAttributes() Ottieni un insieme di coppie nome-valore di attributi aggiuntivi che descrivono la build.
abstract String	getBuildBranch() Metodo facoltativo per restituire il ramo del controllo della sorgente da cui è stata prodotta la build in fase di test.
abstract String	getBuildFlavor() Metodo facoltativo per restituire il tipo di build in fase di test.
abstract String	getBuildId() Restituisce l'identificatore univoco della build in fase di test.
abstract String	getBuildTargetName() Restituisce il nome completo della build in fase di test.
abstract String	getDeviceSerial()
abstract File	getFile(String name) Metodo helper per recuperare un file con il nome specificato.
default File	getFile(BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un file con un determinato BuildInfoFileKey.
abstract Collection<VersionedFile>	getFiles() Restituisce tutti i VersionedFile memorizzati in questo BuildInfo.
abstract Set<IBuildInfo.BuildInfoProperties>	getProperties() Restituisce una copia delle proprietà attualmente impostate su IBuildInfo.
default Set<File>	getRemoteFiles() Ottieni i percorsi per gli artefatti di build il cui download è ritardato.
abstract String	getTestTag() Restituisce un nome univoco per i test in esecuzione.
default String	getVersion(BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare una versione del file con un determinato BuildInfoFileKey.
abstract String	getVersion(String name) Metodo helper per recuperare una versione del file con il nome specificato.
default VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un VersionedFile con un determinato BuildInfoFileKey.
default VersionedFile	getVersionedFile(String name) Metodo helper per recuperare un VersionedFile con un determinato nome.
default Set<String>	getVersionedFileKeys() Restituisce l'insieme di chiavi disponibili per eseguire query su VersionedFile tramite getFile(BuildInfoFileKey).
default List<VersionedFile>	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un elenco di VersionedFile associati a un determinato BuildInfoFileKey.
default void	removeBuildAttribute(String attributeName) Rimuovi un determinato attributeName dal monitoraggio.
abstract void	setBuildBranch(String branch) Imposta il ramo di build
abstract void	setBuildFlavor(String buildFlavor) Imposta la variante di build.
abstract void	setBuildId(String buildId) Imposta l'identificatore univoco della build in fase di test.
abstract void	setDeviceSerial(String serial) Imposta il numero di serie ITestDevice associato a questa build.
default void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Memorizza un file dato un BuildInfoFileKey in queste informazioni sulla build.
abstract void	setFile(String name, File file, String version) Memorizza un file con il nome specificato in queste informazioni sulla build.
abstract void	setProperties(BuildInfoProperties... properties) Imposta BuildInfoProperties per l'istanza IBuildInfo.
abstract void	setTestTag(String testTag) Imposta il nome univoco dei test in esecuzione.
default File	stageRemoteFile(String fileName, File workingDir) Esegui lo staging di un file che fa parte dei file remoti nella directory principale delle informazioni sulla build.
default BuildInformation.BuildInfo	toProto() Serializza un'istanza BuildInfo in un protobuf.

Costanti

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Prefisso utilizzato nel nome per indicare che il download del file è impostato per essere ritardato.

Valore costante: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Il file remoto non è sottoposto al controllo delle versioni.

Valore costante: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

Valore predefinito quando l'ID build è sconosciuto.

Valore costante: "-1"

Metodi pubblici

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Aggiunge il file APK locale e la relativa versione. Tieni presente che gli APK verranno restituiti da getAppPackageFiles() nell'ordine in cui sono stati aggiunti con questo metodo.

Parametri
appPackageFile	File
version	String

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo di build. In questo modo non è possibile eseguire l'override di un attributoName esistente.

Parametri
attributeName	String: il nome univoco dell'attributo
attributeValue	String: il valore dell'attributo

addBuildAttributes

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

Aggiungere attributi di build

Parametri
buildAttributes	Map: mappa degli attributi da aggiungere

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti.

Parametri
stageRemoteFile	boolean

cleanUp

public abstract void cleanUp ()

Libera spazio dai file di build temporanei

cleanUp

public abstract void cleanUp (List<File> doNotDelete)

Versione di cleanUp() in cui alcuni file non vengono eliminati.

Parametri
doNotDelete	List

clone

public abstract IBuildInfo clone ()

Clona l'oggetto IBuildInfo.

Resi
IBuildInfo

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

Recupera una copia del set di file APK dell'app locale e delle relative versioni. L'ordine restituito corrisponde all'ordine in cui gli APK sono stati aggiunti al IAppBuildInfo.

Resi
List<VersionedFile>

getBuildAttributes

public abstract Map<String, String> getBuildAttributes ()

Ottieni un insieme di coppie nome-valore di attributi aggiuntivi che descrivono la build.

Resi
Map<String, String>	un Map di attributi di build. Non sarà null, ma potrebbe essere vuoto.

getBuildBranch

public abstract String getBuildBranch ()

Metodo facoltativo per restituire il ramo del controllo della sorgente da cui è stata prodotta la build in fase di test.

Resi
String	il ramo di build o null se non impostato/non applicabile

getBuildFlavor

public abstract String getBuildFlavor ()

Metodo facoltativo per restituire il tipo di build in fase di test.

Un'implementazione comune per le build della piattaforma Android consiste nel restituire (prodotto build)-(sistema operativo build)-(variante di compilazione). ie generic-linux-userdebug

Resi
String	il tipo di build o null se non impostato/non applicabile

getBuildId

public abstract String getBuildId ()

Restituisce l'identificatore univoco della build in fase di test. Non dovrebbe mai essere null. Il valore predefinito è UNKNOWN_BUILD_ID.

Resi
String

getBuildTargetName

public abstract String getBuildTargetName ()

Restituisce il nome completo della build in fase di test.

Un'implementazione comune consiste nel creare il nome della build di destinazione combinando il nome della variante di build e del ramo. [ad es. (nome del ramo)-(variante di build)]

Resi
String

getDeviceSerial

public abstract String getDeviceSerial ()

Resi
String	il numero di serie ITestDevice su cui è stata eseguita questa build. Restituisce null se non è associato alcun dispositivo a questa build.

getFile

public abstract File getFile (String name)

Metodo helper per recuperare un file con il nome specificato.

Resi
File	il file immagine o null se non viene trovato

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare un file con un determinato BuildInfoFileKey.

Parametri
key	BuildInfoKey.BuildInfoFileKey: il BuildInfoFileKey richiesto.

Resi
File	il file immagine o null se non viene trovato

getFiles

public abstract Collection<VersionedFile> getFiles ()

Restituisce tutti i VersionedFile memorizzati in questo BuildInfo.

Resi
Collection<VersionedFile>

getProperties

public abstract Set<IBuildInfo.BuildInfoProperties> getProperties ()

Restituisce una copia delle proprietà attualmente impostate su IBuildInfo.

Resi
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

Ottieni i percorsi per gli artefatti di build il cui download è ritardato.

Resi
Set<File>

getTestTag

public abstract String getTestTag ()

Restituisce un nome univoco per i test in esecuzione.

Resi
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare una versione del file con un determinato BuildInfoFileKey.

Parametri
key	BuildInfoKey.BuildInfoFileKey: il BuildInfoFileKey richiesto.

Resi
String	la versione dell'immagine o null se non viene trovata

getVersion

public abstract String getVersion (String name)

Metodo helper per recuperare una versione del file con il nome specificato.

Resi
String	la versione dell'immagine o null se non viene trovata

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare un VersionedFile con un determinato BuildInfoFileKey.

Parametri
key	BuildInfoKey.BuildInfoFileKey: il BuildInfoFileKey richiesto.

Resi
VersionedFile	Il file con controllo delle versioni o null se non trovato

getVersionedFile

public VersionedFile getVersionedFile (String name)

Metodo helper per recuperare un VersionedFile con un determinato nome.

Resi
VersionedFile	Il file con controllo delle versioni o null se non trovato

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

Restituisce l'insieme di chiavi disponibili per eseguire query su VersionedFile tramite getFile(BuildInfoFileKey).

Resi
Set<String>

getVersionedFiles

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

Metodo helper per recuperare un elenco di VersionedFile associati a un determinato BuildInfoFileKey. Se la chiave consente di memorizzare un elenco.

Parametri
key	BuildInfoKey.BuildInfoFileKey: il BuildInfoFileKey richiesto.

Resi
List<VersionedFile>	Il file con controllo delle versioni o null se non trovato

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovi un determinato attributeName dal monitoraggio.

Parametri
attributeName	String: l'attributo da interrompere il monitoraggio

setBuildBranch

public abstract void setBuildBranch (String branch)

Imposta il ramo di build

Parametri
branch	String: il nome del ramo

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Imposta la variante di build.

setBuildId

public abstract void setBuildId (String buildId)

Imposta l'identificatore univoco della build in fase di test. Non dovrebbe mai essere null.

Parametri
buildId	String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

Imposta il numero di serie ITestDevice associato a questa build.

Parametri
serial	String: il numero di serie di ITestDevice con cui è stata eseguita questa build.

setFile

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

Memorizza un file dato un BuildInfoFileKey in queste informazioni sulla build.

Parametri
key	BuildInfoKey.BuildInfoFileKey: il nome univoco del file basato su BuildInfoFileKey.
file	File: il File locale
version	String: la versione del file

setFile

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

Memorizza un file con il nome specificato in queste informazioni sulla build.

Parametri
name	String: il nome univoco del file
file	File: il File locale
version	String: la versione del file

setProperties

public abstract void setProperties (BuildInfoProperties... properties)

Imposta BuildInfoProperties per l'istanza IBuildInfo. Ignora le proprietà esistenti impostate in precedenza.

Parametri
properties	BuildInfoProperties: L'elenco delle proprietà da aggiungere.

setTestTag

public abstract void setTestTag (String testTag)

Imposta il nome univoco dei test in esecuzione.

Parametri
testTag	String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Esegui lo staging di un file che fa parte dei file remoti nella directory principale delle informazioni sulla build.

TODO(b/138416078): Remove this interface and its caller when modules required by a test can be properly built output to the test module's directory itself.

Parametri
fileName	String: il nome del file da individuare nei file remoti.
workingDir	File: un oggetto File della directory in cui preparare il file.

Resi
File	l'oggetto File del file sottoposto a staging in workingDir locale.

toProto

public BuildInformation.BuildInfo toProto ()

Serializza un'istanza BuildInfo in un protobuf.

Resi
BuildInformation.BuildInfo