A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

Classi di sottoclasse dirette note

AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo

AppBuildInfo	Un `IBuildInfo` che rappresenta un'applicazione 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` contenente gli artefatti di otatools.

Classi di sottoclasse indirette note

AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo

AppDeviceBuildInfo	Questa classe è stata ritirata. Utilizza direttamente `IDeviceBuildInfo`.
ClusterBuildInfo	Una classe `IBuildInfo` per le build incanalate da TFC.
DeviceFolderBuildInfo	Un `IDeviceBuildInfo` che contiene anche altri elementi di compilazione contenuti in una directory sul file system locale.
OtaDeviceBuildInfo	Un `IDeviceBuildInfo` utilizzato per i test degli aggiornamenti 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 predefiniti degli attributi.
`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 associata.
`void`	`addBuildAttribute(String attributeName, String attributeValue)` Aggiungi un attributo di compilazione.
`void`	`addBuildAttributes( buildAttributes)` Aggiungere attributi di compilazione
`void`	`allowStagingRemoteFile(boolean stageRemoteFile)` Imposta l'autorizzazione per consentire l'organizzazione in anteprima dei file remoti.
`void`	`cleanUp()` Elimina eventuali file di compilazione temporanei
`void`	`cleanUp( 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)` Esegui l'operazione inversa a `toProto()` per recuperare l'istanza.
	`getAppPackageFiles()` Recupera una copia dell'insieme di file APK dell'app locale e delle relative versioni.
	`getBuildAttributes()` Ottieni un insieme di coppie nome-valore di attributi aggiuntivi che descrivono la compilazione.
`String`	`getBuildBranch()` Metodo facoltativo per restituire il ramo del controllo dell'origine 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 test.
`String`	`getBuildTargetName()` Restituisce il nome completo della build in fase di test.
`String`	`getDeviceSerial()`
`File`	`getFile(String name)` Metodo di supporto per recuperare un file con un nome specificato.
`File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Metodo di supporto per recuperare un file con un determinato `BuildInfoFileKey`.
	`getFiles()` Restituisce tutti i `VersionedFile` archiviati in questo `BuildInfo`.
	`getProperties()` Restituisce una copia delle proprietà attualmente impostate su `IBuildInfo`.
	`getRemoteFiles()` Visualizza i percorsi degli elementi della build di cui è stato ritardato il download.
`String`	`getTestTag()` Restituisce un nome univoco per i test in esecuzione.
`String`	`getVersion(BuildInfoKey.BuildInfoFileKey key)` Metodo di supporto per recuperare una versione di un file con un determinato `BuildInfoFileKey`.
`String`	`getVersion(String name)` Metodo di supporto per recuperare una versione del file con il nome specificato.
`VersionedFile`	`getVersionedFile(BuildInfoKey.BuildInfoFileKey key)` Metodo di supporto per recuperare un `VersionedFile` con un determinato `BuildInfoFileKey`.
`final VersionedFile`	`getVersionedFile(String name)` Metodo di supporto per recuperare un `VersionedFile` con un determinato nome.
	`getVersionedFileKeys()` Restituisce l'insieme di chiavi disponibili per eseguire query su `VersionedFile` tramite `getFile(BuildInfoFileKey)`.
