為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

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

TargetFileUtils

public class TargetFileUtils
extends Object

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

摘要

公用建構函式
`TargetFileUtils()`

公用方法
`static ArrayList<String>`	`findFile(String path, String namePattern, List<String> options, ITestDevice device)` 輔助方法，可執行 adb shell 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)` 檢查指定路徑的權限是否為讀寫。

公用建構函式

TargetFileUtils

public TargetFileUtils ()

公用方法

findFile

public static ArrayList<String> findFile (String path, 
                String namePattern, 
                List<String> options, 
                ITestDevice device)

這個輔助方法會執行 adb shell find 指令，並以 ERROR(/ArrayList) 形式傳回結果。

參數
`path`	`String`：裝置上的搜尋路徑。
`namePattern`	`String`：檔案名稱模式。
`options`	`List`：要傳遞的 `String` `List`，用於尋找其他選項。
`device`	`ITestDevice`：測試裝置。

傳回
`ArrayList<String>`	結果位於 `ERROR(/ArrayList)`。

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

getPermission

public static String getPermission (String filepath, 
                ITestDevice device)

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

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

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

擲回
`DeviceNotAvailableException`

hasPermission

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

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

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

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

isReadOnly

public static boolean isReadOnly (String filepath, 
                ITestDevice device)

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

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

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

擲回
`DeviceNotAvailableException`

isReadWriteOnly

public static boolean isReadWriteOnly (String filepath, 
                ITestDevice device)

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

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

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

擲回
`DeviceNotAvailableException`