ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

Ponawia polecenia urządzenia w konfigurowalnej ilości i zapewnia interfejs odzyskiwania urządzenia dla urządzeń, które nie odpowiadają.

Streszczenie

Klasy zagnieżdżone

class ITestDevice.ApexInfo

Prosta klasa struktury do przechowywania informacji o pojedynczym APEX

class ITestDevice.MountPointInfo

Prosta klasa struktury do przechowywania informacji o pojedynczym punkcie montowania

Metody publiczne

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

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

abstract boolean clearErrorDialogs ()

Spróbuj odrzucić wszystkie okna dialogowe błędów wyświetlane obecnie w interfejsie urządzenia.

abstract void clearLastConnectedWifiNetwork ()

Czyści ostatnio podłączoną sieć Wi-Fi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

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

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Łą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 nie ma obecnie łączności sieciowej.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Wariant connectToWifiNetwork(String, String) , który łączy się tylko wtedy, gdy urządzenie nie ma obecnie łączności sieciowej.

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, boolean forTesting)

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

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

Utwórz użytkownika o podanej nazwie i dostarczonych 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ó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 pomocnika w celu określenia, czy plik na urządzeniu istnieje dla danego użytkownika.

abstract File dumpHeap (String process, String devicePath)

Spróbuj zrzucić stertę z serwera system_server.

abstract boolean enableNetworkMonitor ()

Włącza monitorowanie sieci na urządzeniu.

abstract getActiveApexes ()

Pobierz informacje o aktywowanych na urządzeniu APEXach.

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 został 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łędzie z urządzenia.

abstract DeviceFoldableState getCurrentFoldableState ()

Zwraca bieżący stan składania urządzenia lub wartość null, jeśli wystąpiły 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 obecnych na urządzeniu.

abstract String getIpAddress ()

Pobiera adres IP urządzenia.

abstract KeyguardControllerState getKeyguardState ()

Zwróć obiekt, aby uzyskać aktualny stan blokady klawiatury lub wartość null, jeśli nie jest obsługiwana.

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 główny identyfikator użytkownika.

abstract InputStreamSource getScreenshot ()

Pobiera zrzut ekranu z urządzenia.

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)

Przechwytuje zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza.

abstract String getSetting (String namespace, String key)

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

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

Zwróć wartość żądanego ustawienia.

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)

Zwróć numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, -10000 w innych przypadkach.

abstract boolean hasFeature (String feature)

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

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

Zainstaluj pakiet Androida na urządzeniu.

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

Zainstaluj pakiet Androida na urządzeniu.

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

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

abstract String installPackageForUser (File packageFile, boolean reinstall, 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 składającą się z kilku plików APK (jeden główny i dodatkowy podzielony pakiet).

default String installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) 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 dodatkowy podzielony pakiet), które znajdują się na urządzeniu z Androidem.

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 (jeden pakiet główny i dodatkowe pakiety dzielone) dla danego użytkownika.

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 (jeden pakiet główny i dodatkowe pakiety dzielone) dla danego użytkownika.

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowy podzielony pakiet), 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 składającą się z kilku plików APK (jeden główny i dodatkowy podzielony pakiet), które znajdują się na urządzeniu z Androidem.

abstract boolean isHeadlessSystemUserMode ()

Zwraca informację, czy urządzenie używa trybu użytkownika systemu bezobsługowego.

abstract boolean isMainUserPermanentAdmin ()

Zwraca informację, czy główny użytkownik jest stałym administratorem i nie może zostać usunięty ani zdegradowany do statusu innego niż administrator.

abstract boolean isMultiUserSupported ()

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

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

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

abstract boolean isUserRunning (int userId)

Sprawdź, czy dany użytkownik jest uruchomiony.

abstract boolean isUserSecondary (int userId)

Zwraca, czy określony użytkownik jest użytkownikiem drugorzędnym 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 ekranie.

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, 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, zgłoszoną przez „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, aby zgłosić błąd i zalogować go do reporterów.

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver dla tego urządzenia.

abstract boolean removeAdmin (String componentName, int userId)

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

abstract void removeOwners ()

Jak najlepiej usuń wszystkich istniejących właścicieli profili urządzeń.

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, widocznego na danym ekranie (tj. pozwalając użytkownikowi na uruchamianie działań na tym ekranie).

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

