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, List<String> includeFilters, List<String> 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 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 إذا تعذّر تنزيل الملفات
‫java.io.IOException
IOException

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

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

المعلَمات
localFile File: الملف المحلي
remoteFilePath String: مسار الملف البعيد
المرتجعات
boolean "صحيح" إذا كان الملف المحلي حديثًا، و"خطأ" إذا لم يكن كذلك
عمليات الطرح
‫com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

إذا كان حدّ التزامن متاحًا، يمكنك إلغاء إذن تنزيل.