Urządzenie testowe IT

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Znane podklasy pośrednie IManagedTestDevice , LocalAndroidVirtualDevice , ManagedRemoteDevice , NativeDevice , NestedRemoteDevice , RemoteAndroidDevice , RemoteAndroidVirtualDevice , TestDevice IManagedTestDevice 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 na maszynie wirtualnej, którym zarządzamy zdalnie poprzez instancję Tradefed wewnątrz maszyny wirtualnej. Urządzenie natywne Domyślna implementacja urządzeń z systemem Android ITestDevice , które nie obsługują pełnego stosu. Zagnieżdżone urządzenie zdalne Reprezentacja urządzenia działającego w zdalnej maszynie wirtualnej Mątwy. Zdalne urządzenie z Androidem Implementacja ITestDevice dla urządzenia z systemem Android z pełnym stosem połączonego za pośrednictwem połączenia adb. Zdalne urządzenie wirtualne z Androidem Rozszerza zachowanie RemoteAndroidDevice dla pełnego stosu urządzenia z Androidem działającego w Google Compute Engine (Gce). Urządzenie testowe Implementacja ITestDevice dla urządzenia z systemem Android z pełnym stosem

---

Zapewnia niezawodny interfejs API nieco wyższego poziomu dla ddmlib IDevice .

Ponawia wykonywanie poleceń urządzenia w konfigurowalnej ilości i zapewnia interfejs odzyskiwania urządzenia, które nie odpowiada.

Streszczenie

Zagnieżdżone klasy
class	ITestDevice.ApexInfo Prosta klasa struktury do przechowywania informacji o pojedynczym wierzchołku APEX
class	ITestDevice.MountPointInfo Prosta klasa struktury do przechowywania informacji o pojedynczym punkcie podłączenia

