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 , and 68 others. AdbStopServerPreparer الهدف المُعد لإيقاف خادم adb على المضيف قبل إجراء اختبارات adb وبعدها. AllTestAppsInstallSetup برنامج ITargetPreparer الذي يقوم بتثبيت جميع التطبيقات من IDeviceBuildInfo#getTestsDir() على الجهاز. AoaTargetPreparer ITargetPreparer الذي ينفذ سلسلة من الإجراءات (مثل النقرات والضربات الشديدة) باستخدام بروتوكول Android Open Accessory (AOAv2). AppSetup برنامج ITargetPreparer الذي يقوم بتثبيت apk واختباراته. ArtChrootPreparer إنشاء دليل chroot لاختبارات ART. BaseEmulatorPreparer المُعد المشترك لبدء تشغيل محاكي محلي. BaseTargetPreparer فئة التنفيذ الأساسية لـ ITargetPreparer التي تسمح بالتحكم في ما إذا كان الكائن معطلاً أم لا. BuildInfoRecorder برنامج ITargetPreparer الذي يكتب بيانات meta الخاصة بالبناء في ملف محدد. CheckPairingPreparer CompanionAwarePreparer الذي يتحقق من ارتباط BT بين الأجهزة الأساسية والمرافقة رفيق التخصيص فئة أساسية تهتم بتخصيص وتحرير الجهاز المرافق يجب تنفيذ getCompanionDeviceSelectionOptions() لوصف المعايير اللازمة لتخصيص الجهاز المصاحب CompanionAwarePreparer أداة ITargetPreparer التي تلخص منطق الحصول على جهاز مصاحب مخصص بالفعل. CompanionRunCommandTargetPreparer برنامج ITargetPreparer الذي يقوم بتشغيل أوامر محددة على الجهاز المصاحب المخصص CompanionTestAppInstallSetup برنامج ITargetPreparer الذي يقوم بتثبيت تطبيق واحد أو أكثر من IDeviceBuildInfo#getTestsDir() على جهاز مصاحب مخصص. CompileBootImageWithSpeedTargetPreparer يعيد تجميع مسار فئة التمهيد وخادم النظام باستخدام عامل تصفية المترجم "speed". وحدة المعالجة المركزية ITargetPreparer الذي ينتظر حتى يتم استعادة الحد الأقصى للتردد على جميع النوى إلى أعلى مستوى متاح CreateAvdPreparer CreateUserPreparer معد الهدف لإنشاء المستخدم وتنظيفه في النهاية. DeviceBuildInfoBootStrapper برنامج ITargetPreparer الذي يستبدل إنشاء حقول المعلومات بسمات مقروءة من الجهاز هذا مفيد لاختبار الأجهزة ذات الإنشاءات التي تم إنشاؤها من مصدر خارجي (على سبيل المثال DeviceBuildInfoInjector برنامج ITargetPreparer الذي يقوم بإدراج بيانات تعريف DeviceBuildDescriptor في IBuildInfo . منظف ​​الجهاز يقوم بإعادة التشغيل أو التنسيق كإجراء تنظيف بعد الاختبار ، ويتم إيقاف تشغيل الشاشة اختياريًا DeviceFlashPreparer ITargetPreparer الذي يُومض صورة على أجهزة Android المادية. DeviceImageZipFlashingTargetPreparer مُعِد الهدف الذي يُومِض الجهاز بصور الجهاز المقدمة عبر تنسيق محدد. DeviceOwnerTargetPreparer برنامج ITargetPreparer الذي يقوم بإعداد مكون مالك الجهاز. إعداد الجهاز برنامج ITargetPreparer الذي يقوم بتكوين جهاز للاختبار بناءً على Option المتوفرة. DeviceStorageFiller المُعد المستهدف لملء التخزين بحيث يتوفر قدر من المساحة الخالية. DeviceStringPusher الهدف المُعد لكتابة سلسلة إلى ملف. DeviceUpdateTargetPreparer أداة ITargetPreparer مجردة تتولى تنفيذ الخطوات الشائعة حول تحديث الأجهزة بملف صورة جهاز من مصدر خارجي (على عكس خدمة الإنشاء). DeviceWiper ITargetPreparer الذي يمسح بيانات المستخدم قم بتعطيل SELinuxTargetPreparer معد الهدف الذي يعطل SELinux إذا تم تمكينه. DynamicSystemPreparer برنامج ITargetPreparer الذي يقوم بإعداد صورة نظام أعلى جهاز تم إنشاؤه باستخدام تحديث النظام الديناميكي. EraseUserDataPreparer برنامج ITargetPreparer الذي يمسح بيانات المستخدم على الجهاز. FastbootCommandPreparer معد الهدف الذي يقوم بتشغيل fastboot ويرسل أوامر fastboot. FastbootUpdateBootstrapPreparer. برنامج FastbootUpdateBootstrapPreparer برنامج ITargetPreparer الذي يقوم بتدوير الملفات المحددة (أداة تحميل التشغيل ، والراديو ، وصورة الجهاز المضغوط) إلى IDeviceBuildInfo للحصول على وميض الأجهزة باستخدام FastbootDeviceFlasher ، ثم يقوم بحقن سمات جهاز ما بعد التمهيد في معلومات الإنشاء لأغراض الإبلاغ عن النتائج. FeatureFlagTargetPreparer يحدّث DeviceConfig (علامات الميزات التي تم ضبطها بواسطة خدمة بعيدة). قابلة للطي مُعد الهدف يمكنه تبديل الحالة القابلة للطي للجهاز. فولدر سيفر برنامج ITargetPreparer الذي يسحب الدلائل من الجهاز ويضغطها ويحفظها في تسجيل الخلفية. GkiDeviceFlashPreparer مُعِد الهدف الذي يُومِض الجهاز بصورة عامة kernel الشائعة لنظام android. GsiDeviceFlashPreparer أداة إعداد الهدف التي تومض الجهاز بصورة عامة لنظام android. ILabPreparer واجهة ماركر لمعدّي المختبرات راجع ITargetPreparer للحصول على وصف لما تعنيه هذه الواجهات. ITargetCleaner هذه الواجهة مهملة. تم نقل tearDown إلى واجهة ITargetPreparer الأساسية. InstallAllTestZipAppsSetup برنامج ITargetPreparer الذي يقوم بتثبيت جميع التطبيقات في ملف مضغوط تجريبي. InstallApexModuleTargetPreparer InstallApkSetup برنامج ITargetPreparer الذي يقوم بتثبيت واحد أو أكثر من التطبيقات الموجودة على نظام الملفات. InstallBuildEnvApkSetup برنامج ITargetPreparer الذي يقوم بتثبيت تطبيق تجريبي واحد أو أكثر من بيئة إنشاء منصة Android. الأجهزة ITargetPreparer الذي يدير الأجهزة KillExistingEmulatorPreparer ITargetPreparer الذي يقوم بإيقاف تشغيل محاكي قيد التشغيل. KnownFailure محضرا معد الهدف لتخطي إعادة محاولة الفشل المعروف. LocalEmulatorLaunch برنامج TargetPreparer الذي يقوم بتشغيل محاكي محليًا من بيئة إنشاء android. LocalEmulatorSnapshot الهدف من برنامج TargetPreparer إنشاء لقطة محاكاة نظيفة من بيئة إنشاء / تطوير android ModuleOemTargetPreparer NativeLeakCollector ITargetPreparer الذي يقوم بتشغيل "dumpsys meminfo - unreachable -a" لتحديد الذاكرة الأصلية التي لا يمكن الوصول إليها والتي تحتفظ بها حاليًا كل عملية. NoApkTestSkipper مُعد خاص يسمح بتخطي الاحتجاج تمامًا (التحضير والاختبارات) إذا لم يكن هناك تطبيقات للاختبارات. بيرفيتو يدفع مُعد Perfetto ملف التكوين إلى الجهاز في موقع قياسي يمكن لـ perfetto الوصول إليه. PushFileInvoker هذه الفئة مهملة. استخدم PushFilePreparer بدلاً من ذلك PushFilePreparer ITargetPreparer الذي يحاول دفع أي عدد من الملفات من أي مسار مضيف إلى أي مسار للجهاز. PythonVirtualenv المُعد إعداد Python virtualenv على المضيف وتثبيت الحزم. RebootTargetPreparer معد الهدف الذي يعيد تشغيل الجهاز. RecoveryLogPreparer مُعد الهدف يُستخدم لجمع السجلات قبل الاسترداد. RemoveSystemAppPreparer أداة ITargetPreparer لإزالة apk من قسم النظام قبل التشغيل التجريبي. أعد تشغيل SystemServerTargetPreparer معد الهدف الذي يقوم بإعادة تشغيل خادم النظام دون إعادة تشغيل الجهاز. RootTargetPreparer معد الهدف الذي ينفذ "adb root" أو "adb unroot" بناءً على الخيار "force-root". RunCommandTargetPreparer RunHostCommandTargetPreparer معد الهدف لتشغيل أوامر مضيف عشوائية قبل تشغيل الاختبار وبعده. RunHostScriptTargetPreparer معد الهدف الذي ينفذ البرنامج النصي قبل إجراء الاختبار. RunOnSdkSandboxTargetPreparer ITargetPreparer لتحديد أن الاختبارات يجب أن تعمل في sdk sandbox. RunOnSecondaryUserTargetPreparer برنامج ITargetPreparer الذي ينشئ مستخدمًا ثانويًا في الإعداد ، ويضع علامة على وجوب تشغيل الاختبارات في هذا المستخدم. RunOnSystemUserTargetPreparer أداة ITargetPreparer التي تحدد أن الاختبارات يجب أن يتم إجراؤها على المستخدم (بدلاً من المستخدم الحالي). RunOnWorkProfileTargetPreparer برنامج ITargetPreparer الذي ينشئ ملفًا شخصيًا للعمل في الإعداد ، ويضع علامة على وجوب تشغيل الاختبارات في هذا المستخدم. SemaphoreTokenTargetPreparer هذا مُعد يستخدم لاستخدام الرمز المميز لإجراء تسلسل للاختبار في المضيف التجاري. SideloadOtaTargetPreparer مُعد الهدف الذي يقوم بالتحميل الجانبي لحزمة OTA محددة ، ويطبق الحزمة ، وينتظر بدء تشغيل الجهاز ، ويحقن خصائص بناء الجهاز لاستخدامها كمعلومات بناء يفترض مُعد الهدف هذا أن الجهاز سيكون في وضع adb العادي عند بدء التشغيل ، وسيضمن خروج الجهاز في نفس الوضع ولكن مع تطبيق الإصدار الأحدث. StopServicesSetup ITargetPreparer الذي يقوم بإيقاف الخدمات على الجهاز. StubTargetPreparer عنصر نائب تنفيذ فارغ لـ ITargetPreparer . برنامج SuiteApkInstaller تثبيت ملفات APK لتهيئة Suite: إما من المتغير $ ANDROID_TARGET_OUT_TESTCASES أو ROOT_DIR في معلومات البناء. SwitchUserTargetPreparer هو ITargetPreparer الذي يتحول إلى نوع المستخدم المحدد في setUp. TearDownPassThroughPreparer يسمح بتشغيل tearDown على المُعدِّين المضمنة في التكوين ككائن. درجة الحرارة ITargetPreparer الذي ينتظر حتى تنخفض درجة حرارة الجهاز عن الهدف TestAppInstallSetup برنامج ITargetPreparer الذي يقوم بتثبيت تطبيق واحد أو أكثر من مجلد IDeviceBuildInfo.getTestsDir() على الجهاز. TestFilePushSetup برنامج ITargetPreparer الذي يقوم بدفع ملف / dirs واحد أو أكثر من مجلد IDeviceBuildInfo.getTestsDir() إلى الجهاز. TestSystemAppInstallSetup برنامج ITargetPreparer الذي يقوم بتثبيت تطبيق واحد أو أكثر من مجلد IDeviceBuildInfo.getTestsDir() على قسم / system على الجهاز. مضيع للوقت مُعد هدف بسيط لإضاعة الوقت وربما إعادة تشغيل الجهاز. UserCleaner أداة ITargetPreparer التي تزيل المستخدمين الثانويين عند تفكيكها. WaitForDeviceDatetimePreparer ITargetPreparer الذي ينتظر تعيين التاريخ والوقت على الجهاز اختياريًا ، يمكن أن يفرض هذا المُعد خطأ TargetSetupError إذا لم يتم تعيين التاريخ والوقت خلال المهلة ، أو فرض تاريخ ووقت المضيف على الجهاز ، واي فاي برنامج ITargetPreparer الذي يقوم بتهيئة wifi على الجهاز إذا لزم الأمر.

---

تحضير بيئة الاختبار للتشغيل التجريبي.

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

لاحظ أنه يمكن تحديد عدة 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	إذا أصبح الجهاز غير مستجيب