BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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


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

Riepilogo

Costruttori pubblici

BuildInfo ()

Crea un BuildInfo utilizzando i valori di attributo predefiniti.

BuildInfo (String buildId, String buildTargetName)

Crea un BuildInfo

Metodi pubblici

void addAppPackageFile (File appPackageFile, String version)

Aggiunge il file apk locale e la sua versione associata.

void addBuildAttribute (String attributeName, String attributeValue)

Aggiungi un attributo 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 su toProto() per recuperare l'istanza.

getAppPackageFiles ()

Ottiene una copia del set di file apk dell'app locale e delle relative versioni.

getBuildAttributes ()

Ottieni una serie di coppie nome-valore di attributi aggiuntivi che descrivono la build.

String getBuildBranch ()

Metodo facoltativo per restituire il ramo del 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 nome specifico.

File getFile ( BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare un file con un BuildInfoFileKey .

getFiles ()

Restituisce tutti i VersionedFile archiviati in questo BuildInfo .

getProperties ()

Restituisce una copia delle proprietà attualmente impostate in IBuildInfo .

getRemoteFiles ()

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

String getTestTag ()

Restituisce un nome univoco per i test in esecuzione.

String getVersion ( BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare una versione del file con un BuildInfoFileKey .

String getVersion (String name)

Metodo di supporto per recuperare una versione del 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 interrogare VersionedFile tramite getFile(BuildInfoKey.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)

Rimuovere un determinato nomeattributo dal monitoraggio.

void setBuildBranch (String branch)

Imposta il ramo di costruzione

void setBuildFlavor (String buildFlavor)

Imposta il sapore della build.

void setBuildId (String buildId)

Imposta l'identificatore univoco della build sottoposta a test.

void setDeviceSerial (String serial)

Imposta il seriale ITestDevice associato a questa build.

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

Memorizza un file con un nome dato in queste informazioni sulla build.

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

Memorizza un file a cui è stato assegnato 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)

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

BuildInformation.BuildInfo toProto ()

Serializza un'istanza BuildInfo in un protobuf.

String toString ()

Metodi protetti

void addAllBuildAttributes ( BuildInfo build)

Metodo di supporto per copiare gli attributi, il ramo e l'aroma 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)

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 di attributo predefiniti.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Crea un BuildInfo

Parametri
buildId String : l'ID build

buildTargetName String : il nome del target di build

Metodi pubblici

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Aggiunge il file apk locale e la sua versione associata. Nota 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 build. Ciò non consente di eseguire l'override di 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

pulire

public void cleanUp ()

Pulisci tutti i file di build temporanei

pulire

public void cleanUp ( doNotClean)

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

Parametri
doNotClean

clone

public IBuildInfo clone ()

ritorna
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copia tutto il VersionedFile da una data build a questa.

Parametri
build BuildInfo

è uguale a

public boolean equals (Object obj)

Parametri
obj Object

ritorna
boolean

da Proto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Operazione inversa su 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 una serie di coppie nome-valore di attributi aggiuntivi che descrivono la build.

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

getBuildBranch

public String getBuildBranch ()

Metodo facoltativo per restituire il ramo del 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 è restituire (build product)-(build os)-(build variant). cioè generic-linux-userdebug

ritorna
String il tipo 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. Il valore predefinito 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 di destinazione della build da una combinazione di build e nome del ramo. [ie (nome del ramo)-(aroma build)]

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 nome specifico.

ritorna
File il file immagine o null se non trovato

prendi il file

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare un file con un BuildInfoFileKey .

Parametri
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey richiesto.

ritorna
File il file immagine o null se non trovato

getFiles

public  getFiles ()

Restituisce tutti i VersionedFile archiviati in questo BuildInfo .

ritorna

getProperties

public  getProperties ()

Restituisce una copia delle proprietà attualmente impostate in IBuildInfo .

ritorna

getRemoteFiles

public  getRemoteFiles ()

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

ritorna

getTestTag

public String getTestTag ()

Restituisce un nome univoco per i test in esecuzione.

ritorna
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare una versione del file con un BuildInfoFileKey .

Parametri
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey richiesto.

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

getVersion

public String getVersion (String name)

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

ritorna
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.

ritorna
VersionedFile Il file con versione o null se non trovato

getVersionedFile

public final VersionedFile getVersionedFile (String name)

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

ritorna
VersionedFile Il file con versione o null se non trovato

getVersionedFileKeys

public  getVersionedFileKeys ()

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

ritorna

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 memorizzare una lista.

Parametri
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey richiesto.

ritorna
Il file con versione o null se non trovato

codice hash

public int hashCode ()

ritorna
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovere un determinato nomeattributo dal monitoraggio.

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 della build.

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)

Imposta il seriale ITestDevice associato a questa build.

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

setFile

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

Memorizza un file con un nome dato in queste informazioni sulla build.

Parametri
name String : il nome univoco del file

file File : il locale ERROR(/File)

version String : la versione del file

setFile

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

Memorizza 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 locale ERROR(/File)

version String : la versione del file

setProprietà

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)

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

TODO(b/138416078): rimuovere 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 posizionare nei file remoti.

workingDir File : un oggetto ERROR(/File) della directory in cui eseguire lo stage del file.

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

aProto

public BuildInformation.BuildInfo toProto ()

Serializza un'istanza 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, il ramo e l'aroma 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 collegamenti fisici ai file in modo che ogni build abbia un percorso di file univoco per il file.

Parametri
build BuildInfo

Tiri
se viene generata un'eccezione durante la creazione del collegamento fisico.

applicaBuildProperties

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 esaminato.

build IBuildInfo : la build originale viene 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 >