Metody publiczne
abstract boolean	canSwitchToHeadlessSystemUser () Zwraca informację, czy można przełączyć się na użytkownika bezgłowego SYSTEM.
abstract boolean	checkConnectivity () Sprawdź, czy urządzenie ma łączność sieciową.
abstract boolean	clearErrorDialogs () Spróbuj odrzucić wszelkie okna dialogowe o błędach wyświetlane obecnie w interfejsie użytkownika urządzenia.
abstract void	clearLastConnectedWifiNetwork () Usuwa ostatnią połączoną sieć Wi-Fi.
abstract boolean	connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Łączy się z siecią Wi-Fi.
abstract boolean	connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Łączy się z siecią Wi-Fi.
abstract boolean	connectToWifiNetwork (String wifiSsid, String wifiPsk) Łączy się z siecią Wi-Fi.
abstract boolean	connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Łączy 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 aktualnie nie ma połączenia z siecią.
abstract boolean	connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Wariant connectToWifiNetwork(String, String) który łączy się tylko wtedy, gdy urządzenie aktualnie nie ma połączenia z siecią.
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 o podanej nazwie i podanych flagach
abstract int	createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Utwórz użytkownika o podanej nazwie i podanych flagach
abstract int	createUserNoThrow (String name) Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
abstract void	deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Usuwa zarejestrowany IDeviceActionReceiver .
abstract void	disableKeyguard () Próba 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 ustalenia, czy dla danego użytkownika istnieje plik na urządzeniu.
abstract File	dumpHeap (String process, String devicePath) Spróbuj zrzucić stertę z serwera systemowego.
abstract boolean	enableNetworkMonitor () Umożliwia monitorowanie sieci na urządzeniu.
abstract	getActiveApexes () Pobierz informacje o APEXach aktywowanych na urządzeniu.
abstract	getAllSettings (String namespace) Zwróć pary klucz-wartość żądanej przestrzeni nazw.
abstract String	getAndroidId (int userId) Znajdź i zwróć identyfikator Androida powiązany z identyfikatorem użytkownika, null, jeśli nie zostanie znaleziony.
abstract	getAndroidIds () Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników.
abstract PackageInfo	getAppPackageInfo (String packageName) Pobierz informacje o pakiecie zainstalowanym na urządzeniu.
abstract	getAppPackageInfos () Pobierz informacje o pakietach zainstalowanych na urządzeniu.
abstract InputStreamSource	getBugreport () Pobiera raport o błędzie z urządzenia.
abstract InputStreamSource	getBugreportz () Pobiera raport o błędach z urządzenia.
abstract DeviceFoldableState	getCurrentFoldableState () Zwraca bieżący stan składania urządzenia lub wartość null, jeśli wystąpiły pewne problemy.
abstract int	getCurrentUser () Zwróć identyfikator bieżącego uruchomionego użytkownika.
abstract	getFoldableStates () Zwraca listę składanych stanów na urządzeniu.
abstract	getInstalledPackageNames () Pobierz nazwy pakietów aplikacji obecne na urządzeniu.
abstract String	getIpAddress () Pobiera adres IP urządzenia.
abstract KeyguardControllerState	getKeyguardState () Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany.
abstract Integer	getMainUserId () Zwraca główny identyfikator użytkownika.
abstract	getMainlineModuleInfo () Uzyskaj informacje 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 testowe dla urządzenia.
abstract Integer	getPrimaryUserId () Zwraca podstawowy identyfikator użytkownika.
abstract InputStreamSource	getScreenshot (String format, boolean rescale) Pobiera zrzut ekranu z urządzenia.
abstract InputStreamSource	getScreenshot (String format) Pobiera zrzut ekranu z urządzenia.
abstract InputStreamSource	getScreenshot (long displayId) Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza.
abstract InputStreamSource	getScreenshot () Pobiera zrzut ekranu z urządzenia.
abstract String	getSetting (int userId, String namespace, String key) Zwróć wartość żądanego ustawienia.
abstract String	getSetting (String namespace, String key) Zobacz getSetting(int, String, String) i wykonywane na użytkowniku systemowym.
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 do UserInfo na urządzeniu.
abstract int	getUserSerialNumber (int userId) Jeśli zostanie znaleziony, zwróć numer seryjny powiązany z identyfikatorem użytkownika, w pozostałych przypadkach -10000.
abstract boolean	hasFeature (String feature) Sprawdź, czy dana funkcja jest dostępna na urządzeniu.
abstract String	installPackage (File packageFile, boolean reinstall, String... extraArgs) Zainstaluj pakiet Android na urządzeniu.
abstract String	installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj pakiet Android na urządzeniu.
abstract String	installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Zainstaluj pakiet Android na urządzeniu dla danego użytkownika.
abstract String	installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Zainstaluj pakiet Android na urządzeniu dla danego użytkownika.
default String	installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden główny i dodatkowy pakiet podzielony).
default String	installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden główny i dodatkowy pakiet podzielony), które znajdują się na urządzeniu z Androidem.
default String	installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego pakietu głównego i dodatkowych pakietów podzielonych) dla danego użytkownika.
default String	installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego pakietu głównego i dodatkowych pakietów podzielonych) dla danego użytkownika.
default String	installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden główny i dodatkowy pakiet podzielony), które znajdują się na urządzeniu z Androidem.
default String	installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden główny i dodatkowy pakiet podzielony), które znajdują się na urządzeniu z Androidem.
abstract boolean	isHeadlessSystemUserMode () Zwraca informację, czy urządzenie korzysta z trybu użytkownika systemu bezgłowego.
abstract boolean	isMainUserPermanentAdmin () Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani zmienić na inny niż administrator.
abstract boolean	isMultiUserSupported () Określa, czy obsługiwanych jest wielu użytkowników.
abstract boolean	isPackageInstalled (String packageName, String userId) Zapytaj urządzenie o podaną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest ono aktualnie zainstalowane dla tego użytkownika.
abstract boolean	isPackageInstalled (String packageName) Zapytaj urządzenie o podaną nazwę pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie.
abstract boolean	isUserRunning (int userId) Sprawdź, czy dany użytkownik jest uruchomiony.
abstract boolean	isUserSecondary (int userId) Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym zgodnie z jego flagami.
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, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .
abstract boolean	isVisibleBackgroundUsersSupported () Zwraca informację, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle.
abstract boolean	isWifiEnabled () Sprawdź, czy Wi-Fi jest włączone.
abstract	listDisplayIds () Zbierz listę dostępnych identyfikatorów wyświetlaczy na urządzeniu zgodnie z raportem „dumpsys SurfaceFlinger”.
abstract	listDisplayIdsForStartingVisibleBackgroundUsers () Pobiera listę ekranów, których można użyć 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 umożliwiająca przyjęcie raportu o błędzie i zalogowanie go do reporterów.
default void	notifySnapuserd ( SnapuserdWaitPhase waitPhase) Powiadom urządzenie, aby oczekiwało na zakończenie snapuserd.
abstract void	registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Rejestruje IDeviceActionReceiver dla tego urządzenia.
abstract boolean	removeAdmin (String componentName, int userId) Usuń danego administratora urządzenia dla danego użytkownika i zwróć true , jeśli się powiedzie, false w przeciwnym razie.
abstract void	removeOwners () Usuń wszystkich istniejących właścicieli profili urządzeń, dokładając wszelkich starań.
abstract boolean	removeUser (int userId) Usuń danego użytkownika z urządzenia.
abstract boolean	setDeviceOwner (String componentName, int userId) Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika.
abstract void	setSetting (String namespace, String key, String value) Zobacz setSetting(int, String, String, String) i wykonaj na użytkowniku systemowym.
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 aktualnie zatrzymany.
abstract boolean	startUser (int userId, boolean waitFlag) Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany.
abstract boolean	startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Uruchamia danego użytkownika w tle, widocznym na danym ekranie (tzn. umożliwiając użytkownikowi uruchomienie działań na tym ekranie).
abstract boolean	stopUser (int userId) Zatrzymuje danego użytkownika.
abstract boolean	stopUser (int userId, boolean waitFlag, boolean forceFlag) Zatrzymaj danego użytkownika.
abstract boolean	switchUser (int userId) Przełącz na inny identyfikator użytkownika z domyślnym limitem czasu.
abstract boolean	switchUser (int userId, long timeout) Przełącz na inny identyfikator użytkownika z podanym limitem czasu jako ostatecznym terminem.
abstract Bugreport	takeBugreport () Weź raport o błędzie i zwróć go do obiektu Bugreport , aby go 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 dla danego użytkownika.
default void	waitForSnapuserd ( SnapuserdWaitPhase currentPhase) Jeśli jest to oczekiwane, poczekaj na zakończenie snapuserd.

