ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

الفئات الفرعية المعروفة غير المباشرة AdbStopServerPreparer وAllTestAppsInstallSetup وAoaTargetPreparer وAppSetup وartChrootPreparer وBaseEmulatorPreparer وBaseTargetPreparer وBuildRecordInfoer وCheckLogingAllCompware واشلِغ_الإعداد2للإعدادو"هنا"و"هنا"و"هنا" لتأكيد عملية الإعداد ولإعداد هذه السياسة، وو"الإعداد" ومن خلال جهتَي "الإعداد" ولهما؟ 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 الأساسي.  أداة إعداد الأدوات 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	إذا أصبح الجهاز لا يستجيب