自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 Cloud Translation API 翻譯而成。

TarUtil

public class TarUtil
extends Object

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

用於操作 tar 檔案的工具。它會包裝 commons-compress，以便提供 tar 支援。

摘要

公用建構函式
`TarUtil()`

公用方法
`static void`	`extractAndLog(ITestLogger listener, File targzFile, String baseName)` 輔助程式，可擷取並記錄至報表的 tar.gz 檔案及其內容
`static File`	`extractTarGzipToTemp(File targzFile, String nameHint)` 將 tar.gz 檔案解開並解壓縮至暫存目錄。
`static File`	`gzip(File inputFile)` 公用程式函式，用於將檔案壓縮為 gzip (.gz) 格式。
`static boolean`	`isGzip(File file)` 判斷檔案是否為 gzip。
`static File`	`unGzip(File inputFile, File outputDir)` 解壓縮檔案：tar.gz 或 tgz 檔案會變成 tar 檔案。
`static`	`unTar(File inputFile, File outputDir)` 將 tar 檔案解開至目錄。
`static`	`unTar(File inputFile, File outputDir, fileNames)` 將 tar 檔案解開至目錄。

public TarUtil ()

public static void extractAndLog (ITestLogger listener, 
                File targzFile, 
                String baseName)

擷取並記錄至報表的 tar.gz 檔案及其內容的輔助程式

參數
`listener`	`ITestLogger`：記錄檔案的 `ITestLogger`。
`targzFile`	`File`：需要內容記錄的 tar.gz `ERROR(/File)`。
`baseName`	`String`：系統用來尋找檔案的基本名稱。

public static File extractTarGzipToTemp (File targzFile, 
                String nameHint)

將 tar.gz 檔案解開並解壓縮，並將檔案解壓縮到暫存目錄。

參數
`targzFile`	`File`：要解壓縮的 tar.gz 檔案。
`nameHint`	`String`：暫存目錄的前置字串。

傳回
`File`	臨時目錄。

擲回
	FileNotFoundException
	IOException

public static File gzip (File inputFile)

公用函式，用於將檔案壓縮為 gzip (.gz) 格式。.gz 副檔名會加入至基本檔案名稱。

參數
`inputFile`	`File`：要壓縮的 `ERROR(/File)`。

傳回
`File`	壓縮檔案。

擲回
	IOException

public static boolean isGzip (File file)

判斷檔案是否為 gzip。

參數
`file`	`File`：要檢查的檔案。

傳回
`boolean`	檔案是否為 gzip。

擲回
	系統無法讀取檔案。

public static File unGzip (File inputFile, 
                File outputDir)

解壓縮檔案：tar.gz 或 tgz 檔案會變成 tar 檔案。

參數
`inputFile`	`File`：解壓縮的 `ERROR(/File)`
`outputDir`	`File`：解壓縮檔案的放置目錄。

傳回
`File`	`ERROR(/File)` 指向已解壓縮的檔案。

擲回
	FileNotFoundException
	IOException

public static  unTar (File inputFile, 
                File outputDir)

將 tar 檔案解壓縮至目錄。tar.gz 檔案必須先 unGzip(File, File)。

參數
`inputFile`	`File`：要解壓縮的 tar 檔案
`outputDir`	`File`：要放置已解壓縮檔案的目錄。

傳回
	已解壓縮的 `ERROR(/File)` 清單。

擲回
	FileNotFoundException
	IOException

public static  unTar (File inputFile, 
                File outputDir, 
                 fileNames)

將 tar 檔案解壓縮至目錄。tar.gz 檔案必須先 unGzip(File, File)。

傳回
	已解壓縮的 `ERROR(/File)` 清單。

擲回
	FileNotFoundException
	IOException