Metody publiczne

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Zwraca informację, czy można przełączyć się na użytkownika bezgłowego SYSTEM.

Zwroty
boolean

Rzuca
DeviceNotAvailableException

sprawdź Łączność

public abstract boolean checkConnectivity ()

Sprawdź, czy urządzenie ma łączność sieciową.

Zwroty
boolean	true , jeśli urządzenie ma działające połączenie sieciowe, false w przeciwnym razie.

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

wyczyść okno dialogowe błędów

public abstract boolean clearErrorDialogs ()

Spróbuj odrzucić wszelkie okna dialogowe o błędach wyświetlane obecnie w interfejsie użytkownika urządzenia.

Zwroty
boolean	true , jeśli nie było żadnych okien dialogowych lub okna dialogowe zostały pomyślnie usunięte. inaczej false .

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Usuwa ostatnią połączoną sieć Wi-Fi. Należy to wywołać przy rozpoczynaniu nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi używaną w poprzednim teście po ponownym uruchomieniu urządzenia.

połącz się z siecią Wi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

Włącza Wi-Fi i blokuje do czasu nawiązania pomyślnego połączenia z jedną z sieci Wi-Fi podanych na mapie Wi-FiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcji ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsidToPsk	: Mapa identyfikatorów SSID Wi-Fi na hasła.

Zwroty
boolean	true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

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

połącz się z siecią Wi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

Włącza Wi-Fi i blokuje do czasu nawiązania pomyślnego połączenia z jedną z sieci Wi-Fi podanych na mapie Wi-FiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcji ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsidToPsk	: Mapa identyfikatorów SSID Wi-Fi na hasła.
scanSsid	boolean : czy skanować w poszukiwaniu ukrytych identyfikatorów SSID dla tej sieci.

Zwroty
boolean	true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

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

połącz się z siecią Wi-Fi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

Włącza Wi-Fi i blokuje do momentu pomyślnego nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcji ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsid	String : identyfikator SSID Wi-Fi, z którym można się połączyć
wifiPsk	String : hasło PSK lub wartość null, jeśli nie jest szyfrowana

Zwroty
boolean	true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

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

połącz się z siecią Wi-Fi

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

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

Włącza Wi-Fi i blokuje do momentu pomyślnego nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, aż do wywołania funkcji ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsid	String : identyfikator SSID Wi-Fi, z którym można się połączyć
wifiPsk	String : hasło PSK lub wartość null, jeśli nie jest szyfrowana
scanSsid	boolean : czy skanować w poszukiwaniu ukrytego identyfikatora SSID dla tej sieci.

Zwroty
boolean	true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

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

połącz się z siecią Wifi 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 aktualnie nie ma połączenia z siecią.

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

Zwroty
boolean	true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

połącz się z siecią Wifi w razie potrzeby

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Zwroty
boolean	true , jeśli pomyślnie połączono się z siecią Wi-Fi. inaczej false

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Stwórz użytkownika

public abstract int createUser (String name)

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

Parametry
name	String : użytkownika, który ma zostać utworzony na urządzeniu

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Stwórz użytkownika

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

Utwórz użytkownika o podanej nazwie i podanych flagach

Parametry
name	String : użytkownika, który ma zostać utworzony na urządzeniu
guest	boolean : włącz flagę użytkownika --guest podczas tworzenia
ephemeral	boolean : włącz flagę użytkownika --ephemeral podczas tworzenia

