此页面由 Cloud Translation API 翻译。

压缩工具

public class ZipUtil
extends Object

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

压缩相关操作的辅助类

概括

公共构造函数
`ZipUtil ()`

公共方法
`static void`	`addToZip (ZipOutputStream out, File file, relativePathSegs)` `addToZip (ZipOutputStream out, File file, relativePathSegs)` 递归地将给定文件及其内容添加到 ZipOutputStream
`static void`	`applyPermission (File targetFile, CentralDirectoryInfo zipEntry)` 应用在中央目录条目中配置的文件权限。
`static void`	`closeZip (ZipFile zipFile)` 关闭打开的`ERROR(/ZipFile)` ，忽略任何异常。
`static File`	`createZip (File dir)` 用于创建包含给定目录及其所有内容的临时 zip 文件的实用方法。
`static File`	`createZip ( files, String name)` `createZip ( files, String name)` 创建包含给定文件的临时 zip 文件的实用方法。
`static File`	`createZip (File dir, String name)` 用于创建包含给定目录及其所有内容的临时 zip 文件的实用方法。
`static File`	`createZip ( files)` `createZip ( files)` 创建包含给定文件的临时 zip 文件的实用方法
`static void`	`createZip (File dir, File zipFile)` 创建包含给定目录及其所有内容的 zip 文件的实用方法。
`static void`	`createZip ( files, File zipFile)` `createZip ( files, File zipFile)` 创建包含给定文件的 zip 文件的实用方法
`static File`	`extractFileFromZip (ZipFile zipFile, String filePath)` 将一个特定文件从 zip 文件提取到 tmp 文件的实用方法
`static void`	`extractZip (ZipFile zipFile, File destDir)` 将 zip 文件的全部内容提取到给定目录的实用方法
`static void`	`extractZip (ZipFile zipFile, File destDir, shouldExtract)` `extractZip (ZipFile zipFile, File destDir, shouldExtract)` 将 zip 文件的内容提取到给定目录的实用方法
`static File`	`extractZipToTemp (File zipFile, String nameHint)` 将一个 zip 文件解压缩到一个以字符串为前缀的临时目录
`static`	`getZipCentralDirectoryInfos (File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, boolean useZip64)` 获取 zip 文件中文件的 {link CentralDirectoryInfo} 列表。
`static`	`getZipCentralDirectoryInfos (File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset)` 获取 zip 文件中文件的 {link CentralDirectoryInfo} 列表。
`static`	`getZipCentralDirectoryInfos (File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo)` 获取 zip 文件中文件的 {link CentralDirectoryInfo} 列表。
`static`	`getZipCentralDirectoryInfos (File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset, boolean useZip64)` 获取 zip 文件中文件的 {link CentralDirectoryInfo} 列表。
`static void`	`gzipFile (File file, File gzipFile)` 创建单个文件的 gzip 版本的帮助程序方法。
`static boolean`	`isZipFileValid (File zipFile, boolean thorough)` 验证 zip 文件未损坏的实用方法。
`static void`	`unzipPartialZipFile (File partialZip, File targetFile, CentralDirectoryInfo zipEntry, LocalFileHeader localFileHeader, long startOffset)` 从部分 zip 文件中提取请求的文件。
`static void`	`unzipPartialZipFolder (File targetFile, CentralDirectoryInfo zipEntry)` 从部分 zip 文件中提取请求的文件夹并应用适当的权限。

公共构造函数

压缩工具

public ZipUtil ()

公共方法

添加到压缩包

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

递归地将给定文件及其内容添加到 ZipOutputStream

参数
`out`	`ZipOutputStream` : `ERROR(/ZipOutputStream)`
`file`	`File` ：要添加到流中的`ERROR(/File)`
`relativePathSegs`	: 文件的相对路径，包括分隔符

投掷
	如果无法将文件添加到 zip

申请权限

public static void applyPermission (File targetFile, 
                CentralDirectoryInfo zipEntry)

应用在中央目录条目中配置的文件权限。