Zatrzymaj danego użytkownika.

abstract boolean stopUser (int userId)

Zatrzymuje danego użytkownika.

abstract boolean switchUser (int userId)

Przełącz się na inny identyfikator użytkownika z domyślnym limitem czasu.

abstract boolean switchUser (int userId, long timeout)

Przełącz się na inny identyfikator użytkownika z podanym limitem czasu jako 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.

Metody publiczne

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Zwroty
boolean

Rzuty
DeviceNotAvailableException

sprawdź Łączność

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 overover.

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

wyczyść dialogi błędów

public abstract boolean clearErrorDialogs ()

Spróbuj odrzucić wszystkie okna dialogowe błędów wyświetlane obecnie w interfejsie urządzenia.

Zwroty
boolean true Jeśli żadne okna dialogowe nie były obecne lub okna dialogowe zostały pomyślnie wyczyszczone. false inaczej.

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

wyczyść ostatnią połączoną sieć Wi-Fi

public abstract void clearLastConnectedWifiNetwork ()

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

połącz z siecią Wi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

Włącza Wi-Fi i blokuje do momentu pomyślnego nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana 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 z siecią Wi-Fi. false inaczej

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

połącz z siecią Wi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

Włącza Wi-Fi i blokuje do momentu pomyślnego nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana 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 z siecią Wi-Fi. false inaczej

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

połącz z siecią Wi-Fi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

Włącza Wi-Fi i blokuje, dopóki nie zostanie pomyślnie nawiązane połączenie 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, dopóki nie zostanie wywołana ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsid String : identyfikator SSID Wi-Fi, z którym należy się połączyć

wifiPsk String : hasło PSK lub wartość null, jeśli nie jest zaszyfrowana

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

połącz 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, dopóki nie zostanie pomyślnie nawiązane połączenie 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, dopóki nie zostanie wywołana ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .

Parametry
wifiSsid String : identyfikator SSID Wi-Fi, z którym należy się połączyć

wifiPsk String : hasło PSK lub wartość null, jeśli nie jest zaszyfrowana

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

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

Połącz z siecią Wi-Fi 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 łączności sieciowej.

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

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Połącz z siecią Wi-Fi 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 łączności sieciowej.

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

Rzuty
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 do utworzenia na urządzeniu

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

Rzuty
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 dostarczonych flagach

Parametry
name String : użytkownika do utworzenia 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

Rzuty
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 dostarczonych flagach

Parametry
name String : użytkownika do utworzenia 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

Rzuty
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 do utworzenia na urządzeniu

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

wyrejestruj urządzenieDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver .

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

wyłącz ochronę klawiatury

public abstract void disableKeyguard ()

Próby wyłączenia blokady klawiatury.

Najpierw poczekaj, aż wysyłka danych wejściowych będzie gotowa, dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna implementacja frameworka ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie usunięcia blokady klawiatury (działa tylko na niezabezpieczonych)

Rzuty
DeviceNotAvailableException

wyłączMonitor sieci

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 powiodło.

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

czyPlikIstnieje

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Metoda pomocnika w celu określenia, czy plik na urządzeniu istnieje dla danego użytkownika.

Parametry
deviceFilePath String : bezwzględna ścieżka do pliku na urządzeniu do sprawdzenia

userId int : Identyfikator użytkownika, względem którego należy sprawdzić istnienie pliku

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

sterta zrzutu

public abstract File dumpHeap (String process, 
                String devicePath)

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

Parametry
process String : nazwa procesu urządzenia, na którym ma zostać zrzut.

devicePath String : ścieżka na urządzeniu, gdzie umieścić zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia.

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

włączMonitor sieci

public abstract boolean enableNetworkMonitor ()

Włącza monitorowanie sieci na urządzeniu.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

getActiveApexy

public abstract  getActiveApexes ()

Pobierz informacje o aktywowanych na urządzeniu APEXach.

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz wszystkie ustawienia

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.

Rzuty
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 został znaleziony.

Parametry
userId int

Zwroty
String

Rzuty
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ą być zgodne z wartością null.

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

Rzuty
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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Pobierz informacje o pakietach zainstalowanych na urządzeniu.

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierz raport Bugre

