Ponawia próbę wykonania poleceń urządzenia dla konfigurowalnej ilości i udostępnia interfejs odzyskiwania urządzenia dla urządzeń, które nie odpowiadają.
Klasy zagnieżdżone |
---|
class | ITestDevice.ApexInfo Prosta klasa struct do przechowywania informacji o pojedynczym APEX |
class | ITestDevice.MountPointInfo Prosta klasa struktury do przechowywania informacji o pojedynczym punkcie montowania |
enum | ITestDevice.RecoveryMode |
Metody publiczne |
---|
abstract boolean | checkConnectivity () Sprawdź, czy urządzenie ma połączenie sieciowe. |
abstract boolean | clearErrorDialogs () Spróbuj odrzucić wszystkie okna dialogowe błędów aktualnie wyświetlane w interfejsie użytkownika urządzenia. |
abstract void | clearLastConnectedWifiNetwork () Czyści ostatnią podłączoną sieć Wi-Fi. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Łączy się z siecią Wi-Fi. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Łączy się z siecią Wi-Fi. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Łączy się z siecią Wi-Fi. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Łączy się z siecią Wi-Fi. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) Wariant connectToWifiNetwork(String, String) , który łączy się tylko wtedy, gdy urządzenie obecnie nie ma łączności sieciowej. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Wariant connectToWifiNetwork(String, String) , który łączy się tylko wtedy, gdy urządzenie obecnie nie ma łączności sieciowej. |
abstract int | createUser (String name) Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
abstract int | createUser (String name, boolean guest, boolean ephemeral) Utwórz użytkownika o podanej nazwie i dostarczonych flagach |
abstract int | createUserNoThrow (String name) Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
abstract void | 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 określająca, czy plik na urządzeniu istnieje dla danego użytkownika. |
abstract File | dumpHeap (String process, String devicePath) Spróbuj zrzucić stertę z serwera system_server. |
abstract boolean | enableNetworkMonitor () Umożliwia monitorowanie sieci na urządzeniu. |
abstract | getActiveApexes () Pobierz informacje o APEX-ach aktywowanych na urządzeniu. |
abstract | getAllSettings (String namespace) Zwróć pary klucz-wartość żądanej przestrzeni nazw. |
abstract String | getAndroidId (int userId) Znajdź i zwróć identyfikator Androida skojarzony z identyfikatorem użytkownika, null, jeśli nie zostanie znaleziony. |
abstract | getAndroidIds () Utwórz mapę identyfikatorów Androida, które pasują do identyfikatorów użytkowników. |
abstract PackageInfo | getAppPackageInfo (String packageName) Pobierz informacje o pakiecie zainstalowanym na urządzeniu. |
abstract | getAppPackageInfos () Pobierz informacje o pakietach zainstalowanych na urządzeniu. |
abstract DeviceFoldableState | getCurrentFoldableState () Zwraca bieżący stan składania urządzenia lub null, jeśli wystąpiły jakieś problemy. |
abstract int | getCurrentUser () Zwróć identyfikator aktualnie działającego użytkownika. |
abstract | getFoldableStates () Zwraca listę składanych stanów na urządzeniu. |
abstract | getInstalledPackageNames () Pobierz nazwy pakietów aplikacji obecne na urządzeniu. |
abstract String | getIpAddress () Pobiera adres IP urządzenia. |
abstract KeyguardControllerState | getKeyguardState () Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany. |
abstract | getMainlineModuleInfo () Uzyskaj informacje o głównych modułach zainstalowanych na urządzeniu. |
abstract int | getMaxNumberOfRunningUsersSupported () Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających użytkowników. |
abstract int | getMaxNumberOfUsersSupported () Uzyskaj maksymalną liczbę obsługiwanych użytkowników. |
abstract TestDeviceOptions | getOptions () Pobierz opcje testowe dla urządzenia. |
abstract Integer | getPrimaryUserId () Zwraca identyfikator głównego użytkownika. |
abstract InputStreamSource | getScreenshot () Pobiera zrzut ekranu z urządzenia. |
abstract InputStreamSource | getScreenshot (String format, boolean rescale) Pobiera zrzut ekranu z urządzenia. |
abstract InputStreamSource | getScreenshot (String format) Pobiera zrzut ekranu z urządzenia. |
abstract InputStreamSource | getScreenshot (long displayId) Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. |
abstract String | getSetting (String namespace, String key) Zobacz getSetting(int, String, String) i wykonywane na użytkowniku systemu. |
abstract String | getSetting (int userId, String namespace, String key) Zwróć wartość żądanego ustawienia. |
abstract | getUninstallablePackageNames () Pobierz nazwy pakietów aplikacji, które można odinstalować. |
abstract int | getUserFlags (int userId) Znajdź i zwróć flagi danego użytkownika. |
abstract | getUserInfos () Pobiera mapę useId do UserInfo na urządzeniu. |
abstract int | getUserSerialNumber (int userId) Zwróć numer seryjny skojarzony z identyfikatorem użytkownika, jeśli zostanie znaleziony, -10000 w innych przypadkach. |
abstract boolean | hasFeature (String feature) Sprawdź, czy funkcja jest dostępna na urządzeniu. |
abstract String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Zainstaluj pakiet Androida na urządzeniu. |
abstract String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj pakiet Androida na urządzeniu. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Zainstaluj pakiet Android na urządzeniu dla danego użytkownika. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Zainstaluj pakiet Android na urządzeniu dla danego użytkownika. |
default String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu). |
default String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu) dla danego użytkownika. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu) dla danego użytkownika. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. |
abstract boolean | isMultiUserSupported () Określa, czy obsługiwanych jest wielu użytkowników. |
abstract boolean | isPackageInstalled (String packageName) Zapytaj urządzenie o podaną nazwę pakietu, aby sprawdzić, czy jest aktualnie zainstalowane, czy nie. |
abstract boolean | isPackageInstalled (String packageName, String userId) Zapytaj urządzenie o podaną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest aktualnie zainstalowane dla tego użytkownika. |
abstract boolean | isUserRunning (int userId) Sprawdź, czy dany użytkownik jest uruchomiony. |
abstract boolean | isUserSecondary (int userId) Zwróć, czy określony użytkownik jest użytkownikiem pomocniczym zgodnie z jego flagami. |
abstract boolean | isWifiEnabled () Sprawdź, czy Wi-Fi jest włączone. |
abstract | listDisplayIds () Zbierz listę dostępnych wyświetlaczy id na urządzeniu zgłoszoną przez "dumpsys SurfaceFlinger". |
abstract | listUsers () Pobiera listę użytkowników na urządzeniu. |
abstract boolean | removeAdmin (String componentName, int userId) Usuń administratora danego urządzenia w danym użytkowniku i zwróć true , jeśli się powiedzie, false w przeciwnym razie. |
abstract void | removeOwners () Jak najlepiej usuń wszystkich dotychczasowych właścicieli profili urządzeń. |
abstract boolean | removeUser (int userId) Usuń danego użytkownika z urządzenia. |
abstract boolean | setDeviceOwner (String componentName, int userId) Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika. |
abstract void | setSetting (String namespace, String key, String value) Zobacz setSetting(int, String, String, String) i 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 aktualnie zatrzymany. |
abstract boolean | startUser (int userId, boolean waitFlag) Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. |
abstract boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Zatrzymaj danego użytkownika. |
abstract boolean | stopUser (int userId) Zatrzymuje danego użytkownika. |
abstract boolean | switchUser (int userId) Przełącz się na inny identyfikator użytkownika z domyślnym limitem czasu. |
abstract boolean | switchUser (int userId, long timeout) Przełącz się na inny identyfikator użytkownika z podanym limitem czasu jako terminem. |
abstract String | uninstallPackage (String packageName) Odinstaluj pakiet Androida z urządzenia. |
abstract String | uninstallPackageForUser (String packageName, int userId) Odinstaluj pakiet Androida z urządzenia dla danego użytkownika. |
Metody publiczne
sprawdźŁączność
public abstract boolean checkConnectivity ()
Sprawdź, czy urządzenie ma połączenie sieciowe.
Zwroty |
---|
boolean | true , jeśli urządzenie ma działające połączenie sieciowe, false overwise. |
wyczyśćErrorDialogs
public abstract boolean clearErrorDialogs ()
Spróbuj odrzucić wszystkie okna dialogowe błędów aktualnie wyświetlane w interfejsie użytkownika urządzenia.
Zwroty |
---|
boolean | true , jeśli nie było żadnych okien dialogowych lub okna dialogowe zostały pomyślnie wyczyszczone. false inaczej. |
wyczyśćOstatniePołączoneSiećWifi
public abstract void clearLastConnectedWifiNetwork ()
Czyści ostatnią podłączoną sieć Wi-Fi. Powinno to zostać wywołane podczas rozpoczynania nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi używaną w poprzednim teście po ponownym uruchomieniu urządzenia.
Połącz z siecią Wifi
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje 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ła przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie ITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.
Parametry |
---|
wifiSsidToPsk | : Mapa identyfikatorów SSID Wi-Fi na hasła. |
scanSsid | boolean : czy skanować w poszukiwaniu ukrytych identyfikatorów SSID dla tej sieci. |
Zwroty |
---|
boolean | true , jeśli pomyślnie połączono z siecią Wi-Fi. false inaczej |
Połącz z siecią Wifi
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje 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ła przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie ITestDevice#disconnectFromWifi()
lub ITestDevice#clearLastConnectedWifiNetwork()
.
Parametry |
---|
wifiSsidToPsk | : Mapa identyfikatorów SSID Wi-Fi na hasła. |
Zwroty |
---|
boolean | true , jeśli pomyślnie połączono z siecią Wi-Fi. false inaczej |
Połącz z siecią Wifi
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do momentu nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie
ITestDevice#disconnectFromWifi()
lub
ITestDevice#clearLastConnectedWifiNetwork()
.
Parametry |
---|
wifiSsid | String : identyfikator sieci Wi-Fi, z którym chcesz się połączyć |
wifiPsk | String : hasło PSK lub null, jeśli nie jest zaszyfrowane |
Zwroty |
---|
boolean | true , jeśli pomyślnie połączono z siecią Wi-Fi. false inaczej |
Połącz z siecią Wifi
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do momentu nawiązania połączenia z określoną siecią Wi-Fi. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie
ITestDevice#disconnectFromWifi()
lub
ITestDevice#clearLastConnectedWifiNetwork()
.
Parametry |
---|
wifiSsid | String : identyfikator sieci Wi-Fi, z którym chcesz się połączyć |
wifiPsk | String : hasło PSK lub null, jeśli nie jest zaszyfrowane |
scanSsid | boolean : czy skanować w poszukiwaniu ukrytego identyfikatora SSID dla tej sieci. |
Zwroty |
---|
boolean | true , jeśli pomyślnie połączono z siecią Wi-Fi. false inaczej |
connectToWifiNetworkIfNoeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Wariant connectToWifiNetwork(String, String)
, który łączy się tylko wtedy, gdy urządzenie obecnie nie ma łączności sieciowej.
Parametry |
---|
scanSsid | boolean : czy skanować w poszukiwaniu ukrytego identyfikatora SSID dla tej sieci |
Zwroty |
---|
boolean | true , jeśli pomyślnie połączono z siecią Wi-Fi. false inaczej |
connectToWifiNetworkIfNoeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
Wariant connectToWifiNetwork(String, String)
, który łączy się tylko wtedy, gdy urządzenie obecnie nie ma łączności sieciowej.
Zwroty |
---|
boolean | true , jeśli pomyślnie połączono z siecią Wi-Fi. false inaczej |
Stwórz użytkownika
public abstract int createUser (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
Parametry |
---|
name | String : użytkownika do utworzenia na urządzeniu |
Zwroty |
---|
int | liczba całkowita dla utworzonego identyfikatora użytkownika |
Stwórz użytkownika
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
Utwórz użytkownika o podanej nazwie i dostarczonych flagach
Parametry |
---|
name | String : użytkownika do utworzenia na urządzeniu |
guest | boolean : włącz flagę użytkownika --gość podczas tworzenia |
ephemeral | boolean : włącz flagę użytkownika --ephemeral podczas tworzenia |
Zwroty |
---|
int | id utworzonego użytkownika |
utwórzUżytkownikaNieRzucaj
public abstract int createUserNoThrow (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
Parametry |
---|
name | String : użytkownika do utworzenia na urządzeniu |
Zwroty |
---|
int | liczba całkowita dla utworzonego identyfikatora użytkownika lub -1 dla błędu. |
wyłącz ochronę klawiatury
public abstract void disableKeyguard ()
Próby wyłączenia blokady klawiatury.
Najpierw poczekaj na gotowość wysyłania danych wejściowych, dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ w obecnej implementacji frameworka zdarzają się sporadyczne sytuacje wyścigu. Następnie wysyłane jest polecenie wyłączenia blokady klawiatury (działa tylko na niezabezpieczonych)
wyłącz Monitor sieci
public abstract boolean disableNetworkMonitor ()
Wyłącza monitorowanie sieci na urządzeniu.
Zwroty |
---|
boolean | true , jeśli monitorowanie zostało pomyślnie wyłączone. false , jeśli się nie udało. |
rozłącz z Wifi
public abstract boolean disconnectFromWifi ()
Rozłącza się z siecią Wi-Fi.
Usuwa wszystkie sieci z listy znanych sieci i wyłącza Wi-Fi.
Zwroty |
---|
boolean | true , jeśli pomyślnie odłączono od sieci Wi-Fi. false , jeśli rozłączenie nie powiodło się. |
czyFileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
Metoda pomocnicza określająca, czy plik na urządzeniu istnieje dla danego użytkownika.
Parametry |
---|
deviceFilePath | String : bezwzględna ścieżka pliku na urządzeniu do sprawdzenia |
userId | int : identyfikator użytkownika, według którego należy sprawdzić istnienie pliku |
Zwroty |
---|
boolean | true , jeśli plik istnieje, w przeciwnym razie false . |
dumpHeap
public abstract File dumpHeap (String process,
String devicePath)
Spróbuj zrzucić stertę z serwera system_server. Obowiązkiem dzwoniącego jest oczyszczenie zrzuconego pliku.
Parametry |
---|
process | String : nazwa procesu urządzenia do zrzutu. |
devicePath | String : ścieżka na urządzeniu, gdzie umieścić zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia. |
Zwroty |
---|
File | ERROR(/File) zawierający raport. Null, jeśli coś się nie powiedzie. |
włącz Monitor sieci
public abstract boolean enableNetworkMonitor ()
Umożliwia monitorowanie sieci na urządzeniu.
Zwroty |
---|
boolean | true , jeśli monitorowanie jest włączone pomyślnie. false , jeśli się nie udało. |
getActiveApexes
public abstract getActiveApexes ()
Pobierz informacje o APEX-ach aktywowanych na urządzeniu.
pobierz wszystkie ustawienia
public abstract getAllSettings (String namespace)
Zwróć pary klucz-wartość żądanej przestrzeni nazw.
Parametry |
---|
namespace | String : musi być jednym z {"system", "secure", "global"} |
Zwroty |
---|
| mapa par klucz-wartość. Null, jeśli przestrzeń nazw nie jest obsługiwana. |
pobierz identyfikator Androida
public abstract String getAndroidId (int userId)
Znajdź i zwróć identyfikator Androida skojarzony z identyfikatorem użytkownika, null, jeśli nie zostanie znaleziony.
pobierz identyfikatory Androida
public abstract getAndroidIds ()
Utwórz mapę identyfikatorów Androida, które pasują do identyfikatorów użytkowników. Nie ma gwarancji, że każdy identyfikator użytkownika znajdzie identyfikator Androida powiązany z tą funkcją, więc niektóre identyfikatory użytkowników mogą mieć wartość null.
Zwroty |
---|
| Znaleziono mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
Pobierz informacje o pakiecie zainstalowanym na urządzeniu.
Parametry |
---|
packageName | String |
getAppPackageInfos
public abstract getAppPackageInfos ()
Pobierz informacje o pakietach zainstalowanych na urządzeniu.
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
Zwraca bieżący stan składania urządzenia lub null, jeśli wystąpiły jakieś problemy.
getCurrentUser
public abstract int getCurrentUser ()
Zwróć identyfikator aktualnie działającego użytkownika. W przypadku błędu zwróć -10000.
getFoldableStates
public abstract getFoldableStates ()
Zwraca listę składanych stanów na urządzeniu. Można uzyskać za pomocą "cmd device_state print-states".
getInstalledPackageNames
public abstract getInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji obecne na urządzeniu.
getIpAdres
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 |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany.
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
Uzyskaj informacje o głównych modułach zainstalowanych na urządzeniu.
public abstract int getMaxNumberOfRunningUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających użytkowników. Domyślnie 0.
Zwroty |
---|
int | liczba całkowita wskazująca liczbę jednocześnie działających użytkowników |
public abstract int getMaxNumberOfUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników. Domyślnie 0.
Zwroty |
---|
int | liczba całkowita wskazująca liczbę obsługiwanych użytkowników |
getOptions
public abstract TestDeviceOptions getOptions ()
Pobierz opcje testowe dla urządzenia.
getPrimaryUserId
public abstract Integer getPrimaryUserId ()
Zwraca identyfikator głównego użytkownika.
Zwroty |
---|
Integer | identyfikator użytkownika głównego użytkownika, jeśli istnieje, i null, jeśli nie ma głównego użytkownika. |
pobierz zrzut ekranu
public abstract InputStreamSource getScreenshot ()
Pobiera zrzut ekranu z urządzenia.
pobierz zrzut ekranu
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
Pobiera zrzut ekranu z urządzenia. Zalecane jest użycie getScreenshot(String)
zamiast kodowania JPEG dla mniejszych rozmiarów.
Parametry |
---|
format | String : obsługiwane PNG, JPEG |
rescale | boolean : czy zrzut ekranu powinien być przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu |
pobierz zrzut ekranu
public abstract InputStreamSource getScreenshot (String format)
Pobiera zrzut ekranu z urządzenia. Zalecane jest użycie getScreenshot(format) zamiast kodowania JPEG dla mniejszych rozmiarów
Parametry |
---|
format | String : obsługiwane PNG, JPEG |
pobierz zrzut ekranu
public abstract InputStreamSource getScreenshot (long displayId)
Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. Format to PNG.
DO ZROBIENIA: rozszerz powyższe implementacje o obsługę „formatu” i „przeskalowania”
Parametry |
---|
displayId | long : identyfikator ekranu, z którego ma zostać pobrany zrzut ekranu. |
getSetting
public abstract String getSetting (String namespace,
String key)
Zobacz getSetting(int, String, String)
i wykonywane na użytkowniku systemu.
Parametry |
---|
namespace | String |
key | String |
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
Zwróć wartość żądanego ustawienia. przestrzeń nazw musi być jedną z następujących: {"system", "bezpieczna", "globalna"}
Parametry |
---|
userId | int |
namespace | String |
key | String |
Zwroty |
---|
String | wartość powiązana z namespace:key użytkownika. Null, jeśli nie znaleziono. |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
Pobierz nazwy pakietów aplikacji, które można odinstalować. Jest to obecnie definiowane jako pakiety niesystemowe i zaktualizowane pakiety systemowe.
Zwroty |
---|
| ERROR(/Set) nazw pakietów String do odinstalowania aktualnie zainstalowanych na urządzeniu. |
zdobądź flagi użytkownika
public abstract int getUserFlags (int userId)
Znajdź i zwróć flagi danego użytkownika. Flagi są zdefiniowane w klasie „android.content.pm.UserInfo” w Android Open Source Project.
Zwroty |
---|
int | flagi związane z podanym identyfikatorem użytkownika, jeśli zostaną znalezione, -10000 w innych przypadkach. |
pobierzInformacjeUżytkownika
public abstract getUserInfos ()
Pobiera mapę useId do UserInfo
na urządzeniu. DeviceRuntimeException
, jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
Zwroty |
---|
| lista obiektów UserInfo. |
pobierz numer seryjny użytkownika
public abstract int getUserSerialNumber (int userId)
Zwróć numer seryjny skojarzony z identyfikatorem użytkownika, jeśli zostanie znaleziony, -10000 w innych przypadkach.
ma funkcję
public abstract boolean hasFeature (String feature)
Sprawdź, czy funkcja jest dostępna na urządzeniu.
Parametry |
---|
feature | String : jaki format powinien mieć „cecha: " lub " " bezpośrednio. |
Zwroty |
---|
boolean | Prawda, jeśli funkcja zostanie znaleziona, w przeciwnym razie fałsz. |
pakiet instalacyjny
public abstract String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
pakiet instalacyjny
public abstract String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
Uwaga: Tę funkcję należy wywoływać tylko w przypadkach, w których wymagana jest wyraźna kontrola nad przyznawaniem uprawnień w czasie wykonywania w czasie instalacji.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : czy wszystkie uprawnienia wykonawcze powinny być przyznane w czasie instalacji |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Rzuty |
---|
DeviceNotAvailableException | jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać. |
UnsupportedOperationException | jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu. |
installPackageForUser
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Zainstaluj pakiet Android na urządzeniu dla danego użytkownika.
Uwaga: Tę funkcję należy wywoływać tylko w przypadkach, w których wymagana jest wyraźna kontrola nad przyznawaniem uprawnień w czasie wykonywania w czasie instalacji.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : czy wszystkie uprawnienia wykonawcze powinny być przyznane w czasie instalacji |
userId | int : całkowity identyfikator użytkownika do zainstalowania. |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Rzuty |
---|
DeviceNotAvailableException | jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać. |
UnsupportedOperationException | jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu. |
installPackageForUser
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Zainstaluj pakiet Android na urządzeniu dla danego użytkownika.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
userId | int : całkowity identyfikator użytkownika do zainstalowania. |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu). Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Parametry |
---|
packageFiles | : lokalne pliki apk |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Rzuty |
---|
DeviceNotAvailableException | jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać. |
UnsupportedOperationException | jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Uwaga: Tę funkcję należy wywoływać tylko w przypadkach, w których wymagana jest wyraźna kontrola nad przyznawaniem uprawnień w czasie wykonywania w czasie instalacji.
Parametry |
---|
packageFiles | : zdalne ścieżki plików apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : czy wszystkie uprawnienia wykonawcze powinny być przyznane w czasie instalacji |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Rzuty |
---|
DeviceNotAvailableException | jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać. |
UnsupportedOperationException | jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu) dla danego użytkownika. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Uwaga: Tę funkcję należy wywoływać tylko w przypadkach, w których wymagana jest wyraźna kontrola nad przyznawaniem uprawnień w czasie wykonywania w czasie instalacji.
Parametry |
---|
packageFiles | : lokalne pliki apk |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : czy wszystkie uprawnienia wykonawcze powinny być przyznane w czasie instalacji |
userId | int : całkowity identyfikator użytkownika do zainstalowania. |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Rzuty |
---|
DeviceNotAvailableException | jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać. |
UnsupportedOperationException | jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu) dla danego użytkownika. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Parametry |
---|
packageFiles | : lokalne pliki apk |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
userId | int : całkowity identyfikator użytkownika do zainstalowania. |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Rzuty |
---|
DeviceNotAvailableException | jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać. |
UnsupportedOperationException | jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu. |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Uwaga: Tę funkcję należy wywoływać tylko w przypadkach, w których wymagana jest wyraźna kontrola nad przyznawaniem uprawnień w czasie wykonywania w czasie instalacji.
Parametry |
---|
remoteApkPaths | : zdalne ścieżki plików apk |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : czy wszystkie uprawnienia wykonawcze powinny być przyznane w czasie instalacji |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Rzuty |
---|
DeviceNotAvailableException | jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać. |
UnsupportedOperationException | jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu. |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Parametry |
---|
remoteApkPaths | : zdalne ścieżki plików apk |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Rzuty |
---|
DeviceNotAvailableException | jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać. |
UnsupportedOperationException | jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu. |
jest obsługiwana przez wielu użytkowników
public abstract boolean isMultiUserSupported ()
Określa, czy obsługiwanych jest wielu użytkowników.
Zwroty |
---|
boolean | prawda, jeśli obsługiwanych jest wielu użytkowników, w przeciwnym razie fałsz |
czy pakiet jest zainstalowany
public abstract boolean isPackageInstalled (String packageName)
Zapytaj urządzenie o podaną nazwę pakietu, aby sprawdzić, czy jest aktualnie zainstalowane, czy nie.
Parametry |
---|
packageName | String |
Zwroty |
---|
boolean | Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie fałsz. |
czy pakiet jest zainstalowany
public abstract boolean isPackageInstalled (String packageName,
String userId)
Zapytaj urządzenie o podaną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest aktualnie zainstalowane dla tego użytkownika.
Parametry |
---|
packageName | String : pakiet, który sprawdzamy, czy jest zainstalowany. |
userId | String : Identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli ma wartość null, zostanie użyte zero użytkownika podstawowego. |
Zwroty |
---|
boolean | Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie fałsz. |
jestUżytkownikUruchomiony
public abstract boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest uruchomiony.
Zwroty |
---|
boolean | Prawda, jeśli użytkownik jest uruchomiony, we wszystkich pozostałych przypadkach fałsz. |
jest drugorzędny użytkownik
public abstract boolean isUserSecondary (int userId)
Zwróć, czy określony użytkownik jest użytkownikiem pomocniczym zgodnie z jego flagami.
Zwroty |
---|
boolean | prawda, jeśli użytkownik jest drugorzędny, w przeciwnym razie fałsz. |
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 statusu Wi-Fi przed testami, które nie powinny być uruchamiane z Wi-Fi, np. testy danych mobilnych.
Zwroty |
---|
boolean | true , jeśli Wi-Fi jest włączone. false , jeśli wyłączone |
listDisplayIds
public abstract listDisplayIds ()
Zbierz listę dostępnych wyświetlaczy id na urządzeniu zgłoszoną przez "dumpsys SurfaceFlinger".
Zwroty |
---|
| Lista wyświetlaczy. Domyślnie zawsze zwraca domyślny wyświetlacz 0. |
listaUżytkownicy
public abstract listUsers ()
Pobiera listę użytkowników na urządzeniu. DeviceRuntimeException
, jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
Zwroty |
---|
| lista identyfikatorów użytkowników. |
usuńAdministratora
public abstract boolean removeAdmin (String componentName,
int userId)
Usuń administratora danego urządzenia w danym użytkowniku i zwróć true
, jeśli się powiedzie, false
w przeciwnym razie.
Parametry |
---|
componentName | String : administratora urządzenia do usunięcia. |
userId | int : użytkownika, w którym mieszka administrator urządzenia. |
Zwroty |
---|
boolean | Prawda, jeśli się powiedzie, w przeciwnym razie fałsz. |
usuńWłaściciele
public abstract void removeOwners ()
Jak najlepiej usuń wszystkich dotychczasowych właścicieli profili urządzeń.
usuńUżytkownika
public abstract boolean removeUser (int userId)
Usuń danego użytkownika z urządzenia.
Parametry |
---|
userId | int : użytkownika do usunięcia |
Zwroty |
---|
boolean | true, jeśli udało nam się usunąć użytkownika, w przeciwnym razie false. |
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, który ma być właścicielem urządzenia. |
userId | int : użytkownika, w którym mieszka właściciel urządzenia. |
Zwroty |
---|
boolean | Prawda, jeśli się powiedzie, w przeciwnym razie fałsz. |
ustawUstawienie
public abstract void setSetting (String namespace,
String key,
String value)
Zobacz setSetting(int, String, String, String)
i wykonywane na użytkowniku systemu.
Parametry |
---|
namespace | String |
key | String |
value | String |
ustawUstawienie
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu. przestrzeń nazw musi być jedną z następujących: {"system", "bezpieczna", "globalna"}
Parametry |
---|
userId | int |
namespace | String |
key | String |
value | String |
startUser
public abstract boolean startUser (int userId)
Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda to NOOP.
Parametry |
---|
userId | int : użytkownika, aby uruchomić w tle |
Zwroty |
---|
boolean | true , jeśli użytkownik został pomyślnie uruchomiony w tle. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda to NOOP. Możliwe jest podanie dodatkowej flagi, aby poczekać na efekt operacji.
Parametry |
---|
userId | int : użytkownika, aby uruchomić w tle |
waitFlag | boolean : sprawi, że polecenie zaczeka, aż użytkownik zostanie uruchomiony i odblokowany. |
Zwroty |
---|
boolean | true , jeśli użytkownik został pomyślnie uruchomiony w tle. |
stopUżytkownik
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Zatrzymaj danego użytkownika. Możliwe jest zapewnienie dodatkowych flag, aby czekać na efekt operacji i wymusić zakończenie działania użytkownika. Nie można zatrzymać bieżącego i systemowego użytkownika.
Parametry |
---|
userId | int : użytkownika do zatrzymania. |
waitFlag | boolean : sprawi, że polecenie będzie czekać, aż użytkownik zostanie zatrzymany. |
forceFlag | boolean : wymusi zatrzymanie użytkownika. |
Zwroty |
---|
boolean | true, jeśli użytkownik został pomyślnie zatrzymany. |
stopUżytkownik
public abstract boolean stopUser (int userId)
Zatrzymuje danego użytkownika. Jeśli użytkownik jest już zatrzymany, ta metoda to NOOP. Nie można zatrzymać bieżącego i systemowego użytkownika.
Parametry |
---|
userId | int : użytkownika do zatrzymania. |
Zwroty |
---|
boolean | true, jeśli użytkownik został pomyślnie zatrzymany. |
Zmień użytkownika
public abstract boolean switchUser (int userId)
Przełącz się na inny identyfikator użytkownika z domyślnym limitem czasu. switchUser(int, long)
.
Zwroty |
---|
boolean | Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie fałsz. |
Zmień użytkownika
public abstract boolean switchUser (int userId,
long timeout)
Przełącz się na inny identyfikator użytkownika z podanym limitem czasu jako terminem. Spróbuj wyłączyć blokadę klawiatury po pomyślnej zmianie użytkownika.
Parametry |
---|
userId | int |
timeout | long : czekanie przed zwróceniem wartości false dla przełącznika-użytkownika nie powiodło się. |
Zwroty |
---|
boolean | Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie fałsz. |
odinstalujPakiet
public abstract String uninstallPackage (String packageName)
Odinstaluj pakiet Androida z urządzenia.
Parametry |
---|
packageName | String : pakiet Androida do odinstalowania |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
odinstalujPakietDlaUżytkownika
public abstract String uninstallPackageForUser (String packageName,
int userId)
Odinstaluj pakiet Androida z urządzenia dla danego użytkownika.
Parametry |
---|
packageName | String : pakiet Androida do odinstalowania |
userId | int : całkowity identyfikator użytkownika do odinstalowania. |
Zwroty |
---|
String | String z kodem błędu lub null w przypadku powodzenia. |
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2022-08-15 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Brak potrzebnych mi informacji"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Zbyt skomplikowane / zbyt wiele czynności do wykonania"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Nieaktualne treści"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problem z tłumaczeniem"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problem z przykładami/kodem"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Inne"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Łatwo zrozumieć"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Rozwiązało to mój problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Inne"
}]