A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

Sottoclassi dirette note

AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo

AppBuildInfo	Un `IBuildInfo` che rappresenta un'app per Android e i relativi pacchetti di test.
DeviceBuildInfo	Un `IBuildInfo` che rappresenta una build completa del dispositivo Android e (facoltativamente) i relativi test.
FolderBuildInfo	Implementazione concreta di un `IFolderBuildInfo`.
OtatoolsBuildInfo	Un `IBuildInfo` che contiene artefatti otatools.

Sottoclassi indirette note

AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo

AppDeviceBuildInfo	Questa classe è obsoleta. Utilizza `IDeviceBuildInfo` direttamente.
ClusterBuildInfo	Una classe `IBuildInfo` per le build inviate tramite pipe da TFC.
DeviceFolderBuildInfo	Un `IDeviceBuildInfo` che contiene anche altri artefatti di build contenuti in una directory del file system locale.
OtaDeviceBuildInfo	Un `IDeviceBuildInfo` utilizzato per i test di aggiornamento over-the-air.

Implementazione generica di un IBuildInfo che deve essere associato a un ITestDevice.

Riepilogo

Costruttori pubblici
`BuildInfo()` Crea un `BuildInfo` utilizzando i valori degli attributi predefiniti.
`BuildInfo(String buildId, String buildTargetName)` Crea un `BuildInfo`

Metodi pubblici
`void`	`addAppPackageFile(File appPackageFile, String version)` Aggiunge il file APK locale e la relativa versione.
`void`	`addBuildAttribute(String attributeName, String attributeValue)` Aggiungi un attributo di build.
`void`	`addBuildAttributes(Map<String, String> buildAttributes)` Aggiungere attributi di build
`void`	`allowStagingRemoteFile(boolean stageRemoteFile)` Imposta l'autorizzazione per consentire la gestione temporanea dei file remoti.
`void`	`cleanUp()` Libera spazio dai file di build temporanei
`void`	`cleanUp(List<File> doNotClean)` Versione di `cleanUp()` in cui alcuni file non vengono eliminati.
`IBuildInfo`	`clone()`
`final void`	`copyAllFileFrom(BuildInfo build)` Copia tutti i `VersionedFile` da una determinata build a questa.
`boolean`	`equals(Object obj)`
`static IBuildInfo`	`fromProto(BuildInformation.BuildInfo protoBuild)` Operazione inversa a `toProto()` per ripristinare l'istanza.
`List<VersionedFile>`	`getAppPackageFiles()` Recupera una copia del set di file APK dell'app locale e delle relative versioni.
`Map<String, String>`	`getBuildAttributes()` Ottieni un insieme di coppie nome-valore di attributi aggiuntivi che descrivono la build.
`String`	`getBuildBranch()` Metodo facoltativo per restituire il ramo del controllo della sorgente da cui è stata prodotta la build in fase di test.
`String`	`getBuildFlavor()` Metodo facoltativo per restituire il tipo di build in fase di test.
`String`	`getBuildId()` Restituisce l'identificatore univoco della build in fase di test.
`String`	`getBuildTargetName()` Restituisce il nome completo della build in fase di test.
`String`	`getDeviceSerial()`
`File`	`getFile(String name)` Metodo helper per recuperare un file con il nome specificato.
`File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Metodo helper per recuperare un file con un determinato `BuildInfoFileKey`.
`Collection<VersionedFile>`	`getFiles()` Restituisce tutti i `VersionedFile` memorizzati in questo `BuildInfo`.
`Set<IBuildInfo.BuildInfoProperties>`	`getProperties()` Restituisce una copia delle proprietà attualmente impostate su `IBuildInfo`.
`Set<File>`	`getRemoteFiles()` Ottieni i percorsi per gli artefatti di build il cui download è ritardato.
`String`	`getTestTag()` Restituisce un nome univoco per i test in esecuzione.
`String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` Metodo helper per recuperare una versione del file con un determinato `BuildInfoFileKey`.
`String`	`getVersion(String name)` Metodo helper per recuperare una versione del file con il nome specificato.
`VersionedFile`	`getVersionedFile(BuildInfoKey.BuildInfoFileKey key)` Metodo helper per recuperare un `VersionedFile` con un determinato `BuildInfoFileKey`.
`final VersionedFile`	`getVersionedFile(String name)` Metodo helper per recuperare un `VersionedFile` con un determinato nome.
`Set<String>`	`getVersionedFileKeys()` Restituisce l'insieme di chiavi disponibili per eseguire query su `VersionedFile` tramite `getFile(BuildInfoFileKey)`.
`final List<VersionedFile>`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` Metodo helper per recuperare un elenco di `VersionedFile` associati a un determinato `BuildInfoFileKey`.
`int`	`hashCode()`
`void`	`removeBuildAttribute(String attributeName)` Rimuovi un determinato attributeName dal monitoraggio.
`void`	`setBuildBranch(String branch)` Imposta il ramo di build
`void`	`setBuildFlavor(String buildFlavor)` Imposta la variante di build.
`void`	`setBuildId(String buildId)` Imposta l'identificatore univoco della build in fase di test.
`void`	`setDeviceSerial(String serial)` Imposta il numero di serie `ITestDevice` associato a questa build.
`void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Memorizza un file dato un `BuildInfoFileKey` in queste informazioni sulla build.
`void`	`setFile(String name, File file, String version)` Memorizza un file con il nome specificato in queste informazioni sulla build.
`void`	`setProperties(BuildInfoProperties... properties)` Imposta `BuildInfoProperties` per l'istanza `IBuildInfo`.
`void`	`setTestTag(String testTag)` Imposta il nome univoco dei test in esecuzione.
`File`	`stageRemoteFile(String fileName, File workingDir)` Esegui lo staging di un file che fa parte dei file remoti nella directory principale delle informazioni sulla build.
`BuildInformation.BuildInfo`	`toProto()` Serializza un'istanza BuildInfo in un protobuf.
`String`	`toString()`

Metodi protetti
`void`	`addAllBuildAttributes(BuildInfo build)` Metodo helper per copiare gli attributi di build, il ramo e la variante da un'altra build.
`void`	`addAllFiles(BuildInfo build)` Metodo helper per copiare tutti i file dall'altra build.
`boolean`	`applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)` Consente di applicare alcuni dei `IBuildInfo.BuildInfoProperties` e possibilmente di gestirli in modo diverso.
`MultiMap<String, String>`	`getAttributesMultiMap()`
`Map<String, VersionedFile>`	`getVersionedFileMap()`
`MultiMap<String, VersionedFile>`	`getVersionedFileMapFull()`

Costruttori pubblici

BuildInfo

public BuildInfo ()

Crea un BuildInfo utilizzando i valori degli attributi predefiniti.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Crea un BuildInfo

Parametri
`buildId`	`String`: l'ID build
`buildTargetName`	`String`: il nome della destinazione di build

Metodi pubblici

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Aggiunge il file APK locale e la relativa versione. 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 void addBuildAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo di build. In questo modo non è possibile eseguire l'override di un attributoName esistente.

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

addBuildAttributes

public void addBuildAttributes (Map<String, String> buildAttributes)

Aggiungere attributi di build

Parametri
`buildAttributes`	`Map`: 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`

