IBuildInfo
public interface IBuildInfo
com.android.tradefed.build.IBuildInfo |
Contiene informazioni sulla build sotto test.
Riepilogo
Costanti | |
---|---|
String | REMOTE_FILE_PREFIX Prefisso utilizzato nel nome per indicare che il download del file è impostato per essere ritardato. |
String | REMOTE_FILE_VERSION Il file remoto non ha la versione. |
String | UNKNOWN_BUILD_ID Valore predefinito quando l'ID build è sconosciuto. |
Metodi pubblici | |
---|---|
default void | addAppPackageFile (File appPackageFile, String version) Aggiunge il file apk locale e la versione associata. |
abstract void | addBuildAttribute (String attributeName, String attributeValue) Aggiungi un attributo di compilazione. |
default void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Aggiungi attributi di costruzione |
default void | allowStagingRemoteFile (boolean stageRemoteFile) Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti. |
abstract void | cleanUp () Pulisci eventuali file di build temporanei |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) Versione di |
abstract IBuildInfo | clone () Clona l'oggetto |
default | getAppPackageFiles () Ottiene una copia del set di file apk dell'app locale e delle relative versioni. |
abstract | getBuildAttributes () Ottieni un set di coppie nome-valore di attributi aggiuntivi che descrivono la build. |
abstract String | getBuildBranch () Metodo facoltativo per restituire il ramo del controllo del codice sorgente da cui è stata prodotta la build sottoposta a test. |
abstract String | getBuildFlavor () Metodo facoltativo per restituire il tipo di build da testare. |
abstract String | getBuildId () Restituisce l'identificatore univoco della build in prova. |
abstract String | getBuildTargetName () Restituisce il nome completo della build da testare. |
abstract String | getDeviceSerial () |
abstract File | getFile (String name) Metodo di supporto per recuperare un file con il nome specificato. |
default File | getFile ( BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare un file con una determinata |
abstract | getFiles () Restituisce tutti |
abstract | getProperties () Restituisce una copia delle proprietà attualmente impostate su |
default | getRemoteFiles () Ottieni i percorsi per gli artefatti di build il cui download è ritardato. |
abstract String | getTestTag () Restituisce un nome univoco per i test in esecuzione. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare una versione del file con un valore |
abstract String | getVersion (String name) Metodo di supporto per recuperare una versione del file con il nome specificato. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare un |
default VersionedFile | getVersionedFile (String name) Metodo di supporto per recuperare un |
default | getVersionedFileKeys () Restituisce il set di chiavi disponibili per interrogare |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare un elenco di |
default void | removeBuildAttribute (String attributeName) Rimuovi un determinato nomeattributo dal monitoraggio. |
abstract void | setBuildBranch (String branch) Imposta il ramo di compilazione |
abstract void | setBuildFlavor (String buildFlavor) Imposta la tipologia di costruzione. |
abstract void | setBuildId (String buildId) Imposta l'identificatore univoco della build in fase di test. |
abstract void | setDeviceSerial (String serial) Imposta il seriale |
abstract void | setFile (String name, File file, String version) Memorizza un file con il nome specificato in queste informazioni sulla build. |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Memorizza un file con una |
abstract void | setProperties ( BuildInfoProperties... properties) Imposta |
abstract void | setTestTag (String testTag) Imposta il nome univoco per i test in esecuzione. |
default File | stageRemoteFile (String fileName, File workingDir) Metti in stage un file che fa parte di file remoti nella directory root delle informazioni di build. |
default BuildInformation.BuildInfo | toProto () Serializza un'istanza BuildInfo in un protobuf. |
Costanti
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
Prefisso utilizzato nel nome per indicare che il download del file è impostato per essere ritardato.
Valore costante: "remote_file:"
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
Il file remoto non ha la versione.
Valore costante: ""
UNKNOWN_BUILD_ID
public static final String UNKNOWN_BUILD_ID
Valore predefinito quando l'ID build è sconosciuto.
Valore costante: "-1"
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 abstract 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 abstract void cleanUp ()
Pulisci eventuali file di build temporanei
ripulire
public abstract void cleanUp (doNotDelete)
Versione di cleanUp()
in cui alcuni file non vengono eliminati.
Parametri | |
---|---|
doNotDelete |
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
public abstractgetBuildAttributes ()
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 abstract 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 abstract 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 abstract 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 abstract 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 abstract String getDeviceSerial ()
ritorna | |
---|---|
String | il seriale ITestDevice su cui è stata eseguita questa build. Restituisce null se nessun dispositivo è associato a questa build. |
prendi il file
public abstract 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
public abstractgetFiles ()
Restituisce tutti VersionedFile
memorizzati in questo BuildInfo
.
ritorna | |
---|---|
getProperties
public abstractgetProperties ()
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 abstract 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 abstract 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 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
publicgetVersionedFiles (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 |
rimuoviBuildAttribute
public void removeBuildAttribute (String attributeName)
Rimuovi un determinato nomeattributo dal monitoraggio.
Parametri | |
---|---|
attributeName | String : l'attributo per interrompere il tracciamento |
setBuildBranch
public abstract void setBuildBranch (String branch)
Imposta il ramo di compilazione
Parametri | |
---|---|
branch | String : il nome del ramo |
setBuildFlavor
public abstract void setBuildFlavor (String buildFlavor)
Imposta la tipologia di costruzione.
setBuildId
public abstract void setBuildId (String buildId)
Imposta l'identificatore univoco della build in fase di test. Non dovrebbe mai essere nullo.
Parametri | |
---|---|
buildId | String |
setDeviceSerial
public abstract 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 abstract 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 abstract 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 abstract 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 |