دستگاه تست IT

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

زیرکلاس‌های غیرمستقیم شناخته‌شده IManagedTestDevice ، LocalAndroidVirtualDevice ، ManagedRemoteDevice ، NativeDevice ، NestedRemoteDevice ، RemoteAndroidDevice ، RemoteAndroidVirtualDevice ، TestDevice دستگاه تست مدیریت‌شده یک دستگاه تست فناوری اطلاعات که چرخه حیات آن مدیریت می‌شود. دستگاه مجازی اندروید محلی کلاس مربوط به دستگاه‌های مجازی محلی که روی میزبان TradeFed اجرا می‌شوند. دستگاه از راه دور مدیریت‌شده دستگاهی که درون یک ماشین مجازی اجرا می‌شود و ما آن را از راه دور و از طریق یک نمونه Tradefed درون ماشین مجازی مدیریت می‌کنیم. دستگاه بومی پیاده‌سازی پیش‌فرض یک ITestDevice دستگاه‌های اندرویدی غیر فول‌استک. NestedRemoteDevice نمایش دستگاهی که درون یک ماشین مجازی Cuttlefish از راه دور در حال اجرا است. دستگاه اندروید از راه دور پیاده‌سازی یک ITestDevice برای یک دستگاه اندرویدی فول‌استک متصل از طریق adb connect. دستگاه مجازی اندروید از راه دور رفتار RemoteAndroidDevice را برای یک دستگاه اندرویدی فول‌استک که در موتور محاسباتی گوگل (Gce) اجرا می‌شود، گسترش می‌دهد. دستگاه تست پیاده‌سازی یک ITestDevice برای یک دستگاه اندرویدی فول‌استک

---

یک API سطح بالا و قابل اعتماد برای IDevice مربوط به ddmlib ارائه می‌دهد.

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

خلاصه

کلاس‌های تو در تو
class	ITestDevice.ApexInfo یک کلاس struct ساده برای ذخیره اطلاعات مربوط به یک APEX واحد
class	ITestDevice.MountPointInfo یک کلاس struct ساده برای ذخیره اطلاعات مربوط به یک mountpoint واحد

