SyncService

public class SyncService
extends Object

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

---

Classe de service de synchronisation pour envoyer/extraire des données vers/depuis des appareils/émulateurs, via le pont de débogage.

Pour obtenir un objet SyncService, utilisez IDevice.getSyncService().

Résumé

Classes imbriquées
class	SyncService.FileStat
interface	SyncService.ISyncProgressMonitor Les classes qui implémentent cette interface fournissent des méthodes qui gèrent l'affichage de la progression du transfert.

Constructeurs publics
SyncService(InetSocketAddress address, IDevice device) Crée un objet de service de synchronisation.

Méthodes publiques
void	close() Ferme la connexion.
static SyncService.ISyncProgressMonitor	getNullProgressMonitor() Renvoie un moniteur de progression de la synchronisation qui ne fait rien.
boolean	openSync() Ouvre la connexion de synchronisation.
void	pull(FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor) Extrait un ou plusieurs fichiers ou dossiers.
void	pullFile(FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor) Extrait un seul fichier.
void	pullFile(String remoteFilepath, String localFilename, SyncService.ISyncProgressMonitor monitor) Extrait un seul fichier.
void	push(String[] local, FileListingService.FileEntry remote, SyncService.ISyncProgressMonitor monitor) Envoie plusieurs fichiers ou répertoires.
void	push(String[] local, String remote, SyncService.ISyncProgressMonitor monitor) Envoie plusieurs fichiers ou répertoires.
void	pushFile(String local, String remote, SyncService.ISyncProgressMonitor monitor) Transférer un seul fichier
SyncService.FileStat	statFile(String path) Renvoie les informations statistiques du fichier distant.

Constructeurs publics

SyncService

public SyncService (InetSocketAddress address, 
                IDevice device)

Crée un objet de service de synchronisation.

Paramètres
address	InetSocketAddress : adresse à laquelle se connecter
device	IDevice : IDevice auquel le service se connecte.

Méthodes publiques

fermer

public void close ()

Ferme la connexion.

getNullProgressMonitor

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

Renvoie un moniteur de progression de la synchronisation qui ne fait rien. Cela permet aux tâches en arrière-plan qui ne souhaitent pas/n'ont pas besoin d'afficher l'UI de transmettre un ISyncProgressMonitor valide.

Cet objet peut être réutilisé plusieurs fois et peut être utilisé par des threads simultanés.

Renvoie
SyncService.ISyncProgressMonitor

openSync

public boolean openSync ()

Ouvre la connexion de synchronisation. Cette méthode doit être appelée avant tout appel à push[File] / pull[File].

Renvoie
boolean	"true" si la connexion s'est ouverte, "false" si adb refuse la connexion. Cela peut se produire si le IDevice n'est pas valide.

Génère
TimeoutException	en cas de délai d'expiration de la connexion.
AdbCommandRejectedException	si adb rejette la commande.
	Si la connexion à adb a échoué.

récupérer

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

Extrait un ou plusieurs fichiers ou dossiers.

Paramètres
entries	FileEntry : élément(s) distant(s) à extraire
localPath	String : destination locale. Si le nombre d'entrées est supérieur à 1 ou si l'entrée unique est un dossier, il doit s'agir d'un dossier.
monitor	SyncService.ISyncProgressMonitor : moniteur de progression. Ne peut pas être nul.

Génère
	com.android.ddmlib.SyncException
	IOException
	com.android.ddmlib.TimeoutException
SyncException
TimeoutException

Voir aussi :

• FileListingService.FileEntry
• getNullProgressMonitor()

pullFile

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

Extrait un seul fichier.

Paramètres
remote	FileListingService.FileEntry : fichier distant
localFilename	String : destination locale.
monitor	SyncService.ISyncProgressMonitor : moniteur de progression. Ne peut pas être nul.

Génère
	en cas d'exception d'E/S.
TimeoutException	en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.
SyncException	en cas d'exception de synchronisation.

Voir aussi :

• FileListingService.FileEntry
• getNullProgressMonitor()

pullFile

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

Extrait un seul fichier.

Étant donné que cette méthode ne traite qu'une chaîne pour le fichier distant au lieu d'un FileEntry, la taille du fichier extrait est inconnue et ISyncProgressMonitor n'affichera pas correctement la progression.

Paramètres
remoteFilepath	String : chemin d'accès complet au fichier distant
localFilename	String : destination locale.
monitor	SyncService.ISyncProgressMonitor : moniteur de progression. Ne peut pas être nul.

Génère
	en cas d'exception d'E/S.
TimeoutException	en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.
SyncException	en cas d'exception de synchronisation.

Voir aussi :

• getNullProgressMonitor()

push

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

Envoie plusieurs fichiers ou répertoires.

Paramètres
local	String : fichiers locaux à transférer
remote	FileListingService.FileEntry : FileEntry distant représentant un répertoire
monitor	SyncService.ISyncProgressMonitor : indicateur de progression

Génère
SyncException	si certains fichiers n'ont pas pu être transférés ;
	en cas d'erreur d'E/S sur la connexion.
TimeoutException	en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.

push

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

Envoie plusieurs fichiers ou répertoires.

Paramètres
local	String : fichiers locaux à transférer
remote	String : chemin d'accès distant représentant un répertoire
monitor	SyncService.ISyncProgressMonitor : indicateur de progression

Génère
SyncException	si certains fichiers n'ont pas pu être transférés ;
	en cas d'erreur d'E/S sur la connexion.
TimeoutException	en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.

pushFile

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

Transférer un seul fichier

Paramètres
local	String : chemin d'accès local.
remote	String : chemin d'accès distant.
monitor	SyncService.ISyncProgressMonitor : moniteur de progression. Ne peut pas être nul.

Génère
SyncException	si le fichier n'a pas pu être transféré ;
	en cas d'erreur d'E/S sur la connexion.
TimeoutException	en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.

statFile

public SyncService.FileStat statFile (String path)

Renvoie les informations sur les statistiques du fichier distant.

Paramètres
path	String : fichier distant

Renvoie
SyncService.FileStat	un FileStat contenant le mode, la taille et les informations sur la dernière modification si tout s'est bien passé, ou null dans le cas contraire.

Génère
	IOException
TimeoutException	en cas de délai d'inactivité lors de la lecture des réponses de l'appareil.