IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

الفئات الفرعية غير المباشرة المعروفة FileDownloadCacheWrapper وGCSFileDownloader FileDownloadCacheWrapper فئة ملفّ تعريف توفر مرافق FileDownloadCache أثناء تنفيذ واجهة IFileDownloader.  GCSFileDownloader أداة تنزيل الملفات لتنزيل الملفات من Google Cloud Storage (GCS)

---

واجهة لتنزيل ملف عن بُعد

ملخّص

الطرق العامة
default void	acquireDownloadPermit() إذا كان الحدّ الأقصى للعمليات المتزامنة مسموحًا به، يمكنك الحصول على إذن تنزيل.
default void	downloadFile(String remoteFilePath, File destFile, long startOffset, long size) شكل بديل من downloadFile(String, File)، يسمح للمتصل بتنزيل قسم من الملف وحفظه في ملف وجهة محدّد.
abstract void	downloadFile(String relativeRemotePath, File destFile) تنسيق بديل لـ downloadFile(String)، يسمح للمتصل بتحديدملف الوجهة الذي يجب وضع المحتوى البعيد فيه.
abstract File	downloadFile(String remoteFilePath) تنزيل ملف عن بُعد إلى ملف مؤقت على القرص المحلي
default void	downloadZippedFiles(File destDir, String remoteFilePath, includeFilters, excludeFilters) تنزيل الملفات التي تتطابق مع الفلاتر المحدّدة في ملف zip عن بُعد
default boolean	isFresh(File localFile, String remoteFilePath) تأكَّد من حداثة الملف على الجهاز.
default void	releaseDownloadPermit() إذا كان الحد الأقصى لعدد عمليات التنزيل المتزامنة مسموحًا به، عليك إصدار إذن تنزيل.

الطرق العامة

acquireDownloadPermit

public void acquireDownloadPermit ()

إذا كان الحدّ الأقصى للعمليات المتزامنة مسموحًا به، يمكنك الحصول على إذن تنزيل.

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile, 
                long startOffset, 
                long size)

شكل بديل من downloadFile(String, File)، يسمح للمتصل بتنزيل قسم من الملف وحفظه في ملف وجهة محدّد.

المعلمات
remoteFilePath	‫String: المسار البعيد للملف المطلوب تنزيله، نسبةً إلى جذر خاص بالتنفيذ
destFile	‫File: الملف الذي سيتم وضع المحتوى الذي تم تنزيله فيه يجب ألا يكون متوفّرًا.
startOffset	‫long: بدء التقديم أو الإيقاف في الملف البعيد
size	‫long: عدد البايتات المطلوب تنزيلها من الملف البعيد اضبطها على قيمة سلبية لتنزيل الملف بأكمله.

عمليات الرمي
BuildRetrievalError	إذا تعذّر تنزيل الملف

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

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

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

عمليات الرمي
BuildRetrievalError	إذا تعذّر تنزيل الملف

downloadFile

public abstract File downloadFile (String remoteFilePath)

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

المعلمات
remoteFilePath	‫String: المسار البعيد للملف المطلوب تنزيله، نسبةً إلى جذر تنفيذ محدّد

المرتجعات
File	تم تنزيل ERROR(/File) مؤقتًا على الجهاز.

عمليات الرمي
BuildRetrievalError	إذا تعذّر تنزيل الملف

downloadZippedFiles

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

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

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

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

عمليات الرمي
BuildRetrievalError	إذا تعذّر تنزيل الملفات
	IOException

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

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

المعلمات
localFile	‫File: ملف على الجهاز
remoteFilePath	String: مسار الملف البعيد

المرتجعات
boolean	صحيح إذا كان الملف على الجهاز جديدًا، وخطأ بخلاف ذلك

عمليات الرمي
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

إذا كان الحد الأقصى لعدد عمليات التنزيل المتزامنة مسموحًا به، عليك إصدار إذن تنزيل.