À 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.

ZipUtil

public class ZipUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.ZipUtil

Classe d'assistance pour les opérations liées à la compression

Résumé

Constructeurs publics
`ZipUtil()`

Méthodes publiques
`static void`	`addToZip(ZipOutputStream out, File file, relativePathSegs)` Ajoute de manière récursive le fichier donné et son contenu à ZipOutputStream.
`static void`	`applyPermission(File targetFile, CentralDirectoryInfo zipEntry)` Appliquez l'autorisation de fichier configurée dans l'entrée du répertoire central.
`static void`	`closeZip(ZipFile zipFile)` Fermez un `ERROR(/ZipFile)` ouvert, en ignorant toutes les exceptions.
`static File`	`createZip(File dir)` Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant le répertoire donné et tout son contenu.
`static File`	`createZip( files, String name)` Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant les fichiers donnés.
`static File`	`createZip(File dir, String name)` Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant le répertoire donné et tout son contenu.
`static File`	`createZip( files)` Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant les fichiers donnés
`static void`	`createZip(File dir, File zipFile)` Méthode utilitaire permettant de créer un fichier ZIP contenant le répertoire donné et tout son contenu.
`static void`	`createZip( files, File zipFile)` Méthode utilitaire permettant de créer un fichier ZIP contenant les fichiers donnés
`static File`	`extractFileFromZip(ZipFile zipFile, String filePath)` Méthode utilitaire permettant d'extraire un fichier spécifique d'un fichier ZIP dans un fichier temporaire
`static void`	`extractZip(ZipFile zipFile, File destDir)` Méthode d'utilitaire permettant d'extraire l'intégralité du contenu d'un fichier ZIP dans un répertoire donné
`static void`	`extractZip(ZipFile zipFile, File destDir, shouldExtract)` Méthode d'utilitaire permettant d'extraire le contenu d'un fichier ZIP dans un répertoire donné
`static File`	`extractZipToTemp(File zipFile, String nameHint)` Extraire un fichier ZIP dans un répertoire temporaire précédé d'une chaîne
`static`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, boolean useZip64)` Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers d'un fichier ZIP.
`static`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset)` Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers d'un fichier ZIP.
`static`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo)` Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers d'un fichier ZIP.
`static`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset, boolean useZip64)` Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers d'un fichier ZIP.
`static void`	`gzipFile(File file, File gzipFile)` Méthode d'assistance permettant de créer une version compressée gzip d'un seul fichier.
`static boolean`	`isZipFileValid(File zipFile, boolean thorough)` Méthode d'utilitaire permettant de vérifier qu'un fichier ZIP n'est pas corrompu.
`static void`	`unzipPartialZipFile(File partialZip, File targetFile, CentralDirectoryInfo zipEntry, LocalFileHeader localFileHeader, long startOffset)` Extrayez un seul fichier demandé à partir d'un fichier ZIP partiel.
`static void`	`unzipPartialZipFolder(File targetFile, CentralDirectoryInfo zipEntry)` Extrayez le dossier demandé à partir d'un fichier ZIP partiel et appliquez l'autorisation appropriée.

Méthodes protégées
`static void`	`validateDestinationDir(File destDir, String filename)`

Constructeurs publics

ZipUtil

public ZipUtil ()

Méthodes publiques

addToZip

public static void addToZip (ZipOutputStream out, 
                File file, 
                 relativePathSegs)

Ajoute de manière récursive le fichier donné et son contenu à ZipOutputStream.

Paramètres
`out`	`ZipOutputStream`: `ERROR(/ZipOutputStream)`
`file`	`File`: `ERROR(/File)` à ajouter au flux
`relativePathSegs`	: chemin relatif du fichier, y compris les séparateurs

Génère
	si l'ajout du fichier au fichier ZIP a échoué

applyPermission

public static void applyPermission (File targetFile, 
                CentralDirectoryInfo zipEntry)

Appliquez l'autorisation de fichier configurée dans l'entrée du répertoire central.

Paramètres
`targetFile`	`File`: `ERROR(/File)` à définir pour l'autorisation.
`zipEntry`	`CentralDirectoryInfo`: objet `CentralDirectoryInfo` contenant les autorisations de fichier.

Génère
	en cas d'échec de l'accès au fichier.

closeZip

public static void closeZip (ZipFile zipFile)

Fermez un ERROR(/ZipFile) ouvert, en ignorant toutes les exceptions.

Paramètres
`zipFile`	`ZipFile`: fichier à fermer

