ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

---

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

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

خلاصه

کلاس های تو در تو
class	ITestDevice.ApexInfo یک کلاس ساختاری ساده برای ذخیره اطلاعات در مورد یک APEX
class	ITestDevice.MountPointInfo یک کلاس ساختاری ساده برای ذخیره اطلاعات در مورد یک نقطه نصب

روش های عمومی
abstract boolean	canSwitchToHeadlessSystemUser () برمی‌گرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.
abstract boolean	checkConnectivity () بررسی کنید که دستگاه اتصال شبکه دارد.
abstract boolean	clearErrorDialogs () سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.
abstract void	clearLastConnectedWifiNetwork () آخرین شبکه وای فای متصل را پاک می کند.
abstract boolean	connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) به شبکه وای فای متصل می شود.
abstract boolean	connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) 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) یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
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) یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
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 مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null.
abstract	getAndroidIds () یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید.
abstract PackageInfo	getAppPackageInfo (String packageName) اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید.
abstract	getAppPackageInfos () اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید.
abstract InputStreamSource	getBugreport () گزارش اشکال را از دستگاه بازیابی می کند.
abstract InputStreamSource	getBugreportz () یک bugreportz را از دستگاه بازیابی می کند.
abstract DeviceFoldableState	getCurrentFoldableState () وضعیت تاشو فعلی دستگاه را برمی‌گرداند یا در صورت بروز برخی مشکلات، آن را خالی می‌کند.
abstract int	getCurrentUser () شناسه کاربر فعلی را برگردانید.
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 () شناسه کاربر اصلی را برمی گرداند.
abstract InputStreamSource	getScreenshot (String format, boolean rescale) یک اسکرین شات از دستگاه می گیرد.
abstract InputStreamSource	getScreenshot (long displayId) یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد.
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، در هر مورد دیگر -10000 را برگردانید.
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) یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.
default String	installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) را نصب کنید.
default String	installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید.
default String	installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) برای یک کاربر خاص نصب کنید.
default String	installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) برای یک کاربر خاص نصب کنید.
default String	installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید.
default String	installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید.
abstract boolean	isHeadlessSystemUserMode () نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر.
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) آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر.
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) به userId دیگری با مهلت زمانی پیش‌فرض تغییر وضعیت دهید.
abstract boolean	switchUser (int userId, long timeout) به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید.
abstract Bugreport	takeBugreport () یک Bugreport بگیرید و آن را در یک شی Bugreport برمی گرداند تا آن را مدیریت کند.
abstract String	uninstallPackage (String packageName) یک بسته Android را از دستگاه حذف نصب کنید.
abstract String	uninstallPackageForUser (String packageName, int userId) یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید.
default void	waitForSnapuserd ( SnapuserdWaitPhase currentPhase) اگر انتظار می رود، صبر کنید تا snapuserd کامل شود.

روش های عمومی

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

بررسی اتصال

public abstract boolean checkConnectivity ()

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

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

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

اتصال به شبکه Wifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

پارامترها
wifiSsidToPsk	: نقشه ای از SSID وای فای به گذرواژه ها.

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

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

اتصال به شبکه Wifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

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

اتصال به شبکه Wifi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

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

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

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

اتصال به شبکه Wifi

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

createUser

public abstract int createUser (String name)

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

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

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

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

createUser

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

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

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

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

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

createUser

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

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

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

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

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

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

لغو ثبت DeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

public abstract void disableKeyguard ()

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

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

پرتاب می کند
DeviceNotAvailableException

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

public abstract boolean disableNetworkMonitor ()

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

برمی گرداند
boolean	اگر نظارت با موفقیت غیرفعال شود true . false اگر شکست خورد

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

قطع اتصال از وای فای

public abstract boolean disconnectFromWifi ()

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

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

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

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

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

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

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

public abstract boolean enableNetworkMonitor ()

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

برمی گرداند
boolean	true اگر نظارت با موفقیت فعال شود. false اگر شکست خورد

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

getActiveApexes

public abstract  getActiveApexes ()

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

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

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

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

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

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

getAndroidId

public abstract String getAndroidId (int userId)

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

پارامترها
userId	int

برمی گرداند
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

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

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

getAppPackageInfo

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

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

برمی گرداند
DeviceFoldableState

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

getCurrentUser

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

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

getIpAddress

public abstract String getIpAddress ()

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

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

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

getMainUserId

public abstract Integer getMainUserId ()

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

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

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

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

برمی گرداند
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 از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات null .

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

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

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

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

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

public abstract InputStreamSource getScreenshot (String format)

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

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

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

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

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

public abstract InputStreamSource getScreenshot ()

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

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

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

getSetting

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

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

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

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

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

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

برمی گرداند
String

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

getUninstalablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

پارامترها
userId	int

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

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

getUserInfos

public abstract  getUserInfos ()

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

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

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

پارامترها
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

installPackage

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	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست.

installPackage

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

installPackageForUser

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	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست.

installPackageForUser

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

installPackages

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

installPackages

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

installPackagesForUser

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

installPackagesForUser

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

RemotePackages را نصب کنید

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

RemotePackages را نصب کنید

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 ()

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isMultiUserSupported

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	اگر کاربر در حال اجرا باشد درست است، در سایر موارد نادرست است.

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

پارامترها
userId	int

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

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

isUserVisible

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

isVisibleBackgroundUsersOnDefaultDisplaySupported

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

isWifiEnabled است

public abstract boolean isWifiEnabled ()

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

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

برمی گرداند
boolean	true اگر وای فای فعال باشد. false در صورت غیرفعال بودن

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

listDisplayIds

public abstract  listDisplayIds ()

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

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

پرتاب می کند
	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

گزارش logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

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

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

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

پارامترها
waitPhase	SnapuserdWaitPhase

registerDeviceActionReceiver

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

removeUser

public abstract boolean removeUser (int userId)

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

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

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

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

پرتاب می کند
	com.android.tradefed.device.devicenotavailableablexception
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.devicenotavailableablexception
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.devicenotavailableablexception
DeviceNotAvailableException

شروع کار

public abstract boolean startUser (int userId)

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

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

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

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

شروع کار

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

stearvisiblebackgrounduser

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	درست است اگر کاربر با موفقیت متوقف شد.

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

توقفگاه

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

یک کاربر خاص را متوقف کنید. فراهم کردن پرچم های اضافی برای انتظار برای عملکرد و زور که کاربر را خاتمه می دهد. نمی توان کاربر فعلی و سیستم را متوقف کرد.

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

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

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

سوئیچ کننده

public abstract boolean switchUser (int userId)

با یک زمان پیش فرض به یک کاربر دیگر بروید. switchUser(int, long) .

پارامترها
userId	int

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

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

سوئیچ کننده

public abstract boolean switchUser (int userId, 
                long timeout)

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

پارامترها
userId	int
timeout	long : صبر کنید تا قبل از بازگشت کاذب برای کاربر سوئیچ انجام نشد.

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

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

TakebugReport

public abstract Bugreport takeBugreport ()

یک BugReport بگیرید و آن را درون یک شیء Bugreport برگردانید تا آن را اداره کنید. در صورت بروز مسئله ، تهی را برگردانید. پرونده ارجاع شده در شیء 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	اگر اتصال با دستگاه از بین برود و قابل بازیابی نباشد.

Waitforsnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

در صورت انتظار ، صبر کنید تا Snapuserd تکمیل شود.

پارامترها
currentPhase	SnapuserdWaitPhase

پرتاب می کند
DeviceNotAvailableException