自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

RemoteFileUtil

public class RemoteFileUtil
extends Object

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

用于处理远程实例中的文件的实用工具类

摘要

公共构造函数
`RemoteFileUtil()`

公共方法
`static boolean`	`doesRemoteFileExist(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remotePath)` 检查远程实例上是否存在某个文件（或目录）
`static boolean`	`doesRemoteFileExist(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remotePath, String sshPortNumber)` 检查远程实例上是否存在某个文件（或目录）
`static boolean`	`fetchRemoteDir(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteDirPath, File localDir)` 从远程主机提取远程目录。
`static File`	`fetchRemoteDir(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteDirPath)` 从远程主机提取远程目录。
`static File`	`fetchRemoteDir(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteDirPath)` 从远程主机提取远程目录。
`static boolean`	`fetchRemoteDir(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteDirPath, File localDir)` 从远程主机提取远程目录。
`static File`	`fetchRemoteFile(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath)` 在容器实例中提取远程文件。
`static File`	`fetchRemoteFile(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteFilePath)` 在容器实例中提取远程文件。
`static boolean`	`fetchRemoteFile(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` 提取设备或容器实例中的远程文件。
`static boolean`	`fetchRemoteFile(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` 提取设备或容器实例中的远程文件。
`static boolean`	`pushFileToRemote(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` 将 `File` 从本地主机推送到远程实例

公共构造函数

RemoteFileUtil

public RemoteFileUtil ()

公共方法

doesRemoteFileExist

public static boolean doesRemoteFileExist (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remotePath)

检查远程实例上是否存在某个文件（或目录）

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remotePath`	`String`：查找文件的远程路径。

返回
`boolean`	文件是否存在

doesRemoteFileExist

public static boolean doesRemoteFileExist (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remotePath, 
                String sshPortNumber)

检查远程实例上是否存在某个文件（或目录）

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remotePath`	`String`：查找文件的远程路径。
`sshPortNumber`	`String`：SSH 的端口号。

返回
`boolean`	文件是否存在

fetchRemoteDir

public static boolean fetchRemoteDir (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteDirPath, 
                File localDir)

从远程主机提取远程目录。

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteDirPath`	`String`：用于查找目录的远程路径。
`localDir`	`File`：放置提取文件的本地目录。

返回
`boolean`	如果成功，则返回 True；否则，返回 False

fetchRemoteDir

public static File fetchRemoteDir (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteDirPath)

从远程主机提取远程目录。

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteDirPath`	`String`：用于查找目录的远程路径。

返回
`File`	如果成功，则返回拉取的目录 `File`；否则，返回 null

fetchRemoteDir

public static File fetchRemoteDir (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteDirPath)

从远程主机提取远程目录。

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`scpArgs`	`List`：要传递给 scp 命令的额外实参
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteDirPath`	`String`：用于查找目录的远程路径。

返回
`File`	如果成功，则返回拉取的目录 `File`；否则，返回 null

fetchRemoteDir

public static boolean fetchRemoteDir (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteDirPath, 
                File localDir)

从远程主机提取远程目录。

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`scpArgs`	`List`：要传递给 scp 命令的额外实参
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteDirPath`	`String`：用于查找目录的远程路径。
`localDir`	`File`：放置提取文件的本地目录。

返回
`boolean`	如果成功，则返回 True；否则，返回 False

fetchRemoteFile

public static File fetchRemoteFile (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath)

在容器实例中提取远程文件。

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`scpArgs`	`List`：要传递给 scp 命令的额外实参
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteFilePath`	`String`：查找文件的远程路径。

返回
`File`	如果成功，则为拉取的字段；否则为 null

fetchRemoteFile

public static File fetchRemoteFile (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath)

在容器实例中提取远程文件。

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteFilePath`	`String`：查找文件的远程路径。

返回
`File`	如果成功，则为拉取的字段；否则为 null

fetchRemoteFile

public static boolean fetchRemoteFile (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath, 
                File localFile)

在设备或容器实例中提取远程文件。

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`scpArgs`	`List`：要传递给 scp 命令的额外实参
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteFilePath`	`String`：查找文件的远程路径。
`localFile`	`File`：将拉取远程文件的本地 `File`

返回
`boolean`	如果成功，则返回 True；否则，返回 False

fetchRemoteFile

public static boolean fetchRemoteFile (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath, 
                File localFile)

在设备或容器实例中提取远程文件。

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`：包含要使用的 SSH 密钥的文件。
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteFilePath`	`String`：查找文件的远程路径。
`localFile`	`File`：将拉取远程文件的本地 `File`

返回
`boolean`	如果成功，则返回 True；否则，返回 False

pushFileToRemote

public static boolean pushFileToRemote (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath, 
                File localFile)

将 File 从本地主机推送到远程实例

参数
`host`	`String`：远程主机。
`user`	`String`：远程主机上的用户
`sshPrivateKey`	`File`
`scpArgs`	`List`：要传递给 scp 命令的额外实参
`runUtil`	`IRunUtil`：用于执行命令的 `IRunUtil`。
`timeout`	`long`：以毫秒为单位，表示提取完成所需的时间
`remoteFilePath`	`String`：查找文件的远程路径。
`localFile`	`File`：将拉取远程文件的本地 `File`

返回
`boolean`	如果成功，则返回 True；否则，返回 False