参数
`targetFile`	`File` ：要设置权限的`ERROR(/File)` 。
`zipEntry`	`CentralDirectoryInfo` ：包含文件权限的`CentralDirectoryInfo`对象。

投掷
	如果无法访问该文件。

关闭压缩包

public static void closeZip (ZipFile zipFile)

关闭打开的ERROR(/ZipFile) ，忽略任何异常。

参数
`zipFile`	`ZipFile` ：要关闭的文件

创建Zip

public static File createZip (File dir)

用于创建包含给定目录及其所有内容的临时 zip 文件的实用方法。

参数
`dir`	`File` ：要压缩的目录

退货
`File`	包含目录内容的临时 zip `ERROR(/File)`

投掷
	如果创建 zip 文件失败

创建Zip

public static File createZip ( files, 
                String name)

创建包含给定文件的临时 zip 文件的实用方法。

参数
`files`	: 要压缩的文件列表
`name`	`String` ：创建的不带扩展名的 zip 文件的基本名称。

退货
`File`	包含目录内容的临时 zip `ERROR(/File)`

投掷
	如果创建 zip 文件失败

创建Zip

public static File createZip (File dir, 
                String name)

用于创建包含给定目录及其所有内容的临时 zip 文件的实用方法。

参数
`dir`	`File` ：要压缩的目录
`name`	`String` ：创建的不带扩展名的 zip 文件的基本名称。

退货
`File`	包含目录内容的临时 zip `ERROR(/File)`

投掷
	如果创建 zip 文件失败

创建Zip

public static File createZip ( files)

创建包含给定文件的临时 zip 文件的实用方法

参数
`files`	: 要压缩的文件列表

退货
`File`	包含目录内容的临时 zip `ERROR(/File)`

投掷
	如果创建 zip 文件失败

创建Zip

public static void createZip (File dir, 
                File zipFile)

创建包含给定目录及其所有内容的 zip 文件的实用方法。

参数
`dir`	`File` ：要压缩的目录
`zipFile`	`File` ：要创建的 zip 文件 - 它不应该已经存在

投掷
	如果创建 zip 文件失败

创建Zip

public static void createZip ( files, 
                File zipFile)

创建包含给定文件的 zip 文件的实用方法

参数
`files`	: 要压缩的文件列表
`zipFile`	`File` ：要创建的 zip 文件 - 它不应该已经存在

投掷
	如果创建 zip 文件失败

从 Zip 中提取文件

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

将一个特定文件从 zip 文件提取到 tmp 文件的实用方法

参数
`zipFile`	`ZipFile` ：要提取的`ERROR(/ZipFile)`
`filePath`	`String` : 要提取的文件路径

退货
`File`	`ERROR(/File)`或 null（如果未找到）

投掷
	如果无法提取文件

解压缩

public static void extractZip (ZipFile zipFile, 
                File destDir)

将 zip 文件的全部内容提取到给定目录的实用方法

参数
`zipFile`	`ZipFile` ：要提取的`ERROR(/ZipFile)`
`destDir`	`File` ：将文件提取到的本地目录

投掷
	如果无法提取文件

解压缩

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

将 zip 文件的内容提取到给定目录的实用方法

参数
`zipFile`	`ZipFile` ：要提取的`ERROR(/ZipFile)`
`destDir`	`File` ：将文件提取到的本地目录
`shouldExtract`	: 如果 ZipEntry 应该被提取，则要进行 dermine 的谓词

投掷
	如果无法提取文件

extractZipToTemp

public static File extractZipToTemp (File zipFile, 
                String nameHint)

将一个 zip 文件解压缩到一个以字符串为前缀的临时目录

参数
`zipFile`	`File` ：要提取的 zip 文件
`nameHint`	`String` ：临时目录的前缀

退货
`File`	指向临时目录的`ERROR(/File)`

getZipCentralDirectoryInfos

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

获取 zip 文件中文件的 {link CentralDirectoryInfo} 列表。

