از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.

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

دستگاه تست

public class TestDevice
extends NativeDevice

شیء جاوا
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice

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

دستگاه راه دور مدیریت‌شده ، دستگاه راه دور تودرتو ، دستگاه اندروید راه دور

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

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

LocalAndroidVirtualDevice ، RemoteAndroidVirtualDevice

دستگاه مجازی اندروید محلی	کلاس مربوط به دستگاه‌های مجازی محلی که روی میزبان TradeFed اجرا می‌شوند.
دستگاه مجازی اندروید از راه دور	رفتار `RemoteAndroidDevice` را برای یک دستگاه اندرویدی فول‌استک که در موتور محاسباتی گوگل (Gce) اجرا می‌شود، گسترش می‌دهد.

پیاده‌سازی یک ITestDevice برای یک دستگاه اندرویدی فول‌استک

خلاصه

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

ثابت‌ها
`String`	`DISMISS_KEYGUARD_CMD` دستوراتی که می‌توانند برای غیرفعال کردن محافظ کلید استفاده شوند.

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

روش‌های عمومی
`boolean`	`canSwitchToHeadlessSystemUser ()` برمی‌گرداند که آیا مجاز به تغییر به کاربر headless SYSTEM است یا خیر.
`boolean`	`clearErrorDialogs ()` تلاش برای رد کردن هرگونه دیالوگ خطایی که در حال حاضر در رابط کاربری دستگاه نمایش داده می‌شود.
`int`	`createUser (String name)` یک کاربر با نام مشخص و پرچم‌های پیش‌فرض ۰ ایجاد کنید.
`int`	`createUser (String name, boolean guest, boolean ephemeral)` یک کاربر با نام مشخص و پرچم‌های ارائه شده ایجاد کنید
`int`	`createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)` یک کاربر با نام مشخص و پرچم‌های ارائه شده ایجاد کنید
`int`	`createUserNoThrow (String name)` یک کاربر با نام مشخص و پرچم‌های پیش‌فرض ۰ ایجاد کنید.
`void`	`disableKeyguard ()` تلاش برای غیرفعال کردن محافظ کلید.
`boolean`	`doesFileExist (String deviceFilePath, int userId)` متد کمکی برای تعیین اینکه آیا فایلی روی دستگاه برای یک کاربر مشخص وجود دارد یا خیر.
`boolean`	`doesFileExist (String deviceFilePath)` متد کمکی برای تشخیص وجود فایل روی دستگاه.
`File`	`dumpHeap (String process, String devicePath)` تلاش برای تخلیه هیپ از system_server.
	`getActiveApexes ()` اطلاعات مربوط به APEX های فعال شده روی دستگاه را دریافت کنید.
	`getAllSettings (String namespace)` جفت‌های کلید-مقدار از فضای نام درخواستی را برمی‌گرداند.
`String`	`getAndroidId (int userId)` android-id مربوط به یک userId را پیدا کرده و برمی‌گرداند، در صورت عدم یافتن، null.
	`getAndroidIds ()` ایجاد نقشه‌ای از شناسه‌های اندروید یافت‌شده که با شناسه‌های کاربری مطابقت دارند.
`PackageInfo`	`getAppPackageInfo (String packageName)` دریافت اطلاعات مربوط به بسته نصب شده روی دستگاه.
	`getAppPackageInfos ()` اطلاعات بسته‌های نصب‌شده روی دستگاه را دریافت می‌کند.
`InputStreamSource`	`getBugreport ()` گزارش اشکال (bugreport) را از دستگاه بازیابی می‌کند.
`InputStreamSource`	`getBugreportz ()` یک گزارش اشکال (bugreportz) را از دستگاه دریافت می‌کند.
`DeviceFoldableState`	`getCurrentFoldableState ()` وضعیت فعلی دستگاه با قابلیت تا شدن را برمی‌گرداند یا در صورت بروز هرگونه مشکل، مقدار null را برمی‌گرداند.
`int`	`getCurrentUser ()` شناسه (id) کاربر در حال اجرای فعلی را برمی‌گرداند.
	`getFoldableStates ()` لیست حالت‌های تا شدن روی دستگاه را برمی‌گرداند.
	`getInstalledPackageNames ()` نام بسته‌های برنامه‌های موجود در دستگاه را دریافت کنید.
