ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer
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 که اتصال BT را بین دستگاه های اصلی و همراه تأیید می کند
CompanionAlocator کلاس پایه که از تخصیص و آزادسازی دستگاه همراه مراقبت می کند

getCompanionDeviceSelectionOptions() باید برای توصیف معیارهای مورد نیاز برای تخصیص دستگاه همراه پیاده سازی شود.

CompanionAwarePreparer یک ITargetPreparer که منطق بدست آوردن یک دستگاه همراه از قبل اختصاص داده شده را در بر می گیرد.
CompanionRunCommandTargetPreparer یک ITargetPreparer که دستورات مشخص شده را در دستگاه همراه اختصاص داده شده اجرا می کند
CompanionTestAppInstallSetup یک ITargetPreparer که یک یا چند برنامه را از پوشه IDeviceBuildInfo.getTestsDir() روی یک دستگاه همراه اختصاص داده شده نصب می کند.
CompileBootImageWithSpeedTargetPreparer مسیر کلاس بوت و سرور سیستم را با فیلتر کامپایلر 'speed' دوباره کامپایل می کند.
CpuThrottling Waiter یک ITargetPreparer که صبر می کند تا حداکثر فرکانس در همه هسته ها به بالاترین سطح موجود بازگردد.
CreateAvdPreparer
CreateUserPreparer آماده کننده هدف برای ایجاد کاربر و پاکسازی آن در پایان.
DeviceActionTargetPreparer یک ITargetPreparer برای انجام اقدامات دستگاه.
DeviceBuildInfoBootStrapper یک ITargetPreparer که فیلدهای اطلاعات ساخت را با ویژگی های خوانده شده از دستگاه جایگزین می کند