Zwroty
int	identyfikator utworzonego użytkownika

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Stwórz użytkownika

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

Utwórz użytkownika o podanej nazwie i podanych flagach

Parametry
name	String : użytkownika, który ma zostać utworzony na urządzeniu
guest	boolean : włącz flagę użytkownika --guest podczas tworzenia
ephemeral	boolean : włącz flagę użytkownika --ephemeral podczas tworzenia
forTesting	boolean : włącz flagę testową --for-testing podczas tworzenia

Zwroty
int	identyfikator utworzonego użytkownika

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

utwórzUserNoThrow

public abstract int createUserNoThrow (String name)

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

Parametry
name	String : użytkownika, który ma zostać utworzony na urządzeniu

Zwroty
int	liczba całkowita dla utworzonego identyfikatora użytkownika lub -1 w przypadku błędu.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

wyrejestruj urządzenieActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver .

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

wyłącz Keyguarda

public abstract void disableKeyguard ()

Próba wyłączenia blokady klawiatury.

Najpierw poczekaj, aż wysyłanie danych wejściowych będzie gotowe. Dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ w bieżącej implementacji frameworka czasami zdarzają się wyścigi. Następnie wysyłane jest polecenie zwolnienia klawiatury (działa tylko na niezabezpieczonych)

Rzuca
DeviceNotAvailableException

wyłącz NetworkMonitor

public abstract boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwroty
boolean	true , jeśli monitorowanie zostało pomyślnie wyłączone. false jeśli się nie udało.

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

rozłącz się z Wi-Fi

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 pomyślnie rozłączono się z siecią Wi-Fi. false , jeśli rozłączenie nie powiodło się.

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

czy plik istnieje

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Metoda pomocnicza służąca do ustalenia, czy dla danego użytkownika istnieje plik na urządzeniu.

Parametry
deviceFilePath	String : bezwzględna ścieżka pliku na urządzeniu do sprawdzenia
userId	int : Identyfikator użytkownika, według którego sprawdzane jest istnienie pliku

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

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

sterta zrzutu

public abstract File dumpHeap (String process, 
                String devicePath)

Spróbuj zrzucić stertę z serwera systemowego. Oczyszczenie zrzuconego pliku jest obowiązkiem dzwoniącego.

Parametry
process	String : nazwa procesu urządzenia, na którym ma zostać zrzucony plik.
devicePath	String : ścieżka na urządzeniu, gdzie umieścić zrzut. Musi to być lokalizacja, w której pozwalają na to uprawnienia.

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

włączMonitor sieci

public abstract boolean enableNetworkMonitor ()

Umożliwia monitorowanie sieci na urządzeniu.

Zwroty
boolean	true , jeśli monitorowanie zostało pomyślnie włączone. false jeśli się nie udało.

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

pobierz ActiveApexy

public abstract  getActiveApexes ()

Pobierz informacje o APEXach aktywowanych na urządzeniu.

Zwroty
	ERROR(/Set) ApexInfo aktualnie aktywowanego na urządzeniu

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierzWszystkieUstawienia

public abstract  getAllSettings (String namespace)

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

Parametry
namespace	String : musi być jednym z {"system", "bezpieczny", "globalny"}

Zwroty
	mapa par klucz-wartość. Null, jeśli przestrzeń nazw nie jest obsługiwana.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz identyfikator Androida

public abstract String getAndroidId (int userId)

Znajdź i zwróć identyfikator Androida powiązany z identyfikatorem użytkownika, null, jeśli nie zostanie znaleziony.

Parametry
userId	int

Zwroty
String

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz identyfikatory Androida

public abstract  getAndroidIds ()

Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników. Nie ma gwarancji, że każdy identyfikator użytkownika znajdzie identyfikator Androida powiązany z tą funkcją, więc niektóre identyfikatory użytkowników mogą mieć wartość null.

Zwroty
	Znaleziono mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz informacje o pakiecie aplikacji

public abstract PackageInfo getAppPackageInfo (String packageName)

Pobierz informacje o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName	String

Zwroty
PackageInfo	PackageInfo lub null , jeśli nie można pobrać informacji

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierzInformacje o pakiecie aplikacji

public abstract  getAppPackageInfos ()

Pobierz informacje o pakietach zainstalowanych na urządzeniu.

Zwroty
	ERROR(/List) pakietów PackageInfo zainstalowanych na urządzeniu.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz raport błędów

public abstract InputStreamSource getBugreport ()

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

Implementacja tego gwarantuje dalszą pracę na urządzeniu bez karty SD (lub tam, gdzie karta SD nie jest jeszcze zamontowana).

