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

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

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

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

ملخّص

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

طُرق وضع التصميم العامة
`SyncService(InetSocketAddress address, IDevice device)` تنشئ هذه السمة عنصر خدمة المزامنة.

الإجراءات العامة
`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)

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

المعلَمات
`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` غير صالح.

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

سحب

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

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

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

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

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

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

pullFile

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

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

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

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

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

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

getNullProgressMonitor()

إرسال

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

يدفع عدة ملفات أو أدلة.

المعلَمات
`local`	`String`: الملفات المحلية التي سيتم إرسالها
`remote`	‫`FileListingService.FileEntry`: `FileEntry` البعيد الذي يمثّل دليلاً
`monitor`	‫`SyncService.ISyncProgressMonitor`: شاشة مراقبة التقدّم

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

إرسال

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

يدفع عدة ملفات أو أدلة.

المعلَمات
`local`	`String`: الملفات المحلية التي سيتم إرسالها
`remote`	‫`String`: المسار البعيد الذي يمثّل دليلاً
`monitor`	‫`SyncService.ISyncProgressMonitor`: شاشة مراقبة التقدّم

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

pushFile

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

إرسال ملف واحد

المعلَمات
`local`	`String`: مسار الملف المحلي
`remote`	`String`: مسار الملف البعيد
`monitor`	`SyncService.ISyncProgressMonitor`: أداة مراقبة التقدّم لا يمكن أن تكون القيمة فارغة.

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

statFile

public SyncService.FileStat statFile (String path)

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

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

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

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

SyncService

ملخّص

الصفوف المتداخلة

طُرق وضع التصميم العامة

الإجراءات العامة

طُرق وضع التصميم العامة

SyncService

الإجراءات العامة

إغلاق

getNullProgressMonitor

openSync

سحب

pullFile

pullFile

إرسال

إرسال

pushFile

statFile