این برای آزمایش دستگاه هایی با ساخت های تولید شده از یک منبع خارجی مفید است (به عنوان مثال

DeviceBuildInfoInjector یک ITargetPreparer که فراداده DeviceBuildDescriptor در IBuildInfo وارد می کند.
DeviceCleaner پس از آزمایش، راه‌اندازی مجدد یا قالب‌بندی را به‌عنوان اقدام پاک‌سازی انجام می‌دهد و به‌صورت اختیاری صفحه را خاموش می‌کند
DeviceFlashPreparer یک ITargetPreparer که یک تصویر را روی سخت افزار فیزیکی اندروید فلش می کند.
DeviceImageZipFlashingTargetPreparer یک آماده‌کننده هدف که دستگاه را با تصاویر دستگاه ارائه شده از طریق یک فرمت خاص فلش می‌کند.
DeviceOwnerTargetPreparer یک ITargetPreparer که یک جزء مالک دستگاه را تنظیم می کند.
DeviceSetup یک ITargetPreparer که دستگاهی را برای آزمایش بر اساس Option ارائه شده پیکربندی می کند.
DeviceStorageFiller آماده‌کننده هدف را برای پر کردن فضای ذخیره‌سازی تا مقداری فضای آزاد در دسترس قرار دهید.
DeviceStringPusher آماده‌کننده هدف برای نوشتن یک رشته در یک فایل.
DeviceUpdateTargetPreparer یک ITargetPreparer انتزاعی که مراحل معمول را در مورد به‌روزرسانی دستگاه‌ها با فایل تصویر دستگاه از یک منبع خارجی (برخلاف یک سرویس ساخت) انجام می‌دهد.
دستگاه پاک کن یک ITargetPreparer که داده های کاربر را پاک می کند
SELinuxTargetPreparer را غیرفعال کنید آماده‌کننده هدف که در صورت فعال بودن SELinux را غیرفعال می‌کند.
DynamicSystemPreparer یک ITargetPreparer که یک تصویر سیستم را در بالای بیلد دستگاه با به‌روزرسانی Dynamic System تنظیم می‌کند.
EraseUserDataPreparer یک ITargetPreparer که داده های کاربر را روی دستگاه پاک می کند.
FastbootCommandPreparer آماده کننده هدف که فست بوت را راه اندازی می کند و دستورات فست بوت را ارسال می کند.
FastbootUpdateBootstrapPreparer یک ITargetPreparer که فایل‌های مشخص شده (بوت‌لودر، رادیو، زیپ تصویر دستگاه) را در IDeviceBuildInfo قرار می‌دهد تا دستگاه‌ها را با FastbootDeviceFlasher فلش کند، سپس ویژگی‌های دستگاه پس از راه‌اندازی را برای اهداف گزارش نتیجه به اطلاعات ساخت تزریق می‌کند.
FeatureFlagTargetPreparer DeviceConfig (پرچم های ویژگی تنظیم شده توسط یک سرویس راه دور) را به روز می کند.
FoldableModePreparer یک آماده‌کننده هدف که می‌تواند حالت تاشو یک دستگاه را تغییر دهد.
FolderSaver یک ITargetPreparer که دایرکتوری ها را از دستگاه بیرون می کشد، فشرده می کند و در باطن ورود به سیستم ذخیره می کند.
GkiDeviceFlashPreparer یک آماده‌کننده هدف که دستگاه را با تصویر عمومی هسته مشترک اندروید فلش می‌کند.
GsiDeviceFlashPreparer یک آماده‌کننده هدف که دستگاه را با تصویر سیستم عمومی اندروید فلش می‌کند.
ILabPreparer رابط نشانگر برای تهیه کنندگان آزمایشگاه

برای توضیح این که این رابط ها در نظر گرفته شده اند، به ITargetPreparer مراجعه کنید.

ITargetCleaner این رابط منسوخ شده است. tearDown به رابط پایه ITargetPreparer منتقل شده است.
InstallAllTestZipAppsSetup یک ITargetPreparer که همه برنامه ها را در یک فایل فشرده آزمایشی نصب می کند.
InstallApexModuleTargetPreparer
نصب ApkSetup یک ITargetPreparer که یک یا چند apk را روی سیستم فایل نصب می‌کند.
InstallBuildEnvApkSetup را نصب کنید یک ITargetPreparer که یک یا چند apk آزمایشی را از پلتفرم Android build env نصب می‌کند.
InstallKernelModulePreparer یک آماده‌کننده هدف که ماژول‌های هسته را نصب می‌کند.
ابزار دقیق یک ITargetPreparer که ابزار دقیق را اجرا می کند
KillExistingEmulatorPreparer یک ITargetPreparer که شبیه ساز در حال اجرا را خاموش می کند.
KnownFailurePreparer آماده‌کننده هدف برای رد شدن از تلاش مجدد شکست شناخته شده.
LocalEmulatorLaunch TargetPreparer که یک شبیه ساز را به صورت محلی از یک محیط ساخت اندروید راه اندازی می کند.
LocalEmulatorSnapshot TargetPreparer که برای ایجاد یک عکس فوری شبیه ساز تمیز از یک محیط ساخت/توسعه اندروید در نظر گرفته شده است.
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 virtualenv را روی هاست راه اندازی کرده و بسته ها را نصب می کند.
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 روی آماده‌کننده‌هایی که در یک پیکربندی به‌عنوان یک شی گنجانده شده‌اند، اجازه می‌دهد.
گارسون درجه حرارت یک ITargetPreparer که صبر می کند تا دمای دستگاه به هدف کاهش یابد
TestAppInstallSetup یک ITargetPreparer که یک یا چند برنامه را از پوشه IDeviceBuildInfo.getTestsDir() روی دستگاه نصب می کند.
TestFilePushSetup یک ITargetPreparer که یک یا چند فایل/دیر را از پوشه IDeviceBuildInfo.getTestsDir() به دستگاه منتقل می کند.
TestSystemAppInstallSetup یک ITargetPreparer که یک یا چند برنامه را از پوشه IDeviceBuildInfo.getTestsDir() روی پارتیشن سیستم / روی دستگاه نصب می کند.
TimeWaster یک آماده‌کننده هدف ساده برای اتلاف وقت و راه‌اندازی مجدد دستگاه.
UserCleaner یک ITargetPreparer که کاربران ثانویه را در زمان حذف حذف می کند.
VisibleBackgroundUserPreparer آماده‌کننده هدف برای اجرای آزمایش‌ها در کاربری که در پس‌زمینه قابل مشاهده است.
WaitForDeviceDatetimePreparer یک ITargetPreparer که منتظر تنظیم تاریخ در دستگاه است

در صورت تمایل، این آماده‌کننده می‌تواند یک TargetSetupError مجبور کند اگر تاریخ در بازه زمانی تعیین نشده باشد.

WifiPreparer یک ITargetPreparer که در صورت لزوم وای فای را روی دستگاه پیکربندی می کند.


محیط تست را برای اجرای آزمایشی آماده می کند.

به عنوان مثال، نرم افزار را نصب می کند، تنظیمات 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 : اگر فراخوان با یک استثنا به پایان رسید، این استثنایی است که در سطح Invocation ثبت شده است. در غیر این صورت 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 : اگر فراخوان با یک استثنا به پایان رسید، این استثنایی است که در سطح Invocation ثبت شده است. در غیر این صورت null خواهد بود.

پرتاب می کند
DeviceNotAvailableException در صورت عدم پاسخگویی دستگاه