2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ZipUtil

public class ZipUtil
extends Object

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

압축 관련 작업을 위한 도우미 클래스

요약

공개 생성자
`ZipUtil()`

공개 메서드
`static void`	`addToZip(ZipOutputStream out, File file, List<String> relativePathSegs)` 주어진 파일과 그 콘텐츠를 ZipOutputStream에 재귀적으로 추가합니다.
`static void`	`applyPermission(File targetFile, CentralDirectoryInfo zipEntry)` 중앙 디렉터리 항목에 구성된 파일 권한을 적용합니다.
`static void`	`closeZip(ZipFile zipFile)` 예외를 무시하고 열려 있는 `ZipFile`를 닫습니다.
`static File`	`createZip(File dir, String name)` 지정된 디렉터리와 모든 콘텐츠를 포함하는 임시 ZIP 파일을 만드는 유틸리티 메서드입니다.
`static File`	`createZip(File dir)` 지정된 디렉터리와 모든 콘텐츠를 포함하는 임시 ZIP 파일을 만드는 유틸리티 메서드입니다.
`static File`	`createZip(List<File> files)` 지정된 파일이 포함된 임시 zip 파일을 만드는 유틸리티 메서드
`static File`	`createZip(List<File> files, String name)` 지정된 파일이 포함된 임시 zip 파일을 만드는 유틸리티 메서드입니다.
`static void`	`createZip(List<File> files, File zipFile)` 지정된 파일이 포함된 zip 파일을 만드는 유틸리티 메서드
`static void`	`createZip(File dir, 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, Predicate<ZipEntry> shouldExtract)` 지정된 디렉터리에 zip 파일의 콘텐츠를 추출하는 유틸리티 메서드
`static File`	`extractZipToTemp(File zipFile, String nameHint)` 문자열이 앞에 추가된 임시 디렉터리에 zip 파일 추출
`static List<CentralDirectoryInfo>`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset, boolean useZip64)` zip 파일의 파일에 대한 {link CentralDirectoryInfo} 목록을 가져옵니다.
`static List<CentralDirectoryInfo>`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo)` zip 파일의 파일에 대한 {link CentralDirectoryInfo} 목록을 가져옵니다.
`static List<CentralDirectoryInfo>`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, boolean useZip64)` zip 파일의 파일에 대한 {link CentralDirectoryInfo} 목록을 가져옵니다.
`static List<CentralDirectoryInfo>`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset)` 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 파일에서 요청된 폴더를 추출하고 적절한 권한을 적용합니다.

보호된 메서드
`static void`	`validateDestinationDir(File destDir, String filename)`

공개 생성자

ZipUtil

public ZipUtil ()

공개 메서드

addToZip

public static void addToZip (ZipOutputStream out, 
                File file, 
                List<String> relativePathSegs)

주어진 파일과 그 콘텐츠를 ZipOutputStream에 재귀적으로 추가합니다.

매개변수
`out`	`ZipOutputStream`: `ZipOutputStream`
`file`	`File`: 스트림에 추가할 `File`
`relativePathSegs`	`List`: 구분자를 포함한 파일의 상대 경로

생성 값
`IOException`	ZIP에 파일을 추가할 수 없는 경우

applyPermission

public static void applyPermission (File targetFile, 
                CentralDirectoryInfo zipEntry)

중앙 디렉터리 항목에 구성된 파일 권한을 적용합니다.

매개변수
`targetFile`	`File`: 권한을 설정할 `File`입니다.
`zipEntry`	`CentralDirectoryInfo`: 파일 권한이 포함된 `CentralDirectoryInfo` 객체입니다.

생성 값
`IOException`	파일에 액세스할 수 없는 경우

closeZip

public static void closeZip (ZipFile zipFile)

예외를 무시하고 열려 있는 ZipFile를 닫습니다.

매개변수
`zipFile`	`ZipFile`: 닫을 파일

createZip

public static File createZip (File dir, 
                String name)

지정된 디렉터리와 모든 콘텐츠를 포함하는 임시 ZIP 파일을 만드는 유틸리티 메서드입니다.

매개변수
`dir`	`File`: 압축할 디렉터리
`name`	`String`: 확장자 없이 생성된 zip 파일의 기본 이름입니다.

반환
`File`	디렉터리 콘텐츠가 포함된 임시 zip `File`

생성 값
`IOException`	ZIP 파일을 만들지 못한 경우

createZip

public static File createZip (File dir)

지정된 디렉터리와 모든 콘텐츠를 포함하는 임시 ZIP 파일을 만드는 유틸리티 메서드입니다.

매개변수
`dir`	`File`: 압축할 디렉터리

반환
`File`	디렉터리 콘텐츠가 포함된 임시 zip `File`