public abstract InputStreamSource getBugreport ()

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

Wdrożenie tego gwarantuje kontynuację pracy na urządzeniu bez karty SD (lub tam, gdzie karta SD nie jest jeszcze zamontowana).

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

pobierz Bugreportz

public abstract InputStreamSource getBugreportz ()

Pobiera raport o błędzie z urządzenia. Raport o błędzie w formacie ZIP zawiera główny raport o błędzie i inne pliki dziennika, które są przydatne do debugowania.

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

Zwroty
InputStreamSource InputStreamSource pliku zip zawierającego bugreportz, zwróć null w przypadku niepowodzenia.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Zwroty
DeviceFoldableState

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pobierzCurrentUser

public abstract int getCurrentUser ()

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

Zwroty
int

Rzuty
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

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 aktualnie zainstalowanych na urządzeniu.

Rzuty
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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Zwróć obiekt, aby uzyskać aktualny stan blokady klawiatury lub wartość null, jeśli nie jest obsługiwana.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

getGłówny identyfikator użytkownika

public abstract Integer getMainUserId ()

Zwraca główny identyfikator użytkownika.

Zwroty
Integer userId głównego użytkownika, jeśli istnieje, i 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 głównych modułach zainstalowanych na urządzeniu.

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

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ślnie 0.

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxLiczba obsługiwanych użytkowników

public abstract int getMaxNumberOfUsersSupported ()

Uzyskaj maksymalną liczbę obsługiwanych użytkowników. Domyślnie 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 główny identyfikator użytkownika.

Zwroty
Integer userId głównego użytkownika, jeśli istnieje, i 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

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

pobierz zrzut ekranu

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Pobiera zrzut ekranu z urządzenia. Zalecane użycie getScreenshot(String) zamiast kodowania JPEG dla mniejszego rozmiaru.

Parametry
format String : obsługiwany PNG, JPEG

rescale boolean : jeśli zrzut ekranu powinien zostać przeskalowany, aby 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

pobierz zrzut ekranu

public abstract InputStreamSource getScreenshot (String format)

Pobiera zrzut ekranu z urządzenia. Zalecane użycie getScreenshot(format) zamiast kodowania JPEG dla mniejszego rozmiaru

Parametry
format String : obsługiwany 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 (long displayId)

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

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

Parametry
displayId long : identyfikator ekranu, z którego ma zostać pobrany 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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parametry
namespace String

key String

Zwroty
String

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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:klucz użytkownika. Wartość null, jeśli nie została znaleziona.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Pobierz nazwy pakietów aplikacji, które można odinstalować. Jest to obecnie definiowane jako pakiety niesystemowe i zaktualizowane pakiety systemowe.

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

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 skojarzone z podanym identyfikatorem użytkownika, jeśli zostały znalezione, -10000 we wszystkich innych przypadkach.

Rzuty
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 będą zgodne z oczekiwaniami.

Zwroty
lista obiektów UserInfo.

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

pobierz numer seryjny użytkownika

public abstract int getUserSerialNumber (int userId)

Zwróć numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, -10000 w innych przypadkach.

Parametry
userId int

Zwroty
int

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

maFunkcja

public abstract boolean hasFeature (String feature)

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

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

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pakiet instalacyjny

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

Zainstaluj pakiet Androida 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 shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

pakiet instalacyjny

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

Zainstaluj pakiet Androida na urządzeniu.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają jawnej kontroli przyznawania uprawnień w czasie wykonywania podczas instalacji.

Parametry
packageFile File : plik apk do zainstalowania

reinstall boolean : true , jeśli należy przeprowadzić ponowną instalację

grantPermissions boolean : jeśli wszystkie uprawnienia w czasie wykonywania powinny zostać przyznane w czasie instalacji

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.
UnsupportedOperationException jeśli uprawnienia w czasie wykonywania nie są obsługiwane przez platformę na urządzeniu.

zainstaluj pakiet dla uż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ą jawnej kontroli przyznawania uprawnień w czasie wykonywania podczas instalacji.

Parametry
packageFile File : plik apk do zainstalowania

reinstall boolean : true , jeśli należy przeprowadzić ponowną instalację

