IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Sottoclassi indirette conosciute AppBuildInfo , AppDeviceBuildInfo , BuildInfo , ClusterBuildInfo , DeviceBuildInfo , DeviceFolderBuildInfo , FolderBuildInfo , IAppBuildInfo , IDeviceBuildInfo , IFolderBuildInfo , OtaDeviceBuildInfo , OtatoolsBuildInfo Informazioni sulla creazione di app Un IBuildInfo che rappresenta un'applicazione Android e i relativi pacchetti di test. AppDeviceBuildInfo Questa classe è obsoleta. Usa IDeviceBuildInfo direttamente. BuildInfo Implementazione generica di un IBuildInfo che dovrebbe essere associato a un ITestDevice . ClusterBuildInfo Una classe IBuildInfo per le build inviate tramite pipe da TFC. DeviceBuildInfo Un IBuildInfo che rappresenta una build completa del dispositivo Android e (facoltativamente) i suoi test. DeviceFolderBuildInfo Un IDeviceBuildInfo che contiene anche altri artefatti di compilazione contenuti in una directory sul filesystem locale. FolderBuildInfo Implementazione concreta di un IFolderBuildInfo . IAppBuildInfo Questa interfaccia è obsoleta. Usa IBuildInfo direttamente. IDDeviceBuildInfo Un IBuildInfo che rappresenta una build completa del dispositivo Android e (facoltativamente) i suoi test. IFolderBuildInfo Un semplice IBuildInfo astratto i cui artefatti di build sono contenuti in una directory del filesystem locale. OtaDeviceBuildInfo Un IDeviceBuildInfo utilizzato per i test di aggiornamento over-the-air. OtatoolsBuildInfo Un IBuildInfo che contiene artefatti otatools.

---

Contiene informazioni sulla build in prova.

Riepilogo

Classi nidificate
enum	IBuildInfo.BuildInfoProperties Alcune proprietà che un IBuildInfo può avere per modificarne la gestione.

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 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 sua versione associata.
abstract void	addBuildAttribute (String attributeName, String attributeValue) Aggiungi un attributo 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 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 una serie 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 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 nome specifico.
default File	getFile ( BuildInfoKey.BuildInfoFileKey key) Metodo di supporto per recuperare un file con un BuildInfoFileKey .
abstract	getFiles () Restituisce tutti i VersionedFile archiviati in questo BuildInfo .
abstract	getProperties () Restituisce una copia delle proprietà attualmente impostate in 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 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(BuildInfoKey.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) Rimuovere un determinato nomeattributo dal monitoraggio.
abstract void	setBuildBranch (String branch) Imposta il ramo di costruzione
abstract void	setBuildFlavor (String buildFlavor) Imposta il sapore della build.
abstract void	setBuildId (String buildId) Imposta l'identificatore univoco della build sottoposta a 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 un nome dato in queste informazioni sulla build.
default void	setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Memorizza un file a cui è stato assegnato un BuildInfoFileKey in queste informazioni sulla build.
abstract void	setProperties ( BuildInfoProperties... properties) Impostare 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) Eseguire lo stage di un file che fa parte di file remoti nella directory principale 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: "file_remoto:"

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 sua versione associata. Nota 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 build. Ciò non consente di eseguire l'override di 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	: Mappa degli attributi da aggiungere

pulire

public abstract void cleanUp ()

Pulisci tutti i file di build temporanei

pulire

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 una serie di coppie nome-valore di attributi aggiuntivi che descrivono la build.

ritorna
	a 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 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 è restituire (build product)-(build os)-(build variant). cioè generic-linux-userdebug

ritorna
String	il tipo 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. Il valore predefinito 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 di destinazione della build da una combinazione di build e nome del ramo. [ie (nome del ramo)-(aroma 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 un nome specifico.

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

Parametri
key	BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey richiesto.

ritorna
File	il file immagine o null se non trovato

getFiles

public abstract  getFiles ()

Restituisce tutti i VersionedFile archiviati in questo BuildInfo .

ritorna

getProperties

public abstract  getProperties ()

Restituisce una copia delle proprietà attualmente impostate in 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 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(BuildInfoKey.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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovere 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 costruzione

Parametri
branch	String : il nome del ramo

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Imposta il sapore della build.

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)

Imposta il seriale ITestDevice associato a questa build.

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

setFile

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

Memorizza un file con un nome dato in queste informazioni sulla build.

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

setFile

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

Memorizza 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 locale ERROR(/File)
version	String : la versione del file

setProprietà

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)

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

TODO(b/138416078): rimuovere 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 posizionare nei file remoti.
workingDir	File : un oggetto ERROR(/File) della directory in cui eseguire lo stage del file.

ritorna
File	l'oggetto ERROR(/File) del file messo in scena in workingDir locale.

aProto

public BuildInformation.BuildInfo toProto ()

Serializza un'istanza BuildInfo in un protobuf.

ritorna
BuildInformation.BuildInfo