Zwroty
InputStreamSource	InputStreamSource , które na żądanie wygeneruje treść raportu o błędach. W przypadku niepowodzenia InputStreamSource wygeneruje pusty ERROR(/InputStream) .

pobierz Bugreportz

public abstract InputStreamSource getBugreportz ()

Pobiera raport o błędach z urządzenia. Raport o błędach w formacie zip zawiera główny raport o błędach i inne pliki dziennika przydatne do debugowania.

Obsługiwane tylko dla „wersji adb”> 1.0.36

Zwroty
InputStreamSource	InputStreamSource pliku zip zawierającego raport o błędach, w przypadku niepowodzenia zwróć wartość null.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Zwroty
DeviceFoldableState

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz bieżącego użytkownika

public abstract int getCurrentUser ()

Zwróć identyfikator bieżącego uruchomionego użytkownika. W przypadku błędu zwróć -10000.

Zwroty
int

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Zwraca listę składanych stanów na urządzeniu. Można uzyskać za pomocą „cmd Device_state print-states”.

Zwroty

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

Zwroty
	ERROR(/Set) nazw pakietów String aktualnie zainstalowanych na urządzeniu.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz adres IP

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

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

pobierzKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany.

Zwroty
KeyguardControllerState	KeyguardControllerState zawierający migawkę stanu blokady klawiatury i zwraca Null, jeśli zapytanie Keyguard nie jest obsługiwane.

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

pobierzIdMainUserId

public abstract Integer getMainUserId ()

Zwraca główny identyfikator użytkownika.

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

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

pobierzMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Uzyskaj informacje o głównych modułach zainstalowanych na urządzeniu.

Zwroty
	ERROR(/Set) głównych modułów String aktualnie zainstalowanych na urządzeniu.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Zwroty
int	liczba całkowita wskazująca liczbę jednocześnie uruchomionych użytkowników

Rzuca
	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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierzOpcje

public abstract TestDeviceOptions getOptions ()

Pobierz opcje testowe dla urządzenia.

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

pobierz identyfikator użytkownika podstawowego

public abstract Integer getPrimaryUserId ()

Zwraca podstawowy identyfikator użytkownika.

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

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

pobierz zrzut ekranu

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Pobiera zrzut ekranu z urządzenia. Zalecane jest użycie getScreenshot(String) zamiast z kodowaniem JPEG w celu uzyskania mniejszego rozmiaru.

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

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz zrzut ekranu

public abstract InputStreamSource getScreenshot (String format)

Pobiera zrzut ekranu z urządzenia. Zalecane jest użycie getScreenshot(format) zamiast z kodowaniem JPEG w celu uzyskania mniejszego rozmiaru

Parametry
format	String : obsługiwany format PNG, JPEG

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz zrzut ekranu

public abstract InputStreamSource getScreenshot (long displayId)

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

DO ZROBIENIA: rozszerz powyższe implementacje, aby obsługiwały „formatowanie” i „przeskalowanie”

Parametry
displayId	long : identyfikator ekranu, z którego chcesz pobrać zrzut ekranu.

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

Rzuca
	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 się nie powiódł.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz ustawienie

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

Zwróć wartość żądanego ustawienia. przestrzeń nazw musi być jedną z: {"system", "secure", "global"}

Parametry
userId	int
namespace	String
key	String

Zwroty
String	wartość powiązana z przestrzenią nazw:kluczem użytkownika. Wartość null, jeśli nie została znaleziona.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz ustawienie

public abstract String getSetting (String namespace, 
                String key)

Zobacz getSetting(int, String, String) i wykonywane na użytkowniku systemowym.

Parametry
namespace	String
key	String

Zwroty
String

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie definiuje się je jako pakiety niesystemowe i zaktualizowane pakiety systemowe.

Zwroty
	ERROR(/Set) nazw pakietów String , które można odinstalować, aktualnie zainstalowanych na urządzeniu.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz flagi użytkownika

public abstract int getUserFlags (int userId)

Znajdź i zwróć flagi danego użytkownika. Flagi są zdefiniowane w klasie „android.content.pm.UserInfo” w projekcie Android Open Source.

Parametry
userId	int

Zwroty
int	flagi powiązane z identyfikatorem użytkownika, jeśli zostaną znalezione, -10000 w pozostałych przypadkach.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz informacje o użytkowniku

public abstract  getUserInfos ()

Pobiera mapę useId do UserInfo na urządzeniu. Zgłosi wyjątek DeviceRuntimeException jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.

Zwroty
	lista obiektów UserInfo.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

pobierz numer seryjny użytkownika

public abstract int getUserSerialNumber (int userId)

Jeśli zostanie znaleziony, zwróć numer seryjny powiązany z identyfikatorem użytkownika, w pozostałych przypadkach -10000.

