ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

Ponawia polecenia urządzenia przez konfigurowalny czas i udostępnia 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-ie

class ITestDevice.MountPointInfo

Prosta klasa struktury do przechowywania informacji o jednym punkcie montowania.

Metody publiczne

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

Zainstaluj pakiet Androida na urządzeniu za pomocą polecenia adb.

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

Zainstaluj pakiet Androida na urządzeniu za pomocą polecenia adb.

abstract boolean canSwitchToHeadlessSystemUser()

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

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

Próba zamknięcia wszystkich okien dialogowych z błędami, które są obecnie wyświetlane w interfejsie urządzenia.

abstract void clearLastConnectedWifiNetwork()

Usuwa ostatnią połączoną sieć Wi-Fi.

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

Ta metoda została wycofana. użyj w zamian zasady connectToWifiNetworkWithResult(Map,boolean).

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

Ta metoda została wycofana. użyj w zamian zasady connectToWifiNetworkWithResult(Map).

default boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Ta metoda została wycofana. użyj w zamian zasady connectToWifiNetworkWithResult(String,String).

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

Ta metoda została wycofana. użyj w zamian zasady connectToWifiNetworkWithResult(String,String,boolean).

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

Ta metoda została wycofana. użyj w zamian zasady connectToWifiNetworkIfNeededWithResult(String,String,boolean).

default boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

Ta metoda została wycofana. użyj w zamian zasady connectToWifiNetworkIfNeededWithResult(String,String).

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

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

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

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

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

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

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

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

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

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

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

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

abstract int createUser(String name)

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

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

Utwórz użytkownika o podanej nazwie i z podanymi flagami.

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

Utwórz użytkownika o podanej nazwie i z podanymi flagami.

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 pomocnicza do określania, czy plik na urządzeniu istnieje dla danego użytkownika.

abstract File dumpHeap(String process, String devicePath)

Spróbuj zrzucić stertę z system_server.

abstract boolean enableNetworkMonitor()

Włącza monitorowanie sieci na urządzeniu.

abstract Set<ITestDevice.ApexInfo> getActiveApexes()

Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.

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

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

abstract String getAndroidId(int userId)

Znajduje i zwraca identyfikator Androida powiązany z identyfikatorem użytkownika. Jeśli nie znajdzie identyfikatora, zwraca wartość null.

abstract Map<Integer, String> getAndroidIds()

Utwórz mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników.

abstract PackageInfo getAppPackageInfo(String packageName)

Pobiera informacje o pakiecie zainstalowanym na urządzeniu.

abstract List<PackageInfo> getAppPackageInfos()

Pobieranie informacji o pakietach zainstalowanych na urządzeniu.

abstract InputStreamSource getBugreport()

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

abstract InputStreamSource getBugreportz()

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

abstract DeviceFoldableState getCurrentFoldableState()

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

abstract int getCurrentUser()

Zwraca identyfikator aktualnie zalogowanego użytkownika.

abstract Set<DeviceFoldableState> getFoldableStates()

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

abstract Set<String> getInstalledPackageNames()

Pobierz nazwy pakietów aplikacji znajdujących się 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 obsługiwany.

abstract Integer getMainUserId()

Zwraca główny identyfikator użytkownika.

abstract Set<String> getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported(String userType)

Pobierz maksymalną liczbę obsługiwanych użytkowników danego typu.

abstract int getMaxNumberOfUsersSupported()

Ta metoda została wycofana. użyj metody getMaxNumberOfUsersSupported(String userType), aby uzyskać maksymalną liczbę obsługiwanych użytkowników danego typu.

abstract TestDeviceOptions getOptions()

Pobierz opcje testowania urządzenia.

abstract Integer getPrimaryUserId()