grantPermissions boolean : jeśli wszystkie uprawnienia w czasie wykonywania powinny zostać przyznane w czasie instalacji

userId int : całkowity identyfikator użytkownika, dla którego ma zostać zainstalowana.

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.
UnsupportedOperationException jeśli uprawnienia w czasie wykonywania nie są obsługiwane przez platformę na urządzeniu.

zainstaluj pakiet dla uż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 ma zostać zainstalowana.

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

zainstaluj pakiety

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowy podzielony pakiet). Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, aby dowiedzieć się, jak podzielić 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 shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.
UnsupportedOperationException jeśli uprawnienia w czasie wykonywania nie są obsługiwane przez platformę na urządzeniu.

zainstaluj pakiety

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 dodatkowy podzielony pakiet), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, aby dowiedzieć się, jak podzielić apk na kilka plików.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają jawnej kontroli przyznawania uprawnień w czasie wykonywania podczas instalacji.

Parametry
packageFiles : zdalne ścieżki plików apk do zainstalowania

reinstall boolean : true , jeśli należy przeprowadzić ponowną instalację

grantPermissions boolean : jeśli wszystkie uprawnienia w czasie wykonywania powinny zostać przyznane w czasie instalacji

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.
UnsupportedOperationException jeśli uprawnienia w czasie wykonywania nie są obsługiwane przez platformę na urządzeniu.

installPakietyDlaUż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 (jeden pakiet główny i dodatkowe pakiety dzielone) dla danego użytkownika. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, aby dowiedzieć się, jak podzielić apk na kilka plików.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają jawnej kontroli przyznawania uprawnień w czasie wykonywania podczas instalacji.

Parametry
packageFiles : lokalne pliki apk

reinstall boolean : true , jeśli należy przeprowadzić ponowną instalację

grantPermissions boolean : jeśli wszystkie uprawnienia w czasie wykonywania powinny zostać przyznane w czasie instalacji

userId int : całkowity identyfikator użytkownika, dla którego ma zostać zainstalowana.

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.
UnsupportedOperationException jeśli uprawnienia w czasie wykonywania nie są obsługiwane przez platformę na urządzeniu.

installPakietyDlaUżytkownika

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

Zainstaluj aplikację na Androida złożoną z kilku plików APK (jeden pakiet główny i dodatkowe pakiety dzielone) dla danego użytkownika. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, aby dowiedzieć się, jak podzielić 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 ma zostać zainstalowana.

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.
UnsupportedOperationException jeśli uprawnienia w czasie wykonywania 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 dodatkowy podzielony pakiet), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, aby dowiedzieć się, jak podzielić apk na kilka plików.

Parametry
remoteApkPaths : zdalne ścieżki plików apk

reinstall boolean : true , jeśli należy przeprowadzić ponowną instalację

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.
UnsupportedOperationException jeśli uprawnienia w czasie wykonywania 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 podzielony pakiet), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, aby dowiedzieć się, jak podzielić apk na kilka plików.

Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają jawnej kontroli przyznawania uprawnień w czasie wykonywania podczas instalacji.

Parametry
remoteApkPaths : zdalne ścieżki plików apk

reinstall boolean : true , jeśli należy przeprowadzić ponowną instalację

grantPermissions boolean : jeśli wszystkie uprawnienia w czasie wykonywania powinny zostać przyznane w czasie instalacji

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.
UnsupportedOperationException jeśli uprawnienia w czasie wykonywania nie są obsługiwane przez platformę na urządzeniu.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Zwraca informację, czy urządzenie używa trybu użytkownika systemu bezobsługowego.

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Zwraca informację, czy główny użytkownik jest stałym administratorem i nie może zostać usunięty ani zdegradowany do statusu innego niż administrator.

Zwroty
boolean

Rzuty
DeviceNotAvailableException

jest obsługiwany przez wielu użytkowników

public abstract boolean isMultiUserSupported ()

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

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

jest zainstalowany pakiet

public abstract boolean isPackageInstalled (String packageName)

Zapytaj urządzenie o daną 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. Fałsz inaczej.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

jest zainstalowany pakiet

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Zapytaj urządzenie o daną 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. W przypadku wartości null zostanie użyte zero użytkownika podstawowego.

