این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

TestDevice

public class TestDevice
extends NativeDevice

java.lang.object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice

زیر کلاس های مستقیم شناخته شده

ManagedRemoteDevice ، NestedRemoteDevice ، RemoteAndroidDevice

ManagedRemoteDevice	دستگاهی که در داخل یک ماشین مجازی اجرا می شود که ما از راه دور از طریق یک نمونه Tradefed در داخل VM آن را مدیریت می کنیم.
NestedRemoteDevice	نمایش دستگاه در حال اجرا در داخل یک ماشین مجازی Cuttlefish از راه دور.
RemoteAndroidDevice	پیاده سازی `ITestDevice` برای یک دستگاه اندرویدی تمام پشته متصل از طریق adb connect.

زیر کلاس های غیر مستقیم شناخته شده

LocalAndroidVirtualDevice ، RemoteAndroidVirtualDevice

LocalAndroid Virtual Device	کلاس برای دستگاه های مجازی محلی که روی هاست TradeFed اجرا می شوند.
RemoteAndroid Virtual Device	رفتار `RemoteAndroidDevice` برای یک دستگاه Android با پشته کامل که در موتور محاسباتی Google (Gce) اجرا می شود، گسترش می دهد.

پیاده سازی ITestDevice برای یک دستگاه اندرویدی تمام پشته

خلاصه

کلاس های تو در تو
`class`	`TestDevice.MicrodroidBuilder` سازنده ای که برای ایجاد یک Microdroid TestDevice استفاده می شود.

فیلدها
`public static final String`	`DISMISS_KEYGUARD_CMD` دستوراتی که می توان از آنها برای حذف صفحه کلید استفاده کرد.

سازندگان عمومی
`TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)`

روش های عمومی
`boolean`	`canSwitchToHeadlessSystemUser ()` برمی‌گرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.
`boolean`	`clearErrorDialogs ()` سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.
`int`	`createUser (String name)` یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
`int`	`createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)` یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
`int`	`createUser (String name, boolean guest, boolean ephemeral)` یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
`int`	`createUserNoThrow (String name)` یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
`void`	`disableKeyguard ()` تلاش برای غیرفعال کردن محافظ صفحه کلید.
`boolean`	`doesFileExist (String deviceFilePath)` روش کمکی برای تعیین وجود فایل روی دستگاه.
`boolean`	`doesFileExist (String deviceFilePath, int userId)` روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر.
`File`	`dumpHeap (String process, String devicePath)` سعی کنید پشته را از system_server تخلیه کنید.
	`getActiveApexes ()` اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید.
	`getAllSettings (String namespace)` جفت مقدار کلید فضای نام درخواستی را برگردانید.
`String`	`getAndroidId (int userId)` شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null.
	`getAndroidIds ()` یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید.
`PackageInfo`	`getAppPackageInfo (String packageName)` اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید.
	`getAppPackageInfos ()` اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید.
`InputStreamSource`	`getBugreport ()` گزارش اشکال را از دستگاه بازیابی می کند.
`InputStreamSource`	`getBugreportz ()` یک bugreportz را از دستگاه بازیابی می کند.
`DeviceFoldableState`	`getCurrentFoldableState ()` وضعیت تاشو فعلی دستگاه را برمی‌گرداند یا در صورت بروز برخی مشکلات، آن را خالی می‌کند.
`int`	`getCurrentUser ()` شناسه کاربر فعلی را برگردانید.
	`getFoldableStates ()` لیست حالت های تاشو را در دستگاه برمی گرداند.
	`getInstalledPackageNames ()` نام بسته های برنامه موجود در دستگاه را واکشی کنید.
`KeyguardControllerState`	`getKeyguardState ()` یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید.
`Integer`	`getMainUserId ()` شناسه اصلی کاربر را برمی گرداند.
	`getMainlineModuleInfo ()` اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید.
`int`	`getMaxNumberOfRunningUsersSupported ()` حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید.
`int`	`getMaxNumberOfUsersSupported ()` حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید.
`Integer`	`getPrimaryUserId ()` شناسه کاربر اصلی را برمی گرداند.
`InputStreamSource`	`getScreenshot ()` یک اسکرین شات از دستگاه می گیرد.
`InputStreamSource`	`getScreenshot (String format, boolean rescale)` یک اسکرین شات از دستگاه می گیرد.
`InputStreamSource`	`getScreenshot (long displayId)` یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد.
`InputStreamSource`	`getScreenshot (String format)` یک اسکرین شات از دستگاه می گیرد.
`String`	`getSetting (String namespace, String key)` `getSetting(int, String, String)` ببینید و روی کاربر سیستم انجام شود.
`String`	`getSetting (int userId, String namespace, String key)` مقدار تنظیمات درخواستی را برگردانید.
	`getUninstallablePackageNames ()` نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید.