Ta metoda została wycofana. Funkcja getPrimaryUser została wycofana z usługi UserManager. Aby uzyskać pierwszego pełnego użytkownika, użyj ERROR(/android.os.UserManager#getMainUserId()), a w przypadku systemu – 0. Pamiętaj, że w przypadku systemu bez monitora nie jest to pełny użytkownik.

abstract int getRemainingCreatableUserCount(String userType)

Zwraca liczbę użytkowników danego typu, których można utworzyć na tym urządzeniu.

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

Wykonuje zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza w obsługiwanym formacie.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Robi zrzut ekranu urządzenia.

abstract InputStreamSource getScreenshot(String format)

Robi zrzut ekranu urządzenia.

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot()

Robi zrzut ekranu urządzenia.

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

Zwraca wartość żądanego ustawienia.

abstract String getSetting(String namespace, String key)

Patrz getSetting(int,String,String) i wykonywane na użytkowniku systemu.

abstract Set<String> getUninstallablePackageNames()

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

abstract int getUserFlags(int userId)

Znajdź i zwróć flagi danego użytkownika.

abstract Map<Integer, UserInfo> getUserInfos()

Pobiera mapę identyfikatorów użycia do UserInfo na urządzeniu.

abstract int getUserSerialNumber(int userId)

Zwraca numer seryjny powiązany z identyfikatorem userId, jeśli zostanie znaleziony, lub -10000 w innych przypadkach.

abstract int getUserVisibleOnDisplay(int displayId)

Pobiera identyfikator użytkownika widocznego na danym wyświetlaczu.

abstract boolean hasFeature(String feature)

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

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

Zainstaluj pakiet Androida na urządzeniu.

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

Zainstaluj pakiet Androida na urządzeniu.

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

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

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

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

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

Instaluje pliki APK w trybie przyrostowym.

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (głównego i dodatkowych pakietów podzielonych).

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (głównego i dodatkowych pakietów podzielonych) znajdujących się na urządzeniu z Androidem.

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (głównego i dodatkowych pakietów podzielonych) dla danego użytkownika.

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (głównego i dodatkowych pakietów podzielonych) dla danego użytkownika.

abstract boolean isHeadlessSystemUserMode()

Zwraca informację o tym, czy urządzenie korzysta z trybu użytkownika systemu bez interfejsu graficznego.

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

Zwraca informację, czy to urządzenie obsługuje wielu użytkowników z możliwością przełączania, którzy mają własne loginy i konfigurowalne przestrzenie.

abstract boolean isPackageInstalled(String packageName, String userId)

Wysyła zapytanie do urządzenia o daną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana dla tego użytkownika.

abstract boolean isPackageInstalled(String packageName)

Wysyłaj do urządzenia zapytania o daną nazwę pakietu, aby sprawdzić, czy jest on obecnie zainstalowany.

abstract boolean isUserRunning(int userId)

Sprawdź, czy dany użytkownik jest aktywny.

abstract boolean isUserSecondary(int userId)

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

abstract boolean isUserVisible(int userId)

Sprawdza, czy dany użytkownik jest widoczny.

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

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

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Zwraca informację, czy urządzenie zezwala na uruchamianie aplikacji w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

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

abstract Set<Long> listDisplayIds()

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

abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

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

abstract ArrayList<Integer> listUsers()

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

abstract boolean logBugreport(String dataName, ITestLogger listener)

Metoda pomocnicza służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Powiadom urządzenie, aby poczekało na zakończenie działania snapuserd.

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Rejestruje IDeviceActionReceiver na tym urządzeniu.

abstract boolean removeAdmin(String componentName, int userId)

Usuwa administratora danego urządzenia z konta danego użytkownika i zwraca true, jeśli operacja się uda, lub false w przeciwnym razie.

abstract void removeOwners()

Usuń wszystkich obecnych właścicieli profilu urządzenia, korzystając z zasady możliwie najlepszej obsługi.

abstract boolean removeUser(int userId)

Usuń danego użytkownika z urządzenia.

abstract boolean setDeviceOwner(String componentName, int userId)

Ustawianie komponentu administratora urządzenia jako właściciela urządzenia w przypadku danego użytkownika.

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

Patrz setSetting(int,String,String,String) i wykonywane na użytkowniku systemu.

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

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

abstract boolean startUser(int userId)

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

abstract boolean startUser(int userId, boolean waitFlag)

Uruchamia 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 umożliwia użytkownikowi uruchamianie aktywnoś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 na inny identyfikator użytkownika z domyślnym czasem oczekiwania.

abstract boolean switchUser(int userId, long timeout)

Przełącza się na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem.

abstract Bugreport takeBugreport()

Pobiera raport o błędzie i zwraca go w obiekcie Bugreport, aby go obsłużyć.

abstract String uninstallPackage(String packageName)

Odinstaluj pakiet Androida z urządzenia.

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Jeśli jest to oczekiwane, poczekaj na zakończenie działania usługi snapuserd.

Metody publiczne

adbInstallPackage

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

Zainstaluj pakiet Androida na urządzeniu za pomocą polecenia adb.

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

adbInstallPackage

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

Zainstaluj pakiet Androida na urządzeniu za pomocą polecenia adb.

Uwaga: tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas 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 mają być przyznawane w momencie instalacji.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Próba zamknięcia wszystkich okien dialogowych z błędami, które są obecnie wyświetlane w interfejsie urządzenia.

Zwraca
boolean true – jeśli nie było żadnych okien lub zostały one pomyślnie zamknięte. false w przeciwnym razie.
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Usuwa ostatnią połączoną sieć Wi-Fi. Tę metodę należy 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.

connectToWifiNetwork

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

Ta metoda została wycofana.
Zamiast niej używaj zasady connectToWifiNetworkWithResult(Map,boolean).

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

Włącza Wi-Fi i blokuje połączenie do momentu 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 Map: mapa identyfikatorów SSID sieci Wi-Fi do haseł.
scanSsid boolean: czy skanować ukryte identyfikatory SSID w tej sieci.
Zwraca
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

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

Ta metoda została wycofana.
Zamiast niej używaj zasady connectToWifiNetworkWithResult(Map).

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

Włącza Wi-Fi i blokuje połączenie do momentu 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 Map: mapa identyfikatorów SSID sieci Wi-Fi do haseł.
Zwraca
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Ta metoda została wycofana.
Zamiast niej używaj zasady connectToWifiNetworkWithResult(String,String).

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

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

Parametry
wifiSsid String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć.
wifiPsk String: hasło PSK lub wartość null, jeśli połączenie nie jest szyfrowane.
Zwraca
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetwork

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

Ta metoda została wycofana.
Zamiast niej używaj zasady connectToWifiNetworkWithResult(String,String,boolean).

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

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

Parametry
wifiSsid String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć.
wifiPsk String: hasło PSK lub wartość null, jeśli połączenie nie jest szyfrowane.
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwraca
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetworkIfNeeded

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

Ta metoda została wycofana.
użyj w zamian zasady connectToWifiNetworkIfNeededWithResult(String,String,boolean).

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

Parametry
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwraca
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Ta metoda została wycofana.
Zamiast niej używaj zasady connectToWifiNetworkIfNeededWithResult(String,String).

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

Zwraca
boolean true jeśli połączenie z siecią Wi-Fi zostało nawiązane. false w innym przypadku
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

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

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

Parametry
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

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

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

Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkWithResult

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

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

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

Parametry
wifiSsid String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć.
wifiPsk String: hasło PSK lub wartość null, jeśli połączenie nie jest szyfrowane.
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetworkWithResult

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

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

Włącza Wi-Fi i blokuje połączenie 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 Map: mapa identyfikatorów SSID sieci Wi-Fi do haseł.
Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetworkWithResult

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

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

Włącza Wi-Fi i blokuje połączenie 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 Map: mapa identyfikatorów SSID sieci Wi-Fi do haseł.
scanSsid boolean: czy skanować ukryte identyfikatory SSID w tej sieci.
Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

connectToWifiNetworkWithResult

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

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

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

Parametry
wifiSsid String: identyfikator SSID sieci Wi-Fi, z którą chcesz się połączyć.
wifiPsk String: hasło PSK lub wartość null, jeśli połączenie nie jest szyfrowane.
Zwraca
IWifiHelper.WifiConnectionResult WifiConnectionResult – wskazuje stan połączenia.
Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

createUser

public abstract int createUser (String name)

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

Parametry
name String: użytkownika na urządzeniu
Zwraca
int liczba całkowita utworzonego identyfikatora użytkownika.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
IllegalStateException

createUser

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

Utwórz użytkownika o podanej nazwie i z podanymi flagami.

Parametry
name String: użytkownika na urządzeniu
guest boolean: włącz flagę użytkownika --guest podczas tworzenia.
ephemeral boolean: włącz flagę użytkownika --ephemeral podczas tworzenia
Zwraca
int identyfikator utworzonego użytkownika;
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
IllegalStateException

createUser

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

Utwórz użytkownika o podanej nazwie i z podanymi flagami.

Parametry
name String: użytkownika 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
Zwraca
int identyfikator utworzonego użytkownika;
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
IllegalStateException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

Parametry
name String: użytkownika na urządzeniu
Zwraca
int liczba całkowita identyfikatora utworzonego użytkownika lub -1 w przypadku błędu.
Zgłasza
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óby wyłączenia blokady klawiatury,

Najpierw poczekaj, aż wysyłanie danych wejściowych będzie gotowe. Dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ bieżąca implementacja platformy czasami powoduje sytuację wyścigu. Następnie wysyłane jest polecenie zamknięcia ekranu blokady (działa tylko w przypadku niezabezpieczonych ekranów blokady).

Zgłasza
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Wyłącza monitorowanie sieci na urządzeniu.

Zwraca
boolean true, jeśli monitorowanie zostało wyłączone. false jeśli się nie powiodło.
Zgłasza
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.

Zwraca
boolean true, jeśli połączenie z siecią Wi-Fi zostało zakończone. false jeśli nie udało się odłączyć.
Zgłasza
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 do określania, czy plik na urządzeniu istnieje dla danego użytkownika.

Parametry
deviceFilePath String: ścieżka bezwzględna do pliku na urządzeniu, który ma zostać sprawdzony
userId int: identyfikator użytkownika, względem którego należy sprawdzić istnienie pliku.
Zwraca
boolean true, jeśli plik istnieje, false w przeciwnym razie.
Zgłasza
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ć stertę z system_server. Za usunięcie zrzutu pliku odpowiada osoba wywołująca.

Parametry
process String: nazwa procesu na urządzeniu, dla którego chcesz utworzyć zrzut pamięci.
devicePath String: ścieżka na urządzeniu, w której ma się znaleźć zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia.
Zwraca
File File zawierający raport. Wartość null, jeśli coś się nie powiodło.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Włącza monitorowanie sieci na urządzeniu.

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

getActiveApexes

public abstract Set<ITestDevice.ApexInfo> getActiveApexes ()

Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.

Zwraca
Set<ITestDevice.ApexInfo> Set z ApexInfo kart aktywowanych obecnie na urządzeniu
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

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

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

Parametry
namespace String: musi mieć jedną z wartości: {"system", "secure", "global"}
Zwraca
Map<String, String> mapa par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Znajduje i zwraca identyfikator Androida powiązany z identyfikatorem użytkownika. Jeśli nie znajdzie identyfikatora, zwraca wartość null.

Parametry
userId int

Zwraca
String

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract Map<Integer, String> getAndroidIds ()

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

Zwraca
Map<Integer, String> Mapa identyfikatorów Androida pasujących do identyfikatorów użytkowników.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Pobiera informacje o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName String

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

getAppPackageInfos

public abstract List<PackageInfo> getAppPackageInfos ()

Pobieranie informacji o pakietach zainstalowanych na urządzeniu.

Zwraca
List<PackageInfo> List z PackageInfo zainstalowanych na urządzeniu.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

Zwraca
InputStreamSource InputStreamSource, które na żądanie wygeneruje zawartość raportu o błędach. W przypadku niepowodzenia funkcja InputStreamSource zwróci pustą wartość InputStream.

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

Zwraca
InputStreamSource InputStreamSource pliku ZIP zawierającego raport o błędzie. W przypadku niepowodzenia zwraca wartość null.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Zwraca
DeviceFoldableState

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Zwraca identyfikator aktualnie zalogowanego użytkownika. W przypadku błędu zwróć wartość -10000.

Zwraca
int

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract Set<DeviceFoldableState> getFoldableStates ()

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

Zwraca
Set<DeviceFoldableState>

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract Set<String> getInstalledPackageNames ()

Pobierz nazwy pakietów aplikacji znajdujących się na urządzeniu.

Zwraca
Set<String> Set z String nazw pakietów zainstalowanych obecnie na urządzeniu.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Pobiera adres IP urządzenia.

Zwraca
String adres IP urządzenia lub null, jeśli urządzenie nie ma adresu IP;
Zgłasza
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 obsługiwany.

Zwraca
KeyguardControllerState KeyguardControllerState zawierający zrzut stanu ekranu blokady i zwraca wartość Null, jeśli zapytanie dotyczące ekranu blokady nie jest obsługiwane.
Zgłasza
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 główny identyfikator użytkownika.

Zwraca
Integer identyfikator użytkownika głównego, jeśli taki istnieje, lub wartość null, jeśli nie ma użytkownika głównego.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract Set<String> getMainlineModuleInfo ()

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

Zwraca
Set<String> Set z String modułów głównych zainstalowanych obecnie na urządzeniu.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported (String userType)

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

Parametry
userType String: typ użytkownika zdefiniowany w klasie UserManager, np. „android.os.usertype.full.SECONDARY”.
Zwraca
int liczbę całkowitą wskazującą liczbę obsługiwanych użytkowników danego typu,
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Ta metoda została wycofana.
użyj metody getMaxNumberOfUsersSupported(String userType), aby uzyskać maksymalną liczbę obsługiwanych użytkowników danego typu.

Uzyskaj maksymalną liczbę obsługiwanych użytkowników, których można przełączać, z wyłączeniem gości. Po wersji interfejsu API 36 nie obejmuje użytkowników, których nie można przełączyć (np. profili). Domyślna wartość to 0.

Zwraca
int liczba całkowita wskazująca liczbę obsługiwanych użytkowników, między którymi można się przełączać.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Pobierz opcje testowania urządzenia.

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

Zwraca identyfikator głównego użytkownika.

Zwraca
Integer identyfikator użytkownika głównego, jeśli taki istnieje, lub wartość null, jeśli nie ma użytkownika głównego.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
DeviceNotAvailableException

getRemainingCreatableUserCount

public abstract int getRemainingCreatableUserCount (String userType)

Zwraca liczbę użytkowników danego typu, których można utworzyć na tym urządzeniu.

Parametry
userType String: typ użytkownika zdefiniowany w klasie UserManager, np. „android.os.usertype.full.SECONDARY”.
Zwraca
int ile użytkowników danego typu można dodać,
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

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

Wykonuje zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza w obsługiwanym formacie. Zezwalanie na zmianę rozmiaru w celu obsługi mniejszych rozmiarów

Parametry
displayId Long: identyfikator wyświetlacza, z którego ma zostać zrobiony zrzut ekranu.
format String: obsługiwane formaty PNG i JPEG
rescale boolean: czy zrzut ekranu ma zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu.
Zwraca
InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Robi zrzut ekranu urządzenia. Zalecamy używanie getScreenshot(String) zamiast tego formatu, ponieważ w przypadku kodowania JPEG rozmiar jest mniejszy.

Parametry
format String: obsługiwane formaty PNG i JPEG
rescale boolean: czy zrzut ekranu ma zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu.
Zwraca
InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

Parametry
format String: obsługiwane formaty PNG i JPEG
Zwraca
InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

DO ZROBIENIA: rozszerzyć powyższe implementacje, aby obsługiwały „format” i „rescale”

Parametry
displayId long: identyfikator wyświetlacza, z którego ma zostać zrobiony zrzut ekranu.
Zwraca
InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null, jeśli zrzut ekranu nie został wykonany.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Robi zrzut ekranu urządzenia.

Zwraca
InputStreamSource InputStreamSource zrzutu ekranu w formacie PNG lub null, jeśli zrzut ekranu nie został wykonany.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

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

Parametry
userId int

namespace String

key String

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

Patrz getSetting(int,String,String) i wykonywane na użytkowniku systemu.

Parametry
namespace String

key String

Zwraca
String

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract Set<String> getUninstallablePackageNames ()

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

Zwraca
Set<String> Set nazw pakietów, których nie można odinstalować, zainstalowanych obecnie na urządzeniu.String
Zgłasza
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

Zwraca
int flagi powiązane z podanym identyfikatorem użytkownika, jeśli zostaną znalezione, lub -10000 w innych przypadkach.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract Map<Integer, UserInfo> getUserInfos ()

Pobiera mapę identyfikatorów użycia do UserInfo na urządzeniu. Wyrzuci błąd DeviceRuntimeException, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.

Zwraca
Map<Integer, UserInfo> lista obiektów UserInfo.
Zgłasza
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 userId, jeśli zostanie znaleziony, lub -10000 w innych przypadkach.

Parametry
userId int

Zwraca
int

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserVisibleOnDisplay

public abstract int getUserVisibleOnDisplay (int displayId)

Pobiera identyfikator użytkownika widocznego na danym wyświetlaczu.

Parametry
displayId int: identyfikator wyświetlacza.
Zwraca
int identyfikator użytkownika widocznego na danym wyświetlaczu. Nie rozróżnia użytkownika w tle, który jest widoczny, od użytkownika na pierwszym planie, ponieważ oba typy są widoczne. Aby odróżnić te przypadki, porównaj je z wynikiem funkcji getCurrentUser().
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

Parametry
feature String: format powinien mieć postać „feature:” lub bezpośrednio „”.
Zwraca
boolean Wartość true, jeśli funkcja została znaleziona. W przeciwnym razie wartość false.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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ą wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas 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 mają być przyznawane w momencie instalacji.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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, 
                String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu.

Parametry
packageFile File: plik APK do zainstalowania
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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 dla danego użytkownika.

Uwaga: tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas 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 mają być przyznawane w momencie instalacji.
userId int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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, 
                int userId, 
                String... extraArgs)

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

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

