BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

Sottoclassi dirette conosciute AppBuildInfo , DeviceBuildInfo , FolderBuildInfo , OtatoolsBuildInfo AppBuildInfo Oggetto IBuildInfo che rappresenta un'applicazione Android e i relativi pacchetti di test. DeviceBuildInfo Oggetto IBuildInfo che rappresenta una build completa del dispositivo Android e (facoltativamente) i relativi test. FolderBuildInfo Implementazione concreta di un IFolderBuildInfo . OtatoolsBuildInfo Oggetto IBuildInfo che contiene artefatti otatools.

Sottoclassi indirette conosciute AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo AppDeviceBuildInfo Questa classe è obsoleta. Utilizzare direttamente IDeviceBuildInfo . ClusterBuildInfo Una classe IBuildInfo per build reindirizzate da TFC. DeviceFolderBuildInfo Oggetto IDeviceBuildInfo che contiene anche altri artefatti di compilazione contenuti in una directory nel file system locale. OtaDeviceBuildInfo Oggetto IDeviceBuildInfo utilizzato per i test di aggiornamento over-the-air.

---

Implementazione generica di un IBuildInfo che deve essere associato a un ITestDevice .

Riepilogo

Costruttori pubblici
BuildInfo () Crea un BuildInfo utilizzando i valori degli attributi predefiniti.
BuildInfo (String buildId, String buildTargetName) Crea un BuildInfo

Metodi pubblici
void	addAppPackageFile (File appPackageFile, String version) Aggiunge il file apk locale e la versione associata.
void	addBuildAttribute (String attributeName, String attributeValue) Aggiungi un attributo di build.
void	addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Aggiungi attributi di build
void	cleanUp () Pulisci tutti i file di build temporanei
void	cleanUp ( doNotClean) cleanUp ( doNotClean) Versione di cleanUp() in cui alcuni file non vengono eliminati.
IBuildInfo	clone ()
final void	copyAllFileFrom ( BuildInfo build) Copia tutto il VersionedFile da una data build a questa.
boolean	equals (Object obj)
static IBuildInfo	fromProto (BuildInformation.BuildInfo protoBuild) Operazione inversa a toProto() per recuperare l'istanza.
	getAppPackageFiles () Ottiene una copia del set di file apk dell'app locale e delle relative versioni.
	getBuildAttributes () Ottieni un set di coppie nome-valore di attributi aggiuntivi che descrivono la build.
String	getBuildBranch () Metodo facoltativo per restituire il ramo di controllo del codice sorgente da cui è stata prodotta la build in fase di test.
String	getBuildFlavor () Metodo facoltativo per restituire il tipo di build in fase di test.
String	getBuildId () Restituisce l'identificatore univoco della build sottoposta a test.
String	getBuildTargetName () Restituisce il nome completo per la build in fase di test.
String	getDeviceSerial ()
File	getFile (String name) Metodo di supporto per recuperare un file con un determinato nome.
File	getFile ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un file con un dato BuildInfoFileKey .
	getFiles () Restituisce tutti VersionedFile archiviati in questo BuildInfo .
	getProperties () Restituisce una copia delle proprietà attualmente impostate su IBuildInfo .
	getRemoteFiles () Ottieni i percorsi per gli artefatti di build che vengono scaricati in ritardo.
String	getTestTag () Restituisce un nome univoco per i test in esecuzione.
String	getVersion ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare una versione del file con un dato BuildInfoFileKey .
String	getVersion (String name) Metodo helper per recuperare una versione del file con un determinato nome.
VersionedFile	getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un VersionedFile con un dato BuildInfoFileKey .
final VersionedFile	getVersionedFile (String name) Metodo helper per recuperare un VersionedFile con un determinato nome.
	getVersionedFileKeys () Restituisce il set di chiavi disponibili per interrogare VersionedFile tramite getFile(BuildInfoFileKey) .
