Informazioni sulla build

public class BuildInfo
extends Object implements IBuildInfo

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

Sottoclassi dirette note AppBuildInfo, DeviceBuildInfo, CartellaBuildInfo, OtatoolsBuildInfo InfoBuild Un elemento IBuildInfo che rappresenta un'app Android e i relativi pacchetti di test.  Info sulla build Un IBuildInfo che rappresenta una build del dispositivo Android completa e (facoltativamente) i relativi test.  CartellaBuildInfo Implementazione concreta di un IFolderBuildInfo.  OtatoolsBuildInfo Un elemento IBuildInfo che contiene artefatti otatools.

Sottoclassi indirette note AppDeviceBuildInfo, ClusterBuildInfo, DeviceCartellaBuildInfo, OtaDeviceBuildInfo AppDeviceBuildInfo Questo corso è stato ritirato. Usa direttamente IDeviceBuildInfo.  ClusterBuildInfo Una classe IBuildInfo per le build trasmesse da TFC.  DeviceCartellaBuildInfo Un elemento IDeviceBuildInfo che contiene anche altri artefatti di build contenuti in una directory su il file system locale.  OtaDeviceBuildInfo Un IDeviceBuildInfo utilizzato per i test degli aggiornamenti over-the-air.

---

Implementazione generica di un IBuildInfo che deve essere associato con 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 relativa versione associata.
void	addBuildAttribute(String attributeName, String attributeValue) Aggiungi un attributo build.
void	addBuildAttributes( buildAttributes) Aggiungi attributi build
void	allowStagingRemoteFile(boolean stageRemoteFile) Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti.
void	cleanUp() Elimina eventuali file di build temporanei
void	cleanUp( doNotClean) Versione di cleanUp() in cui alcuni file non vengono eliminati.
IBuildInfo	clone()
final void	copyAllFileFrom(BuildInfo build) Copia tutti i VersionedFile di una determinata build in questa.
boolean	equals(Object obj)
static IBuildInfo	fromProto(BuildInformation.BuildInfo protoBuild) Operazione inversa su toProto() per recuperare l'istanza.
	getAppPackageFiles() Recupera una copia del set di file apk delle app locali e delle relative versioni.
	getBuildAttributes() Ottieni un insieme di coppie nome-valore di attributi aggiuntivi che descrivono la build.