`KeyguardControllerState`	`getKeyguardState ()` یک شیء برای دریافت وضعیت فعلی محافظ کلید یا در صورت عدم پشتیبانی، null را برمی‌گرداند.
`Integer`	`getMainUserId ()` شناسه اصلی کاربر را برمی‌گرداند.
	`getMainlineModuleInfo ()` اطلاعات مربوط به ماژول‌های اصلی نصب شده روی دستگاه را دریافت کنید.
`int`	`getMaxNumberOfRunningUsersSupported ()` حداکثر تعداد کاربرانی که همزمان اجرا می‌شوند و پشتیبانی می‌شوند را بدست آورید.
`int`	`getMaxNumberOfUsersSupported ()` حداکثر تعداد کاربران پشتیبانی شده را بدست آورید.
`Integer`	`getPrimaryUserId ()` شناسه کاربر اصلی را برمی‌گرداند.
`InputStreamSource`	`getScreenshot (String format, boolean rescale)` از دستگاه اسکرین شات می‌گیرد.
`InputStreamSource`	`getScreenshot (long displayId)` با توجه به شناسه نمایشگر (display id)، از دستگاه اسکرین‌شات می‌گیرد.
`InputStreamSource`	`getScreenshot (String format)` از دستگاه اسکرین شات می‌گیرد.
`InputStreamSource`	`getScreenshot ()` از دستگاه اسکرین شات می‌گیرد.
`String`	`getSetting (int userId, String namespace, String key)` مقدار تنظیم درخواستی را برمی‌گرداند.
`String`	`getSetting (String namespace, String key)` `getSetting(int, String, String)` ببینید و روی کاربر سیستم اجرا کنید.
	`getUninstallablePackageNames ()` نام بسته‌های برنامه‌هایی که می‌توان آن‌ها را حذف نصب کرد، دریافت کنید.
`int`	`getUserFlags (int userId)` پرچم‌های یک کاربر مشخص را پیدا کرده و برمی‌گرداند.
	`getUserInfos ()` نگاشت useId به `UserInfo` روی دستگاه را دریافت می‌کند.
