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.

IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Classi di sottoclasse indirette note

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

AppBuildInfo	Un `IBuildInfo` che rappresenta un'applicazione per Android e i relativi pacchetti di test.
AppDeviceBuildInfo	Questa classe è stata ritirata. Utilizza direttamente `IDeviceBuildInfo`.
BuildInfo	Implementazione generica di un `IBuildInfo` che deve essere associato a un `ITestDevice`.
ClusterBuildInfo	Una classe `IBuildInfo` per le build incanalate da TFC.
DeviceBuildInfo	Un `IBuildInfo` che rappresenta una build completa del dispositivo Android e (facoltativamente) i relativi test.
DeviceFolderBuildInfo	Un `IDeviceBuildInfo` che contiene anche altri elementi di compilazione contenuti in una directory sul file system locale.
FolderBuildInfo	Implementazione concreta di un `IFolderBuildInfo`.
IAppBuildInfo	Questa interfaccia è stata ritirata. Utilizza direttamente `IBuildInfo`.
IDeviceBuildInfo	Un `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	Un `IDeviceBuildInfo` utilizzato per i test degli aggiornamenti over-the-air.
OtatoolsBuildInfo	Un `IBuildInfo` contenente gli artefatti di otatools.

Contiene informazioni sulla build in test.

Riepilogo

Costanti
`String`	`REMOTE_FILE_PREFIX` Prefisso utilizzato nel nome per indicare che il download del file è impostato come ritardato.
`String`	`REMOTE_FILE_VERSION` Il file remoto non è sottoposto a controllo della 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 relativa versione associata.
`abstract void`	`addBuildAttribute(String attributeName, String attributeValue)` Aggiungi un attributo di compilazione.
`default void`	`addBuildAttributes( buildAttributes)` Aggiungere attributi di compilazione
`default void`	`allowStagingRemoteFile(boolean stageRemoteFile)` Imposta l'autorizzazione per consentire l'organizzazione in anteprima dei file remoti.
`abstract void`	`cleanUp()` Elimina eventuali file di compilazione 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 dell'insieme di file APK dell'app locale e delle relative versioni.
`abstract`	`getBuildAttributes()` Ottieni un insieme di coppie nome-valore di attributi aggiuntivi che descrivono la compilazione.
`abstract String`	`getBuildBranch()` Metodo facoltativo per restituire il ramo del controllo dell'origine 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 in 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 un nome specificato.
`default File`	`getFile(BuildInfoKey.BuildInfoFileKey key)` Metodo di supporto per recuperare un file con un determinato `BuildInfoFileKey`.
`abstract`	`getFiles()` Restituisce tutti i `VersionedFile` archiviati in questo `BuildInfo`.
`abstract`	`getProperties()` Restituisce una copia delle proprietà attualmente impostate su `IBuildInfo`.
`default`	`getRemoteFiles()` Visualizza i percorsi degli elementi della build di cui è stato ritardato il download.
`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 di un file con un determinato `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 l'insieme 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 determinato attributo dal monitoraggio.
`abstract void`	`setBuildBranch(String branch)` Imposta il ramo di compilazione
`abstract void`	`setBuildFlavor(String buildFlavor)` Imposta il tipo di build.
`abstract void`	`setBuildId(String buildId)` Imposta l'identificatore univoco della build in test.
`abstract void`	`setDeviceSerial(String serial)` Imposta il numero di serie `ITestDevice` associato a questa build.
`abstract void`	`setFile(String name, File file, String version)` Memorizza un file con il nome specificato in queste informazioni di compilazione.
`default void`	`setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)` Memorizza un file a cui è stato assegnato un `BuildInfoFileKey` in queste informazioni di compilazione.
`abstract void`	`setProperties(BuildInfoProperties... properties)` Imposta `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)` Esegui la gestione delle fasi di un file che fa parte dei file remoti nella home directory delle informazioni di compilazione.
`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 download del file è impostato come ritardato.

Valore costante: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Il file remoto non è sottoposto a controllo della 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 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 abstract 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 abstract void cleanUp ()

Elimina eventuali file di compilazione temporanei

cleanUp

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.

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 abstract  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 abstract 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 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). ad es. generic-linux-userdebug

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

getBuildId

public abstract 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 abstract 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 abstract String getDeviceSerial ()

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

getFile

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

Restituisce tutti i VersionedFile archiviati in questo BuildInfo.

Ritorni

getProperties

public abstract  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 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 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 abstract 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 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  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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Rimuovi un determinato attributo dal monitoraggio.

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

setBuildBranch

public abstract void setBuildBranch (String branch)

Imposta il ramo di compilazione

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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Imposta il tipo di build.

setBuildId

public abstract void setBuildId (String buildId)

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

Parametri
`buildId`	`String`

setDeviceSerial

public abstract 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 abstract 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 abstract 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 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)

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`