Questa pagina è stata tradotta dall'API Cloud Translation.

IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Sottoclassi indirette note

AppBuildInfo , AppDeviceBuildInfo , BuildInfo , ClusterBuildInfo , DeviceBuildInfo , DeviceFolderBuildInfo , FolderBuildInfo , IAppBuildInfo , IDeviceBuildInfo , IFolderBuildInfo , OtaDeviceBuildInfo , OtatoolsBuildInfo

AppBuildInfo	Oggetto `IBuildInfo` che rappresenta un'applicazione Android e i relativi pacchetti di test.
AppDeviceBuildInfo	Questa classe è obsoleta. Utilizzare direttamente `IDeviceBuildInfo` .
BuildInfo	Implementazione generica di un `IBuildInfo` che deve essere associato a un `ITestDevice` .
ClusterBuildInfo	Una classe `IBuildInfo` per build reindirizzate da TFC.
DeviceBuildInfo	Oggetto `IBuildInfo` che rappresenta una build completa del dispositivo Android e (facoltativamente) i relativi test.
DeviceFolderBuildInfo	Oggetto `IDeviceBuildInfo` che contiene anche altri artefatti di compilazione contenuti in una directory nel file system locale.
FolderBuildInfo	Implementazione concreta di un `IFolderBuildInfo` .
IAppBuildInfo	Questa interfaccia è deprecata. Usare `IBuildInfo` direttamente.
IDeviceBuildInfo	Oggetto `IBuildInfo` che rappresenta una build completa del dispositivo Android e (facoltativamente) i relativi test.
IFolderBuildInfo	Un semplice `IBuildInfo` astratto i cui artefatti di compilazione sono contenuti in una directory del filesystem locale.
OtaDeviceBuildInfo	Oggetto `IDeviceBuildInfo` utilizzato per i test di aggiornamento over-the-air.
OtatoolsBuildInfo	Oggetto `IBuildInfo` che contiene artefatti otatools.

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 `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 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 `BuildInfoFileKey` .
`abstract`	`getFiles ()` Restituisce tutti `VersionedFile` archiviati in questo `BuildInfo` .
`abstract`	`getProperties ()` Restituisce una copia delle proprietà attualmente impostate su `IBuildInfo` .
`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 `BuildInfoFileKey` .
`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 `VersionedFile` con un dato `BuildInfoFileKey` .
`default VersionedFile`	`getVersionedFile (String name)` Metodo helper 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 helper per recuperare un elenco di `VersionedFile` associati a un dato `BuildInfoFileKey` .
`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 `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 dato 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)` 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`	: Mappa degli attributi da aggiungere

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`

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

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

Restituisce tutti VersionedFile archiviati 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 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

public  getVersionedFileKeys ()

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

ritorna

getVersionedFiles

public  getVersionedFiles (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`