SyncService

public class SyncService
extends Object

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

סנכרון של מחלקת שירות כדי לבצע פעולות push/pull למכשירים/לסימולטורים וממכשירים/מסימולטורים, דרך גשר הניפוי באגים.

כדי לקבל אובייקט SyncService, משתמשים ב-IDevice.getSyncService().

סיכום

כיתות במבנה היררכי

class SyncService.FileStat

 

interface SyncService.ISyncProgressMonitor

במחלקה שמטמיעה את הממשק הזה יש שיטות שקשורות להצגת ההתקדמות של ההעברה. 

Constructors ציבוריים

SyncService(InetSocketAddress address, IDevice device)

יוצרת אובייקט של שירות סנכרון.

‫methods ציבוריים

void close()

החיבור ייסגר.

static SyncService.ISyncProgressMonitor getNullProgressMonitor()

מחזירה כלי למעקב אחר התקדמות הסנכרון שלא עושה כלום.

boolean openSync()

פותח את חיבור הסנכרון.

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

שליפת קבצים או תיקיות.

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

שליפה של קובץ יחיד.

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

שליפה של קובץ יחיד.

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

העברה של כמה קבצים או ספריות.

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

העברה של כמה קבצים או ספריות.

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

שליחת קובץ יחיד.

SyncService.FileStat statFile(String path)

מחזירה את פרטי הסטטיסטיקה של הקובץ המרוחק.

Constructors ציבוריים

SyncService

public SyncService (InetSocketAddress address, 
                IDevice device)

יוצרת אובייקט של שירות סנכרון.

פרמטרים
address InetSocketAddress: הכתובת להתחברות
device ‫IDevice: IDevice שהשירות מתחבר אליו.

‫methods ציבוריים

סגירה

public void close ()

החיבור נסגר.

getNullProgressMonitor

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

מחזירה כלי למעקב אחר התקדמות הסנכרון שלא עושה כלום. כך אפשר להעביר ISyncProgressMonitor תקין למשימות ברקע שלא רוצות או צריכות להציג ממשק משתמש.

אפשר להשתמש באובייקט הזה כמה פעמים, והוא יכול לשמש כמה תהליכים מקבילים.

החזרות
SyncService.ISyncProgressMonitor

openSync

public boolean openSync ()

פותח את חיבור הסנכרון. חובה להפעיל את הפונקציה הזו לפני כל הפעלה של push[File] / pull[File].

החזרות
boolean true אם החיבור נפתח, false אם adb דוחה את החיבור. זה יכול לקרות אם: הערך של IDevice לא תקין.
זריקות
TimeoutException במקרה שהזמן הקצוב לתפוגה של החיבור פג.
AdbCommandRejectedException אם adb דוחה את הפקודה
אם החיבור ל-adb נכשל.

שליפה

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

שליפת קבצים או תיקיות.

פרמטרים
entries ‫FileEntry: הפריטים המרוחקים שרוצים למשוך
localPath ‫String: היעד המקומי. אם מספר הרשומות גדול מ-1 או אם הרשומה הייחודית היא תיקייה, הערך צריך להיות תיקייה.
monitor ‫SyncService.ISyncProgressMonitor: מד ההתקדמות. הערך לא יכול להיות null.
זריקות
com.android.ddmlib.SyncException
IOException
com.android.ddmlib.TimeoutException
SyncException
TimeoutException

pullFile

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

שליפה של קובץ יחיד.

פרמטרים
remote FileListingService.FileEntry: הקובץ המרוחק
localFilename ‫String: היעד המקומי.
monitor ‫SyncService.ISyncProgressMonitor: מד ההתקדמות. הערך לא יכול להיות null.
זריקות
במקרה של חריגת קלט/פלט.
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר.
SyncException במקרה של חריגה בסנכרון.

pullFile

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

שליפה של קובץ יחיד.

מכיוון שהשיטה הזו מתייחסת רק למחרוזת של הקובץ המרוחק במקום ל-FileEntry, הגודל של הקובץ שנשלף לא ידוע וההתקדמות לא תוצג בצורה תקינה ב-ISyncProgressMonitor

פרמטרים
remoteFilepath ‫String: הנתיב המלא לקובץ המרוחק
localFilename ‫String: היעד המקומי.
monitor ‫SyncService.ISyncProgressMonitor: מד ההתקדמות. הערך לא יכול להיות null.
זריקות
במקרה של חריגת קלט/פלט.
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר.
SyncException במקרה של חריגה בסנכרון.

מידע נוסף:

דחיפה

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

העברה של כמה קבצים או ספריות.

פרמטרים
local ‫String: הקבצים המקומיים להעלאה
remote ‫FileListingService.FileEntry: ה-FileEntry המרוחק שמייצג ספרייה
monitor ‫SyncService.ISyncProgressMonitor: מד ההתקדמות
זריקות
SyncException אם אי אפשר לדחוף חלק מהקבצים
במקרה של שגיאת קלט/פלט בחיבור
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר

דחיפה

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

העברה של כמה קבצים או ספריות.

פרמטרים
local ‫String: הקבצים המקומיים להעלאה
remote ‫String: הנתיב המרוחק שמייצג ספרייה
monitor ‫SyncService.ISyncProgressMonitor: מד ההתקדמות
זריקות
SyncException אם אי אפשר לדחוף חלק מהקבצים
במקרה של שגיאת קלט/פלט בחיבור
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר

pushFile

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

דחיפה של קובץ יחיד.

פרמטרים
local ‫String: הנתיב המקומי של הקובץ.
remote ‫String: נתיב הקובץ המרוחק.
monitor ‫SyncService.ISyncProgressMonitor: מד ההתקדמות. הערך לא יכול להיות null.
זריקות
SyncException אם אי אפשר לדחוף את הקובץ
במקרה של שגיאת קלט/פלט בחיבור.
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר.

statFile

public SyncService.FileStat statFile (String path)

מחזירה את פרטי הסטטיסטיקה של הקובץ המרוחק.

פרמטרים
path String: הקובץ המרוחק
החזרות
SyncService.FileStat ‫FileStat שמכיל את המצב, הגודל ופרטי השינוי האחרון אם הכול עבר בצורה תקינה, או null אחרת

זריקות
IOException
TimeoutException במקרה של פסק זמן בקריאת התשובות מהמכשיר.