IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

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

ملخّص

الطرق العامة

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 ()

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