روش‌های عمومی
abstract boolean	canSwitchToHeadlessSystemUser () برمی‌گرداند که آیا مجاز به تغییر به کاربر headless SYSTEM است یا خیر.
abstract boolean	checkConnectivity () بررسی کنید که دستگاه به شبکه متصل باشد.
abstract boolean	clearErrorDialogs () تلاش برای رد کردن هرگونه دیالوگ خطایی که در حال حاضر در رابط کاربری دستگاه نمایش داده می‌شود.
abstract void	clearLastConnectedWifiNetwork () آخرین شبکه وای فای متصل را پاک می‌کند.
abstract boolean	connectToWifiNetwork ( wifiSsidToPsk) به شبکه وای فای متصل می‌شود.
abstract boolean	connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) به شبکه وای فای متصل می‌شود.
abstract boolean	connectToWifiNetwork (String wifiSsid, String wifiPsk) به شبکه وای فای متصل می‌شود.
abstract boolean	connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) به شبکه وای فای متصل می‌شود.
abstract boolean	connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) نوعی از connectToWifiNetwork(String, String) که فقط در صورتی متصل می‌شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
abstract boolean	connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) نوعی از connectToWifiNetwork(String, String) که فقط در صورتی متصل می‌شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
abstract int	createUser (String name) یک کاربر با نام مشخص و پرچم‌های پیش‌فرض ۰ ایجاد کنید.
abstract int	createUser (String name, boolean guest, boolean ephemeral) یک کاربر با نام مشخص و پرچم‌های ارائه شده ایجاد کنید
abstract int	createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) یک کاربر با نام مشخص و پرچم‌های ارائه شده ایجاد کنید
abstract int	createUserNoThrow (String name) یک کاربر با نام مشخص و پرچم‌های پیش‌فرض ۰ ایجاد کنید.
abstract void	deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) IDeviceActionReceiver ثبت شده را حذف می‌کند.
abstract void	disableKeyguard () تلاش برای غیرفعال کردن محافظ کلید.
abstract boolean	disableNetworkMonitor () نظارت بر شبکه را روی دستگاه غیرفعال می‌کند.
abstract boolean	disconnectFromWifi () از شبکه وای فای قطع می‌شود.
abstract boolean	doesFileExist (String deviceFilePath, int userId) متد کمکی برای تعیین اینکه آیا فایلی روی دستگاه برای یک کاربر مشخص وجود دارد یا خیر.
abstract File	dumpHeap (String process, String devicePath) تلاش برای تخلیه هیپ از system_server.
abstract boolean	enableNetworkMonitor () نظارت بر شبکه را روی دستگاه فعال می‌کند.
abstract	getActiveApexes () اطلاعات مربوط به APEX های فعال شده روی دستگاه را دریافت کنید.
abstract	getAllSettings (String namespace) جفت‌های کلید-مقدار از فضای نام درخواستی را برمی‌گرداند.
abstract String	getAndroidId (int userId) android-id مربوط به یک userId را پیدا کرده و برمی‌گرداند، در صورت عدم یافتن، null.
abstract	getAndroidIds () ایجاد نقشه‌ای از شناسه‌های اندروید یافت‌شده که با شناسه‌های کاربری مطابقت دارند.
abstract PackageInfo	getAppPackageInfo (String packageName) دریافت اطلاعات مربوط به بسته نصب شده روی دستگاه.
abstract	getAppPackageInfos () اطلاعات بسته‌های نصب‌شده روی دستگاه را دریافت می‌کند.
abstract InputStreamSource	getBugreport () گزارش اشکال (bugreport) را از دستگاه بازیابی می‌کند.
abstract InputStreamSource	getBugreportz () یک گزارش اشکال (bugreportz) را از دستگاه دریافت می‌کند.
abstract DeviceFoldableState	getCurrentFoldableState () وضعیت فعلی دستگاه با قابلیت تا شدن را برمی‌گرداند یا در صورت بروز هرگونه مشکل، مقدار null را برمی‌گرداند.
abstract int	getCurrentUser () شناسه (id) کاربر در حال اجرای فعلی را برمی‌گرداند.
abstract	getFoldableStates () لیست حالت‌های تا شدن روی دستگاه را برمی‌گرداند.
abstract	getInstalledPackageNames () نام بسته‌های برنامه‌های موجود در دستگاه را دریافت کنید.
abstract String	getIpAddress () آدرس IP دستگاه را دریافت می‌کند.
abstract KeyguardControllerState	getKeyguardState () یک شیء برای دریافت وضعیت فعلی محافظ کلید یا در صورت عدم پشتیبانی، null را برمی‌گرداند.
abstract Integer	getMainUserId () شناسه اصلی کاربر را برمی‌گرداند.
abstract	getMainlineModuleInfo () اطلاعات مربوط به ماژول‌های اصلی نصب شده روی دستگاه را دریافت کنید.
abstract int	getMaxNumberOfRunningUsersSupported () حداکثر تعداد کاربرانی که همزمان اجرا می‌شوند و پشتیبانی می‌شوند را بدست آورید.
abstract int	getMaxNumberOfUsersSupported () حداکثر تعداد کاربران پشتیبانی شده را بدست آورید.
abstract TestDeviceOptions	getOptions () گزینه‌های تست دستگاه را دریافت کنید.
abstract Integer	getPrimaryUserId () این متد منسوخ شده است. getPrimaryUser از سرویس UserManager منسوخ شده است، برای دریافت اولین کاربر کامل ERROR(/android.os.UserManager#getMainUserId()) یا برای سیستم از 0 استفاده کنید. توجه داشته باشید که برای سیستم بدون سر، این یک کاربر کامل نیست.
abstract InputStreamSource	getScreenshot (String format, boolean rescale) از دستگاه اسکرین شات می‌گیرد.
abstract InputStreamSource	getScreenshot (long displayId) با توجه به شناسه نمایشگر (display id)، از دستگاه اسکرین‌شات می‌گیرد.
abstract InputStreamSource	getScreenshot (String format) از دستگاه اسکرین شات می‌گیرد.
abstract InputStreamSource	getScreenshot () از دستگاه اسکرین شات می‌گیرد.
abstract String	getSetting (int userId, String namespace, String key) مقدار تنظیم درخواستی را برمی‌گرداند.
abstract String	getSetting (String namespace, String key) getSetting(int, String, String) ببینید و روی کاربر سیستم اجرا کنید.
abstract	getUninstallablePackageNames () نام بسته‌های برنامه‌هایی که می‌توان آن‌ها را حذف نصب کرد، دریافت کنید.
abstract int	getUserFlags (int userId) پرچم‌های یک کاربر مشخص را پیدا کرده و برمی‌گرداند.
abstract	getUserInfos () نگاشت useId به UserInfo روی دستگاه را دریافت می‌کند.
abstract int	getUserSerialNumber (int userId) در صورت یافتن، شماره سریال مربوط به userId را برمی‌گرداند، و در غیر این صورت -۱۰۰۰۰ را برمی‌گرداند.
abstract boolean	hasFeature (String feature) بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر.
abstract String	installPackage (File packageFile, boolean reinstall, String... extraArgs) نصب یک بسته اندروید روی دستگاه
abstract String	installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) نصب یک بسته اندروید روی دستگاه
abstract String	installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) نصب یک بسته اندروید روی دستگاه برای یک کاربر مشخص.
abstract String	installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) نصب یک بسته اندروید روی دستگاه برای یک کاربر مشخص.
abstract boolean	installPackageWithIncrementalMode (File[] apkFiles, String[] extraArgs, String userId) فایل‌های apk را با حالت افزایشی نصب می‌کند.
default String	installPackages ( packageFiles, boolean reinstall, String... extraArgs) یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و دیگری فایل‌های جداگانه) را نصب کنید.
default String	installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) یک برنامه اندروید که از چندین فایل APK (یک فایل اصلی و یک فایل اضافی) که روی دستگاه اندروید قرار دارند، ساخته شده است را نصب کنید.
default String	installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) یک برنامه اندروید متشکل از چندین فایل APK (یک بسته اصلی و یک بسته اضافی) را برای یک کاربر مشخص نصب کنید.
default String	installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) یک برنامه اندروید متشکل از چندین فایل APK (یک بسته اصلی و یک بسته اضافی) را برای یک کاربر مشخص نصب کنید.
default String	installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) یک برنامه اندروید که از چندین فایل APK (یک فایل اصلی و یک فایل اضافی) که روی دستگاه اندروید قرار دارند، ساخته شده است را نصب کنید.
default String	installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) یک برنامه اندروید که از چندین فایل APK (یک فایل اصلی و یک فایل اضافی) که روی دستگاه اندروید قرار دارند، ساخته شده است را نصب کنید.
abstract boolean	isHeadlessSystemUserMode () برمی‌گرداند که آیا دستگاه از حالت کاربر سیستم بدون سر (headless system user mode) استفاده می‌کند یا خیر.
abstract boolean	isMainUserPermanentAdmin () برمی‌گرداند که آیا کاربر اصلی یک مدیر دائمی است و نمی‌توان او را حذف کرد یا به وضعیت غیرمدیر تنزل داد یا خیر.
abstract boolean	isMultiUserSupported () تعیین می‌کند که آیا از چند کاربر پشتیبانی می‌شود یا خیر.
abstract boolean	isPackageInstalled (String packageName, String userId) نام بسته و شناسه کاربری داده شده را از دستگاه پرس‌وجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.
abstract boolean	isPackageInstalled (String packageName) نام بسته‌ی داده شده را از دستگاه پرس‌وجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.
abstract boolean	isUserRunning (int userId) بررسی کنید که آیا یک کاربر خاص در حال اجرا است یا خیر.
abstract boolean	isUserSecondary (int userId) بر اساس پرچم‌های (flags) کاربر مشخص شده، مشخص می‌کند که آیا او یک کاربر ثانویه است یا خیر.
abstract boolean	isUserVisible (int userId) بررسی می‌کند که آیا کاربر داده شده قابل مشاهده است یا خیر.
abstract boolean	isUserVisibleOnDisplay (int userId, int displayId) بررسی می‌کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر.
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported () این تابع نشان می‌دهد که آیا دستگاه به کاربران اجازه می‌دهد تا در پس‌زمینه و در قالب ERROR(/java.android.view.Display#DEFAULT_DISPLAY) اجرا شوند یا خیر.
abstract boolean	isVisibleBackgroundUsersSupported () برمی‌گرداند که آیا دستگاه به کاربران اجازه می‌دهد تا در پس‌زمینه قابل مشاهده باشند یا خیر.
abstract boolean	isWifiEnabled () بررسی کنید که آیا وای فای فعال است یا خیر.
abstract	listDisplayIds () فهرست شناسه نمایشگرهای موجود روی دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع‌آوری کنید.
abstract	listDisplayIdsForStartingVisibleBackgroundUsers () فهرست نمایشگرهایی را که می‌توانند برای start a user visible in the background استفاده شوند، دریافت می‌کند.
abstract	listUsers () لیست کاربران روی دستگاه را دریافت می‌کند.
abstract boolean	logBugreport (String dataName, ITestLogger listener) متد کمکی برای دریافت گزارش اشکال و ثبت آن برای گزارشگران.
default void	notifySnapuserd ( SnapuserdWaitPhase waitPhase) به دستگاه اطلاع دهید تا منتظر تکمیل snapuserd بماند.
abstract void	registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) یک IDeviceActionReceiver برای این دستگاه ثبت می‌کند.
abstract boolean	removeAdmin (String componentName, int userId) مدیر دستگاه داده شده را در کاربر داده شده حذف کنید و در صورت موفقیت آمیز بودن، true و در غیر این صورت false را برگردانید.
abstract void	removeOwners () با تمام تلاش، تمام مالکان پروفایل‌های دستگاه موجود را حذف کنید.
abstract boolean	removeUser (int userId) کاربر مورد نظر را از دستگاه حذف کنید.
abstract boolean	setDeviceOwner (String componentName, int userId) یک جزء مدیر دستگاه را به عنوان مالک دستگاه در کاربر داده شده تنظیم کنید.
abstract void	setSetting (String namespace, String key, String value) به setSetting(int, String, String, String) مراجعه کنید و آن را روی کاربر سیستم اجرا کنید.
abstract void	setSetting (int userId, String namespace, String key, String value) یک مقدار تنظیمی به فضای نام یک کاربر مشخص اضافه می‌کند.
abstract boolean	startUser (int userId) اگر کاربر مورد نظر در حال حاضر متوقف باشد، آن را در پس‌زمینه اجرا می‌کند.
abstract boolean	startUser (int userId, boolean waitFlag) اگر کاربر مورد نظر در حال حاضر متوقف باشد، آن را در پس‌زمینه اجرا می‌کند.
abstract boolean	startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) یک کاربر مشخص را در پس‌زمینه، قابل مشاهده در نمایشگر مشخص، اجرا می‌کند (یعنی به کاربر اجازه می‌دهد فعالیت‌هایی را در آن نمایشگر اجرا کند).
abstract boolean	stopUser (int userId) یک کاربر مشخص را متوقف می‌کند.
abstract boolean	stopUser (int userId, boolean waitFlag, boolean forceFlag) یک کاربر خاص را متوقف کنید.
abstract boolean	switchUser (int userId) به یک شناسه کاربری دیگر با زمان انقضای پیش‌فرض تغییر دهید.
abstract boolean	switchUser (int userId, long timeout) با مهلت زمانی ارائه شده به عنوان مهلت، به شناسه کاربری دیگری بروید.
abstract Bugreport	takeBugreport () یک bugreport را می‌گیرد و آن را درون یک شیء Bugreport برمی‌گرداند تا آن را مدیریت کند.
abstract String	uninstallPackage (String packageName) حذف نصب یک بسته اندروید از دستگاه.
abstract String	uninstallPackageForUser (String packageName, int userId) یک بسته اندروید را از دستگاه یک کاربر خاص حذف نصب کنید.
default void	waitForSnapuserd ( SnapuserdWaitPhase currentPhase) اگر انتظار می‌رود، منتظر بمانید تا snapuserd کامل شود.

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

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