`int`	`getUserFlags (int userId)` پرچم های یک کاربر معین را پیدا کرده و برگردانید.
	`getUserInfos ()` نقشه useId به `UserInfo` را در دستگاه دریافت می کند.
`int`	`getUserSerialNumber (int userId)` در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید.
`boolean`	`hasFeature (String feature)` بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر.
`String`	`installPackage (File packageFile, boolean reinstall, String... extraArgs)` بسته اندروید را روی دستگاه نصب کنید.
`String`	`installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` بسته اندروید را روی دستگاه نصب کنید.
`String`	`installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs)` بسته اندروید را روی دستگاه نصب کنید.
`String`	`installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.
`String`	`installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)` یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.
`String`	`installPackages ( packageFiles, boolean reinstall, String... extraArgs)` `installPackages ( packageFiles, boolean reinstall, String... extraArgs)`
`String`	`installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` `installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` `installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`String`	`installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)` `installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)` `installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)`
`String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)` `installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`boolean`	`isAppEnumerationSupported ()` بررسی کنید که آیا پلتفرم روی دستگاه از شمارش برنامه پشتیبانی می‌کند یا خیر
`boolean`	`isHeadlessSystemUserMode ()` نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر.
`boolean`	`isMainUserPermanentAdmin ()` نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد.
`boolean`	`isMultiUserSupported ()` تعیین می کند که آیا چند کاربر پشتیبانی می شود.
`boolean`	`isPackageInstalled (String packageName)` دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.
`boolean`	`isPackageInstalled (String packageName, String userId)` دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.
`boolean`	`isUserRunning (int userId)` بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر.
`boolean`	`isUserSecondary (int userId)` آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر.
`boolean`	`isUserVisible (int userId)` بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر.
`boolean`	`isUserVisibleOnDisplay (int userId, int displayId)` بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported ()` نشان می‌دهد که آیا دستگاه به کاربران اجازه می‌دهد در پس‌زمینه در `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` قابل مشاهده باشند یا خیر.
`boolean`	`isVisibleBackgroundUsersSupported ()` نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر.
	`listDisplayIds ()` لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید.
	`listDisplayIdsForStartingVisibleBackgroundUsers ()` لیستی از نمایشگرهایی را دریافت می کند که می توانند برای `start a user visible in the background` استفاده شوند.
	`listUsers ()` لیست کاربران دستگاه را دریافت می کند.
`boolean`	`logBugreport (String dataName, ITestLogger listener)` روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران.
`void`	`notifySnapuserd ( SnapuserdWaitPhase waitPhase)`
`void`	`postInvocationTearDown (Throwable exception)` مراحل اضافی برای پاکسازی مورد نیاز خاص دستگاه که پس از انجام فراخوانی اجرا می شود.
`boolean`	`removeAdmin (String componentName, int userId)` ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود `true` برگردانید، در غیر این صورت `false` .
`void`	`removeOwners ()` همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید.
`boolean`	`removeUser (int userId)` یک کاربر معین را از دستگاه حذف کنید.
`boolean`	`setDeviceOwner (String componentName, int userId)` یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید.
`void`	`setFirstBootloaderReboot ()`
`void`	`setSetting (String namespace, String key, String value)` به `setSetting(int, String, String, String)` مراجعه کنید و در کاربر سیستم انجام شد.
`void`	`setSetting (int userId, String namespace, String key, String value)` یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید.
`void`	`shutdownMicrodroid ( ITestDevice microdroidDevice)` در صورت وجود، دستگاه میکرودروئید را خاموش می کند.
`boolean`	`startUser (int userId)` اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند.
`boolean`	`startUser (int userId, boolean waitFlag)` اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند.
`boolean`	`startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)` کاربر مشخصی را در پس‌زمینه شروع می‌کند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه می‌دهد فعالیت‌ها را در آن نمایشگر راه‌اندازی کند).
`boolean`	`stopUser (int userId, boolean waitFlag, boolean forceFlag)` یک کاربر معین را متوقف کنید.
`boolean`	`stopUser (int userId)` یک کاربر معین را متوقف می کند.
`boolean`	`supportsMicrodroid ()` پیش‌شرط‌های اجرای microdroid را بررسی می‌کند.
`boolean`	`supportsMicrodroid (boolean protectedVm)` پیش‌شرط‌های اجرای microdroid را بررسی می‌کند.
`boolean`	`switchUser (int userId)` به userId دیگری با مهلت زمانی پیش‌فرض بروید.
`boolean`	`switchUser (int userId, long timeout)` به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید.
`Bugreport`	`takeBugreport ()` یک Bugreport بگیرید و آن را در یک شی `Bugreport` برمی گرداند تا آن را مدیریت کند.
`String`	`uninstallPackage (String packageName)` یک بسته Android را از دستگاه حذف نصب کنید.
`String`	`uninstallPackageForUser (String packageName, int userId)` یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید.
`void`	`waitForSnapuserd ( SnapuserdWaitPhase currentPhase)`