`int`	`getUserSerialNumber (int userId)` در صورت یافتن، شماره سریال مربوط به userId را برمی‌گرداند، و در غیر این صورت -۱۰۰۰۰ را برمی‌گرداند.
`boolean`	`hasFeature (String feature)` بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر.
`String`	`installPackage (File packageFile, boolean reinstall, String... extraArgs)` نصب یک بسته اندروید روی دستگاه
`String`	`installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs)` نصب یک بسته اندروید روی دستگاه
`String`	`installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` نصب یک بسته اندروید روی دستگاه
`String`	`installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)` نصب یک بسته اندروید روی دستگاه برای یک کاربر مشخص.
`String`	`installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` نصب یک بسته اندروید روی دستگاه برای یک کاربر مشخص.
`boolean`	`installPackageWithIncrementalMode (File[] apkFiles, String[] extraArgs, String userId)` فایل‌های apk را با حالت افزایشی نصب می‌کند.
`String`	`installPackages ( packageFiles, boolean reinstall, String... extraArgs)`
`String`	`installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)`
`String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`boolean`	`isAppEnumerationSupported ()` بررسی کنید که آیا پلتفرم روی دستگاه از شمارش برنامه پشتیبانی می‌کند یا خیر
`boolean`	`isHeadlessSystemUserMode ()` برمی‌گرداند که آیا دستگاه از حالت کاربر سیستم بدون سر (headless system user mode) استفاده می‌کند یا خیر.
`boolean`	`isMainUserPermanentAdmin ()` برمی‌گرداند که آیا کاربر اصلی یک مدیر دائمی است و نمی‌توان او را حذف کرد یا به وضعیت غیرمدیر تنزل داد یا خیر.
`boolean`	`isMultiUserSupported ()` تعیین می‌کند که آیا از چند کاربر پشتیبانی می‌شود یا خیر.
`boolean`	`isPackageInstalled (String packageName, String userId)` نام بسته و شناسه کاربری داده شده را از دستگاه پرس‌وجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.
`boolean`	`isPackageInstalled (String packageName)` نام بسته‌ی داده شده را از دستگاه پرس‌وجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.
`boolean`	`isUserRunning (int userId)` بررسی کنید که آیا یک کاربر خاص در حال اجرا است یا خیر.
`boolean`	`isUserSecondary (int userId)` بر اساس پرچم‌های (flags) کاربر مشخص شده، مشخص می‌کند که آیا او یک کاربر ثانویه است یا خیر.
`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`	`stopUser (int userId, boolean waitFlag, boolean forceFlag)` یک کاربر خاص را متوقف کنید.
`boolean`	`supportsMicrodroid ()` پیش‌شرط‌های لازم برای اجرای یک میکرودروید را بررسی می‌کند.
`boolean`	`supportsMicrodroid (boolean protectedVm)` پیش‌شرط‌های لازم برای اجرای یک میکرودروید را بررسی می‌کند.
`boolean`	`switchUser (int userId)` به یک شناسه کاربری دیگر با زمان انقضای پیش‌فرض تغییر دهید.
`boolean`	`switchUser (int userId, long timeout)` با مهلت زمانی ارائه شده به عنوان مهلت، به شناسه کاربری دیگری بروید.
`Bugreport`	`takeBugreport ()` یک bugreport را می‌گیرد و آن را درون یک شیء `Bugreport` برمی‌گرداند تا آن را مدیریت کند.
`String`	`uninstallPackage (String packageName)` حذف نصب یک بسته اندروید از دستگاه.
`String`	`uninstallPackageForUser (String packageName, int userId)` یک بسته اندروید را از دستگاه یک کاربر خاص حذف نصب کنید.
`void`	`waitForSnapuserd ( SnapuserdWaitPhase currentPhase)`

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

ثابت‌ها

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

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

مقدار ثابت: "ورودی رویداد کلید ۸۲"

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

دستگاه تست

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

روش‌های عمومی

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

بازگشت‌ها
`boolean`

پرتاب‌ها
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

تلاش برای رد کردن هرگونه دیالوگ خطایی که در حال حاضر در رابط کاربری دستگاه نمایش داده می‌شود.

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

پرتاب‌ها
`DeviceNotAvailableException`

ایجادکاربر

public int createUser (String name)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

ایجادکاربر

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

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

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

بازگشت‌ها
`int`	شناسه کاربر ایجاد شده

پرتاب‌ها
`DeviceNotAvailableException`

ایجادکاربر

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

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

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

بازگشت‌ها
`int`	شناسه کاربر ایجاد شده

پرتاب‌ها
`DeviceNotAvailableException`

ایجادکاربربدون پرتاب

public int createUserNoThrow (String name)

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

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

بازگشت‌ها
`int`	عدد صحیح برای شناسه کاربری ایجاد شده یا -۱ برای خطا.

پرتاب‌ها
`DeviceNotAvailableException`

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

public void disableKeyguard ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

آیافایل‌موجود است؟

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

آیافایل‌موجود است؟

public boolean doesFileExist (String deviceFilePath)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

دامپ هیپ

public File dumpHeap (String process, 
                String devicePath)

تلاش برای حذف هیپ از system_server. این مسئولیت فراخواننده است که فایل حذف شده را پاک کند.

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

بازگشت‌ها
`File`	`ERROR(/File)` حاوی گزارش. اگر چیزی با شکست مواجه شد، null.

پرتاب‌ها
`DeviceNotAvailableException`

فعال‌سازی آپکس‌ها

public  getActiveApexes ()

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

بازگشت‌ها
	`ERROR(/Set)` مربوط به `ApexInfo` که در حال حاضر روی دستگاه فعال است.

پرتاب‌ها
`DeviceNotAvailableException`

دریافت همه تنظیمات

public  getAllSettings (String namespace)

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

پارامترها
`namespace`	`String` : باید یکی از {"سیستم"، "امن"، "جهانی"} باشد

بازگشت‌ها
	نقشه جفت‌های کلید-مقدار. اگر فضای نام پشتیبانی نشود، تهی (null) می‌شود.

پرتاب‌ها
`DeviceNotAvailableException`

دریافت اندروید آیدی

public String getAndroidId (int userId)

android-id مربوط به یک userId را پیدا کرده و برمی‌گرداند، در صورت عدم یافتن، null.

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

بازگشت‌ها
`String`

پرتاب‌ها
`DeviceNotAvailableException`

دریافت اندروید آیدز

public  getAndroidIds ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

اطلاعات بسته‌ی برنامه را دریافت کنید

public PackageInfo getAppPackageInfo (String packageName)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

اطلاعات بسته‌ی برنامه (getAppPackageInfos)

public  getAppPackageInfos ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

دریافت گزارش باگرپورت

public InputStreamSource getBugreport ()

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

اجرای این امر تضمین می‌کند که روی دستگاهی بدون کارت حافظه (یا جایی که کارت حافظه هنوز نصب نشده است) به کار خود ادامه دهد.

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

دریافت بوگرپورت

public InputStreamSource getBugreportz ()

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

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

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

دریافت وضعیت فعلی تاشو

public DeviceFoldableState getCurrentFoldableState ()

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

بازگشت‌ها
`DeviceFoldableState`

پرتاب‌ها
`DeviceNotAvailableException`

دریافت کاربر فعلی

public int getCurrentUser ()

شناسه کاربر فعلی در حال اجرا را برمی‌گرداند. در صورت خطا، ‎-10000‎ را برمی‌گرداند.

بازگشت‌ها
`int`

پرتاب‌ها
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

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

بازگشت‌ها

پرتاب‌ها
`DeviceNotAvailableException`

دریافت نام‌های بسته‌های نصب‌شده

public  getInstalledPackageNames ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

دریافت کی‌گارد‌استیت

public KeyguardControllerState getKeyguardState ()

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

بازگشت‌ها
`KeyguardControllerState`	یک `KeyguardControllerState` که شامل یک snapshot از وضعیت keyguard است و در صورتی که کوئری Keyguard پشتیبانی نشود، مقدار Null را برمی‌گرداند.

پرتاب‌ها
`DeviceNotAvailableException`

دریافت شناسه اصلی کاربر

public Integer getMainUserId ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

دریافت اطلاعات ماژول خط اصلی

public  getMainlineModuleInfo ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersپشتیبانی‌شده

public int getMaxNumberOfRunningUsersSupported ()

حداکثر تعداد کاربرانی که همزمان اجرا می‌شوند را دریافت کنید. مقدار پیش‌فرض ۰ است.

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

پرتاب‌ها
`DeviceNotAvailableException`

دریافت حداکثر تعداد کاربران پشتیبانی شده

public int getMaxNumberOfUsersSupported ()

حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. مقدار پیش‌فرض ۰ است.

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

پرتاب‌ها
`DeviceNotAvailableException`

دریافت شناسه کاربری اولیه

public Integer getPrimaryUserId ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

بازگشت‌ها
`InputStreamSource`	یک `InputStreamSource` از تصویر گرفته شده در قالب format، یا `null` در صورتی که تصویر گرفته شده موفقیت‌آمیز نبود.

پرتاب‌ها
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot (long displayId)

با توجه به شناسه نمایشگر دستگاه، از آن اسکرین‌شات می‌گیرد. فرمت آن PNG است.

TODO: پیاده‌سازی‌های بالا را برای پشتیبانی از «قالب‌بندی» و «تغییر مقیاس» گسترش دهید

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

بازگشت‌ها
`InputStreamSource`	یک `InputStreamSource` از تصویر گرفته شده در قالب format، یا `null` در صورتی که تصویر گرفته شده موفقیت‌آمیز نبود.

پرتاب‌ها
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot (String format)

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

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

بازگشت‌ها
`InputStreamSource`	یک `InputStreamSource` از تصویر گرفته شده در قالب format، یا `null` در صورتی که تصویر گرفته شده موفقیت‌آمیز نبود.

پرتاب‌ها
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot ()

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

بازگشت‌ها
`InputStreamSource`	یک `InputStreamSource` از تصویر گرفته شده با فرمت png، یا اگر تصویر گرفته شده موفقیت‌آمیز نبود، `null` .

پرتاب‌ها
`DeviceNotAvailableException`

تنظیمات دریافت

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

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

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

بازگشت‌ها
`String`	مقداری که به namespace:key یک کاربر مرتبط شده است. در صورت عدم یافتن، null برمی‌گرداند.

پرتاب‌ها
`DeviceNotAvailableException`

تنظیمات دریافت

public String getSetting (String namespace, 
                String key)

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

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

بازگشت‌ها
`String`

پرتاب‌ها
`DeviceNotAvailableException`

دریافت نام‌های بسته‌های غیرقابل نصب

public  getUninstallablePackageNames ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

پرچم‌های کاربر را دریافت کنید

public int getUserFlags (int userId)

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

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

بازگشت‌ها
`int`	پرچم‌های مرتبط با شناسه کاربری ارائه شده در صورت یافتن، و در موارد دیگر -۱۰۰۰۰.

پرتاب‌ها
`DeviceNotAvailableException`

دریافت اطلاعات کاربر

public  getUserInfos ()

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

بازگشت‌ها
	لیست اشیاء UserInfo.

پرتاب‌ها
`DeviceNotAvailableException`

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

public int getUserSerialNumber (int userId)

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

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

بازگشت‌ها
`int`

پرتاب‌ها
`DeviceNotAvailableException`

دارایویژگی

public boolean hasFeature (String feature)

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

پارامترها
`feature`	`String` : کدام قالب باید "feature:" باشد؟ «یا» «مستقیماً.

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

پرتاب‌ها
`DeviceNotAvailableException`

نصب بسته

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`

