IBuildInfo
public interface IBuildInfo
com.android.tradefed.build.IBuildInfo |
Contiene informazioni sulla build sottoposta a test.
Riepilogo
Costanti | |
---|---|
String | REMOTE_FILE_PREFIX Prefisso utilizzato nel nome per indicare che il file è impostato per il download ritardato. |
String | REMOTE_FILE_VERSION Il file remoto non è versionato. |
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 build. |
default void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Aggiungi attributi di build |
abstract void | cleanUp () Pulisci tutti i 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 di controllo del codice sorgente da cui è stata prodotta la build in fase di test. |
abstract String | getBuildFlavor () Metodo facoltativo per restituire il tipo di build in fase di test. |
abstract String | getBuildId () Restituisce l'identificatore univoco della build sottoposta a test. |
abstract String | getBuildTargetName () Restituisce il nome completo per la build in fase di test. |
abstract String | getDeviceSerial () |
abstract File | getFile (String name) Metodo di supporto per recuperare un file con un determinato nome. |
default File | getFile ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un file con un dato |
abstract | getFiles () Restituisce tutti |
abstract | getProperties () Restituisce una copia delle proprietà attualmente impostate su |
default | getRemoteFiles () Ottieni i percorsi per gli artefatti di build che vengono scaricati in ritardo. |
abstract String | getTestTag () Restituisce un nome univoco per i test in esecuzione. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare una versione del file con un dato |
abstract String | getVersion (String name) Metodo helper per recuperare una versione del file con un determinato nome. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un |
default VersionedFile | getVersionedFile (String name) Metodo helper per recuperare un |
default | getVersionedFileKeys () Restituisce il set di chiavi disponibili per interrogare |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metodo helper per recuperare un elenco di |
default void | removeBuildAttribute (String attributeName) Rimuovi un determinato attributeName dal tracciamento. |
abstract void | setBuildBranch (String branch) Imposta il ramo di costruzione |
abstract void | setBuildFlavor (String buildFlavor) Imposta il sapore di costruzione. |
abstract void | setBuildId (String buildId) Imposta l'identificatore univoco della build sottoposta a test. |
abstract void | setDeviceSerial (String serial) Impostare 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 dato un |
abstract void | setProperties ( BuildInfoProperties... properties) Impostare |
abstract void | setTestTag (String testTag) Imposta il nome univoco per i test in esecuzione. |
default File | stageRemoteFile (String fileName, File workingDir) Mettere in scena un file che fa parte di file remoti nella directory principale delle informazioni sulla build. |
default BuildInformation.BuildInfo | toProto () Serializza un'istanza di BuildInfo in un protobuf. |
Costanti
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
Prefisso utilizzato nel nome per indicare che il file è impostato per il download ritardato.
Valore costante: "file_remoto:"
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
Il file remoto non è versionato.
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 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 abstract void cleanUp ()
Pulisci tutti i 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 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 abstract 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 abstract 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 abstract 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 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 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
public abstractgetFiles ()
Restituisce tutti VersionedFile
archiviati 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 che vengono scaricati in ritardo.
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 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 abstract 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 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
publicgetVersionedFiles (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 |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
Rimuovi un determinato attributeName dal tracciamento.
Parametri | |
---|---|
attributeName | String : l'attributo per interrompere il tracciamento |
setBuildBranch
public abstract void setBuildBranch (String branch)
Imposta il ramo di costruzione
Parametri | |
---|---|
branch | String : il nome del ramo |
setBuildFlavor
public abstract void setBuildFlavor (String buildFlavor)
Imposta il sapore di costruzione.
setBuildId
public abstract void setBuildId (String buildId)
Imposta l'identificatore univoco della build sottoposta a test. Non dovrebbe mai essere nullo.
Parametri | |
---|---|
buildId | String |
setDeviceSerial
public abstract 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 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 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 abstract 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 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)
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 |