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.

IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

Known indirect subclasses

AndroidBuildDownloader, CasFileDownloader, FileDownloadCacheWrapper, GCSFileDownloader

AndroidBuildDownloader	A `IFileDownloader` that retrieves files from the Android Build API.
CasFileDownloader	File downloader to download files from RBE CAS.
FileDownloadCacheWrapper	A wrapper class that provides `FileDownloadCache` facilities while implementing the `IFileDownloader` interface.
GCSFileDownloader	File downloader to download file from google cloud storage (GCS).

Interfaccia per il download di un file remoto.

Riepilogo

Metodi pubblici
`default void`	`acquireDownloadPermit()` Se il limite di concorrenza è supportato, richiedi un'autorizzazione di download.
`default void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` Forma alternativa di `downloadFile(String,File)`, che consente al chiamante di scaricare una sezione del file e salvarla in un file di destinazione specifico.
`abstract void`	`downloadFile(String relativeRemotePath, File destFile)` Forma alternativa di `downloadFile(String)`, che consente al chiamante di specificare il file di destinazione in cui inserire i contenuti remoti.
`abstract File`	`downloadFile(String remoteFilePath)` Scarica un file remoto in un file temporaneo sul disco locale.
`default void`	`downloadZippedFiles(File destDir, String remoteFilePath, List<String> includeFilters, List<String> excludeFilters)` Scarica i file che corrispondono ai filtri specificati in un file ZIP remoto.
`default boolean`	`isFresh(File localFile, String remoteFilePath)` Controlla la freschezza del file locale.
`default void`	`releaseDownloadPermit()` Se il limite di concorrenza è supportato, rilascia un'autorizzazione di download.

Metodi pubblici

acquireDownloadPermit

public void acquireDownloadPermit ()

Se il limite di concorrenza è supportato, richiedi un'autorizzazione di download.

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile, 
                long startOffset, 
                long size)

Forma alternativa di downloadFile(String,File), che consente al chiamante di scaricare una sezione del file e salvarla in un file di destinazione specifico.

Parametri
`remoteFilePath`	`String`: il percorso remoto del file da scaricare, relativo a una root specifica dell'implementazione.
`destFile`	`File`: il file in cui inserire i contenuti scaricati. Non deve esistere.
`startOffset`	`long`: l'offset iniziale nel file remoto.
`size`	`long`: il numero di byte da scaricare dal file remoto. Imposta un valore negativo per scaricare l'intero file.

Genera
`BuildRetrievalError`	se non è stato possibile scaricare il file

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

Forma alternativa di downloadFile(String), che consente al chiamante di specificare il file di destinazione in cui inserire i contenuti remoti.

Parametri
`relativeRemotePath`	`String`: il percorso remoto del file da scaricare, relativo a una root specifica dell'implementazione.
`destFile`	`File`: il file in cui inserire i contenuti scaricati. Non deve esistere.

Genera
`BuildRetrievalError`	se non è stato possibile scaricare il file

downloadFile

public abstract File downloadFile (String remoteFilePath)

Scarica un file remoto in un file temporaneo sul disco locale.

Parametri
`remoteFilePath`	`String`: il percorso remoto del file da scaricare, relativo a una root specifica dell'implementazione.

Resi
`File`	il `File` temporaneo scaricato localmente.

Genera
`BuildRetrievalError`	se non è stato possibile scaricare il file

downloadZippedFiles

public void downloadZippedFiles (File destDir, 
                String remoteFilePath, 
                List<String> includeFilters, 
                List<String> excludeFilters)

Scarica i file che corrispondono ai filtri specificati in un file ZIP remoto.

Un file all'interno del file ZIP remoto viene scaricato solo se il relativo percorso corrisponde a uno dei filtri di inclusione, ma non ai filtri di esclusione.

Parametri
`destDir`	`File`: il file in cui inserire i contenuti scaricati.
`remoteFilePath`	`String`: il percorso remoto del file da scaricare, relativo a una root specifica dell'implementazione.
`includeFilters`	`List`: un elenco di filtri per scaricare i file corrispondenti.
`excludeFilters`	`List`: un elenco di filtri per saltare il download dei file corrispondenti.

Genera
`BuildRetrievalError`	se non è stato possibile scaricare i file.
	java.io.IOException
`IOException`

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

Controlla la freschezza del file locale. Se il file locale è uguale al file remoto, è fresco. In caso contrario, il file locale è obsoleto. Viene utilizzato principalmente per la cache. L'implementazione predefinita restituirà sempre true, quindi se il file è immutabile non sarà mai necessario controllare la freschezza.

Parametri
`localFile`	`File`: file locale.
`remoteFilePath`	`String`: percorso del file remoto.

Resi
`boolean`	Vero se il file locale è fresco, falso in caso contrario.

Genera
	com.android.tradefed.build.BuildRetrievalError
`BuildRetrievalError`

releaseDownloadPermit

public void releaseDownloadPermit ()

Se il limite di concorrenza è supportato, rilascia un'autorizzazione di download.