Zwroty
boolean Prawda, jeśli pakiet jest zgłaszany jako zainstalowany. Fałsz inaczej.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

jest uruchomionym użytkownikiem

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 we wszystkich innych przypadkach.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parametry
userId int

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

jest widoczny dla użytkownika

public abstract boolean isUserVisible (int userId)

Sprawdza, czy dany użytkownik jest widoczny.

Użytkownik „widoczny” to użytkownik, który wchodzi w interakcję z użytkownikiem „człowiekiem”, a zatem może uruchamiać działania uruchamiania (zwykle w domyślnym ekranie).

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 ekranie.

Użytkownik „widoczny” to użytkownik, który wchodzi w interakcję z użytkownikiem „człowiekiem”, a zatem może uruchamiać działania na tym ekranie.

Parametry
userId int

displayId int

Zwroty
boolean

Rzuty
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

Rzuty
DeviceNotAvailableException

isVisibleBackgroundUsersObsługiwani

public abstract boolean isVisibleBackgroundUsersSupported ()

Zwraca, 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

Rzuty
DeviceNotAvailableException

czy Wi-Fi jest włączone

public abstract boolean isWifiEnabled ()

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

Sprawdza, czy w urządzeniu jest włączone Wi-Fi. Przydatne do potwierdzania statusu Wi-Fi przed testami, które nie powinny być uruchamiane z Wi-Fi, np. testami danych mobilnych.

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

Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostało utracone i nie można go odzyskać.

lista Wyświetlane identyfikatory

public abstract  listDisplayIds ()

Zbierz listę dostępnych identyfikatorów wyświetlaczy na urządzeniu, zgłoszoną przez „dumpsys SurfaceFlinger”.

Zwroty
Lista wyświetlaczy. Default zawsze zwraca domyślne wyświetlanie 0.

Rzuty
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

Rzuty
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 będą zgodne z oczekiwaniami.

Zwroty
lista identyfikatorów użytkowników.

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

dziennik Bugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Metoda pomocnicza, aby zgłosić błąd i zalogować 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 się powiodło, w przeciwnym razie fałsz.

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver dla tego urządzenia.

Wszystkie zarejestrowane identyfikatory IDeviceActionReceiver zostaną powiadomione przed rozpoczęciem akcji urządzenia i po zakończeniu akcji urządzenia.

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

usuńAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

Parametry
componentName String : administratora urządzenia do usunięcia.

userId int : użytkownika, w którym mieszka administrator urządzenia.

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

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuńWłaściciele

public abstract void removeOwners ()

Jak najlepiej usuń wszystkich istniejących właścicieli profili urządzeń.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Remove a given user from the device.

Parametry
userId int : of the user to remove

Zwroty
boolean true if we were successful in removing the user, false otherwise.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Parametry
componentName String : of device admin to be device owner.

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

Zwroty
boolean True if it is successful, false otherwise.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

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

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)

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

Parametry
userId int

namespace String

key String

value String

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

Parametry
userId int : of the user to start in the background

Zwroty
boolean true if the user was successfully started in the background.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

Parametry
userId int : of the user to start in the background

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

Zwroty
boolean true if the user was successfully started in the background.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

Parametry
userId int : of the user to start in the background

displayId int : display to start user visible on

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

Zwroty
boolean true if the user was successfully started visible in the background.

Rzuty
DeviceNotAvailableException

stopUser

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

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

Parametry
userId int : of the user to stop.

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

forceFlag boolean : will force stop the user.

Zwroty
boolean true if the user was successfully stopped.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

Parametry
userId int : of the user to stop.

Zwroty
boolean true if the user was successfully stopped.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

Parametry
userId int

Zwroty
boolean True if the new userId matches the userId provider. False otherwise.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

Parametry
userId int

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

Zwroty
boolean True if the new userId matches the userId provider. False otherwise.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

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

Zwroty
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

Parametry
packageName String : the Android package to uninstall

Zwroty
String a String with an error code, or null if success.

Rzuty
DeviceNotAvailableException if connection with device is lost and cannot be recovered.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

Parametry
packageName String : the Android package to uninstall

userId int : the integer user id to uninstall for.

Zwroty
String a String with an error code, or null if success.

Rzuty
DeviceNotAvailableException if connection with device is lost and cannot be recovered.