اعتبارًا من 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 و57 عملية أخرى

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	تُعيد تجميع مسار تجميع التشغيل وخادم النظام باستخدام فلتر المُجمِّع "السرعة".
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` يسحب الدلائل من الجهاز ويضغطها ويحفظها في الخلفية logging.
GkiDeviceFlashPreparer	أداة إعداد الوجهة التي تُفلش الجهاز باستخدام صورة عامة بنواة Android الشائعة
GsiDeviceFlashPreparer	أداة إعداد الجهاز التي تُثبِّت صورة نظام Android العامة على الجهاز
InstallAllTestZipAppsSetup	`ITargetPreparer` لتثبيت جميع التطبيقات في حزمة zip اختبارية
InstallApkSetup	`ITargetPreparer` الذي يُثبِّت حزمة apk واحدة أو أكثر موجودة في نظام الملفات
InstallBuildEnvApkSetup	`ITargetPreparer` لتثبيت حزمة APK تجريبية واحدة أو أكثر من بيئة إنشاء نظام Android الأساسي
InstallKernelModulePreparer	أداة إعداد مستهدفة لتثبيت وحدات kernel
InstrumentationPreparer	`ITargetPreparer` لتشغيل الأدوات
KillExistingEmulatorPreparer	`ITargetPreparer` لإيقاف محاكي قيد التشغيل
KnownFailurePreparer	يُرجى توجيه مُعدّ المحتوى المستهدف إلى تخطّي إعادة محاولة الخطأ المعروف.
MixKernelTargetPreparer	`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 و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`، ثم تُدخل سمات الجهاز بعد التشغيل في معلومات الإصدار لأغراض إعداد التقارير عن النتائج
InstallApexModuleTargetPreparer
LocalEmulatorLaunch	أداة TargetPreparer التي تطلِق محاكيًا محليًا من بيئة إنشاء Android
LocalEmulatorSnapshot	أداة TargetPreparer مخصّصة لإنشاء لقطة نظيفة للمحاكي من بيئة تطوير/إنشاء تطبيقات Android
ModuleOemTargetPreparer
PushFileInvoker	تم إيقاف هذه الفئة نهائيًا. استخدِم `PushFilePreparer` بدلاً من ذلك
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnWorkProfileTargetPreparer	`ITargetPreparer` لإنشاء ملف عمل في عملية الإعداد، ووضع علامة على الاختبارات التي يجب إجراؤها في هذا المستخدم
SideloadOtaTargetPreparer	أداة إعداد الوجهة التي تُجري تحميلًا من مصدر غير معروف لحزمة OTA محدّدة، وتطبّق الحزمة، وتنتظر حتى يتم تشغيل الجهاز، وتُدخل خصائص إصدار الجهاز لاستخدامها كمعلومات عن الإصدار يفترض أداة إعداد الاستهداف هذه أنّ الجهاز سيكون في وضع adb العادي عند بدء التشغيل، و ستضمن خروج الجهاز من الوضع نفسه ولكن مع تطبيق الإصدار الأحدث.
SuiteApkInstaller	تثبيت حِزم APK المحدّدة لإعداد "مجموعة التطبيقات": إما من المتغيّر $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`: الحالة التي يجب وضع العنصر فيها