SyncService

public class SyncService
extends Object

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


Clase de servicio de sincronización para enviar o extraer datos hacia o desde dispositivos o emuladores a través del puente de depuración.

Para obtener un objeto SyncService, usa IDevice.getSyncService().

Resumen

Clases anidadas

class SyncService.FileStat

 

interface SyncService.ISyncProgressMonitor

Las clases que implementan esta interfaz proporcionan métodos que se encargan de mostrar el progreso de la transferencia. 

Constructores públicos

SyncService(InetSocketAddress address, IDevice device)

Crea un objeto de servicio de Sync.

Métodos públicos

void close()

Cierra la conexión.

static SyncService.ISyncProgressMonitor getNullProgressMonitor()

Devuelve un monitor de progreso de sincronización que no hace nada.

boolean openSync()

Abre la conexión de sincronización.

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

Extrae archivos o carpetas.

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

Extrae un solo archivo.

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

Extrae un solo archivo.

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

Envía varios archivos o directorios.

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

Envía varios archivos o directorios.

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

Envía un solo archivo.

SyncService.FileStat statFile(String path)

Devuelve la información de estadísticas del archivo remoto.

Constructores públicos

SyncService

public SyncService (InetSocketAddress address, 
                IDevice device)

Crea un objeto de servicio de Sync.

Parámetros
address InetSocketAddress: Es la dirección a la que se conectará.

device IDevice: Es el IDevice al que se conecta el servicio.

Métodos públicos

cerrar

public void close ()

Cierra la conexión.

getNullProgressMonitor

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

Devuelve un monitor de progreso de sincronización que no hace nada. Esto permite que las tareas en segundo plano que no quieren o necesitan mostrar la IU pasen un ISyncProgressMonitor válido.

Este objeto se puede reutilizar varias veces y lo pueden usar subprocesos simultáneos.

Muestra
SyncService.ISyncProgressMonitor

openSync

public boolean openSync ()

Abre la conexión de sincronización. Se debe llamar a este método antes de cualquier llamada a push[File] o pull[File].

Muestra
boolean Es verdadero si se abrió la conexión y falso si adb la rechazó. Esto puede suceder si el IDevice no es válido.

Arroja
TimeoutException en caso de que se agote el tiempo de espera de la conexión.
AdbCommandRejectedException Si adb rechaza el comando
Si falló la conexión a adb.

tirar

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

Extrae archivos o carpetas.

Parámetros
entries FileEntry: Los elementos remotos que se extraerán

localPath String: Es el destino local. Si el recuento de entradas es > 1 o si la entrada única es una carpeta, debe ser una carpeta.

monitor SyncService.ISyncProgressMonitor: Es el monitor de progreso. No puede ser nulo.

Arroja
com.android.ddmlib.SyncException
IOException
com.android.ddmlib.TimeoutException
SyncException
TimeoutException

pullFile

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

Extrae un solo archivo.

Parámetros
remote FileListingService.FileEntry: el archivo remoto

localFilename String: Es el destino local.

monitor SyncService.ISyncProgressMonitor: Es el monitor de progreso. No puede ser nulo.

Arroja
en caso de una excepción de IO.
TimeoutException en caso de que se agote el tiempo de espera para leer las respuestas del dispositivo.
SyncException en caso de que se produzca una excepción de sincronización.

pullFile

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

Extrae un solo archivo.

Dado que este método solo maneja una cadena para el archivo remoto en lugar de un FileEntry, se desconoce el tamaño del archivo que se extrae y el ISyncProgressMonitor no mostrará el progreso correctamente.

Parámetros
remoteFilepath String: Es la ruta de acceso completa al archivo remoto.

localFilename String: Es el destino local.

monitor SyncService.ISyncProgressMonitor: Es el monitor de progreso. No puede ser nulo.

Arroja
en caso de una excepción de IO.
TimeoutException en caso de que se agote el tiempo de espera para leer las respuestas del dispositivo.
SyncException en caso de que se produzca una excepción de sincronización.

push

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

Envía varios archivos o directorios.

Parámetros
local String: Los archivos locales que se enviarán

remote FileListingService.FileEntry: Es el objeto FileEntry remoto que representa un directorio.

monitor SyncService.ISyncProgressMonitor: El monitor de progreso

Arroja
SyncException Si no se pudieron enviar algunos archivos
en caso de error de E/S en la conexión
TimeoutException en caso de que se agote el tiempo de espera para leer las respuestas del dispositivo

push

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

Envía varios archivos o directorios.

Parámetros
local String: Los archivos locales que se enviarán

remote String: Es la ruta de acceso remota que representa un directorio.

monitor SyncService.ISyncProgressMonitor: El monitor de progreso

Arroja
SyncException Si no se pudieron enviar algunos archivos
en caso de error de E/S en la conexión
TimeoutException En caso de que se agote el tiempo de espera para leer las respuestas del dispositivo

pushFile

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

Envía un solo archivo.

Parámetros
local String: Es la ruta de acceso del archivo local.

remote String: Es la ruta de acceso remota.

monitor SyncService.ISyncProgressMonitor: Es el monitor de progreso. No puede ser nulo.

Arroja
SyncException Si no se pudo enviar el archivo
en caso de error de E/S en la conexión
TimeoutException en caso de que se agote el tiempo de espera para leer las respuestas del dispositivo.

statFile

public SyncService.FileStat statFile (String path)

Devuelve la información de estadísticas del archivo remoto.

Parámetros
path String: el archivo remoto

Muestra
SyncService.FileStat un FileStat que contiene el modo, el tamaño y la información de la última modificación si todo salió bien o nulo en caso contrario

Arroja
IOException
TimeoutException en caso de que se agote el tiempo de espera para leer las respuestas del dispositivo.