cleanUp

public void cleanUp ()

Libera spazio dai file di build temporanei

cleanUp

public void cleanUp (List<File> doNotClean)

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

Parametri
`doNotClean`	`List`

clone

public IBuildInfo clone ()

Resi
`IBuildInfo`

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copia tutti i VersionedFile da una determinata build a questa.

Parametri
`build`	`BuildInfo`

uguale a

public boolean equals (Object obj)

Parametri
`obj`	`Object`

Resi
`boolean`

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Operazione inversa a toProto() per ripristinare l'istanza.

Parametri
`protoBuild`	`BuildInformation.BuildInfo`

Resi
`IBuildInfo`

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

Recupera 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 al IAppBuildInfo.

Resi
`List<VersionedFile>`

getBuildAttributes

public Map<String, String> getBuildAttributes ()

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

Resi
`Map<String, String>`	un `Map` di attributi di build. Non sarà `null`, ma potrebbe essere vuoto.

getBuildBranch

public String getBuildBranch ()

Metodo facoltativo per restituire il ramo del controllo della sorgente da cui è stata prodotta la build in fase di test.

Resi
`String`	il ramo di build o `null` se non impostato/non applicabile

getBuildFlavor

public 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 (prodotto build)-(sistema operativo build)-(variante di compilazione). ie generic-linux-userdebug

Resi
`String`	il tipo di build o `null` se non impostato/non applicabile

getBuildId

public String getBuildId ()

Restituisce l'identificatore univoco della build in fase di test. Non dovrebbe mai essere null. Il valore predefinito è UNKNOWN_BUILD_ID.

Resi
`String`

getBuildTargetName

public String getBuildTargetName ()

Restituisce il nome completo della build in fase di test.

Un'implementazione comune consiste nel creare il nome della build di destinazione combinando il nome della variante di build e del ramo. [ad es. (nome del ramo)-(variante di build)]

Resi
`String`

getDeviceSerial

public String getDeviceSerial ()

Resi
`String`

getFile

public File getFile (String name)

Metodo helper per recuperare un file con il nome specificato.

Resi
`File`	il file immagine o `null` se non viene trovato

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare un file con un determinato BuildInfoFileKey.

Parametri
`key`	`BuildInfoKey.BuildInfoFileKey`: il `BuildInfoFileKey` richiesto.

Resi
`File`	il file immagine o `null` se non trovato

getFiles

public Collection<VersionedFile> getFiles ()

Restituisce tutti i VersionedFile memorizzati in questo BuildInfo.

Resi
`Collection<VersionedFile>`

getProperties

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

Restituisce una copia delle proprietà attualmente impostate su IBuildInfo.

