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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

DeviceUpdateTargetPreparer

public abstract class DeviceUpdateTargetPreparer
extends DeviceBuildInfoBootStrapper

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.DeviceBuildInfoBootStrapper
		↳	com.android.tradefed.targetprep.DeviceUpdateTargetPreparer

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

‫DeviceImageZipFlashingTargetPreparer وSideloadOtaTargetPreparer

DeviceImageZipFlashingTargetPreparer أداة إعداد هدف تعمل على وميض الجهاز باستخدام صور الجهاز المقدَّمة بتنسيق محدّد.

SideloadOtaTargetPreparer

أداة إعداد الهدف التي تنفّذ التحميل الجانبي لحزمة OTA محدّدة، وتطبّق الحزمة، وتنتظر حتى يتم تشغيل الجهاز، وتُدرج خصائص إصدار الجهاز لاستخدامها كمعلومات الإصدار

يفترض معدّ الإعداد المستهدف هذا أنّ الجهاز سيكون في وضع adb العادي عند بدء التشغيل، وسيضمن خروج الجهاز من الوضع نفسه ولكن مع تطبيق الإصدار الأحدث.

فئة مجرّدة ITargetPreparer تتولّى تنفيذ الخطوات الشائعة المتعلقة بتحديث الأجهزة باستخدام ملف صورة جهاز من مصدر خارجي (بدلاً من خدمة إنشاء). يتم تفويض آلية التحديث الفعلية إلى منفّذ الفئات الفرعية.

ملخّص

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

الإجراءات العامة
`void`	`setUp(TestInformation testInfo)`

طُرق محمية
`abstract File`	`getDeviceUpdateImage()` توفّر هذه السمة مثيلاً `File` يمثّل ملف صورة الجهاز الذي سيتم استخدامه للتحديث
`abstract void`	`performDeviceUpdate(File deviceUpdateImage, ITestDevice device)` تنفيذ تحديث صورة الجهاز على الجهاز
`abstract void`	`postUpdateActions(File deviceUpdateImage, ITestDevice device)` الإجراءات التي يجب تنفيذها بعد تحديث الجهاز ولكن قبل تنفيذ خطوات الإعداد بعد التحديث
`abstract void`	`preUpdateActions(File deviceUpdateImage, ITestDevice device)` الإجراءات التي يجب تنفيذها قبل تحديث الجهاز

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

DeviceUpdateTargetPreparer

public DeviceUpdateTargetPreparer ()

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

setUp

public void setUp (TestInformation testInfo)

المعلَمات
`testInfo`	`TestInformation`

عمليات الطرح
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

طُرق محمية

getDeviceUpdateImage

protected abstract File getDeviceUpdateImage ()

توفّر هذه السمة مثيلاً File يمثّل ملف صورة الجهاز الذي سيتم استخدامه للتحديث

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

performDeviceUpdate

protected abstract void performDeviceUpdate (File deviceUpdateImage, 
                ITestDevice device)

تنفيذ تحديث صورة الجهاز على الجهاز

عمليات الطرح
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

postUpdateActions

protected abstract void postUpdateActions (File deviceUpdateImage, 
                ITestDevice device)

الإجراءات التي يجب تنفيذها بعد تحديث الجهاز ولكن قبل تنفيذ خطوات الإعداد بعد التحديث سيتم استدعاء هذه الطريقة خارج عملية التحكم في التزامن في التحديث السريع.

عمليات الطرح
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

preUpdateActions

protected abstract void preUpdateActions (File deviceUpdateImage, 
                ITestDevice device)

الإجراءات التي يجب تنفيذها قبل تحديث الجهاز سيتم استدعاء هذه الطريقة خارج التحكم في التزامن الخاص بالتحديث السريع.

عمليات الطرح
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`