ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Znane podklasy pośrednie IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice IManagedTestDevice Obiekt ITestDevice, którego cykl życia jest zarządzany.  Lokalne urządzenie wirtualne z Androidem Klasa dla lokalnych urządzeń wirtualnych działających na hoście TradeFed.  Zarządzane urządzenie zdalne Urządzenie działające w maszynie wirtualnej, którą zarządzamy zdalnie za pomocą instancji Tradefed w maszynie wirtualnej.  Urządzenie natywne Domyślna implementacja na urządzeniach z Androidem, które nie mają pełnego stosu.ITestDevice  NestedRemoteDevice Przykład urządzenia działającego w ramach zdalnej maszyny wirtualnej Cuttlefish.  RemoteAndroidDevice Wdrożenie ITestDevice na urządzeniu z Androidem z pełnym stosem połączonym za pomocą adb connect.  RemoteAndroidVirtualDevice Rozszerza działanie RemoteAndroidDevice w przypadku urządzenia z Androidem w pełnym zakresie działającego w Google Compute Engine (Gce).  TestDevice Implementacja interfejsu ITestDevice na urządzeniu z Androidem w wersji pełnej.

---

Zapewnia niezawodny interfejs API o nieco wyższym poziomie dla biblioteki ddmlib IDevice.

Ponownie wysyła polecenia urządzenia do konfigurowanej liczby i udostępnia interfejs przywracania urządzeń, które nie odpowiadają.

Podsumowanie

Zagnieżdżone klasy
class	ITestDevice.ApexInfo Prosta klasa struktury do przechowywania informacji o pojedynczym APEX
class	ITestDevice.MountPointInfo Prosta klasa struktury do przechowywania informacji o pojedynczym punkcie zamontowania.

