החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

SyncService

public class SyncService
extends Object implements AutoCloseable

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` לא תקין.

הקפצת הודעות שגיאה (throw)
`AdbCommandRejectedException`	אם adb דוחה את הפקודה
`TimeoutException`	במקרה שהזמן הקצוב לתפוגה של החיבור פג.
`IOException`	אם החיבור ל-adb נכשל.

שליפת הודעות

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

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

פרמטרים
`entries`	‫`FileEntry`: הפריטים המרוחקים שיש לשלוף
`localPath`	‫`String`: היעד המקומי. אם מספר הרשומות גדול מ-1 או אם הרשומה הייחודית היא תיקייה, הערך צריך להיות תיקייה.
`monitor`	‫`SyncService.ISyncProgressMonitor`: מד ההתקדמות. הערך לא יכול להיות null.

הקפצת הודעות שגיאה (throw)
	com.android.ddmlib.SyncException
	com.android.ddmlib.TimeoutException
	java.io.IOException
`IOException`
`SyncException`
`TimeoutException`

מידע נוסף:

pullFile

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

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

פרמטרים
`remote`	`FileListingService.FileEntry`: הקובץ המרוחק
`localFilename`	‫`String`: היעד המקומי.
`monitor`	‫`SyncService.ISyncProgressMonitor`: מד ההתקדמות. הערך לא יכול להיות null.

הקפצת הודעות שגיאה (throw)
`SyncException`	במקרה של חריגה בסנכרון.
`TimeoutException`	במקרה של פסק זמן בקריאת התשובות מהמכשיר.
`IOException`	במקרה של חריגת קלט/פלט.

מידע נוסף:

pullFile

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

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

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

פרמטרים
`remoteFilepath`	‫`String`: הנתיב המלא לקובץ המרוחק
`localFilename`	‫`String`: היעד המקומי.
`monitor`	‫`SyncService.ISyncProgressMonitor`: מד ההתקדמות. הערך לא יכול להיות null.

הקפצת הודעות שגיאה (throw)
`SyncException`	במקרה של חריגה בסנכרון.
`TimeoutException`	במקרה של פסק זמן בקריאת התשובות מהמכשיר.
`IOException`	במקרה של חריגת קלט/פלט.

מידע נוסף:

getNullProgressMonitor()

דחיפת הודעות

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

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

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

הקפצת הודעות שגיאה (throw)
`SyncException`	אם לא ניתן לדחוף חלק מהקבצים
`TimeoutException`	במקרה של פסק זמן בקריאת התשובות מהמכשיר
`IOException`	במקרה של שגיאת קלט/פלט בחיבור

דחיפת הודעות

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

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

פרמטרים
`local`	‫`String`: הקבצים המקומיים להעלאה
`remote`	‫`String`: הנתיב המרוחק שמייצג ספרייה
`monitor`	‫`SyncService.ISyncProgressMonitor`: מד התקדמות

הקפצת הודעות שגיאה (throw)
`SyncException`	אם לא ניתן לדחוף חלק מהקבצים
`TimeoutException`	במקרה של פסק זמן בקריאת התשובות מהמכשיר
`IOException`	במקרה של שגיאת קלט/פלט בחיבור

pushFile

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

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

פרמטרים
`local`	‫`String`: נתיב הקובץ המקומי.
`remote`	‫`String`: נתיב הקובץ המרוחק.
`monitor`	‫`SyncService.ISyncProgressMonitor`: מד ההתקדמות. הערך לא יכול להיות null.

הקפצת הודעות שגיאה (throw)
`SyncException`	אם אי אפשר לדחוף את הקובץ
`TimeoutException`	במקרה של פסק זמן בקריאת התשובות מהמכשיר.
`IOException`	במקרה של שגיאת קלט/פלט בחיבור.

statFile

public SyncService.FileStat statFile (String path)

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

פרמטרים
`path`	`String`: הקובץ המרוחק

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

הקפצת הודעות שגיאה (throw)
`TimeoutException`	במקרה של פסק זמן בקריאת התשובות מהמכשיר.
	java.io.IOException
`IOException`

SyncService

סיכום

כיתות מוטמעות

‫constructors ציבוריים

‫methods ציבוריים

‫constructors ציבוריים

SyncService

‫methods ציבוריים

סגירה

getNullProgressMonitor

openSync

שליפת הודעות

pullFile

pullFile

דחיפת הודעות

דחיפת הודעות

pushFile

statFile