BuildInfo
public class BuildInfo
extends Object
implements IBuildInfo
java.lang.Oggetto | |
↳ | com.android.tradefed.build.BuildInfo |
Implementazione generica di un IBuildInfo
che deve essere associato a un ITestDevice
.
Riepilogo
Costruttori pubblici | |
---|---|
BuildInfo () Crea un | |
BuildInfo (String buildId, String buildTargetName) Crea un |
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 |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) Copia tutto il |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) Operazione inversa a |
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 |
getFiles () Restituisce tutti | |
getProperties () Restituisce una copia delle proprietà attualmente impostate su | |
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 |
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 |
final VersionedFile | getVersionedFile (String name) Metodo helper per recuperare un |
getVersionedFileKeys () Restituisce il set di chiavi disponibili per interrogare | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un elenco di |
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 |
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 |
void | setProperties ( BuildInfoProperties... properties) Impostare |
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 |
MultiMap <String, String> | getAttributesMultiMap () |
getVersionedFileMap () | |
MultiMap <String, VersionedFile > | getVersionedFileMapFull () |
Costruttori pubblici
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 |
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 |
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
publicgetAppPackageFiles ()
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
publicgetBuildAttributes ()
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-userdebugritorna | |
---|---|
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
publicgetFiles ()
Restituisce tutti VersionedFile
archiviati in questo BuildInfo
.
ritorna | |
---|---|
getProperties
publicgetProperties ()
Restituisce una copia delle proprietà attualmente impostate su IBuildInfo
.
ritorna | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
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
publicgetVersionedFileKeys ()
Restituisce il set di chiavi disponibili per interrogare VersionedFile
tramite getFile(BuildInfoFileKey)
.
ritorna | |
---|---|
getVersionedFiles
public finalgetVersionedFiles (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
protectedgetVersionedFileMap ()
ritorna | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
ritorna | |
---|---|
MultiMap <String, VersionedFile > |