روش های محافظت شده
`AaptParser`	`createParser (File appFile)`
`void`	`doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)` یک راه اندازی مجدد adb انجام دهید.
`InputStreamSource`	`getBugreportInternal ()`
`File`	`getBugreportzInternal ()` روش Internal Helper برای دریافت فایل zip bugreportz به صورت `ERROR(/File)` .
`long`	`getCheckNewUserSleep ()` در معرض آزمایش قرار گرفته است.
`long`	`getHostCurrentTime ()` در معرض آزمایش قرار گرفته است
`void`	`prePostBootSetup ()` به هر نوع دستگاه (AndroidNativeDevice، TestDevice) اجازه می‌دهد این روش را برای راه‌اندازی خاص پس از بوت لغو کند.

فیلدها

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

دستوراتی که می توان از آنها برای حذف صفحه کلید استفاده کرد.

سازندگان عمومی

TestDevice

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

روش های عمومی

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

برمی‌گرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.

برمی گرداند
`boolean`	`true` اگر هیچ گفتگویی وجود نداشته باشد یا گفتگوها با موفقیت پاک شوند. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

createUser

public int createUser (String name)

یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.

پارامترها
`name`	`String` : کاربر برای ایجاد در دستگاه

برمی گرداند
`int`	عدد صحیح برای شناسه کاربری ایجاد شده

پرتاب می کند
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید

پارامترها
`name`	`String` : کاربر برای ایجاد در دستگاه
`guest`	`boolean` : فعال کردن پرچم کاربر --guest در حین ایجاد
`ephemeral`	`boolean` : در حین ایجاد، پرچم کاربر را فعال کنید
`forTesting`	`boolean` : پرچم تست --برای آزمایش در حین ایجاد را فعال کنید

برمی گرداند
`int`	شناسه کاربر ایجاد شده

پرتاب می کند
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید

پارامترها
`name`	`String` : کاربر برای ایجاد در دستگاه
`guest`	`boolean` : فعال کردن پرچم کاربر --guest در حین ایجاد
`ephemeral`	`boolean` : در حین ایجاد، پرچم کاربر را فعال کنید

برمی گرداند
`int`	شناسه کاربر ایجاد شده

پرتاب می کند
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.

پارامترها
`name`	`String` : کاربر برای ایجاد در دستگاه

برمی گرداند
`int`	عدد صحیح برای شناسه کاربر ایجاد شده یا -1 برای خطا.

پرتاب می کند
`DeviceNotAvailableException`

غیرفعال کردن کیگارد

public void disableKeyguard ()

تلاش برای غیرفعال کردن محافظ صفحه کلید.

ابتدا منتظر بمانید تا ارسال ورودی آماده شود، این تقریباً همزمان با گزارش دستگاه BOOT_COMPLETE، ظاهراً ناهمزمان، اتفاق می‌افتد، زیرا پیاده‌سازی چارچوب فعلی دارای شرایط مسابقه گاه به گاه است. سپس دستور رد کردن صفحه کلید ارسال می شود (فقط روی موارد غیر ایمن کار می کند)

پرتاب می کند
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

روش کمکی برای تعیین وجود فایل روی دستگاه.

پارامترها
`deviceFilePath`	`String` : مسیر مطلق فایل روی دستگاه برای بررسی

برمی گرداند
`boolean`	`true` در صورت وجود فایل، `false` در غیر این صورت.

پرتاب می کند
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

پارامترها
`deviceFilePath`	`String` : مسیر مطلق فایل روی دستگاه برای بررسی
`userId`	`int` : شناسه کاربری که وجود فایل را با آن بررسی کنید