اتصال را بررسی کنید

public abstract boolean checkConnectivity ()

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

آخرین اتصالشبکه وای‌فای

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

به شبکه وای فای متصل می‌شود.

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

پارامترها
wifiSsidToPsk	: نقشه‌ای از SSID های وای فای به رمزهای عبور.

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

به شبکه وای فای متصل می‌شود.

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

پارامترها
wifiSsidToPsk	: نقشه‌ای از SSID های وای فای به رمزهای عبور.
scanSsid	boolean : آیا SSID های مخفی برای این شبکه اسکن شوند یا خیر.

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

به شبکه وای فای متصل می‌شود.

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

پارامترها
wifiSsid	String : شناسه شبکه وای‌فای (ssid) که قرار است به آن متصل شوید
wifiPsk	String : عبارت عبور PSK یا در صورت رمزگذاری نشدن، null

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

به شبکه وای فای متصل می‌شود.

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

پارامترها
wifiSsid	String : شناسه شبکه وای‌فای (ssid) که قرار است به آن متصل شوید
wifiPsk	String : عبارت عبور PSK یا در صورت رمزگذاری نشدن، null
scanSsid	boolean : آیا SSID مخفی برای این شبکه اسکن شود یا خیر.

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

نوعی از connectToWifiNetwork(String, String) که فقط در صورتی متصل می‌شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.

