À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer dans AOSP, utilisez android-latest-release. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à 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

Sous-classes indirectes connues

AndroidBuildDownloader, CasFileDownloader, FileDownloadCacheWrapper, GCSFileDownloader

AndroidBuildDownloader	Un `IFileDownloader` qui récupère les fichiers de l'API Android Build.
CasFileDownloader	Téléchargeur de fichiers permettant de télécharger des fichiers depuis RBE CAS.
FileDownloadCacheWrapper	Classe wrapper qui fournit des fonctionnalités `FileDownloadCache` tout en implémentant l'interface `IFileDownloader`.
GCSFileDownloader	Téléchargeur de fichiers permettant de télécharger des fichiers depuis Google Cloud Storage (GCS).

Interface permettant de télécharger un fichier distant.

Résumé

Méthodes publiques
`default void`	`acquireDownloadPermit()` Si la limite de simultanéité est acceptée, obtenez un permis de téléchargement.
`default void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` Forme alternative de `downloadFile(String,File)`, qui permet à l'appelant de télécharger une section du fichier et de l'enregistrer dans un fichier de destination spécifique.
`abstract void`	`downloadFile(String relativeRemotePath, File destFile)` Forme alternative de `downloadFile(String)`, qui permet à l'appelant de spécifier le fichier de destination dans lequel le contenu distant doit être placé.
`abstract File`	`downloadFile(String remoteFilePath)` Télécharge un fichier distant dans un fichier temporaire sur le disque local.
`default void`	`downloadZippedFiles(File destDir, String remoteFilePath, List<String> includeFilters, List<String> excludeFilters)` Téléchargez les fichiers correspondant aux filtres indiqués dans un fichier ZIP distant.
`default boolean`	`isFresh(File localFile, String remoteFilePath)` Vérifiez la fraîcheur du fichier local.
`default void`	`releaseDownloadPermit()` Si la limite de simultanéité est acceptée, libérez un bon de téléchargement.

Méthodes publiques

acquireDownloadPermit

public void acquireDownloadPermit ()

Si la limite de simultanéité est acceptée, obtenez un permis de téléchargement.

downloadFile

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

Forme alternative de downloadFile(String,File), qui permet à l'appelant de télécharger une section du fichier et de l'enregistrer dans un fichier de destination spécifique.

Paramètres
`remoteFilePath`	`String` : chemin d'accès distant au fichier à télécharger, par rapport à une racine spécifique à l'implémentation.
`destFile`	`File` : fichier dans lequel placer le contenu téléchargé. Ne doit pas exister.
`startOffset`	`long` : décalage de début dans le fichier distant.
`size`	`long` : nombre d'octets à télécharger à partir du fichier distant. Définissez-la sur une valeur négative pour télécharger l'intégralité du fichier.

Génère
`BuildRetrievalError`	si le fichier n'a pas pu être téléchargé ;

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

Forme alternative de downloadFile(String), qui permet à l'appelant de spécifier le fichier de destination dans lequel le contenu distant doit être placé.

Paramètres
`relativeRemotePath`	`String` : chemin d'accès distant au fichier à télécharger, par rapport à une racine spécifique à l'implémentation.
`destFile`	`File` : fichier dans lequel placer le contenu téléchargé. Ne doit pas exister.

Génère
`BuildRetrievalError`	si le fichier n'a pas pu être téléchargé ;

downloadFile

public abstract File downloadFile (String remoteFilePath)

Télécharge un fichier distant dans un fichier temporaire sur le disque local.

Paramètres
`remoteFilePath`	`String` : chemin d'accès distant au fichier à télécharger, par rapport à une racine spécifique à l'implémentation.

Renvoie
`File`	le fichier `File` temporaire téléchargé localement.

Génère
`BuildRetrievalError`	si le fichier n'a pas pu être téléchargé ;

downloadZippedFiles

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

Téléchargez les fichiers correspondant aux filtres indiqués dans un fichier ZIP distant.

Un fichier à l'intérieur du fichier ZIP distant n'est téléchargé que si son chemin d'accès correspond à l'un des filtres d'inclusion, mais pas aux filtres d'exclusion.

Paramètres
`destDir`	`File` : fichier dans lequel placer le contenu téléchargé.
`remoteFilePath`	`String` : chemin d'accès distant au fichier à télécharger, par rapport à une racine spécifique à l'implémentation.
`includeFilters`	`List` : liste des filtres permettant de télécharger les fichiers correspondants.
`excludeFilters`	`List` : liste des filtres permettant d'ignorer le téléchargement des fichiers correspondants.

Génère
`BuildRetrievalError`	si les fichiers n'ont pas pu être téléchargés.
	java.io.IOException
`IOException`

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

Vérifiez la fraîcheur du fichier local. Si le fichier local est identique au fichier distant, il est à jour. Sinon, le fichier local est obsolète. Elle est principalement utilisée pour le cache. L'implémentation par défaut renvoie toujours la valeur "true". Par conséquent, si le fichier est immuable, il n'est jamais nécessaire de vérifier sa fraîcheur.

Paramètres
`localFile`	`File` : fichier local.
`remoteFilePath`	`String` : chemin d'accès au fichier distant.

Renvoie
`boolean`	"True" si le fichier local est à jour, "false" dans le cas contraire.

Génère
	com.android.tradefed.build.BuildRetrievalError
`BuildRetrievalError`

releaseDownloadPermit

public void releaseDownloadPermit ()

Si la limite de simultanéité est acceptée, libérez un bon de téléchargement.