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

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

DeviceLaunchControlProvider

public class DeviceLaunchControlProvider
extends LaunchControlProvider implements IDeviceBuildProvider

java.lang.Object
↳	com.google.android.tradefed.build.LaunchControlProvider
	↳	com.google.android.tradefed.build.DeviceLaunchControlProvider

الفئات الفرعية المباشرة المعروفة

CtsDeviceLaunchControlProvider

CtsDeviceLaunchControlProvider ‫LaunchControlProvider مقابل DeviceFolderBuildInfo

حساب LaunchControlProvider لـ IDeviceBuildInfo

ملخّص

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

الإجراءات العامة
`void`	`addDownloadKey(RemoteBuildInfo.BuildAttributeKey attrKey)` يجب تنزيل ملف باستخدام `BuildAttributeKey` معيّن.
`void`	`cleanUp(IBuildInfo info)` احذف أي ملفات إنشاء مؤقتة.
`static Set<String>`	`discoverDependencies(IConfiguration config)` استكشاف تبعيات الإعدادات
`void`	`evaluateDeviceImageChanges(RemoteBuildInfo remoteBuild, IFileDownloader downloader, IDeviceBuildInfo localBuild)` نزِّل الجزء المطلوب لتقييم ما إذا تم تغيير صورة الجهاز أم لا.
`IBuildInfo`	`getBuild(ITestDevice device)` استرداد بيانات الإصدار قيد الاختبار
`ITestDevice`	`getDevice()`
`static String`	`getPathForPattern(RemoteBuildInfo buildInfo, String pattern, boolean ignoreSubdir)` طريقة مساعدة للحصول على المسار البعيد للصور من RemoteBuildInfo
`static String`	`getPathForPattern(RemoteBuildInfo buildInfo, String pattern)` طريقة مساعدة للحصول على المسار البعيد للصور من RemoteBuildInfo
`RemoteBuildInfo`	`getRemoteBuild()` يمكنك الحصول على ردّ بشأن التحكّم في إطلاق التطبيق بدون تنزيل جميع الملفات.
`Set<String>`	`reportTestZipFileFilter()`
`void`	`setAltStaticDeviceInfoClass(String altStaticDeviceInfoClass)`
`void`	`setBootstrapBuildInfo(boolean bootstrapBuildInfo)` معرَّض للاختبار
`boolean`	`shouldAutopopulateFilters()`
`void`	`skipDownload(RemoteBuildInfo.BuildAttributeKey attrKey)` تخطّي تنزيل ملف باستخدام `BuildAttributeKey` معيّن

طُرق محمية
`void`	`convertBuildToSigned(RemoteBuildInfo remoteBuild)` عدِّل المَعلمات في هذا `RemoteBuildInfo` لوصف إصدار موقَّع.
`IBuildInfo`	`downloadBuildFiles(RemoteBuildInfo remoteBuild, String testTargetName, String buildName, IFileDownloader downloader)` نزِّل مفاتيح الملفات اللازمة كما تم ضبطها في --download-build-key من `remoteBuild`، وخزِّنها في `IBuildInfo`.
`void`	`resolveBuildInfoFromDevice(ITestDevice device)` الحصول على رقم التعريف الخاص بالإصدار ونوعه من الجهاز واسترداد معلومات الفرع من خادم الإصدار
`void`	`setDevice(ITestDevice device)`

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

DeviceLaunchControlProvider

public DeviceLaunchControlProvider ()

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

addDownloadKey

public void addDownloadKey (RemoteBuildInfo.BuildAttributeKey attrKey)

يجب تنزيل ملف باستخدام BuildAttributeKey معيّن. يُرجى العِلم أنّ الاستثناءات لها الأولوية على عمليات التضمين، لذا إذا كان الملف في قائمة التخطّي، لن يتم تنزيله حتى إذا تم ذكره هنا.

المعلَمات
`attrKey`	`RemoteBuildInfo.BuildAttributeKey`

cleanUp

public void cleanUp (IBuildInfo info)

احذف أي ملفات إنشاء مؤقتة.

المعلَمات
`info`	`IBuildInfo`

discoverDependencies

public static Set<String> discoverDependencies (IConfiguration config)

استكشاف تبعيات الإعدادات

المعلَمات
`config`	`IConfiguration`

المرتجعات
`Set<String>`

evaluateDeviceImageChanges

public void evaluateDeviceImageChanges (RemoteBuildInfo remoteBuild, 
                IFileDownloader downloader, 
                IDeviceBuildInfo localBuild)

نزِّل الجزء المطلوب لتقييم ما إذا تم تغيير صورة الجهاز أم لا.