Parametry
userId	int

Zwroty
int

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ma funkcję

public abstract boolean hasFeature (String feature)

Sprawdź, czy dana funkcja jest dostępna na urządzeniu.

Parametry
feature	String : jaki format powinien mieć „cechę: " Lub " „bezpośrednio.

Zwroty
boolean	Prawda, jeśli zostanie znaleziona funkcja, w przeciwnym razie fałsz.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

zainstaluj pakiet

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

Zainstaluj pakiet Android na urządzeniu.

Parametry
packageFile	File : plik apk do zainstalowania
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

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

zainstaluj pakiet

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

Zainstaluj pakiet Android na urządzeniu.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznaniem uprawnień wykonawczych w czasie instalacji.

Parametry
packageFile	File : plik apk do zainstalowania
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean : jeśli wszystkie uprawnienia wykonawcze powinny zostać przyznane podczas instalacji
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

Rzuca
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.
UnsupportedOperationException	jeśli platforma na urządzeniu nie obsługuje uprawnień wykonawczych.

zainstalujPakietDlaUżytkownika

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

Zainstaluj pakiet Android na urządzeniu dla danego użytkownika.

Parametry
packageFile	File : plik apk do zainstalowania
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
userId	int : całkowity identyfikator użytkownika, dla którego chcesz dokonać instalacji.
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

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

zainstalujPakietDlaUżytkownika

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

Zainstaluj pakiet Android na urządzeniu dla danego użytkownika.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznaniem uprawnień wykonawczych w czasie instalacji.

Parametry
packageFile	File : plik apk do zainstalowania
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean : jeśli wszystkie uprawnienia wykonawcze powinny zostać przyznane podczas instalacji
userId	int : całkowity identyfikator użytkownika, dla którego chcesz dokonać instalacji.
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

Rzuca
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.
UnsupportedOperationException	jeśli platforma na urządzeniu nie obsługuje uprawnień wykonawczych.

zainstaluj pakiety

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

Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden główny i dodatkowy pakiet podzielony). Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić plik APK na kilka plików.

Parametry
packageFiles	: lokalne pliki apk
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

Rzuca
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.
UnsupportedOperationException	jeśli platforma na urządzeniu nie obsługuje uprawnień wykonawczych.

zainstaluj pakiety

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

Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden główny i dodatkowy pakiet podzielony), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić plik APK na kilka plików.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznaniem uprawnień wykonawczych w czasie instalacji.

Parametry
packageFiles	: ścieżki zdalnych plików apk do zainstalowania
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean : jeśli wszystkie uprawnienia wykonawcze powinny zostać przyznane podczas instalacji
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

Rzuca
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.
UnsupportedOperationException	jeśli platforma na urządzeniu nie obsługuje uprawnień wykonawczych.

zainstalujPakietyDla Użytkownika

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

Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego pakietu głównego i dodatkowych pakietów podzielonych) dla danego użytkownika. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić plik APK na kilka plików.

Parametry
packageFiles	: lokalne pliki apk
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
userId	int : całkowity identyfikator użytkownika, dla którego chcesz dokonać instalacji.
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

Rzuca
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.
UnsupportedOperationException	jeśli platforma na urządzeniu nie obsługuje uprawnień wykonawczych.

zainstalujPakietyDla Użytkownika

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

Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego pakietu głównego i dodatkowych pakietów podzielonych) dla danego użytkownika. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić plik APK na kilka plików.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznaniem uprawnień wykonawczych w czasie instalacji.

Parametry
packageFiles	: lokalne pliki apk
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean : jeśli wszystkie uprawnienia wykonawcze powinny zostać przyznane podczas instalacji
userId	int : całkowity identyfikator użytkownika, dla którego chcesz dokonać instalacji.
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

Rzuca
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.
UnsupportedOperationException	jeśli platforma na urządzeniu nie obsługuje uprawnień wykonawczych.

zainstaluj pakiety zdalne

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

Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden główny i dodatkowy pakiet podzielony), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić plik APK na kilka plików.

Parametry
remoteApkPaths	: ścieżki zdalnych plików apk
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

Rzuca
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.
UnsupportedOperationException	jeśli platforma na urządzeniu nie obsługuje uprawnień wykonawczych.

zainstaluj pakiety zdalne

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

Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden główny i dodatkowy pakiet podzielony), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić plik APK na kilka plików.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznaniem uprawnień wykonawczych w czasie instalacji.

Parametry
remoteApkPaths	: ścieżki zdalnych plików apk
reinstall	boolean : true , jeśli należy przeprowadzić ponowną instalację
grantPermissions	boolean : jeśli wszystkie uprawnienia wykonawcze powinny zostać przyznane podczas instalacji
extraArgs	String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami.

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

