ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

Powtarza polecenia urządzenia przez konfigurowalną liczbę razy i zapewnia interfejs odzyskiwania urządzenia w przypadku urządzeń, które nie odpowiadają.

Podsumowanie

Zagnieżdżone klasy

class ITestDevice.ApexInfo

Prosta klasa struktury do przechowywania informacji o pojedynczym APEX

class ITestDevice.MountPointInfo

Prosta klasa struktury do przechowywania informacji o pojedynczym punkcie zamontowania.

Metody publiczne

abstract boolean canSwitchToHeadlessSystemUser()

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

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

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

abstract void clearLastConnectedWifiNetwork()

Czyści ostatnią połączoną sieć Wi-Fi.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

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

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

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

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

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

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

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

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

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

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

abstract int createUser(String name)

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

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

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

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

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

abstract int createUserNoThrow(String name)

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

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

abstract void disableKeyguard()

Próbuje wyłączyć blokadę klawiatury.

abstract boolean disableNetworkMonitor()

Wyłącza monitorowanie sieci na urządzeniu.

abstract boolean disconnectFromWifi()

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

abstract boolean doesFileExist(String deviceFilePath, int userId)

Metoda pomocnicza służąca do określenia, czy plik na urządzeniu danego użytkownika istnieje.

abstract File dumpHeap(String process, String devicePath)

Spróbuj zrzucić stos z system_server.

abstract boolean enableNetworkMonitor()

Umożliwia monitorowanie sieci na urządzeniu.

abstract getActiveApexes()

Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.

abstract getAllSettings(String namespace)

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

abstract String getAndroidId(int userId)

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

abstract getAndroidIds()

Tworzenie mapy identyfikatorów Androida, które pasują do identyfikatorów użytkowników.

abstract PackageInfo getAppPackageInfo(String packageName)

Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.

abstract getAppPackageInfos()

Pobierać informacje o pakietach zainstalowanych na urządzeniu.

abstract InputStreamSource getBugreport()

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

abstract InputStreamSource getBugreportz()

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

abstract DeviceFoldableState getCurrentFoldableState()

Zwraca bieżący stan urządzenia, które można złożyć, lub wartość null, jeśli wystąpiły jakieś problemy.

abstract int getCurrentUser()

Zwraca identyfikator bieżącego użytkownika.

abstract getFoldableStates()

Zwraca listę stanów składania urządzenia.

abstract getInstalledPackageNames()

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

abstract String getIpAddress()

Pobiera adres IP urządzenia.

abstract KeyguardControllerState getKeyguardState()

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

abstract Integer getMainUserId()

Zwraca identyfikator głównego użytkownika.

abstract getMainlineModuleInfo()

Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.

abstract int getMaxNumberOfRunningUsersSupported()

Pobierz maksymalną liczbę obsługiwanych jednocześnie użytkowników.

abstract int getMaxNumberOfUsersSupported()

Uzyskaj maksymalną liczbę obsługiwanych użytkowników.

abstract TestDeviceOptions getOptions()

Pobierz opcje testowania urządzenia.

abstract Integer getPrimaryUserId()

Ta metoda została wycofana. W usłudze UserManager funkcja getPrimaryUser została wycofana. Użyj parametru ERROR(/android.os.UserManager#getMainUserId()), aby uzyskać pełny identyfikator pierwszego użytkownika, lub 0, aby uzyskać identyfikator systemu. Pamiętaj, że w przypadku systemu bez głowy nie jest to pełny użytkownik.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Robi zrzut ekranu z urządzenia.

abstract InputStreamSource getScreenshot(long displayId)

Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania.

abstract InputStreamSource getScreenshot(String format)

Robi zrzut ekranu z urządzenia.

abstract InputStreamSource getScreenshot()

Robi zrzut ekranu z urządzenia.

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

Zwraca wartość żądanego ustawienia.

abstract String getSetting(String namespace, String key)

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

abstract getUninstallablePackageNames()

Pobierz nazwy pakietów aplikacji, które można odinstalować.

abstract int getUserFlags(int userId)

Znajdowanie i zwracanie flag danego użytkownika.

abstract getUserInfos()

Pobiera mapę useId na urządzeniu do UserInfo.

abstract int getUserSerialNumber(int userId)

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

abstract boolean hasFeature(String feature)

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

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

Zainstaluj na urządzeniu pakiet Androida.

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

Zainstaluj na urządzeniu pakiet Androida.

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

Zainstaluj pakiet Androida na urządzeniu danego użytkownika.

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

Zainstaluj pakiet Androida na urządzeniu danego użytkownika.

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

Instalowanie aplikacji na Androida utworzonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone).

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.

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