Resi
`Set<IBuildInfo.BuildInfoProperties>`

getRemoteFiles

public Set<File> getRemoteFiles ()

Ottieni i percorsi per gli artefatti di build il cui download è ritardato.

Resi
`Set<File>`

getTestTag

public String getTestTag ()

Restituisce un nome univoco per i test in esecuzione.

Resi
`String`

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare una versione del file con un determinato BuildInfoFileKey.

Parametri
`key`	`BuildInfoKey.BuildInfoFileKey`: il `BuildInfoFileKey` richiesto.

Resi
`String`	la versione dell'immagine o `null` se non viene trovata

getVersion

public String getVersion (String name)

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

Resi
`String`	la versione dell'immagine o `null` se non viene trovata

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare un VersionedFile con un determinato BuildInfoFileKey.

Parametri
`key`	`BuildInfoKey.BuildInfoFileKey`: il `BuildInfoFileKey` richiesto.

Resi
`VersionedFile`	Il file con controllo delle versioni o `null` se non trovato

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Metodo helper per recuperare un VersionedFile con un determinato nome.

Resi
`VersionedFile`	Il file con controllo delle versioni o `null` se non trovato

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

Restituisce l'insieme di chiavi disponibili per eseguire query su VersionedFile tramite getFile(BuildInfoFileKey).

Resi
`Set<String>`

getVersionedFiles

public final List<VersionedFile> getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Metodo helper per recuperare un elenco di VersionedFile associati a un determinato BuildInfoFileKey. Se la chiave consente di memorizzare un elenco.

Parametri
`key`	`BuildInfoKey.BuildInfoFileKey`: il `BuildInfoFileKey` richiesto.

Resi
`List<VersionedFile>`	Il file con controllo delle versioni o `null` se non trovato

hashCode

public int hashCode ()

Resi
`int`

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovi un determinato attributeName dal monitoraggio.

Parametri
`attributeName`	`String`: l'attributo da interrompere il monitoraggio

setBuildBranch

public void setBuildBranch (String branch)

Imposta il ramo di build

Parametri
`branch`	`String`: il nome del ramo

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Imposta la variante di build.

setBuildId

public void setBuildId (String buildId)

Imposta l'identificatore univoco della build in fase di test. Non dovrebbe mai essere null.

Parametri
`buildId`	`String`

setDeviceSerial

public void setDeviceSerial (String serial)

Imposta il numero di serie ITestDevice associato a questa build.

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

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`: il `File` locale
`version`	`String`: la versione del file

setFile

public 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`: il `File` locale
`version`	`String`: la versione del file

setProperties

public void setProperties (BuildInfoProperties... properties)

Imposta BuildInfoProperties per l'istanza IBuildInfo. Ignora le proprietà esistenti impostate in precedenza.

Parametri
`properties`	`BuildInfoProperties`: L'elenco delle proprietà da aggiungere.

setTestTag

public void setTestTag (String testTag)

Imposta il nome univoco dei test in esecuzione.

Parametri
`testTag`	`String`

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Esegui lo staging di un file che fa parte dei file remoti nella directory principale delle informazioni sulla build.

TODO(b/138416078): Remove this interface and its caller when modules required by a test can be properly built output to the test module's directory itself.

Parametri
`fileName`	`String`: il nome del file da individuare nei file remoti.
`workingDir`	`File`: un oggetto `File` della directory in cui preparare il file.

Resi
`File`	l'oggetto `File` del file sottoposto a staging in workingDir locale.

toProto

public BuildInformation.BuildInfo toProto ()

Serializza un'istanza BuildInfo in un protobuf.

Resi
`BuildInformation.BuildInfo`

toString

public String toString ()

Resi
`String`

Metodi protetti

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Metodo helper per copiare gli attributi di build, il ramo e la variante da un'altra build.

Parametri
`build`	`BuildInfo`

addAllFiles

protected void addAllFiles (BuildInfo build)

Metodo helper per copiare tutti i file dall'altra build.

Crea nuovi hardlink ai file in modo che ogni build abbia un percorso di file univoco per il file.

Parametri
`build`	`BuildInfo`

Genera
`IOException`	se viene generata un'eccezione durante la creazione del collegamento fisico.

applyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

Consente di applicare alcuni dei IBuildInfo.BuildInfoProperties e possibilmente di gestirli in modo diverso.

Parametri
`origFileConsidered`	`VersionedFile`: il `VersionedFile` attualmente visualizzato.
`build`	`IBuildInfo`: la build originale in fase di clonazione
`receiver`	`IBuildInfo`: la build che riceve le informazioni.

Resi
`boolean`	Vero se abbiamo applicato le proprietà e l'ulteriore gestione deve essere ignorata. False altrimenti.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Resi
`MultiMap<String, String>`

getVersionedFileMap

protected Map<String, VersionedFile> getVersionedFileMap ()

Resi
`Map<String, VersionedFile>`

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Resi
`MultiMap<String, VersionedFile>`