Metody publiczne
abstract boolean	canSwitchToHeadlessSystemUser() Wskazuje, czy można przełączyć się na użytkownika SYSTEMU bez interfejsu graficznego.
abstract boolean	checkConnectivity() Sprawdź, czy urządzenie ma połączenie sieciowe.
abstract boolean	clearErrorDialogs() Spróbuj zamknąć wszystkie okna z błędami wyświetlane obecnie w interfejsie urządzenia.
abstract void	clearLastConnectedWifiNetwork() Czyści ostatnią połączoną sieć Wi-Fi.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk) Łączy się z siecią Wi-Fi.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid) Połącza się z siecią Wi-Fi.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk) Połącza się z siecią Wi-Fi.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid) Połącza się z siecią Wi-Fi.
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid) Wariant connectToWifiNetwork(String, String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z siecią.
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk) Wariant connectToWifiNetwork(String, String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z internetem.
abstract int	createUser(String name) Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
abstract int	createUser(String name, boolean guest, boolean ephemeral) Utwórz użytkownika z danym imieniem i podanymi flagami
abstract int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Utwórz użytkownika z danym imieniem i podanymi flagami
abstract int	createUserNoThrow(String name) Utwórz użytkownika z danym imieniem i domyślnymi flagami 0.
abstract void	deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Usuwa zarejestrowany IDeviceActionReceiver.
abstract void	disableKeyguard() Próby wyłączenia blokady klawiatury.
abstract boolean	disableNetworkMonitor() Wyłącza monitorowanie sieci na urządzeniu.
abstract boolean	disconnectFromWifi() rozłącza się z siecią Wi-Fi.
abstract boolean	doesFileExist(String deviceFilePath, int userId) Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje dla danego użytkownika.
abstract File	dumpHeap(String process, String devicePath) Spróbuj zrobić zrzut stosu z serwera system_server.
abstract boolean	enableNetworkMonitor() Umożliwia monitorowanie sieci na urządzeniu.
abstract	getActiveApexes() Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.
abstract	getAllSettings(String namespace) Zwraca pary klucz-wartość żądanej przestrzeni nazw.
abstract String	getAndroidId(int userId) Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.
abstract	getAndroidIds() Utwórz mapę identyfikatorów Androida, które pasują do identyfikatorów użytkowników.
abstract PackageInfo	getAppPackageInfo(String packageName) Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.
abstract	getAppPackageInfos() Pobiera informacje o pakietach zainstalowanych na urządzeniu.
abstract InputStreamSource	getBugreport() Pobiera raport o błędzie z urządzenia.
abstract InputStreamSource	getBugreportz() Pobiera z urządzenia raport o błędach.
abstract DeviceFoldableState	getCurrentFoldableState() Zwraca bieżący stan urządzenia lub wartość null, jeśli wystąpiły jakieś problemy.
abstract int	getCurrentUser() Zwraca identyfikator bieżącego użytkownika.
abstract	getFoldableStates() Zwraca listę stanów składania urządzenia.
abstract	getInstalledPackageNames() Pobierz nazwy pakietów aplikacji obecnych na urządzeniu.
abstract String	getIpAddress() Pobiera adres IP urządzenia.
abstract KeyguardControllerState	getKeyguardState() Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest on obsługiwany.
abstract Integer	getMainUserId() Zwraca identyfikator głównego użytkownika.
abstract	getMainlineModuleInfo() Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.
abstract int	getMaxNumberOfRunningUsersSupported() Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających użytkowników.
abstract int	getMaxNumberOfUsersSupported() Uzyskaj maksymalną liczbę obsługiwanych użytkowników.
abstract TestDeviceOptions	getOptions() Pobierz opcje testowania urządzenia.
abstract Integer	getPrimaryUserId() Zwraca podstawowy identyfikator użytkownika.
abstract InputStreamSource	getScreenshot(String format, boolean rescale) Robi zrzut ekranu z urządzenia.
abstract InputStreamSource	getScreenshot(long displayId) Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania.
abstract InputStreamSource	getScreenshot(String format) Robi zrzut ekranu z urządzenia.
abstract InputStreamSource	getScreenshot() Robi zrzut ekranu z urządzenia.
abstract String	getSetting(int userId, String namespace, String key) Zwraca wartość żądanego ustawienia.
abstract String	getSetting(String namespace, String key) Zobacz getSetting(int, String, String) i wykonane przez użytkownika systemowego.
abstract	getUninstallablePackageNames() Pobierz nazwy pakietów aplikacji, które można odinstalować.
abstract int	getUserFlags(int userId) Znajdź i zwróć flagi danego użytkownika.
abstract	getUserInfos() Pobiera mapę useId na urządzeniu do UserInfo.
abstract int	getUserSerialNumber(int userId) W przeciwnym razie zwraca -10000.
abstract boolean	hasFeature(String feature) Sprawdzanie, czy funkcja jest dostępna na urządzeniu
abstract String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Zainstaluj na urządzeniu pakiet Androida.
abstract String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj na urządzeniu pakiet Androida.
abstract String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Instalowanie pakietu Androida na urządzeniu danego użytkownika.
abstract String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instalowanie pakietu Androida na urządzeniu danego użytkownika.
default String	installPackages( packageFiles, boolean reinstall, String... extraArgs) Instalowanie aplikacji na Androida utworzonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone).
default String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstalować aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.
default String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs) Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowy pakiet podzielony) dla danego użytkownika.
default String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instalowanie aplikacji na Androida złożonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone) dla danego użytkownika.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs) Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.
abstract boolean	isHeadlessSystemUserMode() Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.
abstract boolean	isMainUserPermanentAdmin() Zwraca informację, czy główny użytkownik jest stałym administratorem i czy nie można go usunąć ani obniżyć jego uprawnień do poziomu nieadministratora.
abstract boolean	isMultiUserSupported() Określa, czy obsługiwany jest tryb wielu użytkowników.
abstract boolean	isPackageInstalled(String packageName, String userId) Przesyłanie zapytania do urządzenia o określonej nazwie pakietu i określonym identyfikatorem użytkownika w celu sprawdzenia, czy aplikacja jest obecnie zainstalowana na tym urządzeniu.
abstract boolean	isPackageInstalled(String packageName) Wyszukaj na urządzeniu daną nazwę pakietu, aby sprawdzić, czy jest on zainstalowany.
abstract boolean	isUserRunning(int userId) Sprawdź, czy dany użytkownik jest obecny.
abstract boolean	isUserSecondary(int userId) Zwraca informację, czy podany użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.
abstract boolean	isUserVisible(int userId) Sprawdza, czy dany użytkownik jest widoczny.
abstract boolean	isUserVisibleOnDisplay(int userId, int displayId) Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() Zwraca informacje o tym, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle w kontekście ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
abstract boolean	isVisibleBackgroundUsersSupported() Wskazuje, czy urządzenie zezwala na uruchamianie użytkowników w tle.
abstract boolean	isWifiEnabled() Sprawdź, czy Wi-Fi jest włączone.
abstract	listDisplayIds() Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys SurfaceFlinger”.
abstract	listDisplayIdsForStartingVisibleBackgroundUsers() Pobiera listę wyświetlaczy, których można używać do start a user visible in the background.
abstract	listUsers() Pobiera listę użytkowników na urządzeniu.
abstract boolean	logBugreport(String dataName, ITestLogger listener) Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w raportach dla zgłaszających.
default void	notifySnapuserd(SnapuserdWaitPhase waitPhase) Poinformuj urządzenie, aby czekało na zakończenie snapuserd.
abstract void	registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Rejestruje IDeviceActionReceiver na tym urządzeniu.
abstract boolean	removeAdmin(String componentName, int userId) Usuń danego administratora urządzenia z konta danego użytkownika i zwróć true, jeśli operacja się uda. W przeciwnym razie: false.
abstract void	removeOwners() Usuń wszystkich dotychczasowych właścicieli profilu urządzenia w miarę możliwości.
abstract boolean	removeUser(int userId) usunąć danego użytkownika z urządzenia,
abstract boolean	setDeviceOwner(String componentName, int userId) Ustaw komponent administratora urządzenia jako właściciela urządzenia u danego użytkownika.
abstract void	setSetting(String namespace, String key, String value) Zobacz setSetting(int, String, String, String) i wykonane przez użytkownika systemowego.
abstract void	setSetting(int userId, String namespace, String key, String value) Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika.
abstract boolean	startUser(int userId) Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.
abstract boolean	startUser(int userId, boolean waitFlag) Uruchamia w tle dane użytkownika, jeśli jego działanie zostało zatrzymane.
abstract boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) Uruchamia użytkownika w tle, co jest widoczne na danym wyświetlaczu (pozwala mu uruchamiać działania na tym ekranie).
abstract boolean	stopUser(int userId) Zatrzymuje danego użytkownika.
abstract boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Zatrzymać danego użytkownika.
abstract boolean	switchUser(int userId) Przełącz się na innego użytkownika o domyślnym czasie oczekiwania.
abstract boolean	switchUser(int userId, long timeout) Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem.
abstract Bugreport	takeBugreport() Przejmuje zgłoszenie błędu i zwraca je w obiekcie Bugreport, aby je obsłużyć.
abstract String	uninstallPackage(String packageName) Odinstaluj pakiet Androida z urządzenia.
abstract String	uninstallPackageForUser(String packageName, int userId) Odinstaluj pakiet Androida z urządzenia danego użytkownika.
default void	waitForSnapuserd(SnapuserdWaitPhase currentPhase) W razie potrzeby poczekaj, aż snapuserd zakończy działanie.

