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

abstract void cleanUp ()

Pulisci eventuali file di build temporanei

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

Clona l'oggetto IBuildInfo .

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

abstract getFiles ()

Restituisce tutti VersionedFile memorizzati in questo BuildInfo .

abstract getProperties ()

Restituisce una copia delle proprietà attualmente impostate su IBuildInfo .

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

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 VersionedFile con un determinato BuildInfoFileKey .

default VersionedFile getVersionedFile (String name)

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

default getVersionedFileKeys ()

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

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare un elenco di VersionedFile associati a un determinato BuildInfoFileKey .

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 ITestDevice associato a questa build.

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 BuildInfoFileKey in queste informazioni di build.

abstract void setProperties ( BuildInfoProperties... properties)

Imposta BuildInfoProperties per l'istanza IBuildInfo .

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 : Mappa degli attributi da aggiungere

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

clone

public abstract IBuildInfo clone ()

Clona l'oggetto IBuildInfo .

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 abstract  getBuildAttributes ()

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-userdebug

ritorna
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 abstract  getFiles ()

Restituisce tutti VersionedFile memorizzati in questo BuildInfo .

ritorna

getProperties

public abstract  getProperties ()

Restituisce una copia delle proprietà attualmente impostate su IBuildInfo .

ritorna

getRemoteFiles

public  getRemoteFiles ()

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

public  getVersionedFileKeys ()

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

ritorna

getVersionedFiles

public  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

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