اعتبارًا من عام 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.

‫FileDownloadCacheWrapper

public class FileDownloadCacheWrapper
extends Object implements IFileDownloader

java.lang.Object
↳	com.android.tradefed.build.FileDownloadCacheWrapper

فئة تغليف توفّر إمكانات FileDownloadCache مع تنفيذ واجهة IFileDownloader.

تكون هذه الفئة مفيدة في الحالات التي تريد فيها تجريد استخدام ذاكرة التخزين المؤقت من المتصلين.

ملخّص

طُرق وضع التصميم العامة
`FileDownloadCacheWrapper(File cacheDir, IFileDownloader delegateDownloader)`

الإجراءات العامة
`void`	`downloadFile(String remoteFilePath, File destFile)` شكل بديل من `downloadFile(String)`، يسمح للمتصل بتحديد ملف الوجهة الذي يجب وضع المحتوى البعيد فيه.
`File`	`downloadFile(String remoteFilePath)` تنزيل ملف بعيد إلى ملف مؤقت على القرص المحلي
`void`	`downloadZippedFiles(File destDir, String remoteFilePath, List<String> includeFilters, List<String> excludeFilters)` تنزيل الملفات التي تطابق الفلاتر المحدّدة في ملف ZIP بعيد
`boolean`	`isFresh(File localFile, String remoteFilePath)` التحقّق من حداثة الملف المحلي

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

FileDownloadCacheWrapper

public FileDownloadCacheWrapper (File cacheDir, 
                IFileDownloader delegateDownloader)

المعلَمات
`cacheDir`	`File`
`delegateDownloader`	`IFileDownloader`

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

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile)

شكل بديل من downloadFile(String)، يسمح للمتصل بتحديد ملف الوجهة الذي يجب وضع المحتوى البعيد فيه.

المعلَمات
`remoteFilePath`	`String`: المسار البعيد للملف الذي سيتم تنزيله، بالنسبة إلى جذر خاص بالتنفيذ
`destFile`	`File`: الملف الذي سيتم وضع المحتوى الذي تم تنزيله فيه يجب ألا يكون هذا الملف موجودًا.

عمليات الطرح
`BuildRetrievalError`

downloadFile

public File downloadFile (String remoteFilePath)

تنزيل ملف بعيد إلى ملف مؤقت على القرص المحلي

المعلَمات
`remoteFilePath`	`String`: المسار البعيد للملف الذي سيتم تنزيله، بالنسبة إلى جذر خاص بالتنفيذ

المرتجعات
`File`	`File` المؤقت الذي تم تنزيله محليًا

عمليات الطرح
`BuildRetrievalError`

downloadZippedFiles

public void downloadZippedFiles (File destDir, 
                String remoteFilePath, 
                List<String> includeFilters, 
                List<String> excludeFilters)

تنزيل الملفات التي تطابق الفلاتر المحدّدة في ملف ZIP بعيد

لا يتم تنزيل ملف داخل ملف ZIP البعيد إلا إذا كان مساره يطابق أيًا من الـ فلاتر التضمين ولكن لا يطابق فلاتر الاستبعاد.

المعلَمات
`destDir`	`File`: الملف الذي سيتم وضع المحتوى الذي تم تنزيله فيه
`remoteFilePath`	`String`: المسار البعيد للملف الذي سيتم تنزيله، بالنسبة إلى جذر خاص بالتنفيذ
`includeFilters`	`List`: قائمة بالفلاتر لتنزيل الملفات المطابقة
`excludeFilters`	`List`: قائمة بالفلاتر لتخطّي تنزيل الملفات المطابقة

عمليات الطرح
`BuildRetrievalError`
`IOException`

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

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

المعلَمات
`localFile`	`File`: الملف المحلي
`remoteFilePath`	`String`: مسار الملف البعيد

المرتجعات
`boolean`	صحيح إذا كان الملف المحلي حديثًا، وغير ذلك خطأ

عمليات الطرح
`BuildRetrievalError`