Metody publiczne

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Zwraca informację, czy można przełączyć się na użytkownika systemu bez interfejsu.

Zwroty
boolean

Rzuty
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

Sprawdź, czy urządzenie ma połączenie z siecią.

Zwroty
boolean	true, jeśli urządzenie ma działające połączenie sieciowe, false powyżej.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Spróbuj zamknąć wszystkie okna z błędami wyświetlane obecnie w interfejsie urządzenia.

Zwroty
boolean	true, jeśli nie było żadnych okien dialogowych lub zostały one wyczyszczone. false w innych przypadkach.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Czyści ostatnią połączoną sieć Wi-Fi. Należy go wywołać podczas uruchamiania nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi użytą w poprzednim teście po ponownym uruchomieniu urządzenia.

połącz_sieciWifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Łączy się z siecią Wi-Fi.

Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork().

Parametry
wifiSsidToPsk	: mapa identyfikatorów SSID sieci Wi-Fi z hasłami.

Zwroty
boolean	true jeśli urządzenie jest połączone z siecią Wi-Fi. W przeciwnym razie: false

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Łączy się z siecią Wi-Fi.

Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork().

Parametry
wifiSsidToPsk	: mapa identyfikatorów SSID sieci Wi-Fi z hasłami.
scanSsid	boolean: czy skanować ukryte identyfikatory SSID tej sieci.

Zwroty
boolean	true jeśli urządzenie jest połączone z siecią Wi-Fi. W przeciwnym razie: false

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Połącza się z siecią Wi-Fi.

Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork().

Parametry
wifiSsid	String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć
wifiPsk	String: hasło PSK lub wartość null, jeśli nie jest zaszyfrowane

Zwroty
boolean	true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

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

Połącza się z siecią Wi-Fi.

Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork().

Parametry
wifiSsid	String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć
wifiPsk	String: hasło PSK lub null, jeśli nie jest zaszyfrowane
scanSsid	boolean: czy skanować ukryte identyfikatory SSID tej sieci.

Zwroty
boolean	true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.

PołączToWifiSiećW razie potrzeby

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