پارامترها
scanSsid	boolean : آیا SSID مخفی برای این شبکه اسکن شود یا خیر

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

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

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

نوعی از connectToWifiNetwork(String, String) که فقط در صورتی متصل می‌شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.

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

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

ایجادکاربر

public abstract int createUser (String name)

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

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

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

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

ایجادکاربر

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

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

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

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

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

ایجادکاربر

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

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

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

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

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

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

public abstract int createUserNoThrow (String name)

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

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

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

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

لغو ثبت نام دستگاه اقدام گیرنده

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

IDeviceActionReceiver ثبت شده را حذف می‌کند.

پارامترها
deviceActionReceiver	IDeviceActionReceiver : یک IDeviceActionReceiver که حذف خواهد شد.

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

public abstract void disableKeyguard ()

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

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

پرتاب‌ها
DeviceNotAvailableException

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

public abstract boolean disableNetworkMonitor ()

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

قطع ارتباط از وای‌فای

public abstract boolean disconnectFromWifi ()

از شبکه وای فای قطع می‌شود.

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

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

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

دامپ هیپ

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

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

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

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

public abstract boolean enableNetworkMonitor ()

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

بازگشت‌ها
boolean	اگر مانیتورینگ با موفقیت فعال شود، true اگر ناموفق باشد false برمی‌گرداند.

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

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