نصب بسته

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`

نصب بسته

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`

نصب بسته برای کاربر

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`

نصب بسته برای کاربر

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`

نصب بسته با حالت افزایشی

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

فایل‌های apk را با حالت افزایشی نصب می‌کند.

پارامترها
`apkFiles`	`File` : فایل‌های apk برای نصب.
`extraArgs`	`String`
`userId`	`String`

بازگشت‌ها
`boolean`

پرتاب‌ها
`DeviceNotAvailableException`

نصب بسته‌ها

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

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

بازگشت‌ها
`String`

پرتاب‌ها
`DeviceNotAvailableException`

نصب بسته‌ها

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

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

بازگشت‌ها
`String`

پرتاب‌ها
`DeviceNotAvailableException`

نصب بسته‌ها برای کاربر

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

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

بازگشت‌ها
`String`

پرتاب‌ها
`DeviceNotAvailableException`

نصب بسته‌ها برای کاربر

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

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

بازگشت‌ها
`String`

پرتاب‌ها
`DeviceNotAvailableException`

نصب بسته‌های از راه دور

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

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

بازگشت‌ها
`String`

پرتاب‌ها
`DeviceNotAvailableException`

نصب بسته‌های از راه دور

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

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

بازگشت‌ها
`String`

پرتاب‌ها
`DeviceNotAvailableException`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