Wariant connectToWifiNetwork(String, String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z internetem.

Parametry
scanSsid	boolean: czy ma skanować w poszukiwaniu ukrytego identyfikatora SSID tej sieci

Zwroty
boolean	true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

PołączToWifiSiećW razie potrzeby

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Wariant connectToWifiNetwork(String, String), który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z internetem.

Zwroty
boolean	true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.

Parametry
name	String: użytkownika, którego należy utworzyć na urządzeniu

Zwroty
int	liczba całkowita dla utworzonego identyfikatora użytkownika

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

Utwórz użytkownika z danym imieniem i podanymi flagami

Parametry
name	String: użytkownika, którego należy utworzyć na urządzeniu
guest	boolean: włącz flagę użytkownika – gość podczas tworzenia.
ephemeral	boolean: włącz flagę użytkownika --ephemeral podczas tworzenia.

Zwroty
int	identyfikator utworzonego użytkownika.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

Utwórz użytkownika z danym imieniem i podanymi flagami

Parametry
name	String: użytkownika, którego należy utworzyć na urządzeniu
guest	boolean: włącz flagę użytkownika – gość podczas tworzenia.
ephemeral	boolean: włącz flagę użytkownika --ephemeral podczas tworzenia.
forTesting	boolean: włącz flagę testu --for-testing podczas tworzenia.

Zwroty
int	identyfikator utworzonego użytkownika.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.

Parametry
name	String: użytkownika, którego należy utworzyć na urządzeniu

Zwroty
int	wartość całkowita identyfikatora utworzonego użytkownika lub -1 w przypadku błędu.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

wyrejestrujUrządzenieDziałanieOdbiornika

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

Parametry
deviceActionReceiver	IDeviceActionReceiver: IDeviceActionReceiver, który zostanie usunięty.

disableKeyguard

public abstract void disableKeyguard ()

Próby wyłączenia blokady klawiatury.

Najpierw zaczekaj, aż przesłanie danych wejściowych będzie gotowe. Stanie się to mniej więcej w tym samym czasie, gdy urządzenie zgłosi BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna implementacja frameworka ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie odblokowania klawiatury (działa tylko w przypadku klawiatur niezabezpieczonych)

Rzuty
DeviceNotAvailableException

wyłącz monitor sieci

public abstract boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwroty
boolean	true, jeśli udało się wyłączyć monitorowanie. false jeśli nie udało się.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

rozłącza się z siecią Wi-Fi.

Usuwa wszystkie sieci z listy znanych sieci i wyłącza Wi-Fi.

Zwroty
boolean	true, jeśli połączenie z siecią Wi-Fi zostało utracone. false, jeśli nie udało się odłączyć.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.

niePlikIstnieje

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Metoda pomocnicza do określenia, czy dany użytkownik istnieje na urządzeniu.

Parametry
deviceFilePath	String: bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony
userId	int: identyfikator użytkownika, którego dotyczy sprawdzanie istnienia pliku

Zwroty
boolean	true, jeśli plik istnieje, false w przeciwnym razie.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Spróbuj zrzucić stos z system_server. Usuwanie zrzutu ekranu należy do osoby wywołującej.

Parametry
process	String: nazwa procesu urządzenia, na którym ma zostać utworzony stos pamięci.
devicePath	String: ścieżka na urządzeniu, na której ma się znajdować zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia.

Zwroty
File	ERROR(/File) zawierający raport. Wartość null, jeśli coś się nie udało.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Umożliwia monitorowanie sieci na urządzeniu.

Zwroty
boolean	true, jeśli monitorowanie zostało włączone. false.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.

getActiveApexes

public abstract  getActiveApexes ()

Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.

Zwroty
	ERROR(/Set) z ApexInfo obecnie aktywnych na urządzeniu

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings,

public abstract  getAllSettings (String namespace)

Zwraca pary klucz-wartość żądanej przestrzeni nazw.

Parametry
namespace	String: musi być jedną z tych wartości: {"system", "secure", "global"}

Zwroty
	mapę par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.

Parametry
userId	int

Zwroty
String

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników. Nie ma pewności, że w przypadku każdego identyfikatora użytkownika uda się znaleźć powiązany z nim identyfikator Androida, więc niektóre identyfikatory użytkowników mogą być równe null.

Zwroty
	Mapa identyfikatorów Androida dopasowanych do identyfikatorów użytkowników.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName	String

Zwroty
PackageInfo	PackageInfo lub null, jeśli nie udało się pobrać informacji

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Pobierać informacje o pakietach zainstalowanych na urządzeniu.

Zwroty
	ERROR(/List) z PackageInfo zainstalowanych na urządzeniu.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Pobiera raport o błędzie z urządzenia.

Zapewniamy, że ta implementacja będzie działać na urządzeniu bez karty SD (lub gdy karta SD nie jest jeszcze zamontowana).

Zwroty
InputStreamSource	InputStreamSource, który będzie generował treści raportu o błędach na żądanie. W przypadku błędu funkcja InputStreamSource zwróci pustą wartość ERROR(/InputStream).

getBugreportz

public abstract InputStreamSource getBugreportz ()

Pobiera raport o błędzie z urządzenia. Raport o błędach w formacie ZIP zawiera główny raport o błędzie i inne pliki dziennika, które przydają się przy debugowaniu.

Obsługiwane tylko w przypadku „wersji adb” > 1.0.36

Zwroty
InputStreamSource	a InputStreamSource pliku zip zawierającego raport o błędzie; zwraca null w przypadku błędu.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Zwraca bieżący stan urządzenia lub wartość null, jeśli wystąpiły jakieś problemy.

Zwroty
DeviceFoldableState

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Zwraca identyfikator bieżącego użytkownika. W przypadku błędu zwraca wartość -10000.

Zwroty
int

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Zwraca listę stanów składania urządzenia. Można go uzyskać za pomocą polecenia „cmd device_state print-states”.

Zwroty

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Pobierz nazwy pakietów aplikacji obecnych na urządzeniu.

Zwroty
	ERROR(/Set) nazw pakietów String, które są obecnie zainstalowane na urządzeniu.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Pobiera adres IP urządzenia.

Zwroty
String	adres IP urządzenia lub null, jeśli urządzenie nie ma adresu IP

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest on obsługiwany.

Zwroty
KeyguardControllerState	Pole KeyguardControllerState zawierające zrzut stanu zabezpieczenia klucza i zwraca wartość null, jeśli zapytanie zabezpieczające nie jest obsługiwane.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getMainUserId,

public abstract Integer getMainUserId ()

Zwraca identyfikator głównego użytkownika.

Zwroty
Integer	userId głównego użytkownika, jeśli taki istnieje, lub null, jeśli nie ma głównego użytkownika.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Uzyskaj informacje o modułach mainline zainstalowanych na urządzeniu.

Zwroty
	Na urządzeniu jest obecnie zainstalowanych ERROR(/Set) z String modułów mainline.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających użytkowników. Domyślna wartość to 0.

Zwroty
int	liczba całkowita wskazująca liczbę jednocześnie działających użytkowników;

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Uzyskaj maksymalną liczbę obsługiwanych użytkowników. Wartość domyślna to 0.

Zwroty
int	liczba całkowita wskazująca liczbę obsługiwanych użytkowników

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Pobierz opcje testowe dla urządzenia.

Zwroty
TestDeviceOptions	TestDeviceOptions związane z testowanym urządzeniem.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Zwraca identyfikator głównego użytkownika.

Zwroty
Integer	userId głównego użytkownika, jeśli taki istnieje, lub null, jeśli nie ma głównego użytkownika.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	jeśli sygnał wyjściowy z urządzenia jest niezgodny z oczekiwaniami.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Robi zrzut ekranu z urządzenia. Zalecamy użycie getScreenshot(String) zamiast kodowania JPEG, aby zmniejszyć rozmiar.

Parametry
format	String: obsługiwane PNG, JPEG
rescale	boolean: jeśli zrzut ekranu należy przeskalować, by zmniejszyć rozmiar wynikowego obrazu.

Zwroty
InputStreamSource	InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie powiódł się.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze. Format to PNG.

DO ZROBIENIA: rozszerz implementacje powyżej, aby obsługiwały opcje „format” i „rescale”.

Parametry
displayId	long: identyfikator wyświetlacza ekranu, z którego ma być zrobiony zrzut ekranu.

Zwroty
InputStreamSource	InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie powiódł się.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Pobierz zrzut ekranu

public abstract InputStreamSource getScreenshot (String format)

Pobiera zrzut ekranu z urządzenia. W przypadku mniejszego rozmiaru zalecamy użycie zamiast tego metody getScreenshot(format) z kodowaniem JPEG

Parametry
format	String: obsługiwane PNG, JPEG

Zwroty
InputStreamSource	InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie powiódł się.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Pobierz zrzut ekranu

public abstract InputStreamSource getScreenshot ()

Pobiera zrzut ekranu z urządzenia.

Zwroty
InputStreamSource	InputStreamSource zrzutu ekranu w formacie png lub null, jeśli zrzut ekranu nie powiódł się.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

Zwraca wartość żądanego ustawienia. namespace musi być jedną z tych wartości: {"system", "secure", "global"}

Parametry
userId	int
namespace	String
key	String

Zwroty
String	wartość powiązana z przestrzenią nazw:klucz użytkownika. Wartość null, jeśli nie znaleziono.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Zobacz getSetting(int, String, String) i wykonane przez użytkownika systemowego.

Parametry
namespace	String
key	String

Zwroty
String

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie są to pakiety niesystemowe i zaktualizowane pakiety systemowe.

Zwroty
	ERROR(/Set) nazwy pakietów String, których nie można odinstalować, zainstalowanych obecnie na urządzeniu.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Znajdowanie i zwracanie flag danego użytkownika. Flagi są definiowane w klasie „android.content.pm.UserInfo” w projekcie Android Open Source.

Parametry
userId	int

Zwroty
int	flagi powiązane z podanym identyfikatorem użytkownika (jeśli został znaleziony), a w pozostałych przypadkach – -10000.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Pobiera Map of useId do UserInfo na urządzeniu. Jeśli dane wyjściowe z urządzenia będą niezgodne z oczekiwaniami, zostanie zwrócony kod DeviceRuntimeException.

Zwroty
	listę obiektów UserInfo.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

W przeciwnym razie zwraca -10000.

Parametry
userId	int

Zwroty
int

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Sprawdzanie, czy funkcja jest dostępna na urządzeniu

Parametry
feature	String: format, który powinien być użyty: „feature:” lub „”.

Zwroty
boolean	Wartość „prawda”, jeśli udało się znaleźć funkcję. W przeciwnym razie wartość „fałsz”.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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

Zainstaluj na urządzeniu pakiet Androida.

Parametry
packageFile	File: plik APK do zainstalowania
reinstall	boolean: true, jeśli należy ponownie zainstalować aplikację
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w opisie „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

installPackage

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

Zainstaluj na urządzeniu pakiet Androida.

Uwaga: tej funkcji należy używać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.

Parametry
packageFile	File: plik APK do zainstalowania
reinstall	boolean: true, jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean: czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w opisie „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null, jeśli operacja się powiodła.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException	jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

zainstalujPakiet dla użytkownika

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

Instalowanie pakietu Androida na urządzeniu danego użytkownika.

Parametry
packageFile	File: plik APK do zainstalowania
reinstall	boolean: true, jeśli należy ponownie zainstalować aplikację
userId	int: liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja.
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

zainstalujPakiet dla użytkownika

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

Instalowanie pakietu Androida na urządzeniu danego użytkownika.

Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest wyraźna kontrola udzielania uprawnień w czasie działania w momencie instalacji.

Parametry
packageFile	File: plik APK do zainstalowania
reinstall	boolean: true, jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean: czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji
userId	int: liczba całkowita identyfikator użytkownika, u którego ma być zainstalowana aplikacja.
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null, jeśli operacja się powiodła.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException	jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackages

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

Instalowanie aplikacji na Androida utworzonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone). Informacje o podziale pliku APK na kilka plików znajdziesz na stronie „https://developer.android.com/studio/build/configure-apk-splits”.

