اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

BaseTargetPreparer

public abstract class BaseTargetPreparer
extends Object implements ITargetPreparer

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

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

‫AdbStopServerPreparer وAllTestAppsInstallSetup وAoaTargetPreparer وAppSetup وArtChrootPreparer وBaseEmulatorPreparer وBuildInfoRecorder وCompanionAllocator وCompanionAwarePreparer وCompileBootImageWithSpeedTargetPreparer وCpuThrottlingWaiter وCreateAvdPreparer وCreateUserPreparer وDeviceActionTargetPreparer وDeviceBuildInfoBootStrapper و59 غيرها

AdbStopServerPreparer	يجب أن يوقف معدّ الجهاز المستهدَف خادم adb على المضيف قبل وبعد تشغيل اختبارات adb.
AllTestAppsInstallSetup	`ITargetPreparer` يثبّت جميع التطبيقات من مجلد `IDeviceBuildInfo.getTestsDir()` على الجهاز.
AoaTargetPreparer	`ITargetPreparer` الذي ينفّذ سلسلة من الإجراءات (مثل عمليات النقر والتمرير السريع) باستخدام بروتوكول Android Open Accessory (AOAv2).
AppSetup	`ITargetPreparer` يثبّت حزمة APK واختباراتها.
ArtChrootPreparer	إنشاء دليل chroot لاختبارات ART
BaseEmulatorPreparer	أداة إعداد شائعة لتشغيل محاكي محلي
BuildInfoRecorder	`ITargetPreparer` يكتب البيانات الوصفية لمعلومات الإنشاء في ملف محدّد.
CompanionAllocator	فئة أساسية تتولّى تخصيص الجهاز المرافق وتحريره يجب تنفيذ `getCompanionDeviceSelectionOptions()` لوصف المعايير اللازمة لتخصيص الجهاز المصاحب
CompanionAwarePreparer	`ITargetPreparer` يغلف منطق الحصول على جهاز مصاحب تم تخصيصه مسبقًا.
CompileBootImageWithSpeedTargetPreparer	إعادة تجميع مسار فئة التمهيد وخادم النظام باستخدام فلتر المجمّع "speed"
CpuThrottlingWaiter	`ITargetPreparer` ينتظر إلى أن تتم استعادة الحد الأقصى للتردد على جميع النوى إلى أعلى مستوى متاح
CreateAvdPreparer
CreateUserPreparer	أداة إعداد الهدف لإنشاء المستخدم وتنظيفه في النهاية
DeviceActionTargetPreparer	`ITargetPreparer` لتنفيذ إجراءات الجهاز
DeviceBuildInfoBootStrapper	`ITargetPreparer` يستبدل حقول معلومات الإصدار بالسمات التي يتم قراءتها من الجهاز ويكون ذلك مفيدًا لاختبار الأجهزة باستخدام إصدارات تم إنشاؤها من مصدر خارجي (مثل
DeviceBuildInfoInjector	`ITargetPreparer` الذي يُدرج بيانات وصفية `DeviceBuildDescriptor` في `IBuildInfo`
DeviceCleaner	إعادة التشغيل أو التنسيق كإجراء تنظيف بعد الاختبار، وإيقاف الشاشة اختياريًا
DeviceFlashPreparer	`ITargetPreparer` تعرض صورة على أجهزة Android.
DeviceOwnerTargetPreparer	`ITargetPreparer` الذي يضبط أحد مكونات مالك الجهاز
DeviceSetup	`ITargetPreparer` يضبط جهازًا للاختبار استنادًا إلى `Option` المقدَّمة.
DeviceStorageFiller	يجب أن يملأ برنامج إعداد الهدف مساحة التخزين لكي تتوفّر مساحة فارغة.
DeviceStringPusher	أداة إعداد الهدف لكتابة سلسلة في ملف
DeviceWiper	`ITargetPreparer` يحجب بيانات المستخدم
DisableSELinuxTargetPreparer	أداة إعداد الهدف التي توقف SELinux في حال تفعيله.
DynamicSystemPreparer	`ITargetPreparer`: هي أداة تعمل على إعداد صورة نظام فوق إصدار الجهاز باستخدام ميزة "تحديث النظام الديناميكي".
EraseUserDataPreparer	`ITargetPreparer` يحجب بيانات المستخدمين من الجهاز.
FastbootCommandPreparer	أداة إعداد الهدف التي تؤدي إلى تشغيل fastboot وإرسال أوامر fastboot
FeatureFlagTargetPreparer	تعدّل هذه السمة DeviceConfig (علامات الميزات التي يتم ضبطها من خلال خدمة عن بُعد).
FoldableModePreparer	أداة إعداد هدف يمكنها تبديل حالة الجهاز القابل للطي.
FolderSaver	`ITargetPreparer` الذي يسحب الأدلة من الجهاز ويضغطها ويحفظها في نظام الخلفية لتسجيل البيانات
FutilityCommandPreparer	مُعدّ لتنفيذ أوامر عدم الجدوى
GkiDeviceFlashPreparer	أداة إعداد الهدف التي تعمل على تحديث الجهاز باستخدام صورة عامة لنواة Android الشائعة
GsiDeviceFlashPreparer	أداة إعداد تستخدم صورة نظام Android عامة لتثبيت نظام التشغيل على الجهاز
InstallAllTestZipAppsSetup	`ITargetPreparer`: هو ملف zip يثبّت جميع التطبيقات.
InstallApkSetup	`ITargetPreparer` الذي يثبّت حِزمة 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 ملف الإعداد إلى الجهاز في موقع جغرافي عادي يمكن أن يصل إليه Perfetto.
ProfileTargetPreparer	فئة أساسية لإعداد أداة إعداد الهدف لأي مستخدم ملف شخصي `android.os.usertype.profile.XXX`.
PushFilePreparer	`ITargetPreparer` التي تحاول نقل أي عدد من الملفات من أي مسار مضيف إلى أي مسار جهاز.
PythonVirtualenvPreparer	تُعدّ هذه السمة بيئة Python افتراضية على المضيف وتثبّت الحِزم.
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.
StopServicesSetup	`ITargetPreparer` يؤدي إلى إيقاف الخدمات على الجهاز
StubTargetPreparer	تنفيذ فارغ للعنصر النائب `ITargetPreparer`
SwitchUserTargetPreparer	`ITargetPreparer` الذي ينتقل إلى نوع المستخدم المحدّد في setUp
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 وDeviceImageZipFlashingTargetPreparer وDeviceUpdateTargetPreparer وFastbootUpdateBootstrapPreparer وGoogleAccountPreparer وInstallApexModuleTargetPreparer وLocalEmulatorLaunch وLocalEmulatorSnapshot وModuleOemTargetPreparer وPushFileInvoker وRunOnCloneProfileTargetPreparer وRunOnPrivateProfileTargetPreparer وRunOnWorkProfileTargetPreparer وSideloadOtaTargetPreparer وSuiteApkInstaller

CheckPairingPreparer	`CompanionAwarePreparer` يثبت ربط البلوتوث بين الجهاز الأساسي والجهاز المرافق
CompanionRunCommandTargetPreparer	`ITargetPreparer` ينفِّذ الأوامر المحدّدة على الجهاز المصاحب المخصّص
CompanionTestAppInstallSetup	`ITargetPreparer` يثبّت تطبيقًا واحدًا أو أكثر من مجلد `IDeviceBuildInfo.getTestsDir()` على جهاز مصاحب مخصّص.
DeviceImageZipFlashingTargetPreparer	أداة إعداد الهدف التي تومض الجهاز بصور الجهاز المقدَّمة بتنسيق محدّد
DeviceUpdateTargetPreparer	فئة مجرّدة `ITargetPreparer` تتولّى تنفيذ الخطوات الشائعة المتعلقة بتحديث الأجهزة باستخدام ملف صورة جهاز من مصدر خارجي (بدلاً من خدمة إنشاء).
FastbootUpdateBootstrapPreparer	`ITargetPreparer` التي تنقل الملفات المحدّدة (برنامج الإقلاع والراديو وملف ZIP لصورة الجهاز) إلى `IDeviceBuildInfo` لتثبيت `FastbootDeviceFlasher` على الأجهزة، ثم تُدرج سمات الجهاز بعد الإقلاع في معلومات الإصدار لأغراض إعداد التقارير عن النتائج.
GoogleAccountPreparer	`ITargetPreparer` يتيح إعداد حسابات 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 في معلومات الإصدار

فئة التنفيذ الأساسية لـ 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`: الحالة التي يجب وضع العنصر فيها