Rzuca
DeviceNotAvailableException	jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go odzyskać.
UnsupportedOperationException	jeśli platforma na urządzeniu nie obsługuje uprawnień wykonawczych.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Zwraca informację, czy urządzenie korzysta z trybu użytkownika systemu bezgłowego.

Zwroty
boolean

Rzuca
DeviceNotAvailableException

isMainUserStały administrator

public abstract boolean isMainUserPermanentAdmin ()

Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani zmienić na inny niż administrator.

Zwroty
boolean

Rzuca
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

jestZainstalowany pakiet

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Zapytaj urządzenie o podaną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest ono aktualnie zainstalowane dla tego użytkownika.

Parametry
packageName	String : pakiet, który sprawdzamy, czy jest zainstalowany.
userId	String : Identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli ma wartość null, użyte zostanie zero użytkownika głównego.

Zwroty
boolean	Prawda, jeśli pakiet jest zgłaszany jako zainstalowany. Inaczej nieprawda.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

jestZainstalowany pakiet

public abstract boolean isPackageInstalled (String packageName)

Zapytaj urządzenie o podaną nazwę pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie.

Parametry
packageName	String

Zwroty
boolean	Prawda, jeśli pakiet jest zgłaszany jako zainstalowany. Inaczej nieprawda.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Sprawdź, czy dany użytkownik jest uruchomiony.

Parametry
userId	int

Zwroty
boolean	Prawda, jeśli użytkownik jest uruchomiony, fałsz w każdym innym przypadku.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

jestUserSecondary

public abstract boolean isUserSecondary (int userId)

Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym zgodnie z jego flagami.

Parametry
userId	int

Zwroty
boolean	true, jeśli użytkownik jest drugorzędny, false w przeciwnym razie.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

jestUżytkownikWidoczny

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 „człowiekiem” i w związku z tym może uruchamiać działania (zwykle na ekranie domyślnym).

Parametry
userId	int

Zwroty
boolean

Rzuca
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 „człowiekiem” i w związku z tym może uruchamiać działania na tym ekranie.

Parametry
userId	int
displayId	int

Zwroty
boolean

Rzuca
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Zwraca, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

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

Zwroty
boolean

Rzuca
DeviceNotAvailableException

isVisibleBackgroundUsersobsługiwane

public abstract boolean isVisibleBackgroundUsersSupported ()

Zwraca informację, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle.

Jeśli tak, możesz wywołać startVisibleBackgroundUser(int, int, boolean) , przekazując ekran zwrócony przez listDisplayIdsForStartingVisibleBackgroundUsers() .

Zwroty
boolean

Rzuca
DeviceNotAvailableException

jest włączone Wi-Fi

public abstract boolean isWifiEnabled ()

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

Sprawdza, czy na urządzeniu jest włączone Wi-Fi. Przydatne do sprawdzania stanu Wi-Fi przed testami, które nie powinny działać z Wi-Fi, np. testami mobilnej transmisji danych.

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

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

listaDisplayIds

public abstract  listDisplayIds ()

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

Zwroty
	Lista wyświetlaczy. Domyślne zawsze zwraca domyślny wyświetlacz 0.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Pobiera listę ekranów, których można użyć do start a user visible in the background .

Zwroty

Rzuca
DeviceNotAvailableException

listaUżytkownicy

public abstract  listUsers ()

Pobiera listę użytkowników na urządzeniu. Zgłosi wyjątek DeviceRuntimeException jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.

Zwroty
	lista identyfikatorów użytkowników.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBłędny raport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Metoda pomocnicza umożliwiająca przyjęcie raportu o błędzie i zalogowanie go do reporterów.

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

Zwroty
boolean	Prawda, jeśli rejestrowanie powiodło się, w przeciwnym razie fałsz.

powiadom Snapuserda

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Powiadom urządzenie, aby oczekiwało na zakończenie snapuserd.

Parametry
waitPhase	SnapuserdWaitPhase

zarejestruj odbiorcę akcji urządzenia

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver dla tego urządzenia.

Wszyscy zarejestrowani IDeviceActionReceiver zostaną powiadomieni przed rozpoczęciem akcji na urządzeniu i po jej zakończeniu.

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

usuńAdministratora

public abstract boolean removeAdmin (String componentName, 
                int userId)

Usuń danego administratora urządzenia dla danego użytkownika i zwróć true , jeśli się powiedzie, false w przeciwnym razie.

Parametry
componentName	String : administratora urządzenia, który ma zostać usunięty.
userId	int : użytkownika, w którym mieszka administrator urządzenia.