Instalowanie aplikacji na Androida utworzonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone) dla danego użytkownika.

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

Instalowanie aplikacji na Androida utworzonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone) dla danego użytkownika.

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.

abstract boolean isHeadlessSystemUserMode()

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

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

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

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

Wysłać zapytanie do urządzenia o określonej nazwie pakietu, aby sprawdzić, czy jest on zainstalowany.

abstract boolean isUserRunning(int userId)

Sprawdź, czy dany użytkownik jest obecny.

abstract boolean isUserSecondary(int userId)

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

abstract boolean isUserVisible(int userId)

Sprawdzanie, czy dany użytkownik jest widoczny.

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

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

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

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

abstract listDisplayIds()

Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys SurfaceFlinger”.

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

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

abstract listUsers()

Pobiera listę użytkowników na urządzeniu.

abstract boolean logBugreport(String dataName, ITestLogger listener)

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

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

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

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver na tym urządzeniu.

abstract boolean removeAdmin(String componentName, int userId)

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

abstract void removeOwners()

Usuń wszystkich dotychczasowych właścicieli profilu urządzenia, stosując zasadę możliwie najlepszej obsługi.

abstract boolean removeUser(int userId)

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

abstract boolean setDeviceOwner(String componentName, int userId)

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

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

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

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

Dodaje wartość ustawienia do przestrzeni nazw danego użytkownika.

abstract boolean startUser(int userId)

Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.

abstract boolean startUser(int userId, boolean waitFlag)

Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.

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

Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać czynności na tym wyświetlaczu).

abstract boolean stopUser(int userId)

Zatrzymuje danego użytkownika.

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

Zatrzymanie danego użytkownika.

abstract boolean switchUser(int userId)

Przełącz się na innego użytkownika o domyślnym czasie oczekiwania.

abstract boolean switchUser(int userId, long timeout)

Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem.

abstract Bugreport takeBugreport()

Przyjmuje zgłoszenie o błędzie i zwraca je w obiekcie Bugreport, aby je obsłużyć.

abstract String uninstallPackage(String packageName)

Odinstaluj pakiet Androida z urządzenia.

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

W razie potrzeby poczekaj, aż snapuserd zakończy działanie.

Metody publiczne

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Zwroty
boolean

Rzuty
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

Zwroty
boolean true jeśli urządzenie ma aktywne połączenie z siecią, false w przeciwnym razie.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Zwroty
boolean true, jeśli nie było żadnych dialogów lub zostały one usunięte. false w innych przypadkach.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

Parametry
wifiSsidToPsk : mapa identyfikatorów SSID sieci Wi-Fi z hasłami.
Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

Parametry
wifiSsidToPsk : mapa identyfikatorów SSID sieci Wi-Fi z hasłami.
scanSsid boolean: czy skanować ukryte identyfikatory SSID tej sieci.
Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

Parametry
wifiSsid String: nazwa sieci Wi-Fi, z którą chcesz się połączyć
wifiPsk String: hasło PSK lub null, jeśli nie jest zaszyfrowane
Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

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

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

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

Parametry
wifiSsid String: nazwa sieci Wi-Fi, z którą chcesz się połączyć
wifiPsk String: hasło PSK lub null, jeśli nie jest zaszyfrowane
scanSsid boolean: czy skanować ukryte identyfikatory SSID tej sieci.
Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetworkIfNeeded

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

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

Parametry
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Zwroty
boolean true jeśli urządzenie jest połączone z siecią Wi-Fi. falsew innym przypadku
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

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

Parametry
name String: użytkownika, którego należy utworzyć na urządzeniu
Zwroty
int liczba całkowita identyfikatora użytkownika,
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

Parametry
name String: użytkownika, którego należy utworzyć na urządzeniu
guest boolean: włącz flagę użytkownika – gość podczas tworzenia.
ephemeral boolean: włącz flagę użytkownika --ephemeral podczas tworzenia.
Zwroty
int identyfikator utworzonego użytkownika.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

Parametry
name String: użytkownika, którego należy utworzyć na urządzeniu
guest boolean: włącz flagę użytkownika – gość podczas tworzenia.
ephemeral boolean: włącz flagę użytkownika --ephemeral podczas tworzenia.
forTesting boolean: włącz flagę testu --for-testing podczas tworzenia.
Zwroty
int identyfikator utworzonego użytkownika.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