final	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un elenco di VersionedFile associati a un dato BuildInfoFileKey .
int	hashCode ()
void	removeBuildAttribute (String attributeName) Rimuovi un determinato attributeName dal tracciamento.
void	setBuildBranch (String branch) Imposta il ramo di costruzione
void	setBuildFlavor (String buildFlavor) Imposta il sapore di costruzione.
void	setBuildId (String buildId) Imposta l'identificatore univoco della build sottoposta a test.
void	setDeviceSerial (String serial) Impostare il seriale ITestDevice associato a questa build.
void	setFile (String name, File file, String version) Memorizza un file con il nome specificato in queste informazioni sulla build.
void	setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Memorizza un file dato un BuildInfoFileKey in queste informazioni sulla build.
void	setProperties ( BuildInfoProperties... properties) Impostare BuildInfoProperties per l'istanza IBuildInfo .
void	setTestTag (String testTag) Imposta il nome univoco per i test in esecuzione.
File	stageRemoteFile (String fileName, File workingDir) Mettere in scena un file che fa parte di file remoti nella directory principale delle informazioni sulla build.
BuildInformation.BuildInfo	toProto () Serializza un'istanza di BuildInfo in un protobuf.
String	toString ()

Metodi protetti
void	addAllBuildAttributes ( BuildInfo build) Metodo di supporto per copiare gli attributi di build, il ramo e il sapore da un'altra build.
void	addAllFiles ( BuildInfo build) Metodo di supporto per copiare tutti i file dall'altra build.
boolean	applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Consentire di applicare alcune delle IBuildInfo.BuildInfoProperties ed eventualmente eseguire una gestione diversa.
MultiMap <String, String>	getAttributesMultiMap ()
	getVersionedFileMap ()
MultiMap <String, VersionedFile >	getVersionedFileMapFull ()

Costruttori pubblici

BuildInfo

public BuildInfo ()

Crea un BuildInfo utilizzando i valori degli attributi predefiniti.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Crea un BuildInfo

Parametri
buildId	String : l'id di build
buildTargetName	String : il nome della destinazione di compilazione

Metodi pubblici

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

Parametri
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo di build. Ciò non consente di sovrascrivere un attributeName esistente.

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Aggiungi attributi di build

Parametri
buildAttributes	: Mappa degli attributi da aggiungere

ripulire

public void cleanUp ()

Pulisci tutti i file di build temporanei

ripulire

public void cleanUp ( doNotClean)

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

Parametri
doNotClean

clone

public IBuildInfo clone ()

ritorna
IBuildInfo

copiaTuttiFileDa

public final void copyAllFileFrom (BuildInfo build)

Copia tutto il VersionedFile da una data build a questa.

Parametri
build	BuildInfo

equivale

public boolean equals (Object obj)

Parametri
obj	Object

ritorna
boolean

da Proto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Operazione inversa a toProto() per recuperare l'istanza.

Parametri
protoBuild	BuildInformation.BuildInfo

ritorna
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Ottiene 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 a IAppBuildInfo .

ritorna

getBuildAttributes

public  getBuildAttributes ()

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

ritorna
	un ERROR(/Map) degli attributi di build. Non sarà null , ma potrebbe essere vuoto.

getBuildBranch

public String getBuildBranch ()

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

ritorna
String	il ramo build o null se non impostato/non applicabile

getBuildFlavor

public 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 (build product)-(build os)-(build variant). cioè generic-linux-userdebug

ritorna
String	il sapore di build o null se non impostato/non applicabile

getBuildId

public String getBuildId ()

Restituisce l'identificatore univoco della build sottoposta a test. Non dovrebbe mai essere nullo. L'impostazione predefinita è UNKNOWN_BUILD_ID .

ritorna
String

getBuildTargetName

public String getBuildTargetName ()

Restituisce il nome completo per la build in fase di test.

Un'implementazione comune consiste nel costruire il nome della destinazione di compilazione da una combinazione del sapore di compilazione e del nome del ramo. [vale a dire (nome del ramo)-(crea sapore)]

ritorna
String

getDeviceSerial

public String getDeviceSerial ()

ritorna
String

prendi il file

public File getFile (String name)

Metodo di supporto per recuperare un file con un determinato nome.

ritorna
File	il file immagine o null se non trovato

prendi il file

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare un file con un dato BuildInfoFileKey .

Parametri
key	BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey richiesta.

ritorna
File	il file immagine o null se non trovato

getFiles

public  getFiles ()

Restituisce tutti VersionedFile archiviati in questo BuildInfo .

