Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

RemoteFileUtil

public class RemoteFileUtil
extends Object

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

Classe utilitária para processar arquivos de uma instância remota.

Resumo

Construtores públicos
`RemoteFileUtil()`

Métodos públicos
`static boolean`	`doesRemoteFileExist(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remotePath)` Verificar se um arquivo (ou diretório) existe na instância remota
`static boolean`	`doesRemoteFileExist(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remotePath, String sshPortNumber)` Verificar se um arquivo (ou diretório) existe na instância remota
`static boolean`	`fetchRemoteDir(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteDirPath, File localDir)` Busca um diretório remoto do host remoto.
`static File`	`fetchRemoteDir(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteDirPath)` Busca um diretório remoto do host remoto.
`static File`	`fetchRemoteDir(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteDirPath)` Busca um diretório remoto do host remoto.
`static boolean`	`fetchRemoteDir(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteDirPath, File localDir)` Busca um diretório remoto do host remoto.
`static File`	`fetchRemoteFile(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath)` Extraia um arquivo remoto na instância do contêiner.
`static File`	`fetchRemoteFile(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteFilePath)` Extraia um arquivo remoto na instância do contêiner.
`static boolean`	`fetchRemoteFile(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` Busca um arquivo remoto no dispositivo ou na instância do contêiner.
`static boolean`	`fetchRemoteFile(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` Busca um arquivo remoto no dispositivo ou na instância do contêiner.
`static boolean`	`pushFileToRemote(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` Enviar um `File` do host local para a instância remota

Construtores públicos

RemoteFileUtil

public RemoteFileUtil ()

Métodos públicos

doesRemoteFileExist

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

Verificar se um arquivo (ou diretório) existe na instância remota

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remotePath`	`String`: o caminho remoto para encontrar o arquivo.

Retorna
`boolean`	se o arquivo existe ou não

doesRemoteFileExist

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

Verificar se um arquivo (ou diretório) existe na instância remota

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remotePath`	`String`: o caminho remoto para encontrar o arquivo.
`sshPortNumber`	`String`: número da porta para SSH.

Retorna
`boolean`	se o arquivo existe ou não

fetchRemoteDir

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

Busca um diretório remoto do host remoto.

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteDirPath`	`String`: o caminho remoto onde encontrar o diretório.
`localDir`	`File`: o diretório local em que os arquivos extraídos serão colocados.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, False.

fetchRemoteDir

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

Busca um diretório remoto do host remoto.

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteDirPath`	`String`: o caminho remoto onde encontrar o diretório.

Retorna
`File`	O diretório extraído `File` se for bem-sucedido. Caso contrário, será nulo.

fetchRemoteDir

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

Busca um diretório remoto do host remoto.

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`scpArgs`	`List`: argumentos extras a serem transmitidos ao comando scp
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteDirPath`	`String`: o caminho remoto onde encontrar o diretório.

Retorna
`File`	O diretório extraído `File` se for bem-sucedido. Caso contrário, será nulo.

fetchRemoteDir

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

Busca um diretório remoto do host remoto.

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`scpArgs`	`List`: argumentos extras a serem transmitidos ao comando scp
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteDirPath`	`String`: o caminho remoto onde encontrar o diretório.
`localDir`	`File`: o diretório local em que os arquivos extraídos serão colocados.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, False.

fetchRemoteFile

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

Extraia um arquivo remoto na instância do contêiner.

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`scpArgs`	`List`: argumentos extras a serem transmitidos ao comando scp
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteFilePath`	`String`: o caminho remoto para encontrar o arquivo.

Retorna
`File`	O campo extraído se for bem-sucedido. Caso contrário, será nulo.

fetchRemoteFile

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

Extraia um arquivo remoto na instância do contêiner.

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteFilePath`	`String`: o caminho remoto para encontrar o arquivo.

Retorna
`File`	O campo extraído se for bem-sucedido. Caso contrário, será nulo.

fetchRemoteFile

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

Busca um arquivo remoto no dispositivo ou na instância do contêiner.

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`scpArgs`	`List`: argumentos extras a serem transmitidos ao comando scp
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteFilePath`	`String`: o caminho remoto para encontrar o arquivo.
`localFile`	`File`: o `File` local em que o arquivo remoto será extraído.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, False.

fetchRemoteFile

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

Busca um arquivo remoto no dispositivo ou na instância do contêiner.

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`: o arquivo que contém a chave SSH a ser usada.
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteFilePath`	`String`: o caminho remoto para encontrar o arquivo.
`localFile`	`File`: o `File` local em que o arquivo remoto será extraído.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, False.

pushFileToRemote

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

Enviar um File do host local para a instância remota

Parâmetros
`host`	`String`: o host remoto.
`user`	`String`: o usuário no host remoto
`sshPrivateKey`	`File`
`scpArgs`	`List`: argumentos extras a serem transmitidos ao comando scp
`runUtil`	`IRunUtil`: um `IRunUtil` para executar comandos.
`timeout`	`long`: em milissegundos para a conclusão da busca.
`remoteFilePath`	`String`: o caminho remoto para encontrar o arquivo.
`localFile`	`File`: o `File` local em que o arquivo remoto será extraído.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, False.