createZip

public static File createZip (File dir)

Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant le répertoire donné et tout son contenu.

Paramètres
`dir`	`File`: répertoire à compresser

Renvoie
`File`	un fichier ZIP `ERROR(/File)` temporaire contenant le contenu du répertoire

Génère
	si la création du fichier ZIP échoue

createZip

public static File createZip ( files, 
                String name)

Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant les fichiers donnés.

Paramètres
`files`	: liste des fichiers à compresser
`name`	`String`: nom de base du fichier ZIP créé sans extension.

Renvoie
`File`	un fichier ZIP `ERROR(/File)` temporaire contenant le contenu du répertoire

Génère
	si la création du fichier ZIP échoue

createZip

public static File createZip (File dir, 
                String name)

Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant le répertoire donné et tout son contenu.

Paramètres
`dir`	`File`: répertoire à compresser
`name`	`String`: nom de base du fichier ZIP créé sans extension.

Renvoie
`File`	un fichier ZIP `ERROR(/File)` temporaire contenant le contenu du répertoire

Génère
	si la création du fichier ZIP échoue

createZip

public static File createZip ( files)

Méthode utilitaire permettant de créer un fichier ZIP temporaire contenant les fichiers donnés

Paramètres
`files`	: liste des fichiers à compresser

Renvoie
`File`	un fichier ZIP `ERROR(/File)` temporaire contenant le contenu du répertoire

Génère
	si la création du fichier ZIP échoue

createZip

public static void createZip (File dir, 
                File zipFile)

Méthode utilitaire permettant de créer un fichier ZIP contenant le répertoire donné et tout son contenu.

Paramètres
`dir`	`File`: répertoire à compresser
`zipFile`	`File`: le fichier ZIP à créer (il ne doit pas exister déjà)

Génère
	si la création du fichier ZIP échoue

createZip

public static void createZip ( files, 
                File zipFile)

Méthode utilitaire permettant de créer un fichier ZIP contenant les fichiers donnés

Paramètres
`files`	: liste des fichiers à compresser
`zipFile`	`File`: le fichier ZIP à créer (il ne doit pas exister déjà)

Génère
	si la création du fichier ZIP échoue

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

Méthode utilitaire permettant d'extraire un fichier spécifique d'un fichier ZIP dans un fichier temporaire

Paramètres
`zipFile`	`ZipFile`: `ERROR(/ZipFile)` à extraire
`filePath`	`String`: chemin d'accès du fichier à extraire

Renvoie
`File`	l'`ERROR(/File)` ou une valeur nulle si elle est introuvable

Génère
	si l'extraction du fichier a échoué

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

Méthode d'utilitaire permettant d'extraire l'intégralité du contenu d'un fichier ZIP dans un répertoire donné

Paramètres
`zipFile`	`ZipFile`: `ERROR(/ZipFile)` à extraire
`destDir`	`File`: répertoire local dans lequel extraire le fichier

Génère
	si l'extraction du fichier a échoué

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir, 
                 shouldExtract)

Méthode d'utilitaire permettant d'extraire le contenu d'un fichier ZIP dans un répertoire donné

Paramètres
`zipFile`	`ZipFile`: `ERROR(/ZipFile)` à extraire
`destDir`	`File`: répertoire local dans lequel extraire le fichier
`shouldExtract`	: prédicat permettant de déterminer si un élément ZipEntry doit être extrait

Génère
	si l'extraction du fichier a échoué

extractZipToTemp

public static File extractZipToTemp (File zipFile, 
                String nameHint)

Extraire un fichier ZIP dans un répertoire temporaire précédé d'une chaîne

Paramètres
`zipFile`	`File`: fichier ZIP à extraire
`nameHint`	`String`: préfixe du répertoire temporaire

Renvoie
`File`	un `ERROR(/File)` pointant vers le répertoire temporaire

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                boolean useZip64)

Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers d'un fichier ZIP.

Paramètres
`partialZipFile`	`File`: objet `ERROR(/File)` du fichier ZIP partiel contenant des entrées de répertoire central.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: objet `EndCentralDirectoryInfo` du fichier ZIP.
`useZip64`	`boolean`: valeur booléenne permettant de prendre en charge le format zip64 lors d'un téléchargement partiel.

Renvoie
	Liste des `CentralDirectoryInfo` du fichier ZIP

Génère
	IOException

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                long offset)

Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers d'un fichier ZIP.

