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