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 przywracania 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 jednym punkcie montowania.

Metody publiczne

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.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

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

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

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

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

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

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

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

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

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

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

abstract int createUser(String name)

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

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

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

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

Utwórz użytkownika o danej 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 ochrony 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 procesu system_server.

abstract boolean enableNetworkMonitor()

Włącza monitorowanie sieci na urządzeniu.

abstract getActiveApexes()

Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.

abstract 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 zostanie znaleziony, zwraca wartość null.

abstract 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 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 getFoldableStates()

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

abstract 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 getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

Pobierz opcje testu dla 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 InputStreamSource getScreenshot(String format, boolean rescale)

Robi zrzut ekranu urządzenia.

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot(String format)

Robi zrzut ekranu urządzenia.

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 getUninstallablePackageNames()

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

abstract int getUserFlags(int userId)

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

abstract getUserInfos()

Pobiera mapę 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 wartość -10000 w innych przypadkach.

abstract boolean hasFeature(String feature)

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

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

Zainstaluj pakiet Androida na urządzeniu.

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

Zainstaluj pakiet Androida na urządzeniu.

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

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

abstract String installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, 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( packageFiles, boolean reinstall, String... extraArgs)

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

default String installPackages( 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), które znajdują się na urządzeniu z Androidem.

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

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

default String installPackagesForUser( 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.

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

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

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()

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

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 użytkowników w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

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

abstract listDisplayIds()

Zbierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, zgodnie z raportem „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 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 urządzenia z konta użytkownika i zwraca true, jeśli operacja się uda, a w przeciwnym razie false.

abstract void removeOwners()

Usuń wszystkich obecnych właścicieli profilu urządzenia, dokładając wszelkich starań.

abstract boolean removeUser(int userId)

Usuń danego użytkownika z urządzenia.

abstract boolean setDeviceOwner(String componentName, int userId)

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

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

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 mu 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łącz 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)

W razie potrzeby poczekaj na zakończenie działania procesu snapuserd.

Metody publiczne

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Zwroty
boolean

Zgłasza
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.
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.