المعلَمات
`remoteBuild`	`RemoteBuildInfo`
`downloader`	`IFileDownloader`
`localBuild`	`IDeviceBuildInfo`

getBuild

public IBuildInfo getBuild (ITestDevice device)

استرداد بيانات الإصدار قيد الاختبار

المعلَمات
`device`	‫`ITestDevice`: `ITestDevice` المخصّص للاختبار

المرتجعات
`IBuildInfo`	`IBuildInfo` لإنشاء إصدار قيد الاختبار أو `null` إذا لم يتوفّر أي إصدار للاختبار

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

getDevice

public ITestDevice getDevice ()

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

getPathForPattern

public static String getPathForPattern (RemoteBuildInfo buildInfo, 
                String pattern, 
                boolean ignoreSubdir)

طريقة مساعدة للحصول على المسار البعيد للصور من RemoteBuildInfo

المعلَمات
`buildInfo`	`RemoteBuildInfo`: RemoteBuildInfo
`pattern`	‫`String`: نمط المسار البعيد للصورة
`ignoreSubdir`	`boolean`: إذا كانت القيمة صحيحة، سيتم تجاهل الدليل الفرعي في النمط

المرتجعات
`String`	المسار البعيد

getPathForPattern

public static String getPathForPattern (RemoteBuildInfo buildInfo, 
                String pattern)

طريقة مساعدة للحصول على المسار البعيد للصور من RemoteBuildInfo

المعلَمات
`buildInfo`	`RemoteBuildInfo`: RemoteBuildInfo
`pattern`	‫`String`: نمط المسار البعيد للصورة

المرتجعات
`String`	المسار البعيد

getRemoteBuild

public RemoteBuildInfo getRemoteBuild ()

يمكنك الحصول على ردّ بشأن التحكّم في إطلاق التطبيق بدون تنزيل جميع الملفات.

تمت إتاحتها للجميع لكي تتمكّن التخصّصات خارج هذه الحزمة من استخدامها مباشرةً. في العادة، يجب استخدام getBuild() بدلاً من ذلك.

المرتجعات
`RemoteBuildInfo`	الردّ `RemoteBuildInfo` من أداة التحكّم في التشغيل

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

reportTestZipFileFilter

public Set<String> reportTestZipFileFilter ()

المرتجعات
`Set<String>`

setAltStaticDeviceInfoClass

public void setAltStaticDeviceInfoClass (String altStaticDeviceInfoClass)

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

setBootstrapBuildInfo

public void setBootstrapBuildInfo (boolean bootstrapBuildInfo)

معرَّض للاختبار

shouldAutopopulateFilters

public boolean shouldAutopopulateFilters ()

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

skipDownload

public void skipDownload (RemoteBuildInfo.BuildAttributeKey attrKey)

تخطّي تنزيل ملف باستخدام BuildAttributeKey معيّن

المعلَمات
`attrKey`	`RemoteBuildInfo.BuildAttributeKey`

طُرق محمية

convertBuildToSigned

protected void convertBuildToSigned (RemoteBuildInfo remoteBuild)

عدِّل المَعلمات في هذا RemoteBuildInfo لوصف إصدار موقَّع.

المعلَمات
`remoteBuild`	`RemoteBuildInfo`: `RemoteBuildInfo` المطلوب تعديله

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

downloadBuildFiles

protected IBuildInfo downloadBuildFiles (RemoteBuildInfo remoteBuild, 
                String testTargetName, 
                String buildName, 
                IFileDownloader downloader)

نزِّل مفاتيح الملفات اللازمة كما تم ضبطها في --download-build-key من remoteBuild، وخزِّنها في IBuildInfo.

المعلَمات
`remoteBuild`	‫`RemoteBuildInfo`: استجابة خادم التحكّم في الإطلاق
`testTargetName`	`String`: اسم هدف الاختبار
`buildName`	`String`: اسم الإصدار، كما هو محدّد من خلال أداة التحكّم في الإصدار
`downloader`	`IFileDownloader`: `IFileDownloader` المطلوب استخدامه لتنزيل ملفات الإصدار

المرتجعات
`IBuildInfo`	يتم ملء `IBuildInfo` بنسخ محلية من ملفات الإنشاء

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

resolveBuildInfoFromDevice

protected void resolveBuildInfoFromDevice (ITestDevice device)

الحصول على رقم التعريف الخاص بالإصدار ونوعه من الجهاز واسترداد معلومات الفرع من خادم الإصدار

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

setDevice

protected void setDevice (ITestDevice device)

المعلَمات
`device`	`ITestDevice`