Parametry
name String: użytkownika, którego należy utworzyć na urządzeniu
Zwroty
int wartość całkowita identyfikatora utworzonego użytkownika lub -1 w przypadku błędu.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Usuwa zarejestrowany IDeviceActionReceiver.

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

disableKeyguard

public abstract void disableKeyguard ()

Próbuje wyłączyć blokadę klawiatury.

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

Rzuty
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwroty
boolean true, jeśli monitoring został wyłączony. false jeśli nie udało się.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

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

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

Zwroty
boolean true, jeśli połączenie z siecią Wi-Fi zostało utracone. false jeśli nie udało się zakończyć połączenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Metoda pomocnicza służąca do określenia, czy plik na urządzeniu danego użytkownika istnieje.

Parametry
deviceFilePath String: bezwzględna ścieżka do pliku na urządzeniu do sprawdzenia
userId int: identyfikator użytkownika, którego dotyczy sprawdzanie istnienia pliku
Zwroty
boolean true, jeśli plik istnieje, false w przeciwnym razie.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

Parametry
process String: nazwa procesu urządzenia, w którym ma zostać utworzony kopia pamięci podręcznej.
devicePath String: ścieżka na urządzeniu, na której ma się znaleźć zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia.
Zwroty
File ERROR(/File) zawierający raport. Wartość null, jeśli coś się nie udało.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Umożliwia monitorowanie sieci na urządzeniu.

Zwroty
boolean true, jeśli monitorowanie zostało włączone. false jeśli nie udało się.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getActiveApexes

public abstract  getActiveApexes ()

Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.

Zwroty
ERROR(/Set) z ApexInfo obecnie aktywnych na urządzeniu
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

Parametry
namespace String: musi być jedną z tych wartości: {"system", "secure", "global"}
Zwroty
mapę par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

Parametry
userId int

Zwroty
String

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

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

Zwroty
Mapa identyfikatorów Androida dopasowanych do identyfikatorów użytkowników.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName String

Zwroty
PackageInfo PackageInfo lub null, jeśli nie udało się pobrać informacji.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Pobierać informacje o pakietach zainstalowanych na urządzeniu.

Zwroty
ERROR(/List) z PackageInfo zainstalowanych na urządzeniu.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Zwraca bieżący stan urządzenia, które można złożyć, lub wartość null, jeśli wystąpiły jakieś problemy.

Zwroty
DeviceFoldableState

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Zwroty
int

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

Zwroty
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

Zwroty
ERROR(/Set) nazw pakietów String, które są obecnie zainstalowane na urządzeniu.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Pobiera adres IP urządzenia.

Zwroty
String adres IP urządzenia lub null, jeśli urządzenie nie ma adresu IP
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Zwroty
KeyguardControllerState KeyguardControllerState zawierający zrzut stanu klucza zabezpieczającego. Zwraca wartość null, jeśli zapytanie dotyczące klucza zabezpieczającego nie jest obsługiwane.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getMainUserId

public abstract Integer getMainUserId ()

Zwraca identyfikator głównego użytkownika.

Zwroty
Integer userId głównego użytkownika, jeśli taki istnieje, lub null, jeśli nie ma głównego użytkownika.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.

Zwroty
ERROR(/Set) z String głównych modułów obecnie zainstalowanych na urządzeniu.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Zwroty
int liczba całkowita wskazująca liczbę jednocześnie działających użytkowników;
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