Parametry
packageFiles	: pliki APK na urządzeniu
reinstall	boolean: true, jeśli należy ponownie zainstalować aplikację
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w opisie „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null, jeśli operacja się powiodła.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException	jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackages

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem. Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.

Uwaga: ta funkcja powinna być wywoływana tylko w przypadkach użycia wymagających bezpośredniej kontroli nad przyznawaniem uprawnień czasu działania podczas instalacji.

Parametry
packageFiles	: ścieżki do zdalnych plików APK do zainstalowania
reinstall	boolean: true, jeśli należy ponownie zainstalować aplikację
grantPermissions	boolean: czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w opisie „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null, jeśli operacja się powiodła.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException	jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackagesForUser

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

Instalowanie aplikacji na Androida złożonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone) dla danego użytkownika. Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.

Parametry
packageFiles	: pliki APK na urządzeniu
reinstall	boolean: true, jeśli należy ponownie zainstalować aplikację
userId	int: liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja.
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException	jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackagesForUser

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

Instalowanie aplikacji na Androida złożonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone) dla danego użytkownika. Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.

Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest wyraźna kontrola udzielania uprawnień w czasie działania w momencie instalacji.

Parametry
packageFiles	: pliki APK na urządzeniu
reinstall	boolean: true, jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean: czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji
userId	int: liczba całkowita identyfikator użytkownika, u którego ma być zainstalowana aplikacja.
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null, jeśli operacja się powiodła.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException	jeśli uprawnienia w czasie działania nie są obsługiwane przez platformę na urządzeniu.