public abstract  getActiveApexes ()

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

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

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

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

public abstract  getAllSettings (String namespace)

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

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

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

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

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

public abstract String getAndroidId (int userId)

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

پارامترها
userId	int

بازگشت‌ها
String

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

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

public abstract  getAndroidIds ()

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

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

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

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

public abstract PackageInfo getAppPackageInfo (String packageName)

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

پارامترها
packageName	String

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

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

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

public abstract  getAppPackageInfos ()

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

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

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

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

public abstract InputStreamSource getBugreport ()

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

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

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

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

public abstract InputStreamSource getBugreportz ()

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

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

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

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

public abstract DeviceFoldableState getCurrentFoldableState ()

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

بازگشت‌ها
DeviceFoldableState

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

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

public abstract int getCurrentUser ()

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

بازگشت‌ها
int

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

getFoldableStates

public abstract  getFoldableStates ()

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

بازگشت‌ها

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

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

public abstract  getInstalledPackageNames ()

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

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

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

آدرس آی‌پی را دریافت کنید

public abstract String getIpAddress ()

آدرس IP دستگاه را دریافت می‌کند.

بازگشت‌ها
String	آدرس IP دستگاه، یا اگر دستگاه آدرس IP نداشته باشد، null

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

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

public abstract KeyguardControllerState getKeyguardState ()

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

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

