اعتبارًا من عام 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.

BaseTargetPreparer

public abstract class BaseTargetPreparer
extends Object implements ITargetPreparer

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

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

‫AFlagsTargetPreparer وAdbStopServerPreparer وAllTestAppsInstallSetup وAoaTargetPreparer وAppSetup وArtChrootPreparer وBaseEmulatorPreparer وBaseSwitchUserTargetPreparer وBaseSystemTestEnvPreparer وBuildInfoRecorder وCompanionAllocator وCompanionAwarePreparer وCompileBootImageWithSpeedTargetPreparer وCpuThrottlingWaiter وCreateAvdPreparer و70 غيرها

AFlagsTargetPreparer	يستخدم `aflags` لتجاوز العلامات قبل إجراء اختبار.
AdbStopServerPreparer	يستهدف هذا الخيار أداة الإعداد لإيقاف خادم adb على المضيف قبل وبعد تشغيل اختبارات adb.
AllTestAppsInstallSetup	`ITargetPreparer` يثبّت جميع التطبيقات من مجلد `IDeviceBuildInfo.getTestsDir()` على الجهاز.
AoaTargetPreparer	`ITargetPreparer` الذي ينفّذ سلسلة من الإجراءات (مثل عمليات النقر والتمرير السريع) باستخدام بروتوكول Android Open Accessory (AOAv2).
AppSetup	`ITargetPreparer` يثبّت حزمة APK واختباراتها.
ArtChrootPreparer	أنشئ دليل chroot لاختبارات ART.
BaseEmulatorPreparer	أداة إعداد شائعة لتشغيل محاكي محلي
BaseSwitchUserTargetPreparer	`ITargetPreparer` الذي يتم التبديل إلى نوع المستخدم المحدّد فيه في setUp
BaseSystemTestEnvPreparer	إعادة التشغيل إلى بيئة اختبار النظام الأساسي
BuildInfoRecorder	`ITargetPreparer` يكتب البيانات الوصفية لمعلومات الإنشاء في ملف محدّد.
CompanionAllocator	صنف أساسي يتولّى تخصيص الجهاز المصاحب وإلغاء تخصيصه يجب تنفيذ `getCompanionDeviceSelectionOptions()` لوصف المعايير اللازمة لتخصيص الجهاز المصاحب
CompanionAwarePreparer	تمثّل هذه السمة `ITargetPreparer` منطق الحصول على جهاز مصاحب تم تخصيصه مسبقًا.
CompileBootImageWithSpeedTargetPreparer	يعيد تجميع مسار فئة التمهيد وخادم النظام باستخدام فلتر المجمّع "speed".
CpuThrottlingWaiter	`ITargetPreparer` ينتظر إلى أن تتم استعادة الحد الأقصى للتردد على جميع النوى إلى أعلى مستوى متاح
CreateAvdPreparer
CreateUserPreparer	أداة إعداد الملف المستهدَف لإنشاء مستخدم ثانوي وتنظيفه في النهاية
CrosDutTopologyPreparer	أداة إعداد تشغّل أداة dt-converter لإنشاء إعدادات الاختبار ومعلماته.
CrosLsNexusPreparer	أداة إعداد تبدأ خدمة LSNexus وتوقفها لجهاز ChromeOS.
CtsSettingsSetup	`ITargetPreparer`: هو برنامج يضبط إعدادات الجهاز استعدادًا لتشغيل اختبارات CTS.
DeviceActionTargetPreparer	`ITargetPreparer` لتنفيذ إجراءات على الجهاز
DeviceBuildInfoBootStrapper	`ITargetPreparer` يستبدل حقول معلومات الإصدار بالسمات التي يتم قراءتها من الجهاز ويكون ذلك مفيدًا لاختبار الأجهزة باستخدام إصدارات تم إنشاؤها من مصدر خارجي (مثل
DeviceBuildInfoInjector	`ITargetPreparer` الذي يُدرج بيانات `DeviceBuildDescriptor` الوصفية في `IBuildInfo`
DeviceCleaner	إعادة التشغيل أو التنسيق كإجراء تنظيف بعد الاختبار، وإيقاف تشغيل الشاشة اختياريًا
DeviceFlashPreparer	`ITargetPreparer` تعرض صورة على أجهزة Android.
DeviceOwnerTargetPreparer	`ITargetPreparer` الذي يضبط أحد مكونات مالك الجهاز
DeviceSetup	`ITargetPreparer` يضبط جهازًا للاختبار استنادًا إلى `Option` المقدَّمة.
DeviceStorageFiller	يجب أن يملأ أداة إعداد الهدف مساحة التخزين لكي تتوفّر مساحة فارغة.
DeviceStringPusher	أداة إعداد الهدف لكتابة سلسلة في ملف
DeviceWiper	`ITargetPreparer` يحجب بيانات المستخدم
DexMetadataExtractor	تثبِّت هذه الأداة ملفات Dex Metadata لحِزم APK المحدّدة.
DisableSELinuxTargetPreparer	أداة إعداد الهدف التي توقف SELinux في حال تفعيله.
DynamicSystemPreparer	`ITargetPreparer` يضبط صورة نظام فوق إصدار الجهاز باستخدام ميزة "تحديث النظام الديناميكي".
EhideTargetPreparer	يبدأ ehide، ما يؤدي إلى إخفاء واجهة إيثرنت عن حزمة شبكة Android.
EraseUserDataPreparer	`ITargetPreparer` يحجب بيانات المستخدمين على الجهاز.
FastbootCommandPreparer	أداة إعداد الهدف التي تؤدي إلى تشغيل fastboot وإرسال أوامر fastboot
FeatureFlagTargetPreparer	تم إيقاف هذه الفئة نهائيًا. يمكن استخدام `AFlagsTargetPreparer` كبديل.
FoldableModePreparer	أداة إعداد هدف يمكنها تبديل حالة الجهاز القابل للطي.
FolderSaver	`ITargetPreparer` الذي يسحب الدلائل من الجهاز ويضغطها ويحفظها في نظام الخلفية لتسجيل البيانات
FutilityCommandPreparer	يُستخدَم هذا الحقل لتحديد ما إذا كان يجب أن ينفّذ المحضِّر أوامر عدم الجدوى.
GkiDeviceFlashPreparer	أداة إعداد الهدف التي تعمل على تثبيت ذاكرة ROM على الجهاز باستخدام صورة عامة لنواة Android الشائعة
GoogleAppsSetup	`ITargetPreparer` يتيح خيارات إعداد متنوعة لتطبيقات Google ملاحظة: يجب إعداد حساب على الجهاز أولاً، راجِع `GoogleAccountPreparer`
GsiDeviceFlashPreparer	أداة إعداد الهدف التي تعمل على تحديث الجهاز باستخدام صورة نظام Android العامة.
HsumBootStrategyPreparer
InstallAllTestZipAppsSetup	`ITargetPreparer` يثبّت جميع التطبيقات في ملف zip تجريبي.
InstallApkSetup	`ITargetPreparer` يثبّت حزمة APK واحدة أو أكثر من حِزم APK المتوفّرة في نظام الملفات.
InstallBuildEnvApkSetup	`ITargetPreparer` يثبّت حزمة APK واحدة أو أكثر من حِزم الاختبار من بيئة إصدار نظام Android الأساسي.
InstallKernelModulePreparer	أداة إعداد الهدف التي تثبّت وحدات نواة النظام
InstrumentationPreparer	`ITargetPreparer` ينفّذ عملية قياس
KillExistingEmulatorPreparer	تمثّل `ITargetPreparer` عملية إيقاف محاكي قيد التشغيل.
KnownFailurePreparer	يجب أن يتجاهل برنامج إعداد الاستهداف إعادة محاولة تنفيذ عملية فاشلة معروفة.
MixKernelTargetPreparer	`ITargetPreparer` يسمح بدمج صورة النواة مع صورة الجهاز.
MixRadioTargetPreparer	`ITargetPreparer` يسمح بدمج صورة الراديو مع صورة الجهاز.
NativeLeakCollector	`ITargetPreparer` التي تنفّذ الأمر "dumpsys meminfo --unreachable -a" لتحديد الذاكرة الأصلية التي لا يمكن الوصول إليها والتي تحتفظ بها كل عملية حاليًا.
NoApkTestSkipper	مُعدّ خاص يسمح بتخطّي عملية استدعاء بالكامل (الإعداد والاختبارات) إذا لم تكن هناك حِزم APK لاختبارها.
PerfettoPreparer	يرسل برنامج Perfetto preparer ملف الإعداد إلى الجهاز في موقع جغرافي عادي يمكن أن يصل إليه برنامج perfetto.
ProfileTargetPreparer	صنف أساسي لإعداد أداة إعداد الهدف لأي مستخدم ملف شخصي `android.os.usertype.profile.XXX`.
PushFilePreparer	`ITargetPreparer` التي تحاول نقل أي عدد من الملفات من أي مسار مضيف إلى أي مسار جهاز.
PythonVirtualenvPreparer	تُعدّ هذه السمة بيئة Python افتراضية على المضيف وتثبّت الحِزم.
RamdumpPreparer	فعِّل Ramdump.
RebootTargetPreparer	أداة إعداد الهدف التي تعيد تشغيل الجهاز.
RecoveryLogPreparer	يتم استخدام أداة إعداد الهدف لجمع السجلات قبل الاسترداد.
RemoveSystemAppPreparer	`ITargetPreparer` لإزالة حزمة APK من قسم النظام قبل إجراء اختبار.
RestartSystemServerTargetPreparer	أداة إعداد الهدف التي تعيد تشغيل خادم النظام بدون إعادة تشغيل الجهاز
RootTargetPreparer	أداة إعداد الهدف التي تنفّذ الأمر "adb root" أو "adb unroot" استنادًا إلى الخيار "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	يستهدف هذا الخيار أداة الإعداد لتنفيذ أوامر مضيف عشوائية قبل تنفيذ الاختبار وبعده.
RunHostScriptTargetPreparer	استهداف أداة الإعداد التي تنفّذ نصًا برمجيًا قبل إجراء اختبار
RunOnSdkSandboxTargetPreparer	`ITargetPreparer`: تشير إلى أنّ الاختبارات يجب أن يتم تنفيذها في وضع الحماية الخاص بحزمة تطوير البرامج (SDK).
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` لضمان تشغيل الاختبار كمستخدم ثانوي
RunOnSystemUserTargetPreparer	`ITargetPreparer` يحدّد أنّه يجب إجراء الاختبارات على المستخدم (بدلاً من المستخدم الحالي).
SemaphoreTokenTargetPreparer	هذا هو المحضّر المستخدَم لاستخدام الرمز المميز لتسلسل تنفيذ الاختبار في مضيف Tradefed.
إعدادات الضبط	`ITargetPreparer` يضبط إعدادات الجهاز من خلال قياس SettingsUtil.apk.
StopServicesSetup	`ITargetPreparer` يؤدي إلى إيقاف الخدمات على الجهاز
StubTargetPreparer	تنفيذ فارغ للعنصر النائب `ITargetPreparer`
TearDownPassThroughPreparer	تسمح بتنفيذ tearDown على أدوات الإعداد المُضمَّنة في الإعدادات كعنصر.
TemperatureThrottlingWaiter	`ITargetPreparer` التي تنتظر إلى أن تنخفض درجة حرارة الجهاز إلى المستوى المطلوب
TestAppInstallSetup	`ITargetPreparer` هو تطبيق يثبّت تطبيقًا واحدًا أو أكثر من مجلد `IDeviceBuildInfo.getTestsDir()` على الجهاز.
TestFilePushSetup	`ITargetPreparer` يدفع ملفًا واحدًا أو أكثر/أدلة من مجلد `IDeviceBuildInfo.getTestsDir()` إلى الجهاز.
TestSystemAppInstallSetup	`ITargetPreparer` يثبّت تطبيقًا واحدًا أو أكثر من مجلد `IDeviceBuildInfo.getTestsDir()` على قسم /system على الجهاز
TimeWaster	أداة بسيطة لإعداد الهدف بهدف إضاعة الوقت وربما إعادة تشغيل الجهاز.
UserCleaner	`ITargetPreparer` التي تزيل المستخدمين الثانويين عند إيقاف التطبيق
VisibleBackgroundUserPreparer	أداة إعداد الهدف لتشغيل الاختبارات في مستخدم يتم تشغيله في الخلفية المرئية
WaitForDeviceDatetimePreparer	`ITargetPreparer` ينتظر ضبط التاريخ والوقت على الجهاز يمكن لهذا المحضِّر فرض `TargetSetupError` إذا لم يتم ضبط التاريخ والوقت خلال المهلة المحدّدة.
WifiPreparer	`ITargetPreparer` يضبط شبكة Wi-Fi على الجهاز إذا لزم الأمر.

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

‫CheckPairingPreparer وCompanionRunCommandTargetPreparer وCompanionTestAppInstallSetup وCompatTargetPreparer وDeviceImageZipFlashingTargetPreparer وDeviceUpdateTargetPreparer وFastbootUpdateBootstrapPreparer وGoogleAccountPreparer وGoogleDeviceFlashPreparer وGoogleDeviceSetup وInstallApexModuleTargetPreparer وLocalEmulatorLaunch وLocalEmulatorSnapshot وModuleOemTargetPreparer وPushFileInvoker و6 غيرها

CheckPairingPreparer	`CompanionAwarePreparer` يتيح التحقّق من ربط البلوتوث بين الجهاز الأساسي والجهاز المرافق
CompanionRunCommandTargetPreparer	`ITargetPreparer` ينفّذ أوامر محدّدة على الجهاز المصاحب المخصّص
CompanionTestAppInstallSetup	`ITargetPreparer` يثبّت تطبيقًا واحدًا أو أكثر من مجلد `IDeviceBuildInfo.getTestsDir()` على جهاز مصاحب مخصّص.
CompatTargetPreparer	`ITargetPreparer` يجهّز الجهاز لإجراء اختبارات التوافق.
DeviceImageZipFlashingTargetPreparer	أداة إعداد هدف تعمل على وميض الجهاز باستخدام صور الجهاز المقدَّمة بتنسيق محدّد.
DeviceUpdateTargetPreparer	فئة مجرّدة `ITargetPreparer` تتولّى تنفيذ الخطوات الشائعة المتعلقة بتحديث الأجهزة باستخدام ملف صورة جهاز من مصدر خارجي (بدلاً من خدمة إنشاء).
FastbootUpdateBootstrapPreparer	`ITargetPreparer`: هي أداة تنقل الملفات المحدّدة (برنامج الإقلاع والراديو وملف ZIP لصورة الجهاز) إلى `IDeviceBuildInfo` لتثبيت `FastbootDeviceFlasher` على الأجهزة، ثم تُدرج سمات الجهاز بعد الإقلاع في معلومات الإصدار لأغراض إعداد التقارير عن النتائج.
GoogleAccountPreparer	`ITargetPreparer` يتيح إعداد حسابات Google
GoogleDeviceFlashPreparer	هي تخصص في `DeviceFlashPreparer` يتيح اتّخاذ خطوات مخصّصة لتثبيت ذاكرة ROM على أجهزة Google.
GoogleDeviceSetup	هي امتداد لـ `DeviceSetup` يتيح إعداد مواقع إضافية خاصة بـ Google.
InstallApexModuleTargetPreparer
LocalEmulatorLaunch	‫TargetPreparer يطلق محاكيًا على الجهاز من بيئة الإصدار في Android.
LocalEmulatorSnapshot	أداة TargetPreparer مخصّصة لإنشاء لقطة سريعة لحالة الجهاز من بيئة تطوير/إصدار Android
ModuleOemTargetPreparer
PushFileInvoker	تم إيقاف هذه الفئة نهائيًا. استخدام `PushFilePreparer` بدلاً من ذلك
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnWorkProfileTargetPreparer	`ITargetPreparer` ينشئ ملف عمل أثناء عملية الإعداد، ويشير إلى أنّه يجب تنفيذ الاختبارات في هذا المستخدم.
SideloadOtaTargetPreparer	أداة إعداد الهدف التي تنفّذ التحميل الجانبي لحزمة OTA محدّدة، وتطبّق الحزمة، وتنتظر حتى يتم تشغيل الجهاز، وتُدرج خصائص إصدار الجهاز لاستخدامها كمعلومات الإصدار يفترض معدّ الإعداد المستهدف هذا أنّ الجهاز سيكون في وضع adb العادي عند بدء التشغيل، وسيضمن خروج الجهاز من الوضع نفسه ولكن مع تطبيق الإصدار الأحدث.
SuiteApkInstaller	تثبيت حِزم APK المحدّدة لإعداد Suite: إما من المتغيّر $ANDROID_TARGET_OUT_TESTCASES أو ROOT_DIR في معلومات الإصدار
SwitchUserTargetPreparer	التنفيذ التلقائي لـ `BaseSwitchUserTargetPreparer` - راجِع javadoc الخاص بهذه الفئة للحصول على مزيد من المعلومات.

فئة التنفيذ الأساسية لـ ITargetPreparer التي تتيح التحكّم في ما إذا كان الكائن غير مفعّل أم لا.

ملخّص

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

الإجراءات العامة
`final boolean`	`isDisabled()` تعرِض هذه السمة القيمة True إذا كان العنصر بأكمله غير مفعّل (تخطّي كل من الإعداد والإزالة).
`final boolean`	`isTearDownDisabled()` تعرِض True إذا كان يجب تخطّي عملية الإيقاف فقط.
`final void`	`setDisable(boolean isDisabled)` يضبط ما إذا كان يجب إيقاف العنصر.
`final void`	`setDisableTearDown(boolean isDisabled)` تضبط هذه السمة ما إذا كان يجب تخطّي خطوة الإيقاف في العنصر.

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

BaseTargetPreparer

public BaseTargetPreparer ()

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

isDisabled

public final boolean isDisabled ()

تعرِض هذه السمة القيمة True إذا كان العنصر بأكمله غير مفعّل (تخطّي كل من الإعداد والإزالة). ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

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

isTearDownDisabled

public final boolean isTearDownDisabled ()

تعرِض True إذا كان يجب تخطّي عملية الإيقاف فقط. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

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

setDisable

public final void setDisable (boolean isDisabled)

يضبط ما إذا كان يجب إيقاف العنصر. يعني الإيقاف أنّه يجب تخطّي كل من خطوات الإعداد والإزالة. يمكن استخدامها لجعل الكائن غير مفعّل تلقائيًا في الدالة الإنشائية التلقائية.

المعلَمات
`isDisabled`	‫`boolean`: الحالة التي يجب وضع العنصر فيها

setDisableTearDown

public final void setDisableTearDown (boolean isDisabled)

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

المعلَمات
`isDisabled`	‫`boolean`: الحالة التي يجب وضع العنصر فيها