Zainstaluj pakiety zdalne

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem. Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.

Parametry
remoteApkPaths	: ścieżki do zdalnych plików APK
reinstall	boolean: true, jeśli należy ponownie zainstalować aplikację
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w opisie „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null, jeśli operacja się powiodła.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException	jeśli uprawnienia w czasie działania nie są obsługiwane przez platformę na urządzeniu.

Zainstaluj pakiety zdalne

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowy dzielony pakiet) znajdujących się na urządzeniu z Androidem. Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.

Uwaga: ta funkcja powinna być wywoływana tylko w przypadkach użycia wymagających bezpośredniej kontroli nad przyznawaniem uprawnień czasu działania podczas instalacji.

Parametry
remoteApkPaths	: ścieżki do zdalnych plików APK
reinstall	boolean: true, jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean: czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji
extraArgs	String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w opisie „adb shell pm -h”.

Zwroty
String	String z kodem błędu lub null, jeśli operacja się powiodła.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException	jeśli uprawnienia w czasie działania nie są obsługiwane przez platformę na urządzeniu.

Tryb użytkownika systemu bez interfejsu graficznego

public abstract boolean isHeadlessSystemUserMode ()

Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Zwraca informację, czy główny użytkownik jest stałym administratorem i czy nie można go usunąć ani obniżyć jego uprawnień do poziomu nieadministratora.

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Określa, czy obsługiwany jest tryb wielu użytkowników.