Zwroty
int liczba całkowita wskazująca liczbę obsługiwanych użytkowników;
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Pobierz opcje testowania urządzenia.

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Ta metoda została wycofana.
getPrimaryUser został wycofany z usługi UserManager. Użyj funkcji ERROR(/android.os.UserManager#getMainUserId()), aby uzyskać pierwszego pełnego użytkownika, lub 0, aby uzyskać system. Pamiętaj, że w przypadku systemu bez głowy nie jest to pełny użytkownik.

Zwraca podstawowy identyfikator użytkownika.

Zwroty
Integer userId głównego użytkownika, jeśli taki istnieje, lub null, jeśli nie ma głównego użytkownika.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parametry
format String: obsługiwane PNG, JPEG
rescale boolean: czy zrzut ekranu ma 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

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania. Format: PNG.

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

Parametry
displayId long: identyfikator wyświetlacza ekranu, z którego chcesz zrobić 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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Robi zrzut ekranu z urządzenia. Zalecamy użycie metody getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.

Parametry
format String: obsługiwane PNG, JPEG
Zwroty
InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie powiódł się.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Robi zrzut ekranu z urządzenia.

Zwroty
InputStreamSource InputStreamSource zrzutu ekranu w formacie png lub null, jeśli zrzut ekranu nie powiódł się.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

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

Parametry
userId int

namespace String

key String

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parametry
namespace String

key String

Zwroty
String

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

Parametry
userId int

Zwroty
int flagi powiązane z podanym identyfikatorem użytkownika userId, jeśli został znaleziony, lub -10000 w innych przypadkach.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Pobiera mapę useId na urządzeniu do UserInfo. Jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami, zostanie zwrócony błąd DeviceRuntimeException.

Zwroty
lista obiektów UserInfo.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parametry
userId int

Zwroty
int

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

Parametry
feature String: format, który powinien być użyty: „feature:” lub „”.
Zwroty
boolean Wartość „PRAWDA”, jeśli udało się znaleźć element, w przeciwnym razie wartość „FAŁSZ”.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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

Zainstaluj na urządzeniu pakiet Androida.

Parametry
packageFile File: plik APK do zainstalowania
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

installPackage

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

Zainstaluj na urządzeniu pakiet Androida.

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

Parametry
packageFile File: plik APK do zainstalowania
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane w momencie instalacji
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackageForUser

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

Zainstaluj pakiet Androida na urządzeniu danego użytkownika.

Parametry
packageFile File: plik APK do zainstalowania
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
userId int: liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

installPackageForUser

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

Zainstaluj pakiet Androida na urządzeniu danego użytkownika.

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

Parametry
packageFile File: plik APK do zainstalowania
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane w momencie instalacji
userId int: liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackages

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

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

Parametry
packageFiles : pliki APK na urządzeniu
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackages

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

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

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

Parametry
packageFiles : ścieżki do zdalnych plików APK do zainstalowania
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane w momencie instalacji
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackagesForUser

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

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

Parametry
packageFiles : pliki APK na urządzeniu
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
userId int: liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installPackagesForUser

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

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

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

Parametry
packageFiles : pliki APK na urządzeniu
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane w momencie instalacji
userId int: liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installRemotePackages

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

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

Parametry
remoteApkPaths : ścieżki do zdalnych plików APK
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

installRemotePackages

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 dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem. Informacje o tym, jak podzielić plik APK na kilka plików, znajdziesz na stronie „https://developer.android.com/studio/build/configure-apk-splits”.

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

Parametry
remoteApkPaths : ścieżki do zdalnych plików APK
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację
grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane w momencie instalacji
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
UnsupportedOperationException jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

Zwroty
boolean wartość „PRAWDA”, jeśli obsługa wielu użytkowników jest możliwa, w przeciwnym razie wartość „FAŁSZ”.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

Parametry
packageName String: pakiet, którego instalację sprawdzamy.
userId String: identyfikator użytkownika, dla którego sprawdzamy, czy zainstalowano pakiet. Jeśli wartość jest pusta, zostanie użyta wartość zero.
Zwroty
boolean Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Wysłać zapytanie do urządzenia o określonej nazwie pakietu, aby sprawdzić, czy jest on zainstalowany.

Parametry
packageName String

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

isUserRunning

public abstract boolean isUserRunning (int userId)

Sprawdź, czy dany użytkownik jest obecny.

Parametry
userId int

Zwroty
boolean Wartość „prawda”, jeśli użytkownik biega, a w pozostałych przypadkach – „fałsz”.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parametry
userId int

Zwroty
boolean Prawda, jeśli użytkownik jest dodatkowy, w przeciwnym razie fałsz.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Sprawdzanie, czy dany użytkownik jest widoczny.

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

Parametry
userId int

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Parametry
userId int

displayId int

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

Zwroty
boolean

Rzuty
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

Sprawdzanie, czy Wi-Fi jest włączone na urządzeniu. Przydatne do sprawdzania stanu Wi-Fi przed testami, które nie powinny być wykonywane z Wi-Fi, np. testy danych mobilnych.

Zwroty
boolean true, jeśli Wi-Fi jest włączone. false, jeśli jest wyłączona
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

listDisplayIds

public abstract  listDisplayIds ()

Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys SurfaceFlinger”.

Zwroty
Lista wyświetlaczy. Domyślnie zawsze zwraca wartość domyślną 0.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Zwroty
Rzuty
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Pobiera listę użytkowników na urządzeniu. Wyjątek DeviceRuntimeException zostanie rzucony, jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.

Zwroty
lista identyfikatorów użytkowników.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

Parametry
dataName String: nazwa, pod którą zgłoszenie błędu zostanie przesłane.
listener ITestLogger: ITestLogger do rejestrowania raportu o błędzie.
Zwroty
boolean Wartość true, jeśli rejestrowanie zakończyło się powodzeniem. W przeciwnym razie wartość false.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

Parametry
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver na tym urządzeniu.

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

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

Parametry
componentName String: administratora urządzenia, którego chcesz usunąć.
userId int: użytkownika, w którego przestrzeni osobistej znajduje się administrator urządzenia.
Zwroty
boolean Wartość true (prawda), jeśli operacja zakończyła się powodzeniem, w przeciwnym razie ma wartość false (fałsz).
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Usuń wszystkich dotychczasowych właścicieli profilu urządzenia, stosując zasadę możliwie najlepszej obsługi.

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

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

Parametry
userId int: użytkownika, którego chcesz usunąć
Zwroty
boolean Wartość „true”, jeśli udało się usunąć użytkownika, a w przeciwnym razie – „false”.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Parametry
componentName String: administrator urządzenia musi być właścicielem urządzenia.
userId int: kraju zamieszkania właściciela urządzenia.
Zwroty
boolean Wartość true (prawda), jeśli operacja zakończyła się powodzeniem, w przeciwnym razie ma wartość false (fałsz).
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

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

Parametry
namespace String

key String

value String

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

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

Parametry
userId int

namespace String

key String

value String

Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

Parametry
userId int: użytkownik może uruchomić aplikację w tle
Zwroty
boolean Wartość true, jeśli użytkownik został uruchomiony w tle.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik jest już uruchomiony w tle, ta metoda nie wykonuje żadnej operacji. Możliwość podania dodatkowego parametru, aby poczekać na zastosowanie operacji.

Parametry
userId int: użytkownik może uruchomić aplikację w tle
waitFlag boolean: polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie.
Zwroty
boolean Wartość true, jeśli użytkownik został uruchomiony w tle.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać czynności na tym wyświetlaczu).

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