بازگشت‌ها
`boolean`	اگر شمارش برنامه پشتیبانی شود، مقدار true و در غیر این صورت false است.

پرتاب‌ها
`DeviceNotAvailableException`

حالت کاربر بدون سر (isHeadlessSystemUserMode)

public boolean isHeadlessSystemUserMode ()

برمی‌گرداند که آیا دستگاه از حالت کاربر سیستم بدون سر (headless system user mode) استفاده می‌کند یا خیر.

بازگشت‌ها
`boolean`

پرتاب‌ها
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

بازگشت‌ها
`boolean`

پرتاب‌ها
`DeviceNotAvailableException`

پشتیبانی از چندکاربره

public boolean isMultiUserSupported ()

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

بازگشت‌ها
`boolean`	اگر چند کاربره پشتیبانی شود، درست و در غیر این صورت نادرست است.

پرتاب‌ها
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

isUserRunning

public boolean isUserRunning (int userId)

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

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

بازگشت‌ها
`boolean`	اگر کاربر در حال اجرا باشد، مقدار درست (true) و در سایر موارد مقدار نادرست (false) است.

پرتاب‌ها
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

بر اساس پرچم‌های (flags) کاربر مشخص شده، مشخص می‌کند که آیا او یک کاربر ثانویه است یا خیر.

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

بازگشت‌ها
`boolean`	اگر کاربر فرعی باشد، مقدار true و در غیر این صورت false است.

پرتاب‌ها
`DeviceNotAvailableException`

کاربر قابل مشاهده است

