InfoIBuild.

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Contiene le informazioni sulla build in corso di 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 è sottoposto al controllo delle versioni.

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

default void addBuildAttributes( buildAttributes)

Aggiungi attributi build

default void allowStagingRemoteFile(boolean stageRemoteFile)

Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti.

abstract void cleanUp()

Elimina eventuali file di build temporanei

abstract void cleanUp( doNotDelete)

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

abstract IBuildInfo clone()

Clona l'oggetto IBuildInfo.

default getAppPackageFiles()

Recupera una copia del set di file apk delle app locali e delle relative versioni.

abstract getBuildAttributes()

Ottieni un insieme 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 utilizzato per la build da testare prodotto.

abstract String getBuildFlavor()

Metodo facoltativo per restituire il tipo di build da testare.

abstract String getBuildId()

Restituisce l'identificatore univoco della build sottoposta a test.

abstract String getBuildTargetName()

Restituisce il nome completo della build in fase di test.

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

abstract getFiles()

Restituisce tutti i valori VersionedFile archiviati in BuildInfo.

abstract getProperties()

Restituisce una copia delle proprietà attualmente impostate nel IBuildInfo.

default getRemoteFiles()

Consente di recuperare i percorsi per gli artefatti della 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 di supporto per recuperare la versione di un file con un BuildInfoFileKey specificato.

abstract String getVersion(String name)

Metodo helper per recuperare una versione di un 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 eseguire query su 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 determinatoattributeName dal monitoraggio.

abstract void setBuildBranch(String branch)

imposta il ramo di build

abstract void setBuildFlavor(String buildFlavor)

Imposta le versioni di build.

abstract void setBuildId(String buildId)

Imposta l'identificatore univoco della build in corso di test.

abstract void setDeviceSerial(String serial)

Imposta il numero seriale ITestDevice associato a questa build.

abstract void setFile(String name, File file, String version)

Archivia un file con il nome specificato nelle informazioni sulla build.

default void setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)

Archivia un file a cui è stato assegnato un BuildInfoFileKey in queste informazioni sulla build.

abstract void setProperties(BuildInfoProperties... properties)

Imposta BuildInfoProperties per l'istanza IBuildInfo.

abstract void setTestTag(String testTag)

Imposta il nome univoco per i test da eseguire.

default File stageRemoteFile(String fileName, File workingDir)

Esegui lo stage di un file che fa parte di file remoti nella directory radice delle informazioni sulla 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 file è impostato per il download ritardato.

Valore costante: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Il file remoto non è sottoposto al controllo delle versioni.

Valore costante: "

ID_BUILD_SCONOSCIUTA

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 con questo metodo.

Parametri
appPackageFile File

version String

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo build. Questo non consente di eseguire l'override di unattributeName esistente.

Parametri
attributeName String: nome univoco dell'attributo
attributeValue String: il valore dell'attributo

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Aggiungi attributi build

Parametri
buildAttributes : mappa degli attributi da aggiungere

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti.

Parametri
stageRemoteFile boolean

pulizia

public abstract void cleanUp ()

Elimina eventuali file di build temporanei

pulizia

public abstract void cleanUp ( doNotDelete)

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

Parametri
doNotDelete

clona

public abstract IBuildInfo clone ()

Clona l'oggetto IBuildInfo.

Ritorni
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Recupera una copia del set di file apk delle app locali e delle relative versioni. L'ordine restituito corrisponde all'ordine in cui gli apk sono stati aggiunti a IAppBuildInfo.

Ritorni

getBuildAttributes

public abstract  getBuildAttributes ()

Ottieni un insieme di coppie nome-valore di attributi aggiuntivi che descrivono la build.

Ritorni
un ERROR(/Map) di 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 utilizzato per la build da testare prodotto.

Ritorni
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 di piattaforme Android è la restituzione (prodotto build) -(sistema operativo build) -(variante build). ad es. generico-linux-userdebug

Ritorni
String la versione build o null se non configurata/non applicabile

getBuildId

public abstract String getBuildId ()

Restituisce l'identificatore univoco della build sottoposta a test. Non deve mai essere null. Il valore predefinito è UNKNOWN_BUILD_ID.

Ritorni
String

getBuildTargetName

public abstract String getBuildTargetName ()

Restituisce il nome completo della build in fase di test.

Un'implementazione comune consiste nel creare il nome della destinazione di build a partire da una combinazione la versione build e il nome del ramo. [ad es. (nome filiale)-(creazione di una versione)]

