اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

SyncService

public class SyncService
extends Object

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

فئة خدمة المزامنة لإرسال البيانات إلى الأجهزة/المحاكيات أو سحبها منها، وذلك من خلال أداة تصحيح الأخطاء.

للحصول على عنصر SyncService، استخدِم IDevice.getSyncService().

ملخّص

الفئات المتداخلة
`class`	`SyncService.FileStat`
`interface`	`SyncService.ISyncProgressMonitor` توفّر الفئات التي تنفّذ هذه الواجهة طرقًا للتعامل مع عرض مستوى تقدّم عملية النقل.

الإنشاءات العامة
`SyncService(InetSocketAddress address, IDevice device)` تنشئ هذه الدالة عنصر خدمة Sync.

الطُرق العامة
`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)` تعرض هذه الدالة معلومات إحصائية عن الملف البعيد.

الإنشاءات العامة

SyncService

public SyncService (InetSocketAddress address, 
                IDevice device)

تنشئ هذه الدالة عنصر خدمة Sync.

المعلمات
`address`	`InetSocketAddress`: العنوان المطلوب الاتصال به
`device`	‫`IDevice`: `IDevice` الذي تتصل به الخدمة

الطُرق العامة

إغلاق

public void close ()

يؤدي هذا الإجراء إلى إغلاق الاتصال.

getNullProgressMonitor

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

تعرض هذه السمة أداة مراقبة لتقدّم المزامنة لا تفعل شيئًا. يتيح ذلك للمهام التي تعمل في الخلفية والتي لا تريد/تحتاج إلى عرض واجهة مستخدم، تمرير ISyncProgressMonitor صالح.

يمكن إعادة استخدام هذا العنصر عدة مرات ويمكن استخدامه من خلال سلاسل متزامنة.

المرتجعات
`SyncService.ISyncProgressMonitor`

openSync

public boolean openSync ()

يفتح هذا الإجراء اتصال المزامنة. يجب استدعاء هذه الدالة قبل أي استدعاءات للدالتين push[File] / pull[File].

المرتجعات
`boolean`	تعرض القيمة "صحيح" إذا تم فتح الاتصال، و"خطأ" إذا رفضت أداة تصحيح الأخطاء في Android الاتصال. يمكن أن يحدث ذلك إذا كان `IDevice` غير صالح.

الرميات
`TimeoutException`	في حال انتهاء مهلة الاتصال
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
	في حال تعذّر الاتصال بـ adb

سحب

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

يجلب الملفات أو المجلدات.

المعلمات
`entries`	‫`FileEntry`: العناصر البعيدة التي سيتم سحبها
`localPath`	‫`String`: تمثّل هذه السمة الوجهة المحلية. إذا كان عدد الإدخالات > 1 أو إذا كان الإدخال الفريد مجلدًا، يجب أن يكون هذا مجلدًا.
`monitor`	‫`SyncService.ISyncProgressMonitor`: أداة مراقبة التقدّم لا يمكن أن تكون القيمة فارغة.

الرميات
	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`: أداة مراقبة التقدّم لا يمكن أن تكون القيمة فارغة.

الرميات
	في حال حدوث خطأ في الإدخال/الإخراج.
`TimeoutException`	في حال انتهاء المهلة المحدّدة لقراءة الردود من الجهاز
`SyncException`	في حال حدوث خطأ في المزامنة

يُرجى الاطّلاع أيضًا على:

pullFile

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

يجلب ملفًا واحدًا.

بما أنّ هذه الطريقة تتعامل فقط مع سلسلة لملف بعيد بدلاً من FileEntry، فإنّ حجم الملف الذي يتم جلبه غير معروف ولن يعرض ISyncProgressMonitor مستوى التقدّم بشكل صحيح.

المعلمات
`remoteFilepath`	‫`String`: المسار الكامل إلى الملف البعيد
`localFilename`	‫`String`: تمثّل هذه السمة الوجهة المحلية.
`monitor`	‫`SyncService.ISyncProgressMonitor`: أداة مراقبة التقدّم لا يمكن أن تكون القيمة فارغة.

الرميات
	في حال حدوث خطأ في الإدخال/الإخراج.
`TimeoutException`	في حال انتهاء المهلة المحدّدة لقراءة الردود من الجهاز
`SyncException`	في حال حدوث خطأ في المزامنة

يُرجى الاطّلاع أيضًا على:

getNullProgressMonitor()

إرسال

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`: أداة مراقبة التقدّم لا يمكن أن تكون القيمة فارغة.

الرميات
`SyncException`	إذا تعذّر إرسال الملف
	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال
`TimeoutException`	في حال انتهاء المهلة المحدّدة لقراءة الردود من الجهاز

statFile

public SyncService.FileStat statFile (String path)

تعرض هذه الدالة معلومات إحصائية عن الملف البعيد.

المعلمات
`path`	`String`: الملف البعيد

المرتجعات
`SyncService.FileStat`	FileStat يحتوي على وضع الملف وحجمه ومعلومات آخر تعديل إذا سارت الأمور على ما يرام أو قيمة فارغة في حال حدوث خطأ

الرميات
	IOException
`TimeoutException`	في حال انتهاء المهلة المحدّدة لقراءة الردود من الجهاز

SyncService

ملخّص

الفئات المتداخلة

الإنشاءات العامة

الطُرق العامة

الإنشاءات العامة

SyncService

الطُرق العامة

إغلاق

getNullProgressMonitor

openSync

سحب

pullFile

pullFile

إرسال

إرسال

pushFile

statFile