public boolean isUserVisible (int userId)

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

کاربر «قابل مشاهده» کاربری است که با کاربر «انسانی» در تعامل است و از این رو قادر به راه‌اندازی فعالیت‌های راه‌اندازی (معمولاً در نمایش پیش‌فرض) است.

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

بازگشت‌ها
`boolean`

پرتاب‌ها
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

کاربر «قابل مشاهده» کاربری است که با کاربر «انسانی» در تعامل است و از این رو می‌تواند فعالیت‌های راه‌اندازی را در آن صفحه نمایش انجام دهد.

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

بازگشت‌ها
`boolean`

پرتاب‌ها
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplayپشتیبانی می‌شود

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`

لیست شناسه‌های نمایش

public  listDisplayIds ()

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

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

پرتاب‌ها
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

بازگشت‌ها

پرتاب‌ها
`DeviceNotAvailableException`

لیست کاربران

public  listUsers ()

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

بازگشت‌ها
	فهرست شناسه‌های کاربری.

پرتاب‌ها
`DeviceNotAvailableException`

گزارش لاگ بوگرپورت

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

بازگشت‌ها
`boolean`	اگر ثبت وقایع موفقیت‌آمیز باشد، مقدار True و در غیر این صورت مقدار False برمی‌گرداند.

اطلاع‌رسانی کنید

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`

حذف کاربر

public boolean removeUser (int userId)

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

پارامترها
`userId`	`int` : نام کاربری که قرار است حذف شود

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

پرتاب‌ها
`DeviceNotAvailableException`

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

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

setFirstBootloaderراه‌اندازی مجدد

public void setFirstBootloaderReboot ()

تنظیم

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

تنظیم

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

یک مقدار تنظیمی به فضای نام یک کاربر مشخص اضافه کنید. برخی از تنظیمات فقط پس از راه‌اندازی مجدد در دسترس خواهند بود. فضای نام باید یکی از موارد زیر باشد: {"سیستم"، "امن"، "جهانی"}

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

پرتاب‌ها
`DeviceNotAvailableException`

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

public void shutdownMicrodroid (ITestDevice microdroidDevice)

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

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

پرتاب‌ها
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

کاربر شروع

public boolean startUser (int userId)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

کاربر شروع

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

کاربر پس‌زمینه‌ی قابل مشاهده‌ی شروع

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

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

توجه: این دستور بررسی نمی‌کند که آیا کاربر وجود دارد، صفحه نمایش در دسترس است، device supports such feature یا خیر، و غیره.

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

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

پرتاب‌ها
`DeviceNotAvailableException`

کاربر را متوقف کنید

public boolean stopUser (int userId)

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

پارامترها
`userId`	`int` :‎‏ از کاربر مورد نظر برای متوقف کردن.

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

پرتاب‌ها
`DeviceNotAvailableException`

کاربر را متوقف کنید

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

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

پارامترها
`userId`	`int` :‎‏ از کاربر مورد نظر برای متوقف کردن.
`waitFlag`	`boolean` : باعث می‌شود دستور تا زمان توقف کاربر منتظر بماند.
`forceFlag`	`boolean` : کاربر را مجبور به توقف اجباری می‌کند.

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

پرتاب‌ها
`DeviceNotAvailableException`

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

public boolean supportsMicrodroid ()

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

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

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

public boolean supportsMicrodroid (boolean protectedVm)

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

پارامترها
`protectedVm`	`boolean` : اگر قرار است microdroid روی ماشین مجازی محافظت‌شده اجرا شود، مقدار true را برمی‌گرداند.

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

کاربر سوئیچ

public boolean switchUser (int userId)

به یک userId دیگر با timeout پیش‌فرض سوئیچ کن. switchUser(int, long) .

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

بازگشت‌ها
`boolean`	اگر شناسه‌ی کاربر جدید با ارائه‌دهنده‌ی شناسه‌ی کاربر مطابقت داشته باشد، مقدار درست (true) و در غیر این صورت مقدار نادرست (false) خواهد بود.

پرتاب‌ها
`DeviceNotAvailableException`

کاربر سوئیچ

public boolean switchUser (int userId, 
                long timeout)

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