Ritorni
String

getDeviceSerial

public abstract String getDeviceSerial ()

Ritorni
String il serial ITestDevice su cui è stata eseguita questa build. Restituisce null se a questa build non è associato alcun dispositivo.

getFile

public abstract File getFile (String name)

Metodo di supporto per recuperare un file con il nome specificato.

Ritorni
File il file immagine o null se non trovato

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare un file con un BuildInfoFileKey specificato.

Parametri
key BuildInfoKey.BuildInfoFileKey: il valore BuildInfoFileKey richiesto.
Ritorni
File il file immagine o null se non trovato

getFile

public abstract  getFiles ()

Restituisce tutti i valori VersionedFile archiviati in BuildInfo.

Ritorni

getProperties

public abstract  getProperties ()

Restituisce una copia delle proprietà attualmente impostate nel IBuildInfo.

Ritorni

getRemoteFiles

public  getRemoteFiles ()

Consente di recuperare i percorsi per gli artefatti della build che vengono scaricati in ritardo.

Ritorni

getTestTag

public abstract String getTestTag ()

Restituisce un nome univoco per i test in esecuzione.

Ritorni
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto per recuperare la versione di un file con un BuildInfoFileKey specificato.

Parametri
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey richiesto.
Ritorni
String la versione dell'immagine o null se non trovata

getVersion

public abstract String getVersion (String name)

Metodo helper per recuperare una versione di un file con il nome specificato.

Ritorni
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.
Ritorni
VersionedFile Il file con il controllo delle versioni o null se non trovato

getVersionedFile

public VersionedFile getVersionedFile (String name)

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

Ritorni
VersionedFile Il file con il controllo delle versioni o null se non trovato

getVersionedFileKey

public  getVersionedFileKeys ()

Restituisce il set di chiavi disponibili per eseguire query su VersionedFile tramite getFile(BuildInfoFileKey).

Ritorni

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 archiviare un elenco.

Parametri
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey richiesto.
Ritorni
Il file con il controllo delle versioni o null se non trovato

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovi un determinatoattributeName dal monitoraggio.

Parametri
attributeName String: l'attributo per interrompere il monitoraggio

setBuildBranch

public abstract void setBuildBranch (String branch)

imposta il ramo di build

Parametri
branch String: il nome della filiale

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Imposta le versioni di build.

setBuildId

public abstract void setBuildId (String buildId)

Imposta l'identificatore univoco della build in corso di test. Non deve mai essere null.

Parametri
buildId String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

Imposta il numero seriale ITestDevice associato a questa build.

Parametri
serial String: il numero di serie del valore ITestDevice con cui è stata eseguita questa build.

setFile

public abstract void setFile (String name, 
                File file, 
                String version)

Archivia un file con il nome specificato nelle informazioni sulla build.

Parametri
name String: nome univoco del file
file File: il ERROR(/File) locale
version String: la versione del file

setFile

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

Archivia un file a cui è stato assegnato un BuildInfoFileKey in queste informazioni sulla build.

Parametri
key BuildInfoKey.BuildInfoFileKey: il nome univoco del file basato su BuildInfoFileKey.
file File: il ERROR(/File) locale
version String: la versione del file

ImpostaProprietà

public abstract void setProperties (BuildInfoProperties... properties)

Imposta BuildInfoProperties per l'istanza IBuildInfo. Sostituisci qualsiasi proprietà esistenti impostate prima.

Parametri
properties BuildInfoProperties: l'elenco di proprietà da aggiungere.

setTestTag

public abstract void setTestTag (String testTag)

Imposta il nome univoco per i test da eseguire.

Parametri
testTag String

File remoto stage

public File stageRemoteFile (String fileName, 
                File workingDir)

Esegui lo stage di un file che fa parte di file remoti nella directory radice delle informazioni sulla build.

TODO(b/138416078): rimuovi questa interfaccia e il chiamante quando i moduli richiesti da un test può essere creato correttamente come output nella directory stessa del modulo di test.

Parametri
fileName String: nome del file da individuare nei file remoti.
workingDir File: un oggetto ERROR(/File) della directory per organizzare il file.
Ritorni
File l'oggetto ERROR(/File) del file in fase di gestione temporanea in workDir locale.

toProto

public BuildInformation.BuildInfo toProto ()

Serializza un'istanza BuildInfo in un protobuf.

Ritorni
BuildInformation.BuildInfo