public abstract Integer getMainUserId ()

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

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

پرتاب‌ها
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	اگر خروجی دستگاه مطابق انتظار نباشد.
DeviceNotAvailableException

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

public abstract  getMainlineModuleInfo ()

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

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

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

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

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

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

public abstract int getMaxNumberOfUsersSupported ()

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

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

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

گزینه‌ها را دریافت کنید

public abstract TestDeviceOptions getOptions ()

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

بازگشت‌ها
TestDeviceOptions	TestDeviceOptions مربوط به دستگاه تحت آزمایش.

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

public abstract Integer getPrimaryUserId ()

این روش منسوخ شده است.
getPrimaryUser از سرویس UserManager منسوخ شده است، برای دریافت اولین کاربر کامل از ERROR(/android.os.UserManager#getMainUserId()) یا برای سیستم از 0 استفاده کنید. توجه داشته باشید که برای سیستم بدون سر، این یک کاربر کامل نیست.

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

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

پرتاب‌ها
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	اگر خروجی دستگاه مطابق انتظار نباشد.
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

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

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

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

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

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

public abstract InputStreamSource getScreenshot (String format)

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

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

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

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

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

public abstract InputStreamSource getScreenshot ()

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

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

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

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

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

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

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

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

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

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

public abstract String getSetting (String namespace, 
                String key)

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

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

بازگشت‌ها
String

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

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

public abstract  getUninstallablePackageNames ()

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

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

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

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

public abstract int getUserFlags (int userId)

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

پارامترها
userId	int

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

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

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

public abstract  getUserInfos ()

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

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

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

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

public abstract int getUserSerialNumber (int userId)

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

پارامترها
userId	int

بازگشت‌ها
int

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

دارایویژگی

public abstract boolean hasFeature (String feature)

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

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

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

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

نصب بسته

public abstract 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 abstract 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	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.
UnsupportedOperationException	اگر مجوز زمان اجرا توسط پلتفرم روی دستگاه پشتیبانی نشود.

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

public abstract 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 abstract 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	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.
UnsupportedOperationException	اگر مجوز زمان اجرا توسط پلتفرم روی دستگاه پشتیبانی نشود.

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

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

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

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

بازگشت‌ها
boolean

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

نصب بسته‌ها

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

یک برنامه اندروید که از چندین فایل APK (یک فایل اصلی و یک فایل اضافی تقسیم شده) ساخته شده است را نصب کنید. برای نحوه تقسیم فایل apk به چندین فایل، به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.
UnsupportedOperationException	اگر مجوز زمان اجرا توسط پلتفرم روی دستگاه پشتیبانی نشود.

نصب بسته‌ها

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

یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و یک بسته اضافی) که روی دستگاه اندروید قرار دارند را نصب کنید. برای نحوه تقسیم فایل apk به چندین فایل، به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.

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

پارامترها
packageFiles	: مسیرهای فایل apk از راه دور برای نصب
reinstall	boolean : اگر نصب مجدد لازم باشد، true
grantPermissions	boolean : اگر قرار باشد تمام مجوزهای زمان اجرا در زمان نصب اعطا شوند.
extraArgs	String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm -h' مراجعه کنید.

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.
UnsupportedOperationException	اگر مجوز زمان اجرا توسط پلتفرم روی دستگاه پشتیبانی نشود.

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

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

یک برنامه اندروید متشکل از چندین فایل APK (یک بسته اصلی و یک بسته اضافی) را برای یک کاربر مشخص نصب کنید. برای نحوه تقسیم فایل apk به چندین فایل، به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.
UnsupportedOperationException	اگر مجوز زمان اجرا توسط پلتفرم روی دستگاه پشتیبانی نشود.

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

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