installPackageWithIncrementalMode

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

Instaluje pliki APK w trybie przyrostowym.

Parametry
apkFiles File: pliki APK do zainstalowania.
extraArgs String

userId String

Zwraca
boolean

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackages

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

Zainstaluj aplikację na Androida składającą się z kilku plików APK (głównego i dodatkowych pakietów podzielonych). Informacje o dzieleniu pakietu APK na kilka plików znajdziesz na stronie „https://developer.android.com/studio/build/configure-apk-splits”.

Parametry
packageFiles List: lokalne pliki APK
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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 (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Zainstaluj aplikację na Androida składającą się z kilku plików APK (głównego i dodatkowych pakietów podzielonych) znajdujących 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 użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.

Parametry
packageFiles List: ś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 mają być przyznawane w momencie instalacji.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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 (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Zainstaluj aplikację na Androida składającą się z kilku plików APK (głównego i dodatkowych pakietów podzielonych) dla danego użytkownika. Informacje o tym, jak podzielić pakiet APK na kilka plików, znajdziesz na stronie „https://developer.android.com/studio/build/configure-apk-splits”.

Parametry
packageFiles List: lokalne pliki APK
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.
userId int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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 (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Zainstaluj aplikację na Androida składającą się z kilku plików APK (głównego i dodatkowych pakietów podzielonych) dla danego użytkownika. Informacje o tym, jak podzielić pakiet 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 użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.

Parametry
packageFiles List: lokalne pliki APK
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.
grantPermissions boolean: czy wszystkie uprawnienia czasu działania mają być przyznawane w momencie instalacji.
userId int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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ę o tym, czy urządzenie korzysta z trybu użytkownika systemu bez interfejsu graficznego.

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Zwraca informację, czy to urządzenie obsługuje wielu użytkowników z możliwością przełączania, którzy mają własne loginy i konfigurowalne przestrzenie.

Pamiętaj, że nawet jeśli ta wartość jest fałszywa, może być możliwe zalogowanie wielu użytkowników, o ile nie jest wymagany interfejs logowania. Na przykład profile mogą być nadal obsługiwane, ponieważ nie wymagają interfejsu logowania.

Sprawdza ona też config_enableMultiUserUI. Na żądanie możemy założyć, że urządzenia, w przypadku których ta zasada ma wartość Prawda, są skonfigurowane tak, aby zezwalać na dodawanie użytkowników dodatkowych za pomocą narzędzia ADB.

Zwraca
boolean czy urządzenie obsługuje wielu użytkowników, między którymi można się przełączać.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Wysyła zapytanie do urządzenia o daną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana dla tego użytkownika.

Parametry
packageName String: pakiet, który sprawdzamy pod kątem instalacji.
userId String: identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli wartość to null, używany będzie główny użytkownik zero.
Zwraca
boolean Wartość true, jeśli pakiet jest zgłaszany jako zainstalowany. W przeciwnym razie ma wartość Fałsz.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Wysyłaj do urządzenia zapytania o daną nazwę pakietu, aby sprawdzić, czy jest on obecnie zainstalowany.

Parametry
packageName String

Zwraca
boolean Wartość true, jeśli pakiet jest zgłaszany jako zainstalowany. W przeciwnym razie ma wartość Fałsz.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Sprawdź, czy dany użytkownik jest aktywny.

Parametry
userId int

Zwraca
boolean Wartość „prawda”, jeśli użytkownik biegnie. W innych przypadkach wartość „fałsz”.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parametry
userId int

Zwraca
boolean Wartość „true”, jeśli użytkownik jest dodatkowy, w przeciwnym razie „false”.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Sprawdza, czy dany użytkownik jest widoczny.

„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „prawdziwym” użytkownikiem i dlatego może uruchamiać działania (zwykle na domyślnym ekranie).

Parametry
userId int

Zwraca
boolean

Zgłasza
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 „prawdziwym” użytkownikiem i dlatego może uruchamiać działania na tym wyświetlaczu.

Parametry
userId int

displayId int

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Zwraca informację, czy urządzenie zezwala na uruchamianie aplikacji w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

W takim przypadku możesz wywołać funkcję startVisibleBackgroundUser(int, int, boolean), przekazując wyświetlacz zwrócony przez funkcję listDisplayIdsForStartingVisibleBackgroundUsers() (który powinien zawierać ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

Zwraca
boolean

Zgłasza
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

Sprawdza, czy Wi-Fi jest włączone na urządzeniu. Przydatne do sprawdzania stanu Wi-Fi przed testami, które nie powinny być przeprowadzane przy włączonym Wi-Fi, np. testami danych komórkowych.

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

listDisplayIds

public abstract Set<Long> listDisplayIds ()

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

Zwraca
Set<Long> Lista wyświetlaczy. Funkcja Default zawsze zwraca domyślny wyświetlacz 0.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Zwraca
Set<Integer>

Zgłasza
DeviceNotAvailableException

listUsers

public abstract ArrayList<Integer> listUsers ()

Pobiera listę użytkowników na urządzeniu. Wyrzuci wyjątek DeviceRuntimeException, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.

Zwraca
ArrayList<Integer> lista identyfikatorów użytkowników.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Metoda pomocnicza służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających.

Parametry
dataName String: nazwa, pod którą zostanie zgłoszony raport o błędzie.
listener ITestLogger: ITestLogger do zarejestrowania raportu o błędzie.
Zwraca
boolean Wartość true, jeśli rejestrowanie się powiodło. W przeciwnym razie wartość false.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Powiadom urządzenie, aby poczekało na zakończenie działania 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 działania urządzenia i po jego zakończeniu.

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Usuwa administratora danego urządzenia z konta danego użytkownika i zwraca true, jeśli operacja się powiedzie, lub false w przeciwnym razie.

Parametry
componentName String: administratora urządzenia do usunięcia.
userId int: użytkownika, w którego profilu znajduje się administrator urządzenia.
Zwraca
boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Usuń wszystkich obecnych właścicieli profilu urządzenia, korzystając z zasady możliwie najlepszej obsługi.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Usuń danego użytkownika z urządzenia.

Parametry
userId int: użytkownika, który ma zostać usunięty
Zwraca
boolean Wartość „true”, jeśli użytkownik został usunięty. W przeciwnym razie „false”.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Ustawianie komponentu administratora urządzenia jako właściciela urządzenia w przypadku danego użytkownika.

Parametry
componentName String: administratora urządzenia na właściciela urządzenia.
userId int: użytkownika, w którego kraju mieszka właściciel urządzenia.
Zwraca
boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Patrz setSetting(int,String,String,String) i wykonywane na użytkowniku systemu.

Parametry
namespace String

key String

value String

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

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

Parametry
userId int

namespace String

key String

value String

Zgłasza
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 już działa w tle, ta metoda nie wykonuje żadnej operacji.

Parametry
userId int: użytkownika, aby rozpocząć w tle.
Zwraca
boolean Wartość true, jeśli użytkownik został uruchomiony w tle.
Zgłasza
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 już działa w tle, ta metoda nie wykonuje żadnej operacji. Możesz podać dodatkową flagę, aby poczekać na wprowadzenie zmian.

Parametry
userId int: użytkownika, aby rozpocząć w tle.
waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.
Zwraca
boolean Wartość true, jeśli użytkownik został uruchomiony w tle.
Zgłasza
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 umożliwia użytkownikowi uruchamianie aktywnoś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żytkownika, aby rozpocząć w tle.
displayId int: wyświetlanie, aby rozpocząć widoczność użytkownika
waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.
Zwraca
boolean true – jeśli użytkownik został uruchomiony w tle.
Zgłasza
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Zatrzymuje danego użytkownika. Jeśli użytkownik jest już zatrzymany, ta metoda nie wykonuje żadnej operacji. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.

Parametry
userId int: użytkownika, którego chcesz zatrzymać.
Zwraca
boolean Wartość true, jeśli użytkownik został zatrzymany.
Zgłasza
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 poczekać na wprowadzenie zmian, i wymusić zakończenie sesji użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.

Parametry
userId int: użytkownika, którego chcesz zatrzymać.
waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik się zatrzyma.
forceFlag boolean: wymusi zatrzymanie użytkownika.
Zwraca
boolean Wartość true, jeśli użytkownik został zatrzymany.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

Parametry
userId int

Zwraca
boolean Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Przełącza się na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem. Próba wyłączenia blokady ekranu po zmianie użytkownika zakończyła się powodzeniem.

Parametry
userId int

timeout long: czas oczekiwania przed zwróceniem wartości false w przypadku niepowodzenia przełączania użytkownika.
Zwraca
boolean Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Pobiera raport o błędzie i zwraca go w obiekcie Bugreport, aby go obsłużyć. W przypadku problemu zwraca wartość null. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony za pomocą funkcji Bugreport.close().

Zwraca
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Odinstaluj pakiet Androida z urządzenia.

Parametry
packageName String: pakiet na Androida do odinstalowania.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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 dla danego użytkownika.

Parametry
packageName String: pakiet na Androida do odinstalowania.
userId int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać odinstalowana aplikacja.
Zwraca
String String z kodem błędu lub null w przypadku powodzenia.
Zgłasza
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)

Jeśli jest to oczekiwane, poczekaj na zakończenie działania usługi snapuserd.

Parametry
currentPhase SnapuserdWaitPhase

Zgłasza
DeviceNotAvailableException