ritorna

getProperties

public  getProperties ()

Restituisce una copia delle proprietà attualmente impostate su IBuildInfo .

ritorna

getRemoteFiles

public  getRemoteFiles ()

Ottieni i percorsi per gli artefatti di build che vengono scaricati in ritardo.

ritorna

getTestTag

public String getTestTag ()

Restituisce un nome univoco per i test in esecuzione.

ritorna
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

Parametri
key	BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey richiesta.

ritorna
String	la versione dell'immagine o null se non trovata

getVersion

public String getVersion (String name)

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

ritorna
String	la versione dell'immagine o null se non trovata

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare un VersionedFile con un dato BuildInfoFileKey .

Parametri
key	BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey richiesta.

ritorna
VersionedFile	Il file con versione o null se non viene trovato

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Metodo helper per recuperare un VersionedFile con un determinato nome.

ritorna
VersionedFile	Il file con versione o null se non viene trovato

getVersionedFileKeys

public  getVersionedFileKeys ()

Restituisce il set di chiavi disponibili per interrogare VersionedFile tramite getFile(BuildInfoFileKey) .

ritorna

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare un elenco di VersionedFile associati a un dato BuildInfoFileKey . Se il tasto permette di memorizzare una lista.

Parametri
key	BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey richiesta.

ritorna
	Il file con versione o null se non viene trovato

codice hash

public int hashCode ()

ritorna
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovi un determinato attributeName dal tracciamento.

Parametri
attributeName	String : l'attributo per interrompere il tracciamento

setBuildBranch

public void setBuildBranch (String branch)

Imposta il ramo di costruzione

Parametri
branch	String : il nome del ramo

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Imposta il sapore di costruzione.

setBuildId

public void setBuildId (String buildId)

Imposta l'identificatore univoco della build sottoposta a test. Non dovrebbe mai essere nullo.

Parametri
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

Impostare il seriale ITestDevice associato a questa build.

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

setFile

public 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 : l' ERROR(/File)
version	String : la versione del file

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 : l' ERROR(/File)
version	String : la versione del file

setProperties

public void setProperties (BuildInfoProperties... properties)

Impostare BuildInfoProperties per l'istanza IBuildInfo . Sostituisci qualsiasi proprietà esistente impostata in precedenza.

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

setTestTag

public void setTestTag (String testTag)

Imposta il nome univoco per i test in esecuzione.

Parametri
testTag	String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Mettere in scena un file che fa parte di file remoti nella directory principale delle informazioni sulla build.

TODO(b/138416078): Rimuovi questa interfaccia e il suo chiamante quando i moduli richiesti da un test possono essere compilati correttamente in output nella directory del modulo di test stesso.

Parametri
fileName	String : nome del file da localizzare nei file remoti.
workingDir	File : un oggetto ERROR(/File) della directory in cui mettere in scena il file.

ritorna
File	l'oggetto ERROR(/File) del file messo in scena nella workingDir locale.

toProto

public BuildInformation.BuildInfo toProto ()

Serializza un'istanza di BuildInfo in un protobuf.

ritorna
BuildInformation.BuildInfo

accordare

public String toString ()

ritorna
String

Metodi protetti

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Metodo di supporto per copiare gli attributi di build, il ramo e il sapore da un'altra build.

Parametri
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Metodo di supporto per copiare tutti i file dall'altra build.

Crea nuovi collegamenti fisici ai file in modo che ogni build abbia un percorso di file univoco al file.

Parametri
build	BuildInfo

Getta
	se viene generata un'eccezione durante la creazione dell'hardlink.

applyBuildProperties

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

Consentire di applicare alcune delle IBuildInfo.BuildInfoProperties ed eventualmente eseguire una gestione diversa.

Parametri
origFileConsidered	VersionedFile : il VersionedFile attualmente visualizzato.
build	IBuildInfo : la build originale clonata
receiver	IBuildInfo : la build che riceve le informazioni.

ritorna
boolean	Vero se abbiamo applicato le proprietà e l'ulteriore gestione dovrebbe essere saltata. Falso altrimenti.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

ritorna
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

ritorna

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

ritorna
MultiMap <String, VersionedFile >