Parametry
userId int: użytkownik może uruchomić aplikację w tle
displayId int: wyświetlanie informacji o początku sesji użytkownika na
waitFlag boolean: polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie.
Zwroty
boolean true jeśli użytkownik został uruchomiony i jest widoczny w tle.
Rzuty
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

Parametry
userId int: zatrzymać.
Zwroty
boolean Wartość true, jeśli użytkownik został zatrzymany.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

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

Parametry
userId int: zatrzymać.
waitFlag boolean: polecenie będzie oczekiwać, aż użytkownik się zatrzyma.
forceFlag boolean: wymuszenie zatrzymania przez użytkownika.
Zwroty
boolean Wartość true, jeśli użytkownik został zatrzymany.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

Parametry
userId int

Zwroty
boolean Prawda, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem. Próba wyłączenia blokady ekranu po pomyślnej zmianie użytkownika.

Parametry
userId int

timeout long: czas oczekiwania przed zwróceniem wartości false w przypadku błędu switch-user.
Zwroty
boolean Prawda, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.
Rzuty
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Przyjmuje zgłoszenie o błędzie i zwraca je w obiekcie Bugreport, aby je obsłużyć. W przypadku problemów zwraca wartość null. Plik, na który wskazuje obiekt Bugreport, musi zostać oczyszczony za pomocą funkcji Bugreport.close().

Zwroty
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Odinstaluj pakiet Androida z urządzenia.

Parametry
packageName String: pakiet na Androida do odinstalowania
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Parametry
packageName String: pakiet na Androida do odinstalowania
userId int: całkowita wartość identyfikatora użytkownika, dla którego ma zostać odinstalowana aplikacja.
Zwroty
String String z kodem błędu lub null w przypadku powodzenia.
Rzuty
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

W razie potrzeby poczekaj, aż snapuserd zakończy działanie.

Parametry
currentPhase SnapuserdWaitPhase

Rzuty
DeviceNotAvailableException