دستگاه تست IT

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

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

خلاصه

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

class ITestDevice.ApexInfo

یک کلاس struct ساده برای ذخیره اطلاعات مربوط به یک APEX واحد

class ITestDevice.MountPointInfo

یک کلاس struct ساده برای ذخیره اطلاعات مربوط به یک mountpoint واحد

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

abstract String adbInstallPackage (File packageFile, boolean reinstall, String... extraArgs)

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

abstract String adbInstallPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

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

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

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

default boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, boolean scanSsid)

این متد منسوخ شده است. به جای آن از connectToWifiNetworkWithResult(Map,boolean) استفاده کنید.

default boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

این متد منسوخ شده است. به جای آن connectToWifiNetworkWithResult(Map) استفاده کنید.

default boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

این متد منسوخ شده است. به جای آن از connectToWifiNetworkWithResult(String,String) استفاده کنید.

default boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

این متد منسوخ شده است. به جای آن از connectToWifiNetworkWithResult(String,String,boolean) استفاده کنید.

default boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

این متد منسوخ شده است. به جای آن از connectToWifiNetworkIfNeededWithResult(String,String,boolean) استفاده کنید.

default boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

این متد منسوخ شده است. به جای آن connectToWifiNetworkIfNeededWithResult(String,String) استفاده کنید.

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, String wifiPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, String wifiPsk)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, String wifiPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, String wifiPsk)

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

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 Set< ITestDevice.ApexInfo > getActiveApexes ()

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

abstract Map<String, String> getAllSettings (String namespace)

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

abstract String getAndroidId (int userId)

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

abstract Map<Integer, String> getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract List< PackageInfo > getAppPackageInfos ()

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

abstract InputStreamSource getBugreport ()

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

abstract InputStreamSource getBugreportz ()

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

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

شناسه (id) کاربر در حال اجرای فعلی را برمی‌گرداند.

abstract Set< DeviceFoldableState > getFoldableStates ()

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

abstract Set<String> getInstalledPackageNames ()

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

abstract String getIpAddress ()

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

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

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

abstract Set<String> getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported (String userType)

حداکثر تعداد کاربران پشتیبانی شده از نوع کاربر داده شده را بدست آورید.

abstract int getMaxNumberOfUsersSupported ()

این روش منسوخ شده است. از getMaxNumberOfUsersSupported(String userType) برای بدست آوردن حداکثر تعداد کاربران پشتیبانی شده برای یک نوع کاربر مشخص استفاده کنید.

abstract TestDeviceOptions getOptions ()

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

abstract Integer getPrimaryUserId ()

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

abstract int getRemainingCreatableUserCount (String userType)

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

abstract InputStreamSource getScreenshot (Long displayId, String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (String format)

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

abstract InputStreamSource getScreenshot (long displayId)

با توجه به شناسه نمایشگر (display id)، از دستگاه اسکرین‌شات می‌گیرد.

abstract InputStreamSource getScreenshot ()

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

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

مقدار تنظیم درخواستی را برمی‌گرداند.

abstract String getSetting (String namespace, String key)

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

abstract Set<String> getUninstallablePackageNames ()

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

abstract int getUserFlags (int userId)

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

abstract Map<Integer, UserInfo > getUserInfos ()

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

abstract int getUserSerialNumber (int userId)

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

abstract int getUserVisibleOnDisplay (int displayId)

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

abstract boolean hasFeature (String feature)

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

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

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

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

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

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

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

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

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

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

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

default String installPackages (List<File> packageFiles, boolean reinstall, String... extraArgs)

یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و دیگری فایل‌های جداگانه) را نصب کنید.

