برنامج 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()

إذا كان حد التزامن متاحًا، يجب إصدار تصريح تنزيل.

الطرق العامة

الحصول على إذن تنزيل

public void acquireDownloadPermit ()

إذا كان حد التزامن متاحًا، احصل على تصريح التنزيل.

تنزيل الملف

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

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

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

تنزيل الملف

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

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

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

تنزيل الملف

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 إذا تعذر تنزيل الملفات.
IOاستثناء

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

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

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

إذن تنزيل البيانات

public void releaseDownloadPermit ()

إذا كان حد التزامن متاحًا، يجب إصدار تصريح تنزيل.