Paramètres
`partialZipFile`	`File`: objet `ERROR(/File)` du fichier ZIP partiel contenant des entrées de répertoire central.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: objet `EndCentralDirectoryInfo` du fichier ZIP.
`offset`	`long`: décalage dans le fichier ZIP partiel où commence le contenu des entrées du répertoire central.

Renvoie
	Liste des `CentralDirectoryInfo` du fichier ZIP

Génère
	IOException

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo)

Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers d'un fichier ZIP.

Paramètres
`partialZipFile`	`File`: objet `ERROR(/File)` du fichier ZIP partiel contenant des entrées de répertoire central.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: objet `EndCentralDirectoryInfo` du fichier ZIP.

Renvoie
	Liste des `CentralDirectoryInfo` du fichier ZIP

Génère
	IOException

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                long offset, 
                boolean useZip64)

Obtenez une liste de {link CentralDirectoryInfo} pour les fichiers d'un fichier ZIP.

Paramètres
`partialZipFile`	`File`: objet `ERROR(/File)` du fichier ZIP partiel contenant des entrées de répertoire central.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: objet `EndCentralDirectoryInfo` du fichier ZIP.
`offset`	`long`: décalage dans le fichier ZIP partiel où commence le contenu des entrées du répertoire central.
`useZip64`	`boolean`: valeur booléenne permettant de prendre en charge le format zip64 lors d'un téléchargement partiel.

Renvoie
	Liste des `CentralDirectoryInfo` du fichier ZIP

Génère
	IOException

gzipFile

public static void gzipFile (File file, 
                File gzipFile)

Méthode d'assistance permettant de créer une version compressée gzip d'un seul fichier.

Paramètres
`file`	`File`: fichier d'origine
`gzipFile`	`File`: fichier dans lequel placer le contenu compressé

Génère
	IOException

isZipFileValid

public static boolean isZipFileValid (File zipFile, 
                boolean thorough)

Méthode d'utilitaire permettant de vérifier qu'un fichier ZIP n'est pas corrompu.

Paramètres
`zipFile`	`File`: `ERROR(/File)` à vérifier
`thorough`	`boolean`: indique si l'archive doit être entièrement extraite. Si la valeur est `false`, cette méthode ne détectera pas les erreurs de CRC dans une archive bien structurée.

Renvoie
`boolean`	`false` si le fichier semble corrompu, `true` dans le cas contraire

Génère
	si le fichier n'a pas pu être ouvert ni lu

unzipPartialZipFile

public static void unzipPartialZipFile (File partialZip, 
                File targetFile, 
                CentralDirectoryInfo zipEntry, 
                LocalFileHeader localFileHeader, 
                long startOffset)

Extrayez un seul fichier demandé à partir d'un fichier ZIP partiel.

Cette méthode suppose que tous les fichiers se trouvent sur le même disque lors de la compression.

Si ERROR(/targetFile) est un répertoire, un répertoire vide sera créé sans son contenu.

Si ERROR(/targetFile) est un lien symbolique, un lien symbolique est créé, mais pas résolu.

Elle n'est pas encore compatible avec les fonctionnalités suivantes:

Fichier ZIP de plus de 4 Go

ZIP64(nécessite la mise à jour de ZipLocalFileHeader sur la taille compressée)

Fichier ZIP chiffré

Paramètres
`partialZip`	`File`: `ERROR(/File)` partiel du fichier ZIP.
`targetFile`	`File`: `ERROR(/File)` dans lequel enregistrer le fichier extrait.
`zipEntry`	`CentralDirectoryInfo`: objet `CentralDirectoryInfo` du fichier à extraire du fichier ZIP partiel.
`localFileHeader`	`LocalFileHeader`: objet `LocalFileHeader` du fichier à extraire du fichier ZIP partiel.
`startOffset`	`long`: décalage de début du fichier à extraire.

Génère
	IOException

unzipPartialZipFolder

public static void unzipPartialZipFolder (File targetFile, 
                CentralDirectoryInfo zipEntry)

Extrayez le dossier demandé à partir d'un fichier ZIP partiel et appliquez l'autorisation appropriée.

Paramètres
`targetFile`	`File`: `ERROR(/File)` dans lequel enregistrer le fichier extrait.
`zipEntry`	`CentralDirectoryInfo`: objet `CentralDirectoryInfo` du fichier à extraire du fichier ZIP partiel.

Génère
	IOException

Méthodes protégées

validateDestinationDir

protected static void validateDestinationDir (File destDir, 
                String filename)

Paramètres
`destDir`	`File`
`filename`	`String`