SyncService

public class SyncService
extends Object

java.lang.Object
   ↳ com.android.tradefed.device.server.SyncService

Classe de serviço de sincronização para enviar/extrair para/de dispositivos/emuladores pela ponte de depuração.

Para receber um objeto SyncService, use IDevice.getSyncService().

Resumo

Classes aninhadas

class SyncService.FileStat

 

interface SyncService.ISyncProgressMonitor

As classes que implementam essa interface fornecem métodos que lidam com a exibição do progresso da transferência. 

Construtores públicos

SyncService(InetSocketAddress address, IDevice device)

Cria um objeto de serviço de sincronização.

Métodos públicos

void close()

Fecha a conexão.

static SyncService.ISyncProgressMonitor getNullProgressMonitor()

Retorna um monitor de progresso de sincronização que não faz nada.

boolean openSync()

Abre a conexão de sincronização.

void pull(FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)

Extrai arquivos ou pastas.

void pullFile(FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)

Extrai um único arquivo.

void pullFile(String remoteFilepath, String localFilename, SyncService.ISyncProgressMonitor monitor)

Extrai um único arquivo.

void push(String[] local, FileListingService.FileEntry remote, SyncService.ISyncProgressMonitor monitor)

Envia vários arquivos ou diretórios.

void push(String[] local, String remote, SyncService.ISyncProgressMonitor monitor)

Envia vários arquivos ou diretórios.

void pushFile(String local, String remote, SyncService.ISyncProgressMonitor monitor)

Envie um único arquivo.

SyncService.FileStat statFile(String path)

Retorna as informações de estatísticas do arquivo remoto.

Construtores públicos

SyncService

public SyncService (InetSocketAddress address, 
                IDevice device)

Cria um objeto de serviço de sincronização.

Parâmetros
address InetSocketAddress: o endereço a ser conectado
device IDevice: o IDevice a que o serviço se conecta.

Métodos públicos

fechar

public void close ()

Fecha a conexão.

getNullProgressMonitor

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

Retorna um monitor de progresso de sincronização que não faz nada. Isso permite que tarefas em segundo plano que não querem/precisam mostrar a interface transmitam um ISyncProgressMonitor válido.

Esse objeto pode ser reutilizado várias vezes e usado por threads simultâneos.

Retorna
SyncService.ISyncProgressMonitor

openSync

public boolean openSync ()

Abre a conexão de sincronização. Isso precisa ser chamado antes de qualquer chamada para push[File] / pull[File].

Retorna
boolean "true" se a conexão foi aberta e "false" se o adb recusou a conexão. Isso pode acontecer se o IDevice for inválido.
Gera
TimeoutException em caso de tempo limite na conexão.
AdbCommandRejectedException se o adb rejeitar o comando
Se a conexão com o adb falhou.

puxar

public void pull (FileEntry[] entries, 
                String localPath, 
                SyncService.ISyncProgressMonitor monitor)

Extrai arquivos ou pastas.

Parâmetros
entries FileEntry: os itens remotos a serem extraídos
localPath String: o destino local. Se a contagem de entradas for > 1 ou se a entrada única for uma pasta, isso precisará ser uma pasta.
monitor SyncService.ISyncProgressMonitor: o monitor de progresso. Não pode ser nulo.
Gera
com.android.ddmlib.SyncException
IOException
com.android.ddmlib.TimeoutException
SyncException
TimeoutException

pullFile

public void pullFile (FileListingService.FileEntry remote, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

Extrai um único arquivo.

Parâmetros
remote FileListingService.FileEntry: o arquivo remoto
localFilename String: o destino local.
monitor SyncService.ISyncProgressMonitor: o monitor de progresso. Não pode ser nulo.
Gera
em caso de uma exceção de E/S.
TimeoutException em caso de tempo limite ao ler respostas do dispositivo.
SyncException em caso de uma exceção de sincronização.

pullFile

public void pullFile (String remoteFilepath, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

Extrai um único arquivo.

Como esse método lida apenas com uma string para o arquivo remoto em vez de um FileEntry, o tamanho do arquivo extraído é desconhecido, e o ISyncProgressMonitor não vai mostrar o progresso corretamente.

Parâmetros
remoteFilepath String: o caminho completo para o arquivo remoto
localFilename String: o destino local.
monitor SyncService.ISyncProgressMonitor: o monitor de progresso. Não pode ser nulo.
Gera
em caso de uma exceção de E/S.
TimeoutException em caso de tempo limite ao ler respostas do dispositivo.
SyncException em caso de uma exceção de sincronização.

Confira também:

push

public void push (String[] local, 
                FileListingService.FileEntry remote, 
                SyncService.ISyncProgressMonitor monitor)

Envia vários arquivos ou diretórios.

Parâmetros
local String: os arquivos locais a serem enviados
remote FileListingService.FileEntry: o FileEntry remoto que representa um diretório
monitor SyncService.ISyncProgressMonitor: o monitor de progresso
Gera
SyncException se alguns arquivos não puderem ser enviados por push
em caso de erro de E/S na conexão
TimeoutException em caso de tempo limite ao ler respostas do dispositivo

push

public void push (String[] local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

Envia vários arquivos ou diretórios.

Parâmetros
local String: os arquivos locais a serem enviados
remote String: o caminho remoto que representa um diretório
monitor SyncService.ISyncProgressMonitor: o monitor de progresso
Gera
SyncException se alguns arquivos não puderem ser enviados por push
em caso de erro de E/S na conexão
TimeoutException em caso de tempo limite ao ler respostas do dispositivo

pushFile

public void pushFile (String local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

Envie um único arquivo.

Parâmetros
local String: o caminho do arquivo local.
remote String: o caminho do arquivo remoto.
monitor SyncService.ISyncProgressMonitor: o monitor de progresso. Não pode ser nulo.
Gera
SyncException se não for possível enviar o arquivo
em caso de erro de E/S na conexão.
TimeoutException em caso de tempo limite ao ler respostas do dispositivo.

statFile

public SyncService.FileStat statFile (String path)

Retorna as informações de estatísticas do arquivo remoto.

Parâmetros
path String: o arquivo remoto
Retorna
SyncService.FileStat um FileStat que contém o modo, o tamanho e as informações da última modificação se tudo der certo ou nulo caso contrário
Gera
IOException
TimeoutException em caso de tempo limite ao ler respostas do dispositivo.