参数
`partialZipFile`	`File` ：包含中央目录条目的部分 zip 文件的`ERROR(/File)`对象。
`endCentralDirInfo`	`EndCentralDirectoryInfo` ：压缩文件的`EndCentralDirectoryInfo`对象。
`useZip64`	`boolean` : 在部分下载中支持 zip64 格式的布尔值。

退货
	zip 文件的`CentralDirectoryInfo`列表

投掷
	异常

getZipCentralDirectoryInfos

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

获取 zip 文件中文件的 {link CentralDirectoryInfo} 列表。

参数
`partialZipFile`	`File` ：包含中央目录条目的部分 zip 文件的`ERROR(/File)`对象。
`endCentralDirInfo`	`EndCentralDirectoryInfo` ：压缩文件的`EndCentralDirectoryInfo`对象。
`offset`	`long` ：部分 zip 文件中中央目录条目内容开始的偏移量。

退货
	zip 文件的`CentralDirectoryInfo`列表

投掷
	异常

getZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo)

获取 zip 文件中文件的 {link CentralDirectoryInfo} 列表。

参数
`partialZipFile`	`File` ：包含中央目录条目的部分 zip 文件的`ERROR(/File)`对象。
`endCentralDirInfo`	`EndCentralDirectoryInfo` ：压缩文件的`EndCentralDirectoryInfo`对象。

退货
	zip 文件的`CentralDirectoryInfo`列表

投掷
	异常

getZipCentralDirectoryInfos

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

获取 zip 文件中文件的 {link CentralDirectoryInfo} 列表。

参数
`partialZipFile`	`File` ：包含中央目录条目的部分 zip 文件的`ERROR(/File)`对象。
`endCentralDirInfo`	`EndCentralDirectoryInfo` ：压缩文件的`EndCentralDirectoryInfo`对象。
`offset`	`long` ：部分 zip 文件中中央目录条目内容开始的偏移量。
`useZip64`	`boolean` : 在部分下载中支持 zip64 格式的布尔值。

退货
	zip 文件的`CentralDirectoryInfo`列表

投掷
	异常

gzip文件

public static void gzipFile (File file, 
                File gzipFile)

创建单个文件的 gzip 版本的帮助程序方法。

参数
`file`	`File` ：原始文件
`gzipFile`	`File` : 放置压缩内容的文件

投掷
	异常

isZipFileValid

public static boolean isZipFileValid (File zipFile, 
                boolean thorough)

验证 zip 文件未损坏的实用方法。

参数
`zipFile`	`File` : 要检查的`ERROR(/File)`
`thorough`	`boolean` ：是否尝试完全提取存档。如果为`false` ，此方法将无法检测格式正确的存档中的 CRC 错误。

退货
`boolean`	如果文件似乎已损坏，则为`false` ；否则为`true`

投掷
	如果文件无法打开或读取

解压缩PartialZip文件

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

从部分 zip 文件中提取请求的文件。

此方法假定所有文件在压缩时都位于同一磁盘上。它还不支持以下功能：

大于 4GB 的 Zip 文件

ZIP64（压缩大小需要 ZipLocalFileHeader 更新）

加密的 zip 文件

符号链接

参数
`partialZip`	`File` ：一个`ERROR(/File)`是 zip 文件的一部分。
`targetFile`	`File` : 将提取的文件保存到的`ERROR(/File)` 。
`zipEntry`	`CentralDirectoryInfo` ：要从部分 zip 文件中提取的文件的`CentralDirectoryInfo`对象。
`localFileHeader`	`LocalFileHeader` ：要从部分 zip 文件中提取的文件的`LocalFileHeader`对象。
`startOffset`	`long` ：要提取的文件的起始偏移量。

投掷
	异常

解压缩PartialZip文件夹

public static void unzipPartialZipFolder (File targetFile, 
                CentralDirectoryInfo zipEntry)

从部分 zip 文件中提取请求的文件夹并应用适当的权限。

参数
`targetFile`	`File` : 将提取的文件保存到的`ERROR(/File)` 。
`zipEntry`	`CentralDirectoryInfo` ：要从部分 zip 文件中提取的文件的`CentralDirectoryInfo`对象。

投掷
	异常