생성 값
`IOException`	ZIP 파일을 만들지 못한 경우

createZip

public static File createZip (List<File> files)

지정된 파일이 포함된 임시 zip 파일을 만드는 유틸리티 메서드

매개변수
`files`	`List`: 압축할 파일 목록

반환
`File`	디렉터리 콘텐츠가 포함된 임시 zip `File`

생성 값
`IOException`	ZIP 파일을 만들지 못한 경우

createZip

public static File createZip (List<File> files, 
                String name)

지정된 파일이 포함된 임시 zip 파일을 만드는 유틸리티 메서드입니다.

매개변수
`files`	`List`: 압축할 파일 목록
`name`	`String`: 확장자 없이 생성된 zip 파일의 기본 이름입니다.

반환
`File`	디렉터리 콘텐츠가 포함된 임시 zip `File`

생성 값
`IOException`	ZIP 파일을 만들지 못한 경우

createZip

public static void createZip (List<File> files, 
                File zipFile)

지정된 파일이 포함된 zip 파일을 만드는 유틸리티 메서드

매개변수
`files`	`List`: 압축할 파일 목록
`zipFile`	`File`: 생성할 zip 파일입니다. 아직 존재하지 않아야 합니다.

생성 값
`IOException`	ZIP 파일을 만들지 못한 경우

createZip

public static void createZip (File dir, 
                File zipFile)

주어진 디렉터리와 모든 콘텐츠가 포함된 zip 파일을 만드는 유틸리티 메서드입니다.

매개변수
`dir`	`File`: 압축할 디렉터리
`zipFile`	`File`: 생성할 zip 파일입니다. 아직 존재하지 않아야 합니다.

생성 값
`IOException`	ZIP 파일을 만들지 못한 경우

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

zip 파일에서 특정 파일을 tmp 파일로 추출하는 유틸리티 메서드

매개변수
`zipFile`	`ZipFile`: 추출할 `ZipFile`
`filePath`	`String`: 추출할 파일 경로

반환
`File`	`File` 또는 찾을 수 없는 경우 null

생성 값
`IOException`	파일 추출에 실패한 경우

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

지정된 디렉터리에 zip 파일의 전체 콘텐츠를 추출하는 유틸리티 메서드

매개변수
`zipFile`	`ZipFile`: 추출할 `ZipFile`
`destDir`	`File`: 파일을 추출할 로컬 디렉터리

생성 값
`IOException`	파일 추출에 실패한 경우

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir, 
                Predicate<ZipEntry> shouldExtract)

지정된 디렉터리에 zip 파일의 콘텐츠를 추출하는 유틸리티 메서드

매개변수
`zipFile`	`ZipFile`: 추출할 `ZipFile`
`destDir`	`File`: 파일을 추출할 로컬 디렉터리
`shouldExtract`	`Predicate`: ZipEntry를 추출해야 하는지 여부를 결정하는 조건자

생성 값
`IOException`	파일 추출에 실패한 경우

extractZipToTemp

public static File extractZipToTemp (File zipFile, 
                String nameHint)

문자열이 앞에 추가된 임시 디렉터리에 zip 파일 추출

매개변수
`zipFile`	`File`: 추출할 zip 파일
`nameHint`	`String`: 임시 디렉터리의 접두사

반환
`File`	임시 디렉터리를 가리키는 `File`

생성 값
`IOException`
`ZipException`

getZipCentralDirectoryInfos

public static List<CentralDirectoryInfo> getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                long offset, 
                boolean useZip64)

zip 파일의 파일에 대한 {link CentralDirectoryInfo} 목록을 가져옵니다.

매개변수
`partialZipFile`	`File`: 중앙 디렉터리 항목이 포함된 부분 ZIP 파일의 `File` 객체입니다.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: zip 파일의 `EndCentralDirectoryInfo` 객체입니다.
`offset`	`long`: 중앙 디렉터리 항목의 콘텐츠가 시작되는 부분 ZIP 파일의 오프셋입니다.
`useZip64`	`boolean`: 부분 다운로드에서 zip64 형식을 지원하는 불리언입니다.

반환
`List<CentralDirectoryInfo>`	ZIP 파일의 `CentralDirectoryInfo` 목록

생성 값
	java.io.IOException
`IOException`

getZipCentralDirectoryInfos

public static List<CentralDirectoryInfo> getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo)

zip 파일의 파일에 대한 {link CentralDirectoryInfo} 목록을 가져옵니다.

매개변수
`partialZipFile`	`File`: 중앙 디렉터리 항목이 포함된 부분 ZIP 파일의 `File` 객체입니다.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: zip 파일의 `EndCentralDirectoryInfo` 객체입니다.

