ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

الفئات الفرعية غير المباشرة المعروفة ‫AdbStopServerPreparer وAllTestAppsInstallSetup وAoaTargetPreparer وAppSetup وArtChrootPreparer وBaseEmulatorPreparer وBaseTargetPreparer وBuildInfoRecorder وCheckPairingPreparer وCompanionAllocator وCompanionAwarePreparer وCompanionRunCommandTargetPreparer وCompanionTestAppInstallSetup وCompileBootImageWithSpeedTargetPreparer وCpuThrottlingWaiter و79 غيرها AdbStopServerPreparer يجب أن يوقف معدّ الجهاز المستهدَف خادم adb على المضيف قبل وبعد تشغيل اختبارات adb.  AllTestAppsInstallSetup ITargetPreparer يثبّت جميع التطبيقات من مجلد IDeviceBuildInfo.getTestsDir() على الجهاز.  AoaTargetPreparer ITargetPreparer الذي ينفّذ سلسلة من الإجراءات (مثل عمليات النقر والتمرير السريع) باستخدام بروتوكول Android Open Accessory (AOAv2).  AppSetup ITargetPreparer يثبّت حزمة APK واختباراتها.  ArtChrootPreparer إنشاء دليل chroot لاختبارات ART  BaseEmulatorPreparer أداة إعداد شائعة لتشغيل محاكي محلي  BaseTargetPreparer فئة التنفيذ الأساسية لـ ITargetPreparer التي تتيح التحكّم في ما إذا كان الكائن غير مفعّل أم لا.  BuildInfoRecorder ITargetPreparer يكتب البيانات الوصفية لمعلومات الإنشاء في ملف محدّد.  CheckPairingPreparer CompanionAwarePreparer يثبت ربط البلوتوث بين الجهاز الأساسي والجهاز المرافق  CompanionAllocator فئة أساسية تتولّى تخصيص الجهاز المرافق وتحريره يجب تنفيذ getCompanionDeviceSelectionOptions() لوصف المعايير اللازمة لتخصيص الجهاز المصاحب  CompanionAwarePreparer ITargetPreparer يغلف منطق الحصول على جهاز مصاحب تم تخصيصه مسبقًا.  CompanionRunCommandTargetPreparer ITargetPreparer ينفِّذ الأوامر المحدّدة على الجهاز المصاحب المخصّص  CompanionTestAppInstallSetup ITargetPreparer يثبّت تطبيقًا واحدًا أو أكثر من مجلد IDeviceBuildInfo.getTestsDir() على جهاز مصاحب مخصّص.  CompileBootImageWithSpeedTargetPreparer إعادة تجميع مسار فئة التمهيد وخادم النظام باستخدام فلتر المجمّع "speed"  CpuThrottlingWaiter ITargetPreparer ينتظر إلى أن تتم استعادة الحد الأقصى للتردد على جميع النوى إلى أعلى مستوى متاح  CreateAvdPreparer   CreateUserPreparer أداة إعداد الهدف لإنشاء المستخدم وتنظيفه في النهاية  DeviceActionTargetPreparer ITargetPreparer لتنفيذ إجراءات الجهاز  DeviceBuildInfoBootStrapper ITargetPreparer يستبدل حقول معلومات الإصدار بالسمات التي يتم قراءتها من الجهاز ويكون ذلك مفيدًا لاختبار الأجهزة باستخدام إصدارات تم إنشاؤها من مصدر خارجي (مثل  DeviceBuildInfoInjector ITargetPreparer الذي يُدرج بيانات وصفية DeviceBuildDescriptor في IBuildInfo  DeviceCleaner إعادة التشغيل أو التنسيق كإجراء تنظيف بعد الاختبار، وإيقاف الشاشة اختياريًا  DeviceFlashPreparer ITargetPreparer تعرض صورة على أجهزة Android.  DeviceImageZipFlashingTargetPreparer أداة إعداد الهدف التي تومض الجهاز بصور الجهاز المقدَّمة بتنسيق محدّد  DeviceOwnerTargetPreparer ITargetPreparer الذي يضبط أحد مكونات مالك الجهاز  DeviceSetup ITargetPreparer يضبط جهازًا للاختبار استنادًا إلى Option المقدَّمة.  DeviceStorageFiller يجب أن يملأ برنامج إعداد الهدف مساحة التخزين لكي تتوفّر مساحة فارغة.  DeviceStringPusher أداة إعداد الهدف لكتابة سلسلة في ملف  DeviceUpdateTargetPreparer فئة مجرّدة ITargetPreparer تتولّى تنفيذ الخطوات الشائعة المتعلقة بتحديث الأجهزة باستخدام ملف صورة جهاز من مصدر خارجي (بدلاً من خدمة إنشاء).  DeviceWiper ITargetPreparer يحجب بيانات المستخدم  DisableSELinuxTargetPreparer أداة إعداد الهدف التي توقف SELinux في حال تفعيله.  DynamicSystemPreparer ITargetPreparer: هي أداة تعمل على إعداد صورة نظام فوق إصدار الجهاز باستخدام ميزة "تحديث النظام الديناميكي".  EraseUserDataPreparer ITargetPreparer يحجب بيانات المستخدمين من الجهاز.  FastbootCommandPreparer أداة إعداد الهدف التي تؤدي إلى تشغيل fastboot وإرسال أوامر fastboot  FastbootUpdateBootstrapPreparer ITargetPreparer التي تنقل الملفات المحدّدة (برنامج الإقلاع والراديو وملف ZIP لصورة الجهاز) إلى IDeviceBuildInfo لتثبيت FastbootDeviceFlasher على الأجهزة، ثم تُدرج سمات الجهاز بعد الإقلاع في معلومات الإصدار لأغراض إعداد التقارير عن النتائج.  FeatureFlagTargetPreparer تعدّل هذه السمة DeviceConfig (علامات الميزات التي يتم ضبطها من خلال خدمة عن بُعد).  FoldableModePreparer أداة إعداد هدف يمكنها تبديل حالة الجهاز القابل للطي.  FolderSaver ITargetPreparer الذي يسحب الأدلة من الجهاز ويضغطها ويحفظها في نظام الخلفية لتسجيل البيانات  FutilityCommandPreparer مُعدّ لتنفيذ أوامر عدم الجدوى  GkiDeviceFlashPreparer أداة إعداد الهدف التي تعمل على تحديث الجهاز باستخدام صورة عامة لنواة Android الشائعة  GoogleAccountPreparer ITargetPreparer يتيح إعداد حسابات Google  GsiDeviceFlashPreparer أداة إعداد تستخدم صورة نظام Android عامة لتثبيت نظام التشغيل على الجهاز  ILabPreparer واجهة علامات لمعدّي التجارب يمكنك الاطّلاع على ITargetPreparer لمعرفة الغرض من هذه الواجهات.  ITargetCleaner تم إيقاف هذه الواجهة نهائيًا. تم نقل tearDown إلى واجهة ITargetPreparer الأساسية.  InstallAllTestZipAppsSetup ITargetPreparer: هو ملف zip يثبّت جميع التطبيقات.  InstallApexModuleTargetPreparer   InstallApkSetup ITargetPreparer الذي يثبّت حِزمة APK واحدة أو أكثر من تلك المتوفّرة في نظام الملفات  InstallBuildEnvApkSetup ITargetPreparer يثبّت حِزم APK واحدة أو أكثر من بيئة إصدار نظام Android الأساسي.  InstallKernelModulePreparer أداة إعداد الهدف التي تثبّت وحدات نواة النظام.  InstrumentationPreparer ITargetPreparer تنفِّذ عملية قياس الأداء  KillExistingEmulatorPreparer تمثّل ITargetPreparer عملية إيقاف محاكي قيد التشغيل.  KnownFailurePreparer يجب أن يتجاهل برنامج إعداد الاستهداف إعادة محاولة تنفيذ عملية فاشلة معروفة.  LocalEmulatorLaunch أداة TargetPreparer تُشغّل محاكيًا على الجهاز من بيئة إنشاء Android.  LocalEmulatorSnapshot أداة TargetPreparer مخصّصة لإنشاء لقطة محاكي نظيفة من بيئة تطوير/إنشاء Android  MixKernelTargetPreparer ITargetPreparer يسمح بدمج صورة النواة مع صورة الجهاز  MixRadioTargetPreparer ITargetPreparer يسمح بدمج صورة الراديو مع صورة الجهاز.  ModuleOemTargetPreparer   NativeLeakCollector ITargetPreparer الذي ينفّذ الأمر dumpsys meminfo --unreachable -a لتحديد الذاكرة الأصلية التي لا يمكن الوصول إليها والتي تحتفظ بها كل عملية حاليًا  NoApkTestSkipper مُعدّ خاص يسمح بتخطّي عملية الاستدعاء بالكامل (الإعداد والاختبارات) في حال عدم توفّر حِزم APK لاختبارها.  PerfettoPreparer يرسل برنامج إعداد Perfetto ملف الإعداد إلى الجهاز في موقع جغرافي عادي يمكن أن يصل إليه Perfetto.  ProfileTargetPreparer فئة أساسية لإعداد أداة إعداد الهدف لأي مستخدم ملف شخصي android.os.usertype.profile.XXX.  PushFileInvoker تم إيقاف هذا الصف نهائيًا. استخدِم PushFilePreparer بدلاً من ذلك  PushFilePreparer ITargetPreparer التي تحاول نقل أي عدد من الملفات من أي مسار مضيف إلى أي مسار جهاز.  PythonVirtualenvPreparer تُعدّ هذه السمة بيئة Python افتراضية على المضيف وتثبّت الحِزم.  RebootTargetPreparer أداة إعداد الهدف التي تعيد تشغيل الجهاز.  RecoveryLogPreparer يتم استخدام أداة إعداد الهدف لجمع السجلات قبل الاسترداد.  RemoveSystemAppPreparer تمثّل ITargetPreparer عملية إزالة حزمة APK من قسم النظام قبل إجراء اختبار.  RestartSystemServerTargetPreparer أداة إعداد الهدف التي تعيد تشغيل خادم النظام بدون إعادة تشغيل الجهاز  RootTargetPreparer أداة إعداد الاستهداف التي تنفّذ الأمر "adb root" أو "adb unroot" استنادًا إلى الخيار "force-root"  RootcanalForwarderPreparer   RunCommandTargetPreparer   RunHostCommandTargetPreparer يستهدف هذا الخيار أداة الإعداد لتنفيذ أوامر مضيف عشوائية قبل وبعد تنفيذ الاختبار.  RunHostScriptTargetPreparer يستهدف هذا الخيار أداة الإعداد التي تنفّذ نصًا برمجيًا قبل تشغيل الاختبار.  RunOnCloneProfileTargetPreparer   RunOnPrivateProfileTargetPreparer   RunOnSdkSandboxTargetPreparer ITargetPreparer: يشير إلى أنّ الاختبارات يجب أن يتم تنفيذها في وضع الحماية لحزمة SDK.  RunOnSecondaryUserTargetPreparer ITargetPreparer لضمان تشغيل الاختبار كمستخدم ثانوي  RunOnSystemUserTargetPreparer تمثّل ITargetPreparer علامة تشير إلى أنّه يجب إجراء الاختبارات على المستخدم (بدلاً من المستخدم الحالي).  RunOnWorkProfileTargetPreparer ITargetPreparer الذي ينشئ ملف عمل أثناء عملية الإعداد، ويشير إلى أنّه يجب تنفيذ الاختبارات في هذا المستخدم.  SemaphoreTokenTargetPreparer هذا هو المحضّر المستخدَم لاستخدام الرمز المميز لتسلسل تنفيذ الاختبار في مضيف Tradefed.  SideloadOtaTargetPreparer أداة إعداد الهدف التي تنفّذ التحميل الجانبي لحزمة OTA محدّدة، وتطبّق الحزمة، وتنتظر حتى يتم تشغيل الجهاز، وتُدرج خصائص إصدار الجهاز لاستخدامها كمعلومات الإصدار يفترض معدِّد الأهداف هذا أنّ الجهاز سيكون في وضع adb العادي عند بدء تشغيله، وسيضمن خروج الجهاز من الوضع نفسه ولكن مع تطبيق الإصدار الأحدث.  StopServicesSetup ITargetPreparer يؤدي إلى إيقاف الخدمات على الجهاز  StubTargetPreparer تنفيذ فارغ للعنصر النائب ITargetPreparer  SuiteApkInstaller تثبيت حِزم APK المحدّدة لإعداد Suite: إما من المتغيّر $ANDROID_TARGET_OUT_TESTCASES أو ROOT_DIR في معلومات الإصدار  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 على الجهاز إذا لزم الأمر.

---

تجهيز بيئة الاختبار لتنفيذ الاختبار

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

يُرجى العِلم أنّه يمكن تحديد عدة 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) بدلاً من ذلك

الطُرق العامة

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

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

المعلمات
device	ITestDevice: ITestDevice المطلوب إعداده
buildInfo	‫IBuildInfo: بيانات حول الإصدار قيد الاختبار

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

setUp

public void setUp (TestInformation testInformation)

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

المعلمات
testInformation	TestInformation: تمثّل هذه السمة TestInformation عملية الاستدعاء.

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

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

نفِّذ عملية التنظيف/الإزالة المستهدَفة بعد الاختبار.

المعلمات
testInformation	TestInformation: تمثّل هذه السمة TestInformation عملية الاستدعاء.
e	‫Throwable: إذا انتهى الاستدعاء باستثناء، سيكون هذا هو الاستثناء الذي تم رصده على مستوى الاستدعاء. وفي ما عدا ذلك، ستكون القيمة null.

الرميات
DeviceNotAvailableException	إذا توقّف الجهاز عن الاستجابة

tearDown

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	إذا أصبح الجهاز لا يستجيب