اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

AndroidBuildDownloader

public class AndroidBuildDownloader
extends Object implements IFileDownloader

java.lang.Object
↳	com.google.android.tradefed.build.AndroidBuildDownloader

IFileDownloader يسترد الملفات من Android Build API.

ملخّص

الحقول
`protected static final ConcurrentMap<String, RemoteZip>`	`REMOTE_ZIP_CACHE` ذاكرة تخزين مؤقت لملفات ZIP البعيدة مفهرسة حسب المسار البعيد

طُرق وضع التصميم العامة
`AndroidBuildDownloader()`

الإجراءات العامة
`static File`	`createTempFile(String remoteFilePath, File rootDir)` ينشئ هذا الإجراء ملفًا فريدًا على القرص المؤقت لتخزين الملف الذي تم تنزيله باستخدام المسار المحدّد.
`void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` شكل بديل من `downloadFile(String,File)`، يتيح للمتصل تنزيل جزء من الملف وحفظه في ملف وجهة محدّد.
`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 بعيد
`void`	`enablePartialDownloadCache(boolean enablePartialDownloadCache)`
`void`	`setMetadataCheck(boolean enableMetadataCheck)`
`void`	`setResolveSymlinks(boolean resolveSymlinks)`
`void`	`setUseMd5(boolean useMd5)`

طُرق محمية
`AndroidBuildFetcher`	`getBuildFetcher()` تعرض هذه الدالة AndroidBuildFetcher، وتنشئها إذا لم تكن متوفّرة من قبل.
`void`	`setBuildEnvironment(String buildEnvironment)`

الحقول

REMOTE_ZIP_CACHE

protected static final ConcurrentMap<String, RemoteZip> REMOTE_ZIP_CACHE

ذاكرة تخزين مؤقت لملفات ZIP البعيدة مفهرسة حسب المسار البعيد

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

AndroidBuildDownloader

public AndroidBuildDownloader ()

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

createTempFile

public static File createTempFile (String remoteFilePath, 
                File rootDir)

ينشئ هذا الإجراء ملفًا فريدًا على القرص المؤقت لتخزين الملف الذي تم تنزيله باستخدام المسار المحدّد.

تنشئ هذه السمة اسم الملف استنادًا إلى اسم الملف الأساسي من المسار

المعلَمات
`remoteFilePath`	‫`String`: المسار البعيد الذي سيتم إنشاء الاسم منه
`rootDir`	`File`

المرتجعات
`File`

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

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 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`

enablePartialDownloadCache

public void enablePartialDownloadCache (boolean enablePartialDownloadCache)

المعلَمات
`enablePartialDownloadCache`	`boolean`

setMetadataCheck

public void setMetadataCheck (boolean enableMetadataCheck)

المعلَمات
`enableMetadataCheck`	`boolean`

setResolveSymlinks

public void setResolveSymlinks (boolean resolveSymlinks)

المعلَمات
`resolveSymlinks`	`boolean`

setUseMd5

public void setUseMd5 (boolean useMd5)

المعلَمات
`useMd5`	`boolean`

طُرق محمية

getBuildFetcher

protected AndroidBuildFetcher getBuildFetcher ()

تعرض هذه الدالة AndroidBuildFetcher، وتنشئها إذا لم تكن متوفّرة من قبل.

المرتجعات
`AndroidBuildFetcher`

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

setBuildEnvironment

protected void setBuildEnvironment (String buildEnvironment)

المعلَمات
`buildEnvironment`	`String`