반환
`List<CentralDirectoryInfo>`	ZIP 파일의 `CentralDirectoryInfo` 목록

생성 값
	java.io.IOException
`IOException`

getZipCentralDirectoryInfos

public static List<CentralDirectoryInfo> getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                boolean useZip64)

zip 파일의 파일에 대한 {link CentralDirectoryInfo} 목록을 가져옵니다.

매개변수
`partialZipFile`	`File`: 중앙 디렉터리 항목이 포함된 부분 ZIP 파일의 `File` 객체입니다.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: zip 파일의 `EndCentralDirectoryInfo` 객체입니다.
`useZip64`	`boolean`: 부분 다운로드에서 zip64 형식을 지원하는 불리언입니다.

반환
`List<CentralDirectoryInfo>`	ZIP 파일의 `CentralDirectoryInfo` 목록

생성 값
	java.io.IOException
`IOException`

getZipCentralDirectoryInfos

public static List<CentralDirectoryInfo> getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                long offset)

zip 파일의 파일에 대한 {link CentralDirectoryInfo} 목록을 가져옵니다.

매개변수
`partialZipFile`	`File`: 중앙 디렉터리 항목이 포함된 부분 ZIP 파일의 `File` 객체입니다.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: zip 파일의 `EndCentralDirectoryInfo` 객체입니다.
`offset`	`long`: 중앙 디렉터리 항목의 콘텐츠가 시작되는 부분 ZIP 파일의 오프셋입니다.

반환
`List<CentralDirectoryInfo>`	ZIP 파일의 `CentralDirectoryInfo` 목록

생성 값
	java.io.IOException
`IOException`

gzipFile

public static void gzipFile (File file, 
                File gzipFile)

단일 파일의 gzip 버전을 만드는 도우미 메서드입니다.

매개변수
`file`	`File`: 원본 파일
`gzipFile`	`File`: 압축된 콘텐츠를 배치할 파일

생성 값
	java.io.IOException
`IOException`

isZipFileValid

public static boolean isZipFileValid (File zipFile, 
                boolean thorough)

ZIP 파일이 손상되지 않았는지 확인하는 유틸리티 메서드입니다.

매개변수
`zipFile`	`File`: 확인할 `File`
`thorough`	`boolean`: 보관 파일을 완전히 추출할지 여부입니다. `false`인 경우 이 메서드는 형식이 올바른 보관 파일에서 CRC 오류를 감지하지 못합니다.

반환
`boolean`	파일이 손상된 것으로 보이는 경우 `false`, 그렇지 않은 경우 `true`

생성 값
`IOException`	파일을 열거나 읽을 수 없는 경우

unzipPartialZipFile

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

부분 zip 파일에서 요청된 단일 파일을 추출합니다.

이 방법은 압축 시 모든 파일이 동일한 디스크에 있다고 가정합니다.

ERROR(/targetFile)가 디렉터리인 경우 콘텐츠 없이 빈 디렉터리가 생성됩니다.

ERROR(/targetFile)가 심볼릭 링크인 경우 심볼릭 링크가 생성되지만 확인되지는 않습니다.

다음 기능은 아직 지원되지 않습니다.

ZIP 파일이 4GB보다 큼

ZIP64(압축된 크기에 ZipLocalFileHeader 업데이트 필요)

암호화된 ZIP 파일

매개변수
`partialZip`	`File`: ZIP 파일의 일부인 `File`입니다.
`targetFile`	`File`: 추출된 파일을 저장할 `File`입니다.
`zipEntry`	`CentralDirectoryInfo`: 부분 zip 파일에서 추출할 파일의 `CentralDirectoryInfo` 객체입니다.
`localFileHeader`	`LocalFileHeader`: 부분 zip 파일에서 추출할 파일의 `LocalFileHeader` 객체입니다.
`startOffset`	`long`: 추출할 파일의 시작 오프셋입니다.

생성 값
	java.io.IOException
`IOException`

unzipPartialZipFolder

public static void unzipPartialZipFolder (File targetFile, 
                CentralDirectoryInfo zipEntry)

부분 ZIP 파일에서 요청된 폴더를 추출하고 적절한 권한을 적용합니다.

매개변수
`targetFile`	`File`: 추출된 파일을 저장할 `File`입니다.
`zipEntry`	`CentralDirectoryInfo`: 부분 zip 파일에서 추출할 파일의 `CentralDirectoryInfo` 객체입니다.

생성 값
	java.io.IOException
`IOException`

보호된 메서드

validateDestinationDir

protected static void validateDestinationDir (File destDir, 
                String filename)

매개변수
`destDir`	`File`
`filename`	`String`

생성 값
`IOException`