Zwroty
boolean	Prawda, jeśli się powiedzie, fałsz w przeciwnym razie.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuń właścicieli

public abstract void removeOwners ()

Usuń wszystkich istniejących właścicieli profili urządzeń, dokładając wszelkich starań.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuń użytkownika

public abstract boolean removeUser (int userId)

Usuń danego użytkownika z urządzenia.

Parametry
userId	int : użytkownika do usunięcia

Zwroty
boolean	true, jeśli pomyślnie usunęliśmy użytkownika, false w przeciwnym razie.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ustaw właściciela urządzenia

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Parametry
componentName	String : administrator urządzenia ma być właścicielem urządzenia.
userId	int : użytkownika, w którym mieszka właściciel urządzenia.

Zwroty
boolean	Prawda, jeśli się powiedzie, fałsz w przeciwnym razie.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ustawUstawienie

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

Zobacz setSetting(int, String, String, String) i wykonaj na użytkowniku systemowym.

Parametry
namespace	String
key	String
value	String

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ustawUstawienie

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. przestrzeń nazw musi być jedną z: {"system", "secure", "global"}

Parametry
userId	int
namespace	String
key	String
value	String

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

uruchom użytkownika

public abstract boolean startUser (int userId)

Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda jest NOOP.

Parametry
userId	int : użytkownika, aby rozpocząć w tle

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

uruchom użytkownika

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda jest NOOP. Możliwość zapewnienia dodatkowej flagi oczekującej na efekt operacji.

Parametry
userId	int : użytkownika, aby rozpocząć w tle
waitFlag	boolean : sprawi, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUżytkownik

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

Uruchamia danego użytkownika w tle, widocznym na danym ekranie (tzn. umożliwiając użytkownikowi uruchomienie działań 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żytkownika, aby rozpocząć w tle
displayId	int : wyświetlacz, na którym użytkownik będzie widoczny
waitFlag	boolean : sprawi, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.

Zwroty
boolean	true , jeśli użytkownik został pomyślnie uruchomiony, widoczny w tle.

Rzuca
DeviceNotAvailableException

zatrzymajUżytkownika

public abstract boolean stopUser (int userId)

Zatrzymuje danego użytkownika. Jeśli użytkownik został już zatrzymany, ta metoda jest NOOP. Nie można zatrzymać bieżącego użytkownika i użytkownika systemowego.

Parametry
userId	int : użytkownika, aby zatrzymać.

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

zatrzymajUżytkownika

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

Zatrzymaj danego użytkownika. Możliwość dostarczenia dodatkowych flag oczekujących na efekt operacji i wymuszenia zakończenia działania użytkownika. Nie można zatrzymać bieżącego użytkownika i użytkownika systemowego.

Parametry
userId	int : użytkownika, aby zatrzymać.
waitFlag	boolean : sprawi, że polecenie będzie czekać, aż użytkownik zostanie zatrzymany.
forceFlag	boolean : wymusi zatrzymanie użytkownika.

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

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Zmień użytkownika

public abstract boolean switchUser (int userId)

Przełącz na inny identyfikator użytkownika z domyślnym limitem czasu. switchUser(int, long) .

Parametry
userId	int

Zwroty
boolean	Wartość true, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. Inaczej nieprawda.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Zmień użytkownika

public abstract boolean switchUser (int userId, 
                long timeout)

Przełącz na inny identyfikator użytkownika z podanym limitem czasu jako ostatecznym terminem. Próba wyłączenia blokady klawiatury po pomyślnej zmianie użytkownika.

Parametry
userId	int
timeout	long : czekać przed zwróceniem wartości false w przypadku niepowodzenia przełączania użytkownika.

Zwroty
boolean	Wartość true, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. Inaczej nieprawda.

Rzuca
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

weź raport Bugre

public abstract Bugreport takeBugreport ()

Weź raport o błędzie i zwróć go do obiektu Bugreport , aby go obsłużyć. W przypadku problemu zwróć wartość null. Plik, do którego odwołuje się obiekt Bugreport, należy wyczyścić za pomocą Bugreport.close() .

Zwroty
Bugreport

odinstaluj pakiet

public abstract String uninstallPackage (String packageName)

Odinstaluj pakiet Androida z urządzenia.

Parametry
packageName	String : pakiet Androida do odinstalowania

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

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

odinstalujPakietForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Parametry
packageName	String : pakiet Androida do odinstalowania
userId	int : całkowity identyfikator użytkownika, dla którego chcesz odinstalować.

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

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

poczekaj na Snapuserda

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Jeśli jest to oczekiwane, poczekaj na zakończenie snapuserd.

Parametry
currentPhase	SnapuserdWaitPhase

Rzuca
DeviceNotAvailableException