default String installPackages (List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

یک برنامه اندروید که از چندین فایل APK (یک فایل اصلی و یک فایل اضافی) که روی دستگاه اندروید قرار دارند، ساخته شده است را نصب کنید.

default String installPackagesForUser (List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)

یک برنامه اندروید متشکل از چندین فایل APK (یک بسته اصلی و یک بسته اضافی) را برای یک کاربر مشخص نصب کنید.

default String installPackagesForUser (List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, 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 Set<Long> listDisplayIds ()

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

abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

abstract ArrayList<Integer> 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 کامل شود.

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

adbInstallPackage 

public abstract String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

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

پارامترها
packageFile File : فایل apk برای نصب

reinstall boolean : اگر نصب مجدد لازم باشد، true

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm -h' مراجعه کنید.

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

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

adbInstallPackage 

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

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

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

پارامترها
packageFile File : فایل apk برای نصب

reinstall boolean : اگر نصب مجدد لازم باشد، true

grantPermissions boolean : اگر قرار باشد تمام مجوزهای زمان اجرا در زمان نصب اعطا شوند.

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm -h' مراجعه کنید.

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

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

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 boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

این روش منسوخ شده است.
به جای آن از connectToWifiNetworkWithResult(Map,boolean) استفاده کنید.

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

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

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

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

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

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

connectToWifiNetwork 

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

این روش منسوخ شده است.
به جای آن از connectToWifiNetworkWithResult(Map) استفاده کنید.

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

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

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

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

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

connectToWifiNetwork 

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

این روش منسوخ شده است.
به جای آن از connectToWifiNetworkWithResult(String,String) استفاده کنید.

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

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

پارامترها
wifiSsid String : شناسه شبکه وای‌فای (ssid) که قرار است به آن متصل شوید

wifiPsk String : عبارت عبور PSK یا در صورت رمزگذاری نشدن، null

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

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

connectToWifiNetwork 

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

این روش منسوخ شده است.
به جای آن از connectToWifiNetworkWithResult(String,String,boolean) استفاده کنید.

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

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

پارامترها
wifiSsid String : شناسه شبکه وای‌فای (ssid) که قرار است به آن متصل شوید

wifiPsk String : عبارت عبور PSK یا در صورت رمزگذاری نشدن، null

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

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

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

connectToWifiNetworkIfNeeded 

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

این روش منسوخ شده است.
به جای آن از connectToWifiNetworkIfNeededWithResult(String,String,boolean) استفاده کنید.

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

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

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

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

connectToWifiNetworkIfNeeded 

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

این روش منسوخ شده است.
به جای آن از connectToWifiNetworkIfNeededWithResult(String,String) استفاده کنید.

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

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

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

connectToWifiNetworkIfNeededWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

بازگشت‌ها
IWifiHelper.WifiConnectionResult نتیجه WifiConnectionResult که وضعیت اتصال را نشان می‌دهد.

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

connectToWifiNetworkIfNeededWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

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

بازگشت‌ها
IWifiHelper.WifiConnectionResult نتیجه WifiConnectionResult که وضعیت اتصال را نشان می‌دهد.

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

connectToWifiNetworkWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

پارامترها
wifiSsid String : شناسه شبکه وای‌فای (ssid) که قرار است به آن متصل شوید

wifiPsk String : عبارت عبور PSK یا در صورت رمزگذاری نشدن، null

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

بازگشت‌ها
IWifiHelper.WifiConnectionResult نتیجه WifiConnectionResult که وضعیت اتصال را نشان می‌دهد.

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

connectToWifiNetworkWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

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

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

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

بازگشت‌ها
IWifiHelper.WifiConnectionResult نتیجه WifiConnectionResult که وضعیت اتصال را نشان می‌دهد.

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

connectToWifiNetworkWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

بازگشت‌ها
IWifiHelper.WifiConnectionResult نتیجه WifiConnectionResult که وضعیت اتصال را نشان می‌دهد.

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

connectToWifiNetworkWithResult 

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

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

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

پارامترها
wifiSsid String : شناسه شبکه وای‌فای (ssid) که قرار است به آن متصل شوید

wifiPsk String : عبارت عبور PSK یا در صورت رمزگذاری نشدن، null

بازگشت‌ها
IWifiHelper.WifiConnectionResult نتیجه WifiConnectionResult که وضعیت اتصال را نشان می‌دهد.

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

ایجادکاربر 

public abstract int createUser (String name)

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

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

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

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

ایجادکاربر 

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
IllegalStateException

ایجادکاربر 

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
IllegalStateException

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

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 File حاوی گزارش. اگر چیزی با شکست مواجه شد، null برمی‌گردد.

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

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

public abstract boolean enableNetworkMonitor ()

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

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

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

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

public abstract Set<ITestDevice.ApexInfo> getActiveApexes ()

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

بازگشت‌ها
Set< ITestDevice.ApexInfo > Set از ApexInfo که در حال حاضر روی دستگاه فعال است

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

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

public abstract Map<String, String> getAllSettings (String namespace)

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

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

بازگشت‌ها
Map<String, 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 Map<Integer, String> getAndroidIds ()

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

بازگشت‌ها
Map<Integer, String> نقشه شناسه‌های اندروید منطبق با شناسه‌های کاربری پیدا شد.

پرتاب‌ها
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 List<PackageInfo> getAppPackageInfos ()

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

بازگشت‌ها
List< PackageInfo > List PackageInfo های نصب شده روی دستگاه.

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

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

public abstract InputStreamSource getBugreport ()

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

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

بازگشت‌ها
InputStreamSource یک InputStreamSource که محتوای گزارش اشکال را در صورت تقاضا تولید می‌کند. در صورت عدم موفقیت، InputStreamSource یک 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 Set<DeviceFoldableState> getFoldableStates ()

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

بازگشت‌ها
Set< DeviceFoldableState >

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

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

public abstract Set<String> getInstalledPackageNames ()

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

بازگشت‌ها
Set<String> 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 Set<String> getMainlineModuleInfo ()

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

بازگشت‌ها
Set<String> Set از ماژول‌های String اصلی که در حال حاضر روی دستگاه نصب شده‌اند.

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

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

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

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

public abstract int getMaxNumberOfUsersSupported (String userType)

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

پارامترها
userType String : نوع کاربر، همانطور که در UserManager تعریف شده است، مانند "android.os.usertype.full.SECONDARY".

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

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

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

public abstract int getMaxNumberOfUsersSupported ()

این روش منسوخ شده است.
برای بدست آوردن حداکثر تعداد کاربران پشتیبانی شده برای یک نوع کاربر مشخص، از تابع getMaxNumberOfUsersSupported(String userType) استفاده کنید.

حداکثر تعداد کاربران قابل تغییر پشتیبانی شده، به جز مهمان‌ها را دریافت کنید. پس از نسخه ۳۶ API، کاربران غیر قابل تغییر (مانند پروفایل‌ها) را شامل نمی‌شود. مقدار پیش‌فرض ۰ است.

بازگشت‌ها
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

getRemainingCreatableUserCount 

public abstract int getRemainingCreatableUserCount (String userType)

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

پارامترها
userType String : نوع کاربر، همانطور که در UserManager تعریف شده است، مانند "android.os.usertype.full.SECONDARY".

بازگشت‌ها
int چند کاربر از نوع کاربر داده شده می‌توانند اضافه شوند؟

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

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

public abstract InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

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

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

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

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

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

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
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 (String format)

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

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

بازگشت‌ها
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 ()

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

بازگشت‌ها
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 Set<String> getUninstallablePackageNames ()

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

بازگشت‌ها
Set<String> 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 Map<Integer, UserInfo> getUserInfos ()

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

بازگشت‌ها
Map<Integer, UserInfo > لیست اشیاء 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 int getUserVisibleOnDisplay (int displayId)

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

پارامترها
displayId int : شناسه‌ی نمایشگر.

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

پرتاب‌ها
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, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

پارامترها
packageFile File : فایل apk برای نصب

reinstall boolean : اگر نصب مجدد لازم باشد، true

grantPermissions boolean : اگر قرار باشد تمام مجوزهای زمان اجرا در زمان نصب اعطا شوند.

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm -h' مراجعه کنید.

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

پرتاب‌ها
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 installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

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

پارامترها
packageFile File : فایل apk برای نصب

reinstall boolean : اگر نصب مجدد لازم باشد، true

grantPermissions boolean : اگر قرار باشد تمام مجوزهای زمان اجرا در زمان نصب اعطا شوند.

userId int : شناسه کاربری عدد صحیح که قرار است نصب برایش انجام شود.

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm -h' مراجعه کنید.

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

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

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

public 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 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 (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

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

پارامترها
packageFiles List : فایل‌های apk محلی

reinstall boolean : اگر نصب مجدد لازم باشد، true

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm -h' مراجعه کنید.

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

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

نصب بسته‌ها 

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

پارامترها
packageFiles List : مسیرهای فایل apk از راه دور برای نصب

reinstall boolean : true if a reinstall should be performed

grantPermissions boolean : if all runtime permissions should be granted at install time

extraArgs String : optional extra arguments to pass. See 'adb shell pm -h' for available options.

بازگشت‌ها
String a String with an error code, or null if success.

پرتاب‌ها
DeviceNotAvailableException if connection with device is lost and cannot be recovered.
UnsupportedOperationException if runtime permission is not supported by the platform on device.

installPackagesForUser 

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Install an Android application made of several APK files (one main and extra split packages) for a given user. See "https://developer.android.com/studio/build/configure-apk-splits" on how to split apk to several files.

پارامترها
packageFiles List : the local apk files

reinstall boolean : true if a reinstall should be performed

userId int : the integer user id to install for.

extraArgs String : optional extra arguments to pass. See 'adb shell pm -h' for available options.

بازگشت‌ها
String a String with an error code, or null if success.

پرتاب‌ها
DeviceNotAvailableException if connection with device is lost and cannot be recovered.
UnsupportedOperationException if runtime permission is not supported by the platform on device.

installPackagesForUser 

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Install an Android application made of several APK files (one main and extra split packages) for a given user. See "https://developer.android.com/studio/build/configure-apk-splits" on how to split apk to several files.

Note: Only use cases that requires explicit control of granting runtime permission at install time should call this function.

پارامترها
packageFiles List : the local apk files

reinstall boolean : true if a reinstall should be performed

grantPermissions boolean : if all runtime permissions should be granted at install time

userId int : the integer user id to install for.

extraArgs String : optional extra arguments to pass. See 'adb shell pm -h' for available options.

بازگشت‌ها
String a String with an error code, or null if success.

پرتاب‌ها
DeviceNotAvailableException if connection with device is lost and cannot be recovered.
UnsupportedOperationException if runtime permission is not supported by the platform on device.

isHeadlessSystemUserMode 

public abstract boolean isHeadlessSystemUserMode ()

Returns whether the device uses headless system user mode.

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

isMainUserPermanentAdmin 

public abstract boolean isMainUserPermanentAdmin ()

Returns whether the main user is a permanent admin and can't be deleted or downgraded to non-admin status.

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

isMultiUserSupported 

public abstract boolean isMultiUserSupported ()

Returns whether this device supports multiple switchable users with their own login and customizable space.

Note that, even if false, multiple users might still be possible, as long as no login UI is required; eg, profiles might still be supported, as they do not require a login UI.

This also checks config_enableMultiUserUI. By demand, we are allowed to assume that devices for which this is true are configured to allow adding secondary users via adb.

بازگشت‌ها
boolean whether the device supports multiple switchable users.

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

isPackageInstalled 

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Query the device for a given package name and given user id to check if it's currently installed or not for that user.

پارامترها
packageName String : the package we are checking if it's installed.

userId String : The user id we are checking the package is installed for. If null, primary user zero will be used.

بازگشت‌ها
boolean True if the package is reported as installed. False otherwise.

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

isPackageInstalled 

public abstract boolean isPackageInstalled (String packageName)

Query the device for a given package name to check if it's currently installed or not.

پارامترها
packageName String

بازگشت‌ها
boolean True if the package is reported as installed. False otherwise.

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

isUserRunning 

public abstract boolean isUserRunning (int userId)

Check if a given user is running.

پارامترها
userId int

بازگشت‌ها
boolean True if the user is running, false in every other cases.

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

isUserSecondary 

public abstract boolean isUserSecondary (int userId)

Return whether the specified user is a secondary user according to it's flags.

پارامترها
userId int

بازگشت‌ها
boolean true if the user is secondary, false otherwise.

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

isUserVisible 

public abstract boolean isUserVisible (int userId)

Checks if the given user is visible.

A "visible" user is a user that is interacting with the "human" user and hence is able to launch launch activities (typically in the default display).

پارامترها
userId int

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

isUserVisibleOnDisplay 

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Checks if the given user is visible in the given display.

A "visible" user is a user that is interacting with the "human" user and hence is able to launch launch activities in that display.

پارامترها
userId int

displayId int

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported 

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Returns whether the device allow users to be started visible in the background in the ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

If it does, you could call startVisibleBackgroundUser(int, int, boolean) , passing a display returned by listDisplayIdsForStartingVisibleBackgroundUsers() (which should include ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

isVisibleBackgroundUsersSupported 

public abstract boolean isVisibleBackgroundUsersSupported ()

Returns whether the device allow users to be started visible in the background.

If it does, you could call startVisibleBackgroundUser(int, int, boolean) , passing a display returned by listDisplayIdsForStartingVisibleBackgroundUsers() .

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

isWifiEnabled 

public abstract boolean isWifiEnabled ()

Test if wifi is enabled.

Checks if wifi is enabled on device. Useful for asserting wifi status before tests that shouldn't run with wifi, eg mobile data tests.

بازگشت‌ها
boolean true if wifi is enabled. false if disabled

پرتاب‌ها
DeviceNotAvailableException if connection with device is lost and cannot be recovered.

listDisplayIds 

public abstract Set<Long> listDisplayIds ()

Collect the list of available displays id on the device as reported by "dumpsys SurfaceFlinger".

بازگشت‌ها
Set<Long> The list of displays. Default always returns the default display 0.

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

listDisplayIdsForStartingVisibleBackgroundUsers 

public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

Gets the list of displays that can be used to start a user visible in the background .

بازگشت‌ها
Set<Integer>

پرتاب‌ها
DeviceNotAvailableException

listUsers 

public abstract ArrayList<Integer> listUsers ()

Gets the list of users on the device. Will throw DeviceRuntimeException if output from device is not as expected.

بازگشت‌ها
ArrayList<Integer> the list of user ids.

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

logBugreport 

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Helper method to take a bugreport and log it to the reporters.

پارامترها
dataName String : name under which the bugreport will be reported.

listener ITestLogger : an ITestLogger to log the bugreport.

بازگشت‌ها
boolean True if the logging was successful, false otherwise.

notifySnapuserd 

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Notify the device to wait for snapuserd completion.

پارامترها
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver 

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registers a IDeviceActionReceiver for this device.

All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

پارامترها
deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

removeAdmin 

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remove given device admin in given user and return true if it is successful, false otherwise.

پارامترها
componentName String : of device admin to be removed.

userId int : of user that the device admin lives in.

بازگشت‌ها
boolean True if it is successful, false otherwise.

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

removeOwners 

public abstract void removeOwners ()

Remove all existing device profile owners with the best effort.

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

removeUser 

public abstract boolean removeUser (int userId)

Remove a given user from the device.

پارامترها
userId int : of the user to remove

بازگشت‌ها
boolean true if we were successful in removing the user, false otherwise.

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

setDeviceOwner 

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Set a device admin component as device owner in given user.

پارامترها
componentName String : of device admin to be device owner.

userId int : of the user that the device owner lives in.

بازگشت‌ها
boolean True if it is successful, false otherwise.

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

تنظیم 

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

See setSetting(int,String,String,String) and performed on system user.

پارامترها
namespace String

key String

value String

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

تنظیم 

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

Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

پارامترها
userId int

namespace String

key String

value String

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

startUser 

public abstract boolean startUser (int userId)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

پارامترها
userId int : of the user to start in the background

بازگشت‌ها
boolean true if the user was successfully started in the background.

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

startUser 

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

پارامترها
userId int : of the user to start in the background

waitFlag boolean : will make the command wait until user is started and unlocked.

بازگشت‌ها
boolean true if the user was successfully started in the background.

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

startVisibleBackgroundUser 

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

Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

پارامترها
userId int : of the user to start in the background

displayId int : display to start user visible on

waitFlag boolean : will make the command wait until user is started and unlocked.

بازگشت‌ها
boolean true if the user was successfully started visible in the background.

پرتاب‌ها
DeviceNotAvailableException

stopUser 

public abstract boolean stopUser (int userId)

Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

پارامترها
userId int : of the user to stop.

بازگشت‌ها
boolean true if the user was successfully stopped.

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

stopUser 

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

Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

پارامترها
userId int : of the user to stop.

waitFlag boolean : will make the command wait until user is stopped.

forceFlag boolean : will force stop the user.

بازگشت‌ها
boolean true if the user was successfully stopped.

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

switchUser 

public abstract boolean switchUser (int userId)

Switch to another userId with a default timeout. switchUser(int, long) .

پارامترها
userId int

بازگشت‌ها
boolean True if the new userId matches the userId provider. False otherwise.

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

switchUser 

public abstract boolean switchUser (int userId, 
                long timeout)

Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

پارامترها
userId int

timeout long : to wait before returning false for switch-user failed.

بازگشت‌ها
boolean True if the new userId matches the userId provider. False otherwise.

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

takeBugreport 

public abstract Bugreport takeBugreport ()

Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

بازگشت‌ها
Bugreport

uninstallPackage 

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

پارامترها
packageName String : the Android package to uninstall

بازگشت‌ها
String a String with an error code, or null if success.

پرتاب‌ها
DeviceNotAvailableException if connection with device is lost and cannot be recovered.

uninstallPackageForUser 

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

پارامترها
packageName String : the Android package to uninstall

userId int : the integer user id to uninstall for.

بازگشت‌ها
String a String with an error code, or null if success.

پرتاب‌ها
DeviceNotAvailableException if connection with device is lost and cannot be recovered.

waitForSnapuserd 

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

If expected, wait for snapuserd to complete.

پارامترها
currentPhase SnapuserdWaitPhase

پرتاب‌ها
DeviceNotAvailableException