String	getBuildBranch() Metodo facoltativo per restituire il ramo di controllo del codice sorgente utilizzato per la build da testare prodotto.
String	getBuildFlavor() Metodo facoltativo per restituire il tipo di build da testare.
String	getBuildId() Restituisce l'identificatore univoco della build sottoposta a test.
String	getBuildTargetName() Restituisce il nome completo della build in fase di test.
String	getDeviceSerial()
File	getFile(String name) Metodo di supporto per recuperare un file con il nome specificato.
File	getFile(BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare un file con un BuildInfoFileKey specificato.
	getFiles() Restituisce tutti i valori VersionedFile archiviati in BuildInfo.
	getProperties() Restituisce una copia delle proprietà attualmente impostate nel IBuildInfo.
	getRemoteFiles() Consente di recuperare i percorsi per gli artefatti della build che vengono scaricati in ritardo.
String	getTestTag() Restituisce un nome univoco per i test in esecuzione.
String	getVersion(BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare la versione di un file con un BuildInfoFileKey specificato.
String	getVersion(String name) Metodo helper per recuperare una versione di un file con il nome specificato.
VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare un VersionedFile con un determinato BuildInfoFileKey.
final VersionedFile	getVersionedFile(String name) Metodo di supporto per recuperare un VersionedFile con un determinato nome.
	getVersionedFileKeys() Restituisce il set di chiavi disponibili per eseguire query su VersionedFile tramite getFile(BuildInfoFileKey).
final	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare un elenco di VersionedFile associati a un determinato BuildInfoFileKey.
int	hashCode()
void	removeBuildAttribute(String attributeName) Rimuovi un determinatoattributeName dal monitoraggio.
void	setBuildBranch(String branch) imposta il ramo di build
void	setBuildFlavor(String buildFlavor) Imposta le versioni di build.
void	setBuildId(String buildId) Imposta l'identificatore univoco della build in corso di test.
void	setDeviceSerial(String serial) Imposta il numero seriale ITestDevice associato a questa build.
void	setFile(String name, File file, String version) Archivia un file con il nome specificato nelle informazioni sulla build.
void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Archivia un file a cui è stato assegnato un BuildInfoFileKey in queste informazioni sulla build.
void	setProperties(BuildInfoProperties... properties) Imposta BuildInfoProperties per l'istanza IBuildInfo.
void	setTestTag(String testTag) Imposta il nome univoco per i test da eseguire.
File	stageRemoteFile(String fileName, File workingDir) Esegui lo stage di un file che fa parte di file remoti nella directory radice delle informazioni sulla build.
BuildInformation.BuildInfo	toProto() Serializza un'istanza BuildInfo in un protobuf.
String	toString()

Metodi protetti
void	addAllBuildAttributes(BuildInfo build) Metodo helper per copiare gli attributi, il ramo e la versione di build 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) Consenti di applicare alcune delle IBuildInfo.BuildInfoProperties ed eventualmente eseguire una gestione diversa.
MultiMap<String, String>	getAttributesMultiMap()
	getVersionedFileMap()
MultiMap<String, VersionedFile>	getVersionedFileMapFull()

Costruttori pubblici

Informazioni sulla build

public BuildInfo ()

Crea un BuildInfo utilizzando i valori degli attributi predefiniti.

Informazioni sulla build

public BuildInfo (String buildId, 
                String buildTargetName)

Crea un BuildInfo

Parametri
buildId	String: l'ID build
buildTargetName	String: nome della destinazione di build

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 con questo metodo.

Parametri
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo build. Questo non consente di eseguire l'override di unattributeName esistente.

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Aggiungi attributi build

Parametri
buildAttributes	: 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

pulizia

public void cleanUp ()

Elimina eventuali file di build temporanei

pulizia

public void cleanUp ( doNotClean)

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

Parametri
doNotClean

clona

public IBuildInfo clone ()

Ritorni
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copia tutti i VersionedFile di una determinata build in questa.

Parametri
build	BuildInfo

uguale

public boolean equals (Object obj)

Parametri
obj	Object

Ritorni
boolean

daProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

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

Parametri
protoBuild	BuildInformation.BuildInfo

Ritorni
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Recupera una copia del set di file apk delle app locali e delle relative versioni. L'ordine restituito corrisponde all'ordine in cui gli apk sono stati aggiunti a IAppBuildInfo.

Ritorni

getBuildAttributes

public  getBuildAttributes ()

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

Ritorni
	un ERROR(/Map) di 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 utilizzato per la build da testare prodotto.

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

getBuildFlavor

public String getBuildFlavor ()

Metodo facoltativo per restituire il tipo di build da testare.

Un'implementazione comune per le build di piattaforme Android è la restituzione (prodotto build) -(sistema operativo build) -(variante build). ad es. generico-linux-userdebug

Ritorni
String	la versione build o null se non configurata/non applicabile

getBuildId

public String getBuildId ()

Restituisce l'identificatore univoco della build sottoposta a test. Non deve mai essere null. Il valore predefinito è UNKNOWN_BUILD_ID.

Ritorni
String

getBuildTargetName

public String getBuildTargetName ()

Restituisce il nome completo della build in fase di test.

Un'implementazione comune consiste nel creare il nome della destinazione di build a partire da una combinazione la versione build e il nome del ramo. [ad es. (nome filiale)-(creazione di una versione)]

Ritorni
String

getDeviceSerial

public String getDeviceSerial ()

Ritorni
String

getFile

public File getFile (String name)

Metodo di supporto per recuperare un file con il nome specificato.

Ritorni
File	il file immagine o null se non trovato

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare un file con un BuildInfoFileKey specificato.

Parametri
key	BuildInfoKey.BuildInfoFileKey: il valore BuildInfoFileKey richiesto.

Ritorni
File	il file immagine o null se non trovato

getFile

public  getFiles ()

Restituisce tutti i valori VersionedFile archiviati in BuildInfo.

Ritorni

getProperties

public  getProperties ()

Restituisce una copia delle proprietà attualmente impostate nel IBuildInfo.

Ritorni

getRemoteFiles

public  getRemoteFiles ()

Consente di recuperare i percorsi per gli artefatti della build che vengono scaricati in ritardo.

Ritorni

getTestTag

public String getTestTag ()

Restituisce un nome univoco per i test in esecuzione.

Ritorni
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare la versione di un file con un BuildInfoFileKey specificato.

Parametri
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey richiesto.

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

getVersion

public String getVersion (String name)

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

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

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare un VersionedFile con un determinato BuildInfoFileKey.

Parametri
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey richiesto.

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

getVersionedFile

public final VersionedFile getVersionedFile (String name)

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

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

getVersionedFileKey

public  getVersionedFileKeys ()

Restituisce il set di chiavi disponibili per eseguire query su VersionedFile tramite getFile(BuildInfoFileKey).

Ritorni

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

Parametri
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey richiesto.

Ritorni
	Il file con il controllo delle versioni o null se non trovato

codice hash

public int hashCode ()

Ritorni
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovi un determinatoattributeName dal monitoraggio.

Parametri
attributeName	String: l'attributo per interrompere il monitoraggio

setBuildBranch

public void setBuildBranch (String branch)

imposta il ramo di build

Parametri
branch	String: il nome della filiale

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Imposta le versioni di build.

setBuildId

public void setBuildId (String buildId)

Imposta l'identificatore univoco della build in corso di test. Non deve mai essere null.

Parametri
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

Imposta il numero seriale ITestDevice associato a questa build.

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

setFile

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

Archivia un file con il nome specificato nelle informazioni sulla build.

Parametri
name	String: nome univoco del file
file	File: il ERROR(/File) locale
version	String: la versione del file

setFile

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

Archivia un file a cui è stato assegnato un BuildInfoFileKey in queste informazioni sulla build.

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

ImpostaProprietà

public void setProperties (BuildInfoProperties... properties)

Imposta BuildInfoProperties per l'istanza IBuildInfo. Sostituisci qualsiasi proprietà esistenti impostate prima.

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

setTestTag

public void setTestTag (String testTag)

Imposta il nome univoco per i test da eseguire.

Parametri
testTag	String

File remoto stage

public File stageRemoteFile (String fileName, 
                File workingDir)

Esegui lo stage di un file che fa parte di file remoti nella directory radice delle informazioni sulla build.

TODO(b/138416078): rimuovi questa interfaccia e il chiamante quando i moduli richiesti da un test può essere creato correttamente come output nella directory stessa del modulo di test.

Parametri
fileName	String: nome del file da individuare nei file remoti.
workingDir	File: un oggetto ERROR(/File) della directory per organizzare il file.

Ritorni
File	l'oggetto ERROR(/File) del file in fase di gestione temporanea in workDir locale.

toProto

public BuildInformation.BuildInfo toProto ()

Serializza un'istanza BuildInfo in un protobuf.

Ritorni
BuildInformation.BuildInfo

ToString

public String toString ()

Ritorni
String

Metodi protetti

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Metodo helper per copiare gli attributi, il ramo e la versione di build 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 link fissi ai file in modo che ogni build abbia un percorso di file univoco nella .

Parametri
build	BuildInfo

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

applyBuildProperties

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

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

Parametri
origFileConsidered	VersionedFile: VersionedFile attualmente guardato.
build	IBuildInfo: la build originale in fase di clonazione
receiver	IBuildInfo: la build che riceve le informazioni.

Ritorni
boolean	True se abbiamo applicato le proprietà e l'ulteriore gestione deve essere saltata. Falso negli altri casi.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Ritorni
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Ritorni

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Ritorni
MultiMap<String, VersionedFile>