برمی گرداند
`boolean`	`true` در صورت وجود فایل، `false` در غیر این صورت.

پرتاب می کند
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

سعی کنید پشته را از system_server تخلیه کنید. این وظیفه تماس گیرنده است که فایل تخلیه شده را پاک کند.

پارامترها
`process`	`String` : نام فرآیند دستگاهی که باید روی آن تخلیه شود.
`devicePath`	`String` : مسیر روی دستگاه که در آن روگرفت را قرار دهید. این باید مکانی باشد که مجوزها اجازه آن را می دهند.

برمی گرداند
`File`	`ERROR(/File)` حاوی گزارش. اگر چیزی شکست خورده است.

پرتاب می کند
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید.

برمی گرداند
	`ERROR(/Set)` `ApexInfo` در حال حاضر در دستگاه فعال شده است

پرتاب می کند
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

جفت مقدار کلید فضای نام درخواستی را برگردانید.

پارامترها
`namespace`	`String` : باید یکی از {"system"، "secure"، "global"} باشد.

برمی گرداند
	نقشه جفت ارزش کلیدی اگر فضای نام پشتیبانی نشود، تهی است.

پرتاب می کند
`DeviceNotAvailableException`

getAndroidId

public String getAndroidId (int userId)

شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null.

پارامترها
`userId`	`int`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید. هیچ بیمه ای وجود ندارد که هر شناسه کاربری یک شناسه اندروید مرتبط با این تابع را پیدا کند، بنابراین برخی از شناسه های کاربر ممکن است با null مطابقت داشته باشند.

برمی گرداند
	نقشه شناسه های اندروید، شناسه های کاربر منطبق را پیدا کرد.

پرتاب می کند
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید.

پارامترها
`packageName`	`String`

برمی گرداند
`PackageInfo`	`PackageInfo` یا در صورتی که اطلاعات قابل بازیابی نباشد، `null`

پرتاب می کند
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید.

برمی گرداند
	`ERROR(/List)` `PackageInfo` های نصب شده روی دستگاه.

پرتاب می کند
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

گزارش اشکال را از دستگاه بازیابی می کند.