Zwroty
boolean true – jeśli nie było żadnych okien lub zostały one usunię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 abstract boolean connectToWifiNetwork ( 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 : mapa identyfikatorów SSID sieci Wi-Fi i haseł.
Zwroty
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 abstract boolean connectToWifiNetwork ( 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 : mapa identyfikatorów SSID sieci Wi-Fi i haseł.
scanSsid boolean: czy skanować ukryte identyfikatory SSID w tej sieci.
Zwroty
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 abstract boolean connectToWifiNetwork (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.
Zwroty
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 abstract boolean connectToWifiNetwork (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.
Zwroty
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 abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

Parametry
scanSsid boolean: czy skanować ukryty identyfikator SSID tej sieci.
Zwroty
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 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 siecią.

Zwroty
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

createUser

public abstract int createUser (String name)

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

Parametry
name String: użytkownika, który ma utworzyć na urządzeniu
Zwroty
int liczba całkowita utworzonego identyfikatora użytkownika,
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

Parametry
name String: użytkownika, który ma utworzyć na urządzeniu
guest boolean: włącz flagę użytkownika --guest podczas tworzenia.
ephemeral boolean: włącz flagę użytkownika --ephemeral podczas tworzenia.
Zwroty
int identyfikator utworzonego użytkownika,
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

Parametry
name String: użytkownika, który ma utworzyć na urządzeniu
guest boolean: włącz flagę użytkownika --guest podczas tworzenia.
ephemeral boolean: włącz flagę użytkownika --ephemeral podczas tworzenia.
forTesting boolean: włącz flagę testową --for-testing podczas tworzenia
Zwroty
int identyfikator utworzonego użytkownika,
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

Parametry
name String: użytkownika, który ma utworzyć na urządzeniu
Zwroty
int liczba całkowita identyfikatora użytkownika utworzonego 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óra zostanie usunięta.

disableKeyguard

public abstract void disableKeyguard ()

próby wyłączenia ochrony 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 wyścig. 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.

Zwroty
boolean true, jeśli monitorowanie zostało wyłączone. falsew przypadku niepowodzenia.
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.

Zwroty
boolean true, jeśli połączenie z siecią Wi-Fi zostało zakończone. false jeśli nie udało się zakończyć połączenia.
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: bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony.
userId int: identyfikator użytkownika, względem którego należy sprawdzić istnienie pliku.
Zwroty
boolean true, jeśli plik istnieje, false w przeciwnym razie.
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 procesu system_server. Za usunięcie zrzutu pliku odpowiada osoba wywołująca.

Parametry
process String: nazwa procesu na urządzeniu, w którym ma zostać wykonany zrzę pamięci.
devicePath String: ścieżka na urządzeniu, w której ma zostać umieszczony 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 powiodło.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Włącza monitorowanie sieci na urządzeniu.

Zwroty
boolean true – jeśli monitorowanie zostało włączone. falsew przypadku niepowodzenia.
Zgłasza
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 pakietach APEX aktywowanych na urządzeniu.

Zwroty
Obecnie na urządzeniu aktywowano ERROR(/Set) z ApexInfo
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

Parametry
namespace String: musi mieć jedną z wartości: {"system", "secure", "global"}
Zwroty
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 zostanie znaleziony, zwraca wartość null.

Parametry
userId int

Zwroty
String

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

getAndroidIds

public abstract  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.

Zwroty
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

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

Pobieranie informacji o pakietach zainstalowanych na urządzeniu.

Zwroty
ERROR(/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 na urządzeniu, na którym karta SD nie jest jeszcze zamontowana).

Zwroty
InputStreamSource InputStreamSource, które na żądanie wygeneruje zawartość raportu o błędach. W przypadku niepowodzenia funkcja InputStreamSource zwróci pustą wartość ERROR(/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, które są przydatne do debugowania.

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

Zwroty
InputStreamSource a 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.

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

Zwroty
int

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

getFoldableStates

public abstract  getFoldableStates ()

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

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

Zwroty
ERROR(/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.

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

Zwroty
KeyguardControllerState KeyguardControllerState zawierający zrzut stanu blokady ekranu. Zwraca wartość null, jeśli zapytanie dotyczące blokady ekranu 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.

Zwroty
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  getMainlineModuleInfo ()

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

Zwroty
ERROR(/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 użytkowników działających jednocześnie. Domyślna wartość to 0.

Zwroty
int liczbę całkowitą wskazującą liczbę użytkowników działających jednocześnie,
Zgłasza
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;
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Pobierz opcje testu dla urządzenia.

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Ta metoda została wycofana.
getPrimaryUser został wycofany z usługi UserManager. Aby uzyskać pierwszego pełnego użytkownika, użyj 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 podstawowy identyfikator użytkownika.

Zwroty
Integer userId głównego użytkownika, jeśli taki istnieje, lub wartość null, jeśli nie ma głównego użytkownika.
Zgłasza
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 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.
Zwroty
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 parametry „format” i „rescale”

Parametry
displayId long: identyfikator ekranu, z którego ma zostać zrobiony zrzut.
Zwroty
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. Zalecamy używanie zamiast tego metody getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.

Parametry
format String: obsługiwane formaty PNG i JPEG
Zwroty
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.

Zwroty
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

Zwroty
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

Zwroty
String

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

Zwroty
ERROR(/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

Zwroty
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  getUserInfos ()

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

Zwroty
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 wartość -10000 w innych przypadkach.

Parametry
userId int

Zwroty
int

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 „”.
Zwroty
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, 
                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”.
Zwroty
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, 
                boolean grantPermissions, 
                String... extraArgs)

Zainstaluj pakiet Androida na urządzeniu.

Uwaga: tę funkcję należy wywoływać tylko w przypadkach, 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 powinny być przyznawane podczas instalacji.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwroty
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 platforma nie obsługuje uprawnień czasu działania na urządzeniu.

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”.
Zwroty
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, 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 powinny być przyznawane podczas 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”.
Zwroty
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 platforma nie obsługuje uprawnień czasu działania na urządzeniu.

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

Zwroty
boolean

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

installPackages

public String installPackages ( 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 : 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”.
Zwroty
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 platforma nie obsługuje uprawnień czasu działania 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 (głównego i dodatkowych pakietów podzielonych), 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, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.

Parametry
packageFiles : ścieżki do zdalnych plików APK do zainstalowania
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.
grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane podczas instalacji.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwroty
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 platforma nie obsługuje uprawnień czasu działania na urządzeniu.

installPackagesForUser

public String installPackagesForUser ( 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 : 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”.
Zwroty
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 platforma nie obsługuje uprawnień czasu działania na urządzeniu.

installPackagesForUser

public String installPackagesForUser ( 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, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas instalacji.

Parametry
packageFiles : lokalne pliki APK
reinstall boolean: true, jeśli należy ponownie zainstalować aplikację.
grantPermissions boolean: czy wszystkie uprawnienia czasu działania powinny być przyznawane podczas 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”.
Zwroty
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 platforma nie obsługuje uprawnień czasu działania 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 (głównego i dodatkowych pakietów podzielonych), które znajdują się na urządzeniu z Androidem. Informacje o dzieleniu pakietu 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 w sekcji „adb shell pm -h”.
Zwroty
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 platforma nie obsługuje uprawnień czasu działania 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 (głównego i dodatkowych pakietów podzielonych), które znajdują się na urządzeniu z Androidem. Informacje o dzieleniu pakietu 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, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie działania podczas 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 podczas instalacji.
extraArgs String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”.
Zwroty
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 platforma nie obsługuje uprawnień czasu działania na urządzeniu.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

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

Zwroty
boolean

Zgłasza
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

Zwroty
boolean wartość „true”, jeśli obsługiwanych jest wielu użytkowników, w przeciwnym razie „false”.
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żywana będzie wartość zero.
Zwroty
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

Zwroty
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

Zwroty
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

Zwroty
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

Zwroty
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

Zwroty
boolean

Zgłasza
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Zwraca informację, czy urządzenie zezwala na uruchamianie użytkowników 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)).

Zwroty
boolean

Zgłasza
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Zwraca informację, czy urządzenie zezwala na uruchamianie użytkownikom widocznym 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

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.

Zwroty
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  listDisplayIds ()

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

Zwroty
Lista wyświetlaczy. Domyślna zawsze zwraca domyślny wyświetlacz 0.
Zgłasza
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
Zgłasza
DeviceNotAvailableException

listUsers

public abstract  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.

Zwroty
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, aby zarejestrować raport o błędzie.
Zwroty
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 urządzenia z konta użytkownika i zwraca true, jeśli operacja się uda, a w przeciwnym razie false.

Parametry
componentName String: administratora urządzenia do usunięcia.
userId int: użytkownika, w którego profilu znajduje się administrator urządzenia.
Zwroty
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, dokładając wszelkich starań.

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.
Zwroty
boolean Wartość true, jeśli użytkownik został usunięty. W przeciwnym razie wartość false.
Zgłasza
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: administratora urządzenia na właściciela urządzenia.
userId int: użytkownika, w którego kraju mieszka właściciel urządzenia.
Zwroty
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
Zwroty
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ć, aż operacja zacznie działać.

Parametry
userId int: użytkownika, aby rozpocząć w tle
waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.
Zwroty
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 mu 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świetlany użytkownikowi na początku
waitFlag boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany.
Zwroty
boolean true – jeśli użytkownikowi udało się uruchomić widoczną w tle aplikację.
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 żadnych działań. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.

Parametry
userId int: użytkownika, którego chcesz zatrzymać.
Zwroty
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.
Zwroty
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

Zwroty
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łącz 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.
Zwroty
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 razie problemu zwraca wartość null. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony 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.
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.
Zwroty
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)

W razie potrzeby poczekaj na zakończenie działania procesu snapuserd.

Parametry
currentPhase SnapuserdWaitPhase

Zgłasza
DeviceNotAvailableException