`final`	`getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)` Metodo di supporto per recuperare un elenco di `VersionedFile` associati a un determinato `BuildInfoFileKey`.
`int`	`hashCode()`
`void`	`removeBuildAttribute(String attributeName)` Rimuovi un determinato attributo dal monitoraggio.
`void`	`setBuildBranch(String branch)` Imposta il ramo di compilazione
`void`	`setBuildFlavor(String buildFlavor)` Imposta il tipo di build.
`void`	`setBuildId(String buildId)` Imposta l'identificatore univoco della build in test.
`void`	`setDeviceSerial(String serial)` Imposta il numero di serie `ITestDevice` associato a questa build.
`void`	`setFile(String name, File file, String version)` Memorizza un file con il nome specificato in queste informazioni di compilazione.
`void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Memorizza un file a cui è stato assegnato un `BuildInfoFileKey` in queste informazioni di compilazione.
`void`	`setProperties(BuildInfoProperties... properties)` Imposta `BuildInfoProperties` per l'istanza `IBuildInfo`.
`void`	`setTestTag(String testTag)` Imposta il nome univoco per i test in esecuzione.
`File`	`stageRemoteFile(String fileName, File workingDir)` Esegui la gestione delle fasi di un file che fa parte dei file remoti nella home directory delle informazioni di compilazione.
`BuildInformation.BuildInfo`	`toProto()` Serializza un'istanza BuildInfo in un protobuf.
`String`	`toString()`

Metodi protetti
`void`	`addAllBuildAttributes(BuildInfo build)` Metodo di supporto per copiare gli attributi, il ramo e il flavor di una build da un'altra build.
`void`	`addAllFiles(BuildInfo build)` Metodo di supporto per copiare tutti i file dall'altra compilazione.
`boolean`	`applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)` Consentire di applicare alcuni dei `IBuildInfo.BuildInfoProperties` e, eventualmente, di eseguire una gestione diversa.
`MultiMap<String, String>`	`getAttributesMultiMap()`
	`getVersionedFileMap()`
`MultiMap<String, VersionedFile>`	`getVersionedFileMapFull()`

Costruttori pubblici

BuildInfo

public BuildInfo ()

Crea un BuildInfo utilizzando i valori predefiniti degli attributi.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Crea un BuildInfo

Parametri
`buildId`	`String`: l'ID build
`buildTargetName`	`String`: il nome del target di compilazione

Metodi pubblici

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

Aggiungi un attributo di compilazione. Non è possibile eseguire l'override di un attributo esistente.

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Aggiungere attributi di compilazione

Parametri
`buildAttributes`	: mappa degli attributi da aggiungere

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Imposta l'autorizzazione per consentire l'organizzazione in anteprima dei file remoti.

Parametri
`stageRemoteFile`	`boolean`

cleanUp

public void cleanUp ()

Elimina eventuali file di compilazione temporanei

cleanUp

public void cleanUp ( doNotClean)

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

Parametri
`doNotClean`

clone

public IBuildInfo clone ()

Ritorni
`IBuildInfo`

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Copia tutti i VersionedFile da una determinata build a questa.

Parametri
`build`	`BuildInfo`

uguale

public boolean equals (Object obj)

Parametri
`obj`	`Object`

Ritorni
`boolean`

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Esegui l'operazione inversa a toProto() per recuperare l'istanza.

Parametri
`protoBuild`	`BuildInformation.BuildInfo`

Ritorni
`IBuildInfo`

getAppPackageFiles

public  getAppPackageFiles ()

Recupera una copia dell'insieme di file APK dell'app locale e delle relative versioni. L'ordine restituito corrisponde a quello in cui gli apk sono stati aggiunti a IAppBuildInfo.

Ritorni

getBuildAttributes

public  getBuildAttributes ()

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

Ritorni
	un `ERROR(/Map)` di attributi di build. Non sarà `null`, ma può essere vuoto.

getBuildBranch

public String getBuildBranch ()

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

Ritorni
`String`	il ramo di compilazione 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 è restituire (build product)-(build os)-(build variant). ad es. generic-linux-userdebug

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

getBuildId

public String getBuildId ()

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

Ritorni
`String`

getBuildTargetName

public String getBuildTargetName ()

Restituisce il nome completo della build in fase di test.

Un'implementazione comune è creare il nome del target di compilazione da una combinazione del nome del branch e del flavor di compilazione. [ad es. (nome ramo)-(flavor di build)]

Ritorni
`String`

getDeviceSerial

public String getDeviceSerial ()

Ritorni
`String`

getFile

public File getFile (String name)

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

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

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

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

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

getFiles

public  getFiles ()

Restituisce tutti i VersionedFile archiviati in questo BuildInfo.

Ritorni

getProperties

public  getProperties ()

Restituisce una copia delle proprietà attualmente impostate su IBuildInfo.

Ritorni

getRemoteFiles

public  getRemoteFiles ()

Visualizza i percorsi degli elementi della build di cui è stato ritardato il download.

Ritorni

getTestTag

public 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 una versione di un file con un determinato BuildInfoFileKey.

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

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

getVersion

public String getVersion (String name)

Metodo di supporto per recuperare una versione del 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`: il `BuildInfoFileKey` richiesto.