اجرای این برای ادامه کار بر روی دستگاهی بدون sdcard (یا جایی که sdcard هنوز نصب نشده است) تضمین شده است.

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` که محتویات گزارش اشکال را در صورت تقاضا تولید می کند. در صورت خرابی، `InputStreamSource` یک `ERROR(/InputStream)` خالی تولید می کند.

getBugreportz

public InputStreamSource getBugreportz ()

یک bugreportz را از دستگاه بازیابی می کند. اشکال گزارش فرمت زیپ حاوی گزارش اشکال اصلی و سایر فایل‌های گزارش است که برای اشکال‌زدایی مفید هستند.

فقط برای «نسخه adb» > 1.0.36 پشتیبانی می شود

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از فایل فشرده حاوی bugreportz، در صورت خرابی، null را برگردانید.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

برمی گرداند
`DeviceFoldableState`

پرتاب می کند
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

شناسه کاربر فعلی را برگردانید. در صورت بروز خطا 10000- را برگردانید.

برمی گرداند
`int`

پرتاب می کند
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

لیست حالت های تاشو را در دستگاه برمی گرداند. می توان با "cmd device_state print-states" به دست آورد.

برمی گرداند

پرتاب می کند
`DeviceNotAvailableException`

getInstalledPackageNames

public  getInstalledPackageNames ()

نام بسته های برنامه موجود در دستگاه را واکشی کنید.

برمی گرداند
	`ERROR(/Set)` نام‌های بسته `String` که در حال حاضر روی دستگاه نصب شده‌اند.

پرتاب می کند
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید.

برمی گرداند
`KeyguardControllerState`	یک `KeyguardControllerState` که حاوی یک عکس فوری از وضعیت نگهدارنده کلید است و در صورت عدم پشتیبانی از پرس و جوی Keyguard، Null را برمی گرداند.

پرتاب می کند
`DeviceNotAvailableException`

getMainUserId

public Integer getMainUserId ()

شناسه اصلی کاربر را برمی گرداند.

برمی گرداند
`Integer`	شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد null.

پرتاب می کند
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید.

برمی گرداند
	`ERROR(/Set)` ماژول های خط اصلی `String` که در حال حاضر روی دستگاه نصب شده اند.

پرتاب می کند
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید. پیش فرض 0 است.

برمی گرداند
`int`	یک عدد صحیح که تعداد کاربرانی که به طور همزمان در حال اجرا هستند را نشان می دهد

پرتاب می کند
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. پیش فرض 0 است.

برمی گرداند
`int`	یک عدد صحیح که تعداد کاربران پشتیبانی شده را نشان می دهد

پرتاب می کند
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

شناسه کاربر اصلی را برمی گرداند.

برمی گرداند
`Integer`	شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد، null.

پرتاب می کند
`DeviceNotAvailableException`

دریافت اسکرین شات

public InputStreamSource getScreenshot ()

یک اسکرین شات از دستگاه می گیرد.

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از اسکرین شات با فرمت png یا در صورت عدم موفقیت اسکرین شات `null` .

پرتاب می کند
`DeviceNotAvailableException`

دریافت اسکرین شات

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

یک اسکرین شات از دستگاه می گیرد. توصیه می شود به جای آن از getScreenshot(String) با رمزگذاری JPEG برای اندازه کوچکتر استفاده کنید.

پارامترها
`format`	`String` : پشتیبانی از PNG، JPEG
`rescale`	`boolean` : اگر اسکرین شات باید تغییر مقیاس داده شود تا اندازه تصویر حاصل کاهش یابد

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات `null` .

پرتاب می کند
`DeviceNotAvailableException`

دریافت اسکرین شات

public InputStreamSource getScreenshot (long displayId)

یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. فرمت PNG است.

TODO: پیاده سازی های بالا را برای پشتیبانی از "قالب" و "مقیاس مجدد" گسترش دهید

پارامترها
`displayId`	`long` : شناسه نمایش صفحه برای گرفتن اسکرین شات از آن.

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات `null` .

پرتاب می کند
`DeviceNotAvailableException`

دریافت اسکرین شات

public InputStreamSource getScreenshot (String format)

یک اسکرین شات از دستگاه می گیرد. توصیه می شود برای اندازه کوچکتر از getScreenshot (فرمت) به جای کدگذاری JPEG استفاده کنید

پارامترها
`format`	`String` : پشتیبانی از PNG، JPEG

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات `null` .

پرتاب می کند
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

getSetting(int, String, String) ببینید و روی کاربر سیستم انجام شود.

پارامترها
`namespace`	`String`
`key`	`String`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

مقدار تنظیمات درخواستی را برگردانید. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}

پارامترها
`userId`	`int`
`namespace`	`String`
`key`	`String`

برمی گرداند
`String`	مقدار مربوط به فضای نام: کلید یک کاربر. اگر پیدا نشد، پوچ است.

پرتاب می کند
`DeviceNotAvailableException`

getUninstalablePackageNames

public  getUninstallablePackageNames ()

نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید. این در حال حاضر به عنوان بسته های غیر سیستمی و بسته های سیستمی به روز شده تعریف می شود.

برمی گرداند
	`ERROR(/Set)` نام‌های بسته `String` غیرقابل نصب که در حال حاضر روی دستگاه نصب شده‌اند.

پرتاب می کند
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

پرچم های یک کاربر معین را پیدا کرده و برگردانید. پرچم‌ها در کلاس «android.content.pm.UserInfo» در پروژه منبع باز Android تعریف شده‌اند.

پارامترها
`userId`	`int`

برمی گرداند
`int`	پرچم های مرتبط با userId ارائه شده در صورت یافتن، -10000 در هر مورد دیگر.

پرتاب می کند
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

نقشه useId به UserInfo را در دستگاه دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException پرتاب می کند.

برمی گرداند
	لیست اشیاء UserInfo

پرتاب می کند
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید.

پارامترها
`userId`	`int`

برمی گرداند
`int`

پرتاب می کند
`DeviceNotAvailableException`

دارای ویژگی

public boolean hasFeature (String feature)

بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر.

پارامترها
`feature`	`String` : کدام فرمت باید «feature: "یا" "مستقیم.

برمی گرداند
`boolean`	اگر ویژگی پیدا شود درست است، در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

بسته اندروید را روی دستگاه نصب کنید.

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`reinstall`	`boolean` : `true` اگر نصب مجدد انجام شود
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

بسته اندروید را روی دستگاه نصب کنید.

توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`reinstall`	`boolean` : `true` اگر نصب مجدد انجام شود
`grantPermissions`	`boolean` : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                String... extraArgs)

بسته اندروید را روی دستگاه نصب کنید.

توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`certFile`	`File` : `true` اگر نصب مجدد انجام شود
`reinstall`	`boolean` : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.

توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`reinstall`	`boolean` : `true` اگر نصب مجدد انجام شود
`grantPermissions`	`boolean` : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند
`userId`	`int` : شناسه کاربری عدد صحیح برای نصب.
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`reinstall`	`boolean` : `true` اگر نصب مجدد انجام شود
`userId`	`int` : شناسه کاربری عدد صحیح برای نصب.
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

پارامترها
`packageFiles`
`reinstall`	`boolean`
`extraArgs`	`String`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

پارامترها
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

پارامترها
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

پارامترها
`packageFiles`
`reinstall`	`boolean`
`userId`	`int`
`extraArgs`	`String`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

RemotePackages را نصب کنید

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

پارامترها
`remoteApkPaths`
`reinstall`	`boolean`
`extraArgs`	`String`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

RemotePackages را نصب کنید

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

پارامترها
`remoteApkPaths`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

بررسی کنید که آیا پلتفرم روی دستگاه از شمارش برنامه پشتیبانی می‌کند یا خیر

برمی گرداند
`boolean`	اگر شمارش برنامه پشتیبانی شود درست است، در غیر این صورت نادرست است

پرتاب می کند
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

تعیین می کند که آیا چند کاربر پشتیبانی می شود یا خیر.

برمی گرداند
`boolean`	درست است اگر چند کاربر پشتیبانی می شود، نادرست در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

isPackageInstalled است

public boolean isPackageInstalled (String packageName)

دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.

پارامترها
`packageName`	`String`

برمی گرداند
`boolean`	درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isPackageInstalled است

public boolean isPackageInstalled (String packageName, 
                String userId)

دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.

پارامترها
`packageName`	`String` : بسته ای که ما در حال بررسی آن هستیم که آیا نصب شده است.
`userId`	`String` : شناسه کاربری که بسته را بررسی می کنیم برای آن نصب شده است. اگر null باشد، از کاربر اصلی صفر استفاده می شود.

برمی گرداند
`boolean`	درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isUserRunning

public boolean isUserRunning (int userId)

بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر.

پارامترها
`userId`	`int`

برمی گرداند
`boolean`	اگر کاربر در حال اجرا باشد درست است، در سایر موارد نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر.

پارامترها
`userId`	`int`

برمی گرداند
`boolean`	درست است اگر کاربر ثانویه باشد، در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر.

کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت ها را راه اندازی کند (معمولاً در صفحه نمایش پیش فرض).

پارامترها
`userId`	`int`

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر.

کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت های خود را در آن نمایشگر راه اندازی کند.

پارامترها
`userId`	`int`
`displayId`	`int`

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

نشان می‌دهد که آیا دستگاه به کاربران اجازه می‌دهد در پس‌زمینه در ERROR(/java.android.view.Display#DEFAULT_DISPLAY) قابل مشاهده باشند یا خیر.

اگر اینطور است، می‌توانید startVisibleBackgroundUser(int, int, boolean) را فراخوانی کنید و نمایشگری را ارسال کنید که توسط listDisplayIdsForStartingVisibleBackgroundUsers() (که باید شامل ERROR(/java.android.view.Display#DEFAULT_DISPLAY) باشد).

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر.

اگر اینطور است، می توانید startVisibleBackgroundUser(int, int, boolean) فراخوانی کنید و نمایشگری را که توسط listDisplayIdsForStartingVisibleBackgroundUsers() برگردانده شده است، ارسال کنید.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید.

برمی گرداند
	لیست نمایشگرها پیش فرض همیشه نمایشگر پیش فرض 0 را برمی گرداند.

پرتاب می کند
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

لیستی از نمایشگرهایی را دریافت می کند که می توانند برای start a user visible in the background استفاده شوند.

برمی گرداند

پرتاب می کند
`DeviceNotAvailableException`

لیست کاربران

public  listUsers ()

لیست کاربران دستگاه را دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException پرتاب می کند.

برمی گرداند
	لیست شناسه های کاربر

پرتاب می کند
`DeviceNotAvailableException`

گزارش logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران.

پارامترها
`dataName`	`String` : نامی که گزارش اشکال تحت آن گزارش می شود.
`listener`	`ITestLogger` : یک `ITestLogger` برای ثبت گزارش اشکال.

برمی گرداند
`boolean`	اگر ثبت با موفقیت انجام شد درست است، در غیر این صورت نادرست است.

اطلاع رسانی به اسناپوسرد

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

پارامترها
`waitPhase`	`SnapuserdWaitPhase`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

مراحل اضافی برای پاکسازی مورد نیاز خاص دستگاه که پس از انجام فراخوانی اجرا می شود.

پارامترها
`exception`	`Throwable` : در صورت وجود، آخرین استثنا ناشی از شکست فراخوانی.

حذف ادمین

public boolean removeAdmin (String componentName, 
                int userId)

ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود true برگردانید، در غیر این صورت false .

پارامترها
`componentName`	`String` : مدیر دستگاه که باید حذف شود.
`userId`	`int` : کاربری که سرپرست دستگاه در آن زندگی می کند.

برمی گرداند
`boolean`	اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست.

پرتاب می کند
`DeviceNotAvailableException`

حذف مالکان

public void removeOwners ()

همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید.

پرتاب می کند
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

یک کاربر معین را از دستگاه حذف کنید.

پارامترها
`userId`	`int` : کاربر برای حذف

برمی گرداند
`boolean`	درست است اگر در حذف کاربر موفق بودیم، در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید.

پارامترها
`componentName`	`String` : مدیر دستگاه که مالک دستگاه باشد.
`userId`	`int` : کاربری که صاحب دستگاه در آن زندگی می کند.

برمی گرداند
`boolean`	اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست.

پرتاب می کند
`DeviceNotAvailableException`

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

به setSetting(int, String, String, String) مراجعه کنید و در کاربر سیستم انجام شد.

پارامترها
`namespace`	`String`
`key`	`String`
`value`	`String`

پرتاب می کند
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید. برخی از تنظیمات فقط پس از راه اندازی مجدد در دسترس خواهند بود. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}

پارامترها
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

پرتاب می کند
`DeviceNotAvailableException`

خاموش کردن میکرودروید

public void shutdownMicrodroid (ITestDevice microdroidDevice)

در صورت وجود، دستگاه میکرودروئید را خاموش می کند.

پارامترها
`microdroidDevice`	`ITestDevice`

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند. اگر کاربر قبلاً در پس‌زمینه اجرا می‌شود، این روش یک NOOP است.

پارامترها
`userId`	`int` : کاربر برای شروع در پس زمینه

برمی گرداند
`boolean`	درست است اگر کاربر با موفقیت در پس‌زمینه راه‌اندازی شده باشد.

پرتاب می کند
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند. اگر کاربر قبلاً در پس‌زمینه اجرا می‌شود، این روش یک NOOP است. امکان ارائه پرچم اضافی برای منتظر ماندن برای تأثیرگذاری عملیات.

پارامترها
`userId`	`int` : کاربر برای شروع در پس زمینه
`waitFlag`	`boolean` : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند.

برمی گرداند
`boolean`	درست است اگر کاربر با موفقیت در پس‌زمینه راه‌اندازی شده باشد.

پرتاب می کند
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

کاربر مشخصی را در پس‌زمینه شروع می‌کند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه می‌دهد فعالیت‌ها را در آن نمایشگر راه‌اندازی کند).

توجه: این دستور بررسی نمی کند که آیا کاربر وجود دارد، نمایشگر موجود است، device supports such feature و غیره.

پارامترها
`userId`	`int` : کاربر برای شروع در پس زمینه
`displayId`	`int` : نمایش برای شروع قابل مشاهده کاربر
`waitFlag`	`boolean` : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند.

برمی گرداند
`boolean`	`true` اگر کاربر با موفقیت شروع به کار کرده باشد در پس زمینه قابل مشاهده است.

پرتاب می کند
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

یک کاربر معین را متوقف کنید. امکان ارائه پرچم‌های اضافی برای منتظر ماندن برای تأثیرگذاری عملیات و خاتمه اجباری کاربر. کاربر فعلی و سیستم را نمی توان متوقف کرد.

پارامترها
`userId`	`int` : کاربر برای توقف.
`waitFlag`	`boolean` : فرمان را منتظر می ماند تا کاربر متوقف شود.
`forceFlag`	`boolean` : کاربر را مجبور به توقف می کند.

برمی گرداند
`boolean`	درست است اگر کاربر با موفقیت متوقف شود.

پرتاب می کند
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

یک کاربر معین را متوقف می کند. اگر کاربر قبلا متوقف شده باشد، این روش یک NOOP است. کاربر فعلی و سیستم را نمی توان متوقف کرد.

پارامترها
`userId`	`int` : کاربر برای توقف.

برمی گرداند
`boolean`	درست است اگر کاربر با موفقیت متوقف شود.

پرتاب می کند
`DeviceNotAvailableException`

از میکرودروید پشتیبانی می کند

public boolean supportsMicrodroid ()

پیش‌شرط‌های اجرای microdroid را بررسی می‌کند.

برمی گرداند
`boolean`	اگر پیش‌شرط‌ها برآورده شوند true و در غیر این صورت false برمی‌گرداند.

از میکرودروید پشتیبانی می کند

public boolean supportsMicrodroid (boolean protectedVm)

پیش‌شرط‌های اجرای microdroid را بررسی می‌کند.

پارامترها
`protectedVm`	`boolean` : درست است اگر microdroid برای اجرا در VM محافظت شده در نظر گرفته شده باشد.

برمی گرداند
`boolean`	اگر پیش‌شرط‌ها برآورده شوند true و در غیر این صورت false برمی‌گرداند.

switchUser

public boolean switchUser (int userId)

به userId دیگری با مهلت زمانی پیش‌فرض تغییر وضعیت دهید. switchUser(int, long) .

پارامترها
`userId`	`int`

برمی گرداند
`boolean`	اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید. پس از موفقیت آمیز بودن تغییر کاربر، محافظ صفحه کلید را غیرفعال کنید.

پارامترها
`userId`	`int`
`timeout`	`long` : منتظر ماندن قبل از بازگشت false برای سوئیچ کاربر ناموفق بود.

برمی گرداند
`boolean`	اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

یک Bugreport بگیرید و آن را در یک شی Bugreport برمی گرداند تا آن را مدیریت کند. در صورت مشکل، باطل برگردانید. فایل ارجاع شده در شی Bugreport باید از طریق Bugreport.close() پاک شود.

برمی گرداند
`Bugreport`

UninstallPackage

public String uninstallPackage (String packageName)

یک بسته Android را از دستگاه حذف نصب کنید.

پارامترها
`packageName`	`String` : بسته Android برای حذف نصب

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید.

پارامترها
`packageName`	`String` : بسته Android برای حذف نصب
`userId`	`int` : شناسه کاربری عدد صحیح برای حذف نصب.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

منتظر اسناپوسرد باشید

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

پارامترها
`currentPhase`	`SnapuserdWaitPhase`

پرتاب می کند
`DeviceNotAvailableException`

روش های محافظت شده

createParser

protected AaptParser createParser (File appFile)

پارامترها
`appFile`	`File`

برمی گرداند
`AaptParser`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

یک راه اندازی مجدد adb انجام دهید.

پارامترها
`rebootMode`	`NativeDevice.RebootMode` : حالتی از این راه‌اندازی مجدد.
`reason`	`String` : برای این راه اندازی مجدد.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

برمی گرداند
`InputStreamSource`

getBugreportzInternal

protected File getBugreportzInternal ()

روش Internal Helper برای دریافت فایل zip bugreportz به صورت ERROR(/File) .

برمی گرداند
`File`

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

در معرض آزمایش قرار گرفته است.

برمی گرداند
`long`

getHostCurrentTime

protected long getHostCurrentTime ()

در معرض آزمایش قرار گرفته است

برمی گرداند
`long`

prePostBootSetup

protected void prePostBootSetup ()

به هر نوع دستگاه (AndroidNativeDevice، TestDevice) اجازه می‌دهد این روش را برای راه‌اندازی خاص پس از بوت لغو کند.

پرتاب می کند
`DeviceNotAvailableException`

TestDevice

خلاصه

کلاس های تو در تو

فیلدها

سازندگان عمومی

روش های عمومی

روش های محافظت شده

فیلدها

DISMISS_KEYGUARD_CMD

سازندگان عمومی

TestDevice

روش های عمومی

canSwitchToHeadlessSystemUser

clearErrorDialogs

createUser

createUser

createUser

createUserNoThrow

غیرفعال کردن کیگارد

doesFileExist

doesFileExist

dumpHeap

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getPrimaryUserId

دریافت اسکرین شات

دریافت اسکرین شات

دریافت اسکرین شات

دریافت اسکرین شات

getSetting

getSetting

getUninstalablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

دارای ویژگی

installPackage

installPackage

installPackage

installPackageForUser

installPackageForUser

installPackages

installPackages

installPackagesForUser

installPackagesForUser

RemotePackages را نصب کنید

RemotePackages را نصب کنید

isAppEnumerationSupported

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserSupported

isPackageInstalled است

isPackageInstalled است

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

listDisplayIds

listDisplayIdsForStartingVisibleBackgroundUsers

لیست کاربران

گزارش logBugreport

اطلاع رسانی به اسناپوسرد

postInvocationTearDown