À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

Sous-classes indirectes connues

FileDownloadCacheWrapper, GCSFileDownloader

FileDownloadCacheWrapper	Classe wrapper qui fournit des fonctionnalités `FileDownloadCache` lors de l'implémentation de 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 prise en charge, obtenez une autorisation de téléchargement.
`default void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` Autre forme 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, includeFilters, excludeFilters)` Téléchargez les fichiers correspondant aux filtres donnés dans un fichier ZIP distant.
`default boolean`	`isFresh(File localFile, String remoteFilePath)` Vérifiez l'actualisation du fichier local.
`default void`	`releaseDownloadPermit()` Si la limite de simultanéité est prise en charge, libérez une autorisation de téléchargement.

Méthodes publiques

acquireDownloadPermit

public void acquireDownloadPermit ()

Si la limite de simultanéité est prise en charge, obtenez une autorisation de téléchargement.

downloadFile

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

Autre forme 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-le 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 `ERROR(/File)` local temporaire téléchargé.

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

downloadZippedFiles

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

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

Un fichier dans le 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`	: liste des filtres permettant de télécharger les fichiers correspondants.
`excludeFilters`	: liste de filtres pour ignorer le téléchargement des fichiers correspondants.

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

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

Vérifiez l'actualisation du fichier local. Si le fichier local est identique au fichier distant, il est à jour. Sinon, le fichier local est obsolète. Il est principalement utilisé pour le cache. L'implémentation par défaut renvoie toujours "true". Par conséquent, si le fichier est immuable, il n'a jamais besoin 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 prise en charge, libérez une autorisation de téléchargement.