Zwroty
boolean	true, jeśli obsługiwane jest korzystanie przez wielu użytkowników, w przeciwnym razie false

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackagePackage (Zainstalowany pakiet)

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Przesyłać zapytanie do urządzenia o określoną nazwę pakietu i określony identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana na tym urządzeniu.

Parametry
packageName	String: pakiet, którego instalację sprawdzamy.
userId	String: identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli wartość jest pusta, zostanie użyta wartość zero.

Zwroty
boolean	Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackagePackage (Zainstalowany pakiet)

public abstract boolean isPackageInstalled (String packageName)

Wyszukaj na urządzeniu daną nazwę pakietu, aby sprawdzić, czy jest on zainstalowany.

Parametry
packageName	String

Zwroty
boolean	Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Sprawdź, czy dany użytkownik jest obecny.

Parametry
userId	int

Zwroty
boolean	Wartość „prawda”, jeśli użytkownik biega. W pozostałych przypadkach wartość „fałsz”.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

Zwraca informację, czy podany użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.

Parametry
userId	int

Zwroty
boolean	Prawda, jeśli użytkownik jest dodatkowy, w przeciwnym razie fałsz.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Sprawdza, czy dany użytkownik jest widoczny.

„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „ludzkim” użytkownikiem, a zatem może uruchamiać czynności (zazwyczaj w wyświetlanym domyślnie widoku).

Parametry
userId	int

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.

„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „ludzkim” użytkownikiem, a zatem może uruchamiać na wyświetlaczu różne działania.

Parametry
userId	int
displayId	int

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Zwraca informacje o tym, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle w kontekście ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