Ritorni
`VersionedFile`	Il file con versione o `null` se non trovato

getVersionedFile

public final VersionedFile getVersionedFile (String name)

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

Ritorni
`VersionedFile`	Il file con versione o `null` se non trovato

getVersionedFileKeys

public  getVersionedFileKeys ()

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

Ritorni

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Metodo di supporto 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.

Ritorni
	Il file con versione o `null` se non trovato

hashCode

public int hashCode ()

Ritorni
`int`

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovi un determinato attributo dal monitoraggio.

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

setBuildBranch

public void setBuildBranch (String branch)

Imposta il ramo di compilazione

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

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Imposta il tipo di build.

setBuildId

public void setBuildId (String buildId)

Imposta l'identificatore univoco della build in test. Non deve 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 del `ITestDevice` con cui è stata eseguita questa build.

setFile

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

Memorizza un file con il nome specificato in queste informazioni di compilazione.

Parametri
`name`	`String`: il 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)

Memorizza un file a cui è stato assegnato un BuildInfoFileKey in queste informazioni di compilazione.

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

setProperties

public void setProperties (BuildInfoProperties... properties)

Imposta BuildInfoProperties per l'istanza IBuildInfo. Sovrascrivi eventuali proprietà esistenti impostate in precedenza.

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

setTestTag

public void setTestTag (String testTag)

Imposta il nome univoco per i test in esecuzione.

Parametri
`testTag`	`String`

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Esegui la gestione delle fasi di un file che fa parte dei file remoti nella home directory delle informazioni di compilazione.

DA FARE(b/138416078): rimuovi questa interfaccia e il relativo chiamante quando i moduli richiesti da un test possono essere compilati correttamente nella directory del modulo di test stesso.

Parametri
`fileName`	`String`: il nome del file da individuare nei file remoti.
`workingDir`	`File`: un oggetto `ERROR(/File)` della directory in cui eseguire il commit del file.

Ritorni
`File`	L'oggetto `ERROR(/File)` del file sottoposto a staging in workingDir locale.

toProto

public BuildInformation.BuildInfo toProto ()

Serializza un'istanza BuildInfo in un protobuf.

Ritorni
`BuildInformation.BuildInfo`

toString

public String toString ()

Ritorni
`String`

Metodi protetti

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Metodo di supporto per copiare gli attributi, il ramo e il flavor di una build da un'altra build.

Parametri
`build`	`BuildInfo`

addAllFiles

protected void addAllFiles (BuildInfo build)

Metodo di supporto per copiare tutti i file dall'altra compilazione.

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

Parametri
`build`	`BuildInfo`

Lanci
	Se viene lanciata un'eccezione durante la creazione dell'hardlink.

applyBuildProperties

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

Consentire di applicare alcuni dei IBuildInfo.BuildInfoProperties e, eventualmente, di eseguire una gestione diversa.

Parametri
`origFileConsidered`	`VersionedFile`: l'elemento attualmente visualizzato `VersionedFile`.
`build`	`IBuildInfo`: la build originale da clonare
`receiver`	`IBuildInfo`: la build che riceve le informazioni.

Ritorni
`boolean`	Vero se abbiamo applicato le proprietà e l'ulteriore gestione deve essere saltata. Falso negli altri casi.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Ritorni
`MultiMap<String, String>`

getVersionedFileMap

protected  getVersionedFileMap ()

Ritorni

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Ritorni
`MultiMap<String, VersionedFile>`