یک برنامه اندروید متشکل از چندین فایل APK (یک بسته اصلی و یک بسته اضافی) را برای یک کاربر مشخص نصب کنید. برای نحوه تقسیم فایل apk به چندین فایل، به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.

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

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.
UnsupportedOperationException	اگر مجوز زمان اجرا توسط پلتفرم روی دستگاه پشتیبانی نشود.

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

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

یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و یک بسته اضافی) که روی دستگاه اندروید قرار دارند را نصب کنید. برای نحوه تقسیم فایل apk به چندین فایل، به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.
UnsupportedOperationException	اگر مجوز زمان اجرا توسط پلتفرم روی دستگاه پشتیبانی نشود.

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

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

یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و یک بسته اضافی) که روی دستگاه اندروید قرار دارند را نصب کنید. برای نحوه تقسیم فایل apk به چندین فایل، به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.

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

پارامترها
remoteApkPaths	: مسیرهای فایل apk از راه دور
reinstall	boolean : اگر نصب مجدد لازم باشد، true
grantPermissions	boolean : اگر قرار باشد تمام مجوزهای زمان اجرا در زمان نصب اعطا شوند.
extraArgs	String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm -h' مراجعه کنید.

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.
UnsupportedOperationException	اگر مجوز زمان اجرا توسط پلتفرم روی دستگاه پشتیبانی نشود.

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

public abstract boolean isHeadlessSystemUserMode ()

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

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

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

public abstract boolean isMultiUserSupported ()

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

پارامترها
packageName	String

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

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

isUserRunning

public abstract boolean isUserRunning (int userId)

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

پارامترها
userId	int

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

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

پارامترها
userId	int

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

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

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

public abstract boolean isUserVisible (int userId)

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

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

پارامترها
userId	int

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

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

public abstract 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 abstract boolean isVisibleBackgroundUsersSupported ()

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

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

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

فعال بودن وای‌فای

public abstract boolean isWifiEnabled ()

بررسی کنید که آیا وای فای فعال است یا خیر.

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

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

public abstract  listDisplayIds ()

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

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

بازگشت‌ها

پرتاب‌ها
DeviceNotAvailableException

لیست کاربران

public abstract  listUsers ()

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

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

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

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

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

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

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

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

به دستگاه اطلاع دهید تا منتظر تکمیل snapuserd بماند.

پارامترها
waitPhase	SnapuserdWaitPhase

گیرنده‌ی اقدام دستگاه را ثبت کنید

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

یک IDeviceActionReceiver برای این دستگاه ثبت می‌کند.

قبل از شروع و پس از پایان عملیات دستگاه، به تمام IDeviceActionReceiver ثبت شده اطلاع داده خواهد شد.

پارامترها
deviceActionReceiver	IDeviceActionReceiver : یک IDeviceActionReceiver که ثبت خواهد شد.

حذف ادمین

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

حذف مالکان

public abstract void removeOwners ()

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

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

حذف کاربر

public abstract boolean removeUser (int userId)

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

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

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

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

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

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

تنظیم

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

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

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

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

تنظیم

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

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

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

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

کاربر شروع

public abstract boolean startUser (int userId)

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

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

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

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

کاربر شروع

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

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

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

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

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

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

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

پرتاب‌ها
DeviceNotAvailableException

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

public abstract boolean stopUser (int userId)

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

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

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

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

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

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

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

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

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

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

کاربر سوئیچ

public abstract boolean switchUser (int userId)

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

پارامترها
userId	int

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

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

کاربر سوئیچ

public abstract boolean switchUser (int userId, 
                long timeout)

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

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

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

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

تیک بوگرپورت

public abstract Bugreport takeBugreport ()

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

بازگشت‌ها
Bugreport

حذف نصب بسته

public abstract String uninstallPackage (String packageName)

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

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

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

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

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

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

اگر انتظار می‌رود، منتظر بمانید تا snapuserd کامل شود.

پارامترها
currentPhase	SnapuserdWaitPhase

پرتاب‌ها
DeviceNotAvailableException