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

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

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

AdbStopServerPreparer	أداة التجهيز المستهدفة لإيقاف خادم adb على المضيف قبل تشغيل اختبارات adb وبعده
AllTestAppsInstallSetup	جهاز `ITargetPreparer` يثبِّت جميع التطبيقات من خلال جهاز `IDeviceBuildInfo#getTestsDir()` المجلد إلى الجهاز.
AoaTargetPreparer	`ITargetPreparer` التي تنفّذ سلسلة من الإجراءات (مثل النقرات والتمريرات السريعة) باستخدام بروتوكول "الملحق المفتوح لنظام Android" (AOAv2).
إعداد التطبيق	نوع `ITargetPreparer` الذي يثبِّت حزمة APK واختباراتها
artChrootPreparer	إنشاء دليل chroot لاختبارات ART.
BaseEmulatorPreparer	الأداة الشائعة لإطلاق محاكي محلي
BaseTargetPreparer	فئة التنفيذ الأساسية في `ITargetPreparer` التي تسمح بالتحكّم في العنصر معطلة أو لا.
BuildInfoRecorder	يشير ذلك المصطلح إلى `ITargetPreparer` يكتب في ملف محدّد بيانات الإصدار الخاصة بمعلومات التصميم.
CheckPairingPreparer	`CompanionAwarePreparer` الذي يتحقّق من ارتباط BT بين الأجهزة الأساسية والأجهزة المصاحبة
CompanionAllocator	فئة أساسية تتولى تخصيص الجهاز المصاحب وتحريره يجب تنفيذ السمة `getCompanionDeviceSelectionOptions()` لوصف المعايير مطلوب لتخصيص الجهاز المصاحب
CompanionAwarePreparer	`ITargetPreparer` الذي يتضمّن منطق الحصول على رفيق مخصّص الخاص بك.
CompanionRunCommandTargetPreparer	`ITargetPreparer` ينفّذ أوامر محدّدة على الجهاز المصاحب المخصّص
CompanionTestAppInstallSetup	`ITargetPreparer` الذي يثبّت تطبيقًا واحدًا أو أكثر من مجلد واحد (`IDeviceBuildInfo#getTestsDir()`) على جهاز مصاحب مخصّص.
CompileBootImageWithSpeedTargetPreparer	تعمل هذه السياسة على إعادة تجميع مسار فئة التمهيد وخادم النظام باستخدام فلتر التجميع البرمجي "السرعة".
CpuThrottling الجيدer	`ITargetPreparer`: ينتظر حتى تتم استعادة الحد الأقصى لمعدّل التكرار على جميع النوى إلى أعلى مستوياته. يتوفّر مستوى
CreateAvdPreparer
CreateUserPreparer	التجهيز المستهدف لإنشاء مستخدم وتنظيفه في النهاية.
DeviceActionTargetPreparer	`ITargetPreparer` لتنفيذ إجراءات الجهاز
DeviceBuildInfoBootStrapper	`ITargetPreparer` يستبدل حقول معلومات الإصدار بسمات تتم قراءتها من الجهاز ويُعدّ هذا الأمر مفيدًا لاختبار الأجهزة التي تتضمّن إصدارات تم إنشاؤها من مصدر خارجي (على سبيل المثال،
DeviceBuildInfoInjector	تمثّل هذه السمة `ITargetPreparer` الذي يدرج بيانات `DeviceBuildDescriptor` الوصفية في `IBuildInfo`.
DeviceCleaner	إعادة تشغيل الجهاز أو تنسيقه كإجراء تنظيف بعد الاختبار، وإيقاف الشاشة اختياريًا
DeviceFlashPreparer	عنصر `ITargetPreparer` الذي تومض صورة على أجهزة Android الفعلية
DeviceImageZipFlashingTargetPreparer	يشير ذلك المصطلح إلى أداة إعداد مستهدَفة تومض الجهاز باستخدام صور الجهاز التي يتم توفيرها بتنسيق معيّن.
DeviceOwnerTargetPreparer	عنصر `ITargetPreparer` لإعداد مكوِّن مالك الجهاز
إعداد الجهاز	هي `ITargetPreparer` تعمل على إعداد الجهاز للاختبار استنادًا إلى `Option` المُقدّمة.
DeviceStorageFiller	أداة التجهيز المستهدفة لملء مساحة التخزين حتى تتوفّر بعض المساحة الخالية.
DeviceStringPusher	التجهيز المستهدف لكتابة سلسلة إلى ملف.
DeviceUpdateTargetPreparer	ملخّص `ITargetPreparer` يعالج الخطوات الشائعة لتحديث الأجهزة باستخدام ملف صورة جهاز من مصدر خارجي (على عكس خدمة الإصدار).
أداة DeviceWiper	`ITargetPreparer` الذي يحجب بيانات المستخدمين
DisableSELinuxTargetPreparer	أداة الإعداد المستهدفة التي توقِف SELinux في حال تفعيلها.
DynamicSystemPreparer	`ITargetPreparer` الذي يعمل على إعداد صورة نظام فوق إصدار جهاز باستخدام السمة الديناميكية تحديث النظام
CleanUserDataPreparer	`ITargetPreparer` الذي يحجب بيانات المستخدمين من الجهاز
FastbootCommandPreparer	أداة الإعداد المستهدفة التي تشغِّل Fastboot وترسل أوامر Fastboot.
FastbootUpdateBootstrapPreparer	`ITargetPreparer` ينقل ملفات محددة (برنامج التحميل والراديو وملف zip لصورة الجهاز) إلى `IDeviceBuildInfo` للحصول على وميض `FastbootDeviceFlasher` للأجهزة، ثم الحقن سمات الجهاز بعد التشغيل في معلومات الإصدار لأغراض الإبلاغ عن النتائج.
FeatureFlagTargetPreparer	تعدِّل هذه السياسة إعدادات DeviceConfig (علامات الميزات التي تضبطها خدمة عن بُعد).
FoldableModePreparer	هي أداة إعداد مستهدَفة يمكنها تبديل حالة أحد الأجهزة القابلة للطي.
أداة حفظ المجلدات	ملف `ITargetPreparer` يسحب الأدلة من الجهاز ويضغطها ويحفظها في عملية التسجيل الخلفية.
GkiDeviceFlashPreparer	أداة تحضير مستهدَفة تعمل على تشغيل وميض الجهاز باستخدام صورة عامة النواة العامة لنظام Android
GsiDeviceFlashPreparer	أداة إعداد مستهدفة تعمل على وميض الجهاز بصورة عامة لنظام Android.
ILabPreparer	واجهة محدّد الموقع الخاصة بأدوات إعداد المعمل يمكنك الانتقال إلى `ITargetPreparer` للاطّلاع على وصف لما تقصده هذه الواجهات.
ITargetCleaner	تم إيقاف هذه الواجهة نهائيًا. تم نقل البيانات إلى واجهة ITargetPreparer الأساسية.
InstallAllTestZipAppsSetup	ملف `ITargetPreparer` يثبِّت جميع التطبيقات في ملف ZIP تجريبي.
InstallApexModuleTargetPreparer
InstallApkSetup	هو `ITargetPreparer` الذي يثبِّت حزمة واحدة أو أكثر من ملفات APK على نظام الملفات.
InstallBuildEnvApkSetup	تمثّل هذه السمة `ITargetPreparer` تثبِّت حزمة APK اختبارية واحدة أو أكثر من بيئة إصدار نظام Android الأساسي.
InstallKernelModulePreparer	أداة تحضير مستهدَفة تعمل على تشغيل وميض الجهاز باستخدام صورة عامة النواة العامة لنظام Android
أداة إعداد الأدوات	`ITargetPreparer` الذي يدير الأدوات
KillExistingEmulatorPreparer	رسالة `ITargetPreparer` التي يوقف فيها المحاكي قيد التشغيل.
knownFailurePreparer	أداة الإعداد الهدف لتخطّي إعادة محاولة الإخفاق المعروف.
LocalEmulatorLaunch	أداة TargetPreparer تعمل على تشغيل محاكي محليًا من بيئة إصدار Android
LocalEmulatorSnapshot	والهدف من برنامج TargetPreparer هو إنشاء لقطة واضحة للمحاكي من هاتف Android. بيئة إنشاء/تطوير
MixKernelTargetPreparer	هي `ITargetPreparer` تسمح بخلط صورة kernel مع صورة الجهاز.
ModuleOemTargetPreparer
NativeLeakCollector	`ITargetPreparer` يقوم بتشغيل 'dumpsys meminfo --unreachable -a' لتحديد ذاكرة أصلية لا يمكن الوصول إليها حاليًا في كل عملية.
NoApkTestStepper	أداة إعداد خاصة تسمح بتخطّي الاستدعاء تمامًا (الإعداد والاختبارات) إذا كان هناك ليست هناك ملفات APK للاختبار.
PerfettoPreparer	ترسل أداة إعداد Perfetto ملف الإعداد إلى الجهاز في موقع عادي لديك حق الوصول إليها.
ProfileTargetPreparer	الفئة الأساسية لإعداد أداة الإعداد الهدف لأي مستخدم ملف شخصي `android.os.usertype.profile.XXX`
PushFileInvoker	تم إيقاف هذا الصف نهائيًا. استخدام `PushFilePreparer` بدلاً من ذلك
PushFilePreparer	يشير هذا المصطلح إلى `ITargetPreparer` الذي يحاول نقل أي عدد من الملفات من أي مسار مضيف إلى أي عدد من الملفات. مسار الجهاز.
PythonVirtualenvPreparer	تتيح هذه السياسة إعداد Python افتراضي على المضيف وتثبيت الحِزم.
إعادة التشغيلTargetPreparer	أداة الإعداد المستهدَفة التي تعيد تشغيل الجهاز
RecoveryLogPreparer	يشير ذلك المصطلح إلى أداة إعداد مستهدَفة يتم استخدامها لجمع السجلّات قبل عملية الاسترداد.
RemoveSystemAppPreparer	تمثّل هذه السمة `ITargetPreparer` لإزالة حزمة APK من قسم النظام قبل إجراء اختبار.
ResetSystemServerTargetPreparer	أداة التجهيز المستهدفة التي تعيد تشغيل خادم النظام بدون إعادة تشغيل الجهاز.
RootTargetPreparer	أداة التجهيز المستهدفة التي تنفِّذ "جذر adb" أو "adb unroot" استنادًا إلى الخيار "force-root".
RootcanalforwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	أداة الإعداد المستهدفة لتشغيل أوامر المضيف العشوائية قبل إجراء الاختبار وبعده.
RunHostScriptTargetPreparer	التجهيز المستهدف الذي ينفِّذ نصًا برمجيًا قبل إجراء الاختبار
RunOnCloneProfileTargetPreparer
RunOnPrivacyProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	يشير هذا الرمز `ITargetPreparer` إلى أنّه يجب إجراء الاختبارات في وضع الحماية الخاص بحزمة تطوير البرامج (SDK).
RunOnsecondaryUserTargetPreparer	تمثّل هذه السمة `ITargetPreparer` لضمان إجراء الاختبار كمستخدم ثانوي.
RunOnSystemUserTargetPreparer	يجب إجراء `ITargetPreparer` علامة تشير إلى أنّه يجب إجراء الاختبارات على المستخدم (بدلاً من المستخدم الحالي).
RunOnWorkProfileTargetPreparer	`ITargetPreparer` الذي يُنشئ ملفًا شخصيًا للعمل في عملية الإعداد، ويحدّد أنّ الاختبارات يجب أن تكون تنفيذها في هذا المستخدم.
SemaphoreTokenTargetPreparer	هذه عبارة عن أداة تحضير تُستخدم لاستخدام الرمز المميّز لتنفيذ تسلسل تنفيذ الاختبار في مضيف مقايض.
SideloadOtaTargetPreparer	أداة الإعداد المستهدف التي تنفّذ التحميل الجانبي لحزمة OTA محددة، وتطبق الحزمة، وتنتظر لتشغيل الجهاز وإدخال خصائص إصدار الجهاز لاستخدامها كمعلومات إصدار تفترض أداة إعداد الاستهداف هذه أنّ الجهاز سيكون في وضع adb المعتاد عند بدء تشغيله. سيضمن خروج الجهاز في الوضع نفسه ولكن مع تطبيق الإصدار الأحدث.
StopServicesSetup	عنوان `ITargetPreparer` الذي يوقف الخدمات على الجهاز
StubTargetPreparer	عنصر نائب لتنفيذ عنصر `ITargetPreparer` فارغ.
SuiteApkInstaller	يتم تثبيت حِزم APK محدّدة لإعداد الحزمة: إما من $ANDROID_TARGET_OUT_TESTCASES. المتغير أو ROOT_DIR في معلومات الإصدار.
SwitchUserTargetPreparer	تمثّل هذه السمة `ITargetPreparer` يتم التبديل إلى نوع المستخدم المحدّد في setUp.
TearDownPassThroughPreparer	يسمح بتشغيل TerDown على أدوات الإعداد المضمنة في الإعداد ككائن.
ناقل شديد الحرارة	درجة حرارة الجهاز `ITargetPreparer` تنتظر حتى تنخفض درجة حرارة الجهاز إلى المستوى المستهدَف
TestAppInstallSetup	هي أداة "`ITargetPreparer`" تثبِّت تطبيقًا واحدًا أو أكثر من مجلد "`IDeviceBuildInfo.getTestsDir()`" على الجهاز.
TestFilePushSetup	`ITargetPreparer` الذي يضع ملفًّا أو أكثر من الملفات أو التطبيقات المثبَّتة من مجلد `IDeviceBuildInfo.getTestsDir()` إلى الجهاز
TestSystemAppInstallSetup	هي أداة `ITargetPreparer` تثبِّت تطبيقًا واحدًا أو أكثر من مجلد `IDeviceBuildInfo.getTestsDir()` في قسم /system على الجهاز.
TimeWaster	أداة إعداد مستهدَفة بسيطة لإضاعة الوقت وربما إعادة تشغيل الجهاز
UserCleaner	`ITargetPreparer` الذي يزيل المستخدمين الثانويين عند القطع.
مرئيBackgroundUserPreparer	أداة الإعداد المستهدفة لإجراء الاختبارات في مستخدم يتم تشغيله في الخلفية المرئية في الخلفية.
FixForDeviceDatetimePreparer	جهاز `ITargetPreparer` ينتظر ضبط التاريخ والوقت على الجهاز يمكن اختياريًا أن تفرض أداة التجهيز هذه `TargetSetupError` في حال عدم ضبط التاريخ والوقت ضمن المهلة.
WifiPreparer	`ITargetPreparer` الذي يضبط شبكة Wi-Fi على الجهاز إذا لزم الأمر.

تحضير بيئة الاختبار لإجراء الاختبار.

على سبيل المثال، يتم تثبيت البرامج وتعديل إعدادات البيئة من أجل الاختبار وتشغيل الأهداف وما إلى ذلك.

يُرجى العِلم أنّه يمكن تحديد عدة ITargetPreparer في الإعدادات. من المهم بأن يوثق كل ITargetPreparer الإعداد المسبق لبيئته المتوقعة بوضوح بعد الإعداد. مثلاً: يجب تشغيل أداة ITargetPreparer التي تهيئ جهازًا للاختبار بعد برنامج ITargetPreparer الذي يثبّت البرامج.

ملخّص

الطرق العامة
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` تم إيقاف هذه الطريقة نهائيًا. استخدام `setUp(com.android.tradefed.invoker.TestInformation)` بدلاً من ذلك
`default void`	`setUp(TestInformation testInformation)` نفِّذ الإعداد المستهدف للاختبار.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` إجراء التنظيف/الإلغاء المستهدف بعد الاختبار.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` تم إيقاف هذه الطريقة نهائيًا. استخدام `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)` بدلاً من ذلك

الطرق العامة

إعداد

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

تم إيقاف هذه الطريقة نهائيًا.
استخدام setUp(com.android.tradefed.invoker.TestInformation) كبديل

نفِّذ الإعداد المستهدف للاختبار.

المعلمات
`device`	`ITestDevice`: `ITestDevice` للاستعداد.
`buildInfo`	`IBuildInfo`: بيانات الإصدار قيد الاختبار.

الرميات
`TargetSetupError`	إذا حدث خطأ فادح أثناء إعداد البيئة
`BuildError`	في حال حدوث خطأ متعلق بمعلومات BuildInfo
`DeviceNotAvailableException`	إذا أصبح الجهاز لا يستجيب

إعداد

public void setUp (TestInformation testInformation)

نفِّذ الإعداد المستهدف للاختبار.

المعلمات
`testInformation`	`TestInformation`: `TestInformation` للاستدعاء.

الرميات
`TargetSetupError`	إذا حدث خطأ فادح أثناء إعداد البيئة
`BuildError`	في حال حدوث خطأ بسبب تجهيز الإصدار
`DeviceNotAvailableException`	إذا أصبح الجهاز لا يستجيب

قطع

public void tearDown (TestInformation testInformation, 
                Throwable e)

إجراء التنظيف/الإلغاء المستهدف بعد الاختبار.

المعلمات
`testInformation`	`TestInformation`: `TestInformation` للاستدعاء.
`e`	`Throwable`: إذا انتهى الاستدعاء باستثناء حالات، فسيكون هذا هو الاستثناء الذي على مستوى الاستدعاء. بخلاف ذلك، ستكون `null`.

الرميات
`DeviceNotAvailableException`	إذا أصبح الجهاز لا يستجيب

قطع

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

تم إيقاف هذه الطريقة نهائيًا.
استخدام tearDown(com.android.tradefed.invoker.TestInformation, Throwable) كبديل

إجراء التنظيف/الإلغاء المستهدف بعد الاختبار.

المعلمات
`device`	`ITestDevice`: `ITestDevice` للاستعداد.
`buildInfo`	`IBuildInfo`: بيانات الإصدار قيد الاختبار.
`e`	`Throwable`: إذا انتهى الاستدعاء باستثناء حالات، فسيكون هذا هو الاستثناء الذي على مستوى الاستدعاء. بخلاف ذلك، ستكون `null`.

الرميات
`DeviceNotAvailableException`	إذا أصبح الجهاز لا يستجيب