BuildInfo
public class BuildInfo
extends Object
implements IBuildInfo
java.lang.Object | |
↳ | 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 compilazione. |
void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Aggiungi attributi di costruzione |
void | allowStagingRemoteFile (boolean stageRemoteFile) Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti. |
void | cleanUp () Pulisci eventuali 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 su |
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 del controllo del codice sorgente da cui è stata prodotta la build sottoposta a test. |
String | getBuildFlavor () Metodo facoltativo per restituire il tipo di build da testare. |
String | getBuildId () Restituisce l'identificatore univoco della build in prova. |
String | getBuildTargetName () Restituisce il nome completo della build da testare. |
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 una determinata |
getFiles () Restituisce tutti | |
getProperties () Restituisce una copia delle proprietà attualmente impostate su | |
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 valore |
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 |
final VersionedFile | getVersionedFile (String name) Metodo di supporto per recuperare un |
getVersionedFileKeys () Restituisce il set di chiavi disponibili per interrogare | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare un elenco di |
int | hashCode () |
void | removeBuildAttribute (String attributeName) Rimuovi un determinato nomeattributo dal monitoraggio. |
void | setBuildBranch (String branch) Imposta il ramo di compilazione |
void | setBuildFlavor (String buildFlavor) Imposta la tipologia di costruzione. |
void | setBuildId (String buildId) Imposta l'identificatore univoco della build in fase di test. |
void | setDeviceSerial (String serial) Imposta 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 con una |
void | setProperties ( BuildInfoProperties... properties) Imposta |
void | setTestTag (String testTag) Imposta il nome univoco per i test in esecuzione. |
File | stageRemoteFile (String fileName, File workingDir) Metti in stage un file che fa parte di file remoti nella directory root delle informazioni di build. |
BuildInformation.BuildInfo | toProto () Serializza un'istanza BuildInfo in un protobuf. |
String | toString ()
|
Metodi protetti | |
---|---|
void | addAllBuildAttributes ( BuildInfo build) Metodo di supporto per copiare attributi, rami e caratteristiche della 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 |
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 build |
buildTargetName | String : il nome della destinazione della 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 da questo metodo.
Parametri | |
---|---|
appPackageFile | File |
version | String |
addBuildAttribute
public void addBuildAttribute (String attributeName, String attributeValue)
Aggiungi un attributo di compilazione. Ciò non consente di sovrascrivere un attributoName esistente.
Parametri | |
---|---|
attributeName | String : il nome dell'attributo univoco |
attributeValue | String : il valore dell'attributo |
aggiungiBuildAttributes
public void addBuildAttributes (buildAttributes)
Aggiungi attributi di costruzione
Parametri | |
---|---|
buildAttributes |
consentireStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti.
Parametri | |
---|---|
stageRemoteFile | boolean |
ripulire
public void cleanUp ()
Pulisci eventuali file di build temporanei
ripulire
public void cleanUp (doNotClean)
Versione di cleanUp()
in cui alcuni file non vengono eliminati.
Parametri | |
---|---|
doNotClean |
copyAllFileFrom
public final void copyAllFileFrom (BuildInfo build)
Copia tutto il VersionedFile
da una determinata 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 su 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 del controllo del codice sorgente da cui è stata prodotta la build sottoposta a 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 da testare.
Un'implementazione comune per le build della piattaforma Android è restituire (build product)-(build os)-(build variante). cioè generic-linux-userdebugritorna | |
---|---|
String | la versione build o null se non impostato/non applicabile |
getBuildId
public String getBuildId ()
Restituisce l'identificatore univoco della build in prova. Non dovrebbe mai essere nullo. Il valore predefinito è UNKNOWN_BUILD_ID
.
ritorna | |
---|---|
String |
getBuildTargetName
public String getBuildTargetName ()
Restituisce il nome completo della build da testare.
Un'implementazione comune consiste nel costruire il nome di destinazione della build da una combinazione del tipo di build e del nome del ramo. [cioè (nome del ramo)-(sapore 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 il nome specificato.
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 una determinata BuildInfoFileKey
.
Parametri | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey richiesto. |
ritorna | |
---|---|
File | il file immagine o null se non trovato |
getFiles
publicgetFiles ()
Restituisce tutti VersionedFile
memorizzati 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 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 valore 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
publicgetVersionedFileKeys ()
Restituisce il set di chiavi disponibili per interrogare VersionedFile
tramite getFile(BuildInfoFileKey)
.
ritorna | |
---|---|
getVersionedFiles
public finalgetVersionedFiles (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 |
rimuoviBuildAttribute
public void removeBuildAttribute (String attributeName)
Rimuovi un determinato nomeattributo dal monitoraggio.
Parametri | |
---|---|
attributeName | String : l'attributo per interrompere il tracciamento |
setBuildBranch
public void setBuildBranch (String branch)
Imposta il ramo di compilazione
Parametri | |
---|---|
branch | String : il nome del ramo |
setBuildFlavor
public void setBuildFlavor (String buildFlavor)
Imposta la tipologia di costruzione.
setBuildId
public void setBuildId (String buildId)
Imposta l'identificatore univoco della build in fase di 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 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 con una BuildInfoFileKey
in queste informazioni di 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)
Imposta 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)
Metti in stage un file che fa parte di file remoti nella directory root delle informazioni di build.
TODO(b/138416078): rimuovere questa interfaccia e il relativo chiamante quando i moduli richiesti da un test possono essere correttamente generati 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 per mettere in scena il file. |
ritorna | |
---|---|
File | l'oggetto ERROR(/File) del file gestito nella 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
aggiungiAllBuildAttributes
protected void addAllBuildAttributes (BuildInfo build)
Metodo di supporto per copiare attributi, rami e caratteristiche della build da un'altra build.
Parametri | |
---|---|
build | BuildInfo |
aggiungiTuttiFile
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 file univoco per il file.
Parametri | |
---|---|
build | BuildInfo |
Lancia | |
---|---|
| se viene generata un'eccezione durante la creazione del collegamento fisico. |
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 esaminato. |
build | IBuildInfo : la build originale da clonare |
receiver | IBuildInfo : la build che riceve le informazioni. |
ritorna | |
---|---|
boolean | Vero se applicassimo 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 > |