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

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

TargetFileUtils

public class TargetFileUtils
extends Object

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

摘要

公用建構函式
`TargetFileUtils()`

公用方法
`static`	`findFile(String path, String namePattern, options, ITestDevice device)` 執行 ADB 殼層 find 指令的輔助方法，並將結果傳回為 `ERROR(/ArrayList)`。
`static String`	`getPermission(String filepath, ITestDevice device)` 讀取路徑的檔案權限位元。
`static boolean`	`hasPermission(TargetFileUtils.FilePermission permission, String permissionBits)` 判斷權限位元是否將指定權限授予任何群組。
`static boolean`	`isReadOnly(String filepath, ITestDevice device)` 檢查指定路徑的權限是否為唯讀。
`static boolean`	`isReadWriteOnly(String filepath, ITestDevice device)` 檢查指定路徑的權限是否為讀寫權限。

public TargetFileUtils ()

public static  findFile (String path, 
                String namePattern, 
                 options, 
                ITestDevice device)

執行 ADB 殼層尋找指令的輔助方法，並將結果傳回為 ERROR(/ArrayList)。

參數
`path`	`String`：裝置上的搜尋路徑。
`namePattern`	`String`：檔案名稱格式。
`options`	：其他選項傳遞給 find 的 `String` `ERROR(/List)`。
`device`	`ITestDevice`：測試裝置。

傳回
	`ERROR(/ArrayList)` 中的結果。

擲回
`DeviceNotAvailableException`	如果與裝置的連線中斷且無法復原。

public static String getPermission (String filepath, 
                ITestDevice device)

讀取路徑的檔案權限位元。

參數
`filepath`	`String`：檔案或目錄的路徑。
`device`	`ITestDevice`：測試裝置。

傳回
`String`	路徑的八進位權限位元。

擲回
`DeviceNotAvailableException`

public static boolean hasPermission (TargetFileUtils.FilePermission permission, 
                String permissionBits)

判斷權限位元是否將指定權限授予任何群組。

參數
`permission`	`TargetFileUtils.FilePermission`：指定權限。
`permissionBits`	`String`：八進位權限字串 (例如 741)。

傳回
`boolean`	如果任何擁有者/群組/全域擁有指定權限，則為「是」。

public static boolean isReadOnly (String filepath, 
                ITestDevice device)

檢查指定路徑的權限是否為唯讀。

參數
`filepath`	`String`：檔案或目錄的路徑。
`device`	`ITestDevice`：測試裝置。

傳回
`boolean`	如果路徑為唯讀，則傳回 true，否則傳回 false。

擲回
`DeviceNotAvailableException`

public static boolean isReadWriteOnly (String filepath, 
                ITestDevice device)

檢查指定路徑的權限是否為 readwrite。

參數
`filepath`	`String`：檔案或目錄的路徑。
`device`	`ITestDevice`：測試裝置。

傳回
`boolean`	如果路徑為 readwrite，則傳回 true，否則傳回 false。

擲回
`DeviceNotAvailableException`