پارامترها
`userId`	`int`
`timeout`	`long` : برای انتظار قبل از برگرداندن مقدار false در صورت ناموفق بودن switch-user.

بازگشت‌ها
`boolean`	اگر شناسه‌ی کاربر جدید با ارائه‌دهنده‌ی شناسه‌ی کاربر مطابقت داشته باشد، مقدار درست (true) و در غیر این صورت مقدار نادرست (false) خواهد بود.

پرتاب‌ها
`DeviceNotAvailableException`

تیک بوگرپورت

public Bugreport takeBugreport ()

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

بازگشت‌ها
`Bugreport`

حذف نصب بسته

public String uninstallPackage (String packageName)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

حذف نصب بسته برای کاربر

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

پرتاب‌ها
`DeviceNotAvailableException`

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

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

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

پرتاب‌ها
`DeviceNotAvailableException`

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

ایجاد پارسر

protected AaptParser createParser (File appFile)

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

بازگشت‌ها
`AaptParser`

انجام راه اندازی مجدد Adb

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

یک بار adb را ریبوت کنید.

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

پرتاب‌ها
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

دریافت گزارش داخلی

protected InputStreamSource getBugreportInternal ()

بازگشت‌ها
`InputStreamSource`

getBugreportz داخلی

protected File getBugreportzInternal ()

متد کمکی داخلی برای دریافت فایل زیپ bugreportz به عنوان یک ERROR(/File) .

بازگشت‌ها
`File`

دریافتبررسیکاربرجدیدخواب

protected long getCheckNewUserSleep ()

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

بازگشت‌ها
`long`

دریافت زمان فعلی میزبان

protected long getHostCurrentTime ()

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

بازگشت‌ها
`long`

تنظیمات پیش از بوت

protected void prePostBootSetup ()

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

پرتاب‌ها
`DeviceNotAvailableException`

دستگاه تست

خلاصه

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

ثابت‌ها

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

روش‌های عمومی

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

ثابت‌ها

DISMISS_KEYGUARD_CMD

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

دستگاه تست

روش‌های عمومی

canSwitchToHeadlessSystemUser

clearErrorDialogs

ایجادکاربر

ایجادکاربر

ایجادکاربر

ایجادکاربربدون پرتاب

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

آیافایل‌موجود است؟

آیافایل‌موجود است؟

دامپ هیپ

فعال‌سازی آپکس‌ها

دریافت همه تنظیمات

دریافت اندروید آیدی

دریافت اندروید آیدز

اطلاعات بسته‌ی برنامه را دریافت کنید

اطلاعات بسته‌ی برنامه (getAppPackageInfos)

دریافت گزارش باگرپورت

دریافت بوگرپورت

دریافت وضعیت فعلی تاشو

دریافت کاربر فعلی

getFoldableStates

دریافت نام‌های بسته‌های نصب‌شده

دریافت کی‌گارد‌استیت

دریافت شناسه اصلی کاربر

دریافت اطلاعات ماژول خط اصلی

getMaxNumberOfRunningUsersپشتیبانی‌شده

دریافت حداکثر تعداد کاربران پشتیبانی شده

دریافت شناسه کاربری اولیه

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

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

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

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

تنظیمات دریافت

تنظیمات دریافت

دریافت نام‌های بسته‌های غیرقابل نصب

پرچم‌های کاربر را دریافت کنید

دریافت اطلاعات کاربر

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

دارایویژگی

نصب بسته

نصب بسته

نصب بسته

نصب بسته برای کاربر

نصب بسته برای کاربر

نصب بسته با حالت افزایشی

نصب بسته‌ها

نصب بسته‌ها

نصب بسته‌ها برای کاربر

نصب بسته‌ها برای کاربر

نصب بسته‌های از راه دور

نصب بسته‌های از راه دور

isAppEnumerationSupported

حالت کاربر بدون سر (isHeadlessSystemUserMode)

isMainUserPermanentAdmin

پشتیبانی از چندکاربره

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

کاربر قابل مشاهده است

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplayپشتیبانی می‌شود

isVisibleBackgroundUsersSupported

لیست شناسه‌های نمایش

listDisplayIdsForStartingVisibleBackgroundUsers

لیست کاربران

گزارش لاگ بوگرپورت

اطلاع‌رسانی کنید