Jeśli tak, możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wyświetlacz zwrócony przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers() (która powinna zawierać ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Zwraca informację, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle.

Jeśli tak, możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wartość wyświetlaną przez listDisplayIdsForStartingVisibleBackgroundUsers().

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Sprawdź, czy Wi-Fi jest włączone.

Sprawdzanie, czy Wi-Fi jest włączone na urządzeniu. Ta opcja jest przydatna do sprawdzania stanu sieci Wi-Fi przed przeprowadzeniem testów, które nie powinny działać z siecią Wi-Fi (np. testów mobilnej transmisji danych).

Zwroty
boolean	true, jeśli Wi-Fi jest włączone. false, jeśli jest wyłączona

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

listaDisplayIds

public abstract  listDisplayIds ()

Zbierz listę identyfikatorów wyświetlaczy dostępnych na urządzeniu zgodnie z raportem „dumpsys SurfaceFlinger”.

Zwroty
	Lista wyświetlaczy. Wartość domyślna zawsze zwraca wartość domyślną 0.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Pobiera listę wyświetlaczy, których można używać do start a user visible in the background.

Zwroty

Rzuty
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Pobiera listę użytkowników na urządzeniu. Jeśli dane wyjściowe z urządzenia będą niezgodne z oczekiwaniami, wywoła DeviceRuntimeException.

Zwroty
	lista identyfikatorów użytkowników.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w dzienniku autorów.

Parametry
dataName	String: nazwa, pod którą zgłoszenie błędu zostanie przesłane.
listener	ITestLogger: ITestLogger do rejestrowania raportu o błędzie.

Zwroty
boolean	Wartość true, jeśli rejestrowanie zakończyło się powodzeniem. W przeciwnym razie wartość false.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Poinformuj urządzenie, aby czekało na zakończenie snapuserd.

Parametry
waitPhase	SnapuserdWaitPhase

RegisterDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver na tym urządzeniu.

Wszystkie zarejestrowane IDeviceActionReceiver zostaną powiadomione przed rozpoczęciem i po zakończeniu działania na urządzeniu.

Parametry
deviceActionReceiver	IDeviceActionReceiver: IDeviceActionReceiver, który zostanie zarejestrowany.

usuń administratora

public abstract boolean removeAdmin (String componentName, 
                int userId)

Usuń danego administratora urządzenia w danym użytkowniku i wróć true, jeśli operacja się powiedzie, w przeciwnym razie false.

Parametry
componentName	String: administratora urządzenia, którego chcesz usunąć.
userId	int: użytkownika, w którego przestrzeni osobistej znajduje się administrator urządzenia.

Zwroty
boolean	Wartość „true” (prawda), jeśli jest udana, albo „false” (fałsz).

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Usuń wszystkich dotychczasowych właścicieli profilu urządzenia.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

usunąć danego użytkownika z urządzenia.

Parametry
userId	int: użytkownika do usunięcia

Zwroty
boolean	Wartość „true”, jeśli udało się usunąć użytkownika, a w przeciwnym razie – „false”.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Ustaw komponent administratora urządzenia jako właściciela urządzenia u danego użytkownika.

Parametry
componentName	String: administrator urządzenia musi być właścicielem urządzenia.
userId	int: kraju zamieszkania właściciela urządzenia.

Zwroty
boolean	Wartość „true” (prawda), jeśli jest udana, albo „false” (fałsz).

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

UstawUstawienia

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

Zobacz setSetting(int, String, String, String) i wykonane przez użytkownika systemowego.

Parametry
namespace	String
key	String
value	String

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu urządzenia. namespace musi być jedną z tych wartości: {"system", "secure", "global"}

Parametry
userId	int
namespace	String
key	String
value	String

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Użytkownik początkowy

public abstract boolean startUser (int userId)

Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik jest już uruchomiony w tle, ta metoda nie wykonuje żadnej operacji.

Parametry
userId	int: użytkownik może uruchomić aplikację w tle

Zwroty
boolean	Wartość true, jeśli użytkownik został uruchomiony w tle.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Użytkownik początkowy

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Uruchamia w tle dane użytkownika, jeśli jego działanie zostało zatrzymane. Jeśli użytkownik jest już uruchomiony w tle, ta metoda nie wykonuje żadnej operacji. Możliwość dodania dodatkowej flagi, aby poczekać na zastosowanie operacji.

Parametry
userId	int: użytkownik może uruchomić aplikację w tle
waitFlag	boolean: polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie.

Zwroty
boolean	Wartość true, jeśli użytkownik został uruchomiony w tle.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

Uruchamia użytkownika w tle, co jest widoczne na danym wyświetlaczu (pozwala mu uruchamiać działania na tym ekranie).

UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature itp.

Parametry
userId	int: użytkownik może uruchomić aplikację w tle
displayId	int: wyświetlanie informacji o początkowym użytkowniku na
waitFlag	boolean: polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie.

Zwroty
boolean	true jeśli użytkownik został uruchomiony i jest widoczny w tle.

Rzuty
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Zatrzymuje danego użytkownika. Jeśli użytkownik został już zatrzymany, ta metoda nie będzie miała żadnego działania. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemowego.

Parametry
userId	int: użytkownik musi się zatrzymać.

Zwroty
boolean	true, jeśli użytkownik został zatrzymany.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

Zatrzymanie danego użytkownika. Można podać dodatkowe flagi, aby zaczekać na wykonanie operacji i przymusowo zakończyć działanie użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemowego.

Parametry
userId	int: użytkownik musi się zatrzymać.
waitFlag	boolean: polecenie będzie oczekiwać, aż użytkownik się zatrzyma.
forceFlag	boolean: wymusi zatrzymanie użytkownika.

Zwroty
boolean	true, jeśli użytkownik został zatrzymany.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Przełącz się na innego użytkownika o domyślnym czasie oczekiwania. switchUser(int, long).

Parametry
userId	int

Zwroty
boolean	Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem. Spróbuj wyłączyć blokadę klawiszy po pomyślnym zmianie użytkownika.

Parametry
userId	int
timeout	long: nie udało się poczekać przed zwróceniem wartości false dla użytkownika Switch.

Zwroty
boolean	Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Przyjmuje zgłoszenie o błędzie i zwraca je w obiekcie Bugreport, aby je obsłużyć. W przypadku problemów zwraca wartość null. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony w programie Bugreport.close().

Zwroty
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Odinstaluj pakiet Androida z urządzenia.

Parametry
packageName	String: pakiet na Androida do odinstalowania

Zwroty
String	String z kodem błędu lub null, jeśli operacja się powiodła.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

Odinstaluj pakiet dla użytkownika

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Odinstaluj pakiet Androida z urządzenia danego użytkownika.

Parametry
packageName	String: pakiet na Androida do odinstalowania
userId	int: całkowita wartość identyfikatora użytkownika, dla którego ma zostać odinstalowana aplikacja.

Zwroty
String	String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Jeśli oczekiwano, poczekaj, aż Snapuserd się zakończy.

Parametry
currentPhase	SnapuserdWaitPhase

Rzuty
DeviceNotAvailableException