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

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

AndroidBuildFetcher

public class AndroidBuildFetcher
extends Object

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

فئة مساعدة تُستخدَم لتنزيل الملفات من Android Build API.

ملخّص

طُرق وضع التصميم العامة
`AndroidBuildFetcher(String buildEnv)` منشئ AndroidBuildFetcher

الإجراءات العامة
`void`	`fetchArtifact(String target, String buildId, String resourceId, String attemptId, File outputFile)` نزِّل العنصر إلى ملف محلي.
`void`	`fetchArtifact(String target, String buildId, String resourceId, String attemptId, File outputFile, long startOffset, long size)` تنزيل جزء من العنصر إلى ملف محلي بالنطاق المحدّد
`void`	`fetchDeviceBlob(String deviceName, String binaryType, String version, File outputFile)` نزِّل كائن البيانات الثنائية الكبير للجهاز إلى ملف محلي.
`BuildArtifactMetadata`	`getArtifactMetadata(String target, String buildId, String resourceId, String attemptId)` الحصول على البيانات الوصفية لعنصر البناء
`void`	`setUseMd5(boolean useMd5)`

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

AndroidBuildFetcher

public AndroidBuildFetcher (String buildEnv)

منشئ AndroidBuildFetcher

المعلَمات
`buildEnv`	‫`String`: بيئة Build API التي سيتم استخدامها.

عمليات الطرح
	java.io.IOException
	java.security.GeneralSecurityException
`GeneralSecurityException`
`IOException`

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

fetchArtifact

public void fetchArtifact (String target, 
                String buildId, 
                String resourceId, 
                String attemptId, 
                File outputFile)

نزِّل العنصر إلى ملف محلي.

المعلَمات
`target`	`String`: هدف العنصر. إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`buildId`	‫`String`: معرّف الإصدار الخاص بالعنصر إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`resourceId`	استبدِل `String` باسم الملف المطلوب تنزيله. إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`attemptId`	‫`String`: رقم تعريف الأحدث أو الحالي أو محاولة إثبات الهوية، والقيمة التلقائية هي الأحدث.
`outputFile`	`File`: تنزيل الملف إلى هذا الملف المحلي

عمليات الطرح
	com.android.tradefed.build.BuildRetrievalError
	java.io.IOException
`BuildRetrievalError`
`IOException`

fetchArtifact

public void fetchArtifact (String target, 
                String buildId, 
                String resourceId, 
                String attemptId, 
                File outputFile, 
                long startOffset, 
                long size)

تنزيل جزء من العنصر إلى ملف محلي بالنطاق المحدّد

المعلَمات
`target`	`String`: هدف العنصر. إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`buildId`	‫`String`: معرّف الإصدار الخاص بالعنصر إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`resourceId`	استبدِل `String` باسم الملف المطلوب تنزيله. إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`attemptId`	‫`String`: رقم تعريف الأحدث أو الحالي أو محاولة إثبات الهوية، والقيمة التلقائية هي الأحدث.
`outputFile`	`File`: تنزيل الملف إلى هذا الملف المحلي
`startOffset`	‫`long`: إزاحة بداية الملف المطلوب تنزيله
`size`	‫`long`: عدد وحدات البايت المطلوب تنزيلها اضبطها على قيمة سالبة لجلب الملف بأكمله.

عمليات الطرح
	com.android.tradefed.build.BuildRetrievalError
	java.io.IOException
`BuildRetrievalError`
`IOException`

fetchDeviceBlob

public void fetchDeviceBlob (String deviceName, 
                String binaryType, 
                String version, 
                File outputFile)

نزِّل كائن البيانات الثنائية الكبير للجهاز إلى ملف محلي.

المعلَمات
`deviceName`	`String`: إذا كانت هذه القيمة فارغة، سيتعذّر التنزيل.
`binaryType`	‫`String`: radio.img أو bootloader.img إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`version`	‫`String`: إصدار الجهاز إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`outputFile`	‫`File`: ملف محلي نزِّل كائن البيانات الثنائية الكبير إلى هذا الملف المحلي.

عمليات الطرح
	java.io.IOException
`IOException`

getArtifactMetadata

public BuildArtifactMetadata getArtifactMetadata (String target, 
                String buildId, 
                String resourceId, 
                String attemptId)

الحصول على البيانات الوصفية لعنصر إصدار

المعلَمات
`target`	`String`: هدف العنصر. إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`buildId`	‫`String`: معرّف الإصدار الخاص بالعنصر إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`resourceId`	استبدِل `String` باسم الملف المطلوب تنزيله. إذا كانت القيمة فارغة، سيتعذّر التنزيل.
`attemptId`	‫`String`: رقم تعريف الأحدث أو الحالي أو محاولة إثبات الهوية، والقيمة التلقائية هي الأحدث.

المرتجعات
`BuildArtifactMetadata`	عنصر `BuildArtifactMetadata`

عمليات الطرح
	java.io.IOException
`IOException`

setUseMd5

public void setUseMd5 (boolean useMd5)

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