ITestDevice
public
interface
ITestDevice
implements
INativeDevice
com.android.tradefed.device.ITestDevice
|
Zapewnia niezawodny interfejs API o nieco wyższym poziomie dla biblioteki IDevice
.
W przypadku niedziałających poleceń urządzenia powtarza je w określonej liczbie i zapewnia interfejs odzyskiwania urządzenia.
Podsumowanie
Zagnieżdżone klasy |
class |
ITestDevice.ApexInfo
Prosta klasa struktury do przechowywania informacji o pojedynczym APEX
|
class |
ITestDevice.MountPointInfo
Prosta klasa struktury do przechowywania informacji o pojedynczym punkcie zamontowania.
|
Metody publiczne |
abstract
boolean
|
canSwitchToHeadlessSystemUser()
Zwraca informację, czy można przełączyć się na użytkownika systemu bez interfejsu.
|
abstract
boolean
|
checkConnectivity()
Sprawdź, czy urządzenie ma połączenie z siecią.
|
abstract
boolean
|
clearErrorDialogs()
Spróbuj zamknąć wszystkie okna z błędami wyświetlane obecnie w interfejsie urządzenia.
|
abstract
void
|
clearLastConnectedWifiNetwork()
Czyści ostatnią połączoną sieć Wi-Fi.
|
abstract
boolean
|
connectToWifiNetwork( wifiSsidToPsk)
Połącza się z siecią Wi-Fi.
|
abstract
boolean
|
connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)
Połącza się z siecią Wi-Fi.
|
abstract
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Połącza się z siecią Wi-Fi.
|
abstract
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Połącza się z siecią Wi-Fi.
|
abstract
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Wariant connectToWifiNetwork(String, String) , który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z internetem.
|
abstract
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Wariant connectToWifiNetwork(String, String) , który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z internetem.
|
abstract
int
|
createUser(String name)
Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.
|
abstract
int
|
createUser(String name, boolean guest, boolean ephemeral)
Utwórz użytkownika z danym imieniem i podanymi flagami
|
abstract
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Utwórz użytkownika z danym imieniem i podanymi flagami
|
abstract
int
|
createUserNoThrow(String name)
Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.
|
abstract
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Usuwa zarejestrowany IDeviceActionReceiver .
|
abstract
void
|
disableKeyguard()
Próbuje wyłączyć blokadę klawiatury.
|
abstract
boolean
|
disableNetworkMonitor()
Wyłącza monitorowanie sieci na urządzeniu.
|
abstract
boolean
|
disconnectFromWifi()
rozłącza się z siecią Wi-Fi.
|
abstract
boolean
|
doesFileExist(String deviceFilePath, int userId)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje dla danego użytkownika.
|
abstract
File
|
dumpHeap(String process, String devicePath)
Spróbuj zrzucić stos z system_server.
|
abstract
boolean
|
enableNetworkMonitor()
Umożliwia monitorowanie sieci na urządzeniu.
|
abstract
|
getActiveApexes()
Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.
|
abstract
|
getAllSettings(String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw.
|
abstract
String
|
getAndroidId(int userId)
Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.
|
abstract
|
getAndroidIds()
Utwórz mapę identyfikatorów Androida, które pasują do identyfikatorów użytkowników.
|
abstract
PackageInfo
|
getAppPackageInfo(String packageName)
Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.
|
abstract
|
getAppPackageInfos()
Pobierać informacje o pakietach zainstalowanych na urządzeniu.
|
abstract
InputStreamSource
|
getBugreport()
Pobiera raport o błędzie z urządzenia.
|
abstract
InputStreamSource
|
getBugreportz()
Pobiera raport o błędzie z urządzenia.
|
abstract
DeviceFoldableState
|
getCurrentFoldableState()
Zwraca bieżący stan urządzenia lub wartość null, jeśli wystąpiły jakieś problemy.
|
abstract
int
|
getCurrentUser()
Zwraca identyfikator bieżącego użytkownika.
|
abstract
|
getFoldableStates()
Zwraca listę stanów składania urządzenia.
|
abstract
|
getInstalledPackageNames()
Pobierz nazwy pakietów aplikacji obecnych na urządzeniu.
|
abstract
String
|
getIpAddress()
Pobiera adres IP urządzenia.
|
abstract
KeyguardControllerState
|
getKeyguardState()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest on obsługiwany.
|
abstract
Integer
|
getMainUserId()
Zwraca identyfikator głównego użytkownika.
|
abstract
|
getMainlineModuleInfo()
Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.
|
abstract
int
|
getMaxNumberOfRunningUsersSupported()
Pobierz maksymalną liczbę obsługiwanych jednocześnie uruchomionych użytkowników.
|
abstract
int
|
getMaxNumberOfUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników.
|
abstract
TestDeviceOptions
|
getOptions()
Pobierz opcje testowania urządzenia.
|
abstract
Integer
|
getPrimaryUserId()
Zwraca podstawowy identyfikator użytkownika.
|
abstract
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Robi zrzut ekranu z urządzenia.
|
abstract
InputStreamSource
|
getScreenshot(long displayId)
Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania.
|
abstract
InputStreamSource
|
getScreenshot(String format)
Robi zrzut ekranu z urządzenia.
|
abstract
InputStreamSource
|
getScreenshot()
Robi zrzut ekranu z urządzenia.
|
abstract
String
|
getSetting(int userId, String namespace, String key)
Zwraca wartość żądanego ustawienia.
|
abstract
String
|
getSetting(String namespace, String key)
Zobacz getSetting(int, String, String) i wykonane przez użytkownika systemowego.
|
abstract
|
getUninstallablePackageNames()
Pobierz nazwy pakietów aplikacji, które można odinstalować.
|
abstract
int
|
getUserFlags(int userId)
Znajdowanie i zwracanie flag danego użytkownika.
|
abstract
|
getUserInfos()
Pobiera mapę useId na urządzeniu do UserInfo .
|
abstract
int
|
getUserSerialNumber(int userId)
W przeciwnym razie zwraca -10000.
|
abstract
boolean
|
hasFeature(String feature)
Sprawdzanie, czy funkcja jest dostępna na urządzeniu
|
abstract
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
|
abstract
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
|
abstract
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Instalowanie pakietu Androida na urządzeniu danego użytkownika.
|
abstract
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
instalować pakiet Androida na urządzeniu danego użytkownika.
|
default
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
Instalowanie aplikacji na Androida utworzonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone).
|
default
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.
|
default
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
Instalowanie aplikacji na Androida złożonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone) dla danego użytkownika.
|
default
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instalowanie przez danego użytkownika aplikacji na Androida złożonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone)
|
default
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.
|
default
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem.
|
abstract
boolean
|
isHeadlessSystemUserMode()
Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.
|
abstract
boolean
|
isMainUserPermanentAdmin()
Zwraca informację, czy główny użytkownik jest stałym administratorem i czy nie można go usunąć ani obniżyć jego uprawnień do poziomu nieadministratora.
|
abstract
boolean
|
isMultiUserSupported()
Określa, czy obsługiwany jest tryb wielu użytkowników.
|
abstract
boolean
|
isPackageInstalled(String packageName, String userId)
Przesyłanie zapytania do urządzenia o określonej nazwie pakietu i określonym identyfikatorem użytkownika w celu sprawdzenia, czy aplikacja jest obecnie zainstalowana na tym urządzeniu.
|
abstract
boolean
|
isPackageInstalled(String packageName)
Wysłać zapytanie do urządzenia o określonej nazwie pakietu, aby sprawdzić, czy jest on zainstalowany.
|
abstract
boolean
|
isUserRunning(int userId)
Sprawdź, czy dany użytkownik jest obecny.
|
abstract
boolean
|
isUserSecondary(int userId)
Zwraca informację, czy podany użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.
|
abstract
boolean
|
isUserVisible(int userId)
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 informacje o tym, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle w konfiguracji ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .
|
abstract
boolean
|
isVisibleBackgroundUsersSupported()
Zwraca informację, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle.
|
abstract
boolean
|
isWifiEnabled()
Sprawdź, czy Wi-Fi jest włączone.
|
abstract
|
listDisplayIds()
Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys
SurfaceFlinger”.
|
abstract
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Pobiera listę wyświetlaczy, których można używać do start a user visible in the background .
|
abstract
|
listUsers()
Pobiera listę użytkowników na urządzeniu.
|
abstract
boolean
|
logBugreport(String dataName, ITestLogger listener)
Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w raportach dla zgłaszających.
|
default
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
Poinformuj urządzenie, aby czekało na zakończenie snapuserd.
|
abstract
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Rejestruje IDeviceActionReceiver na tym urządzeniu.
|
abstract
boolean
|
removeAdmin(String componentName, int userId)
Usuń danego administratora urządzenia w danym użytkowniku i wróć true , jeśli operacja się powiedzie, w przeciwnym razie false .
|
abstract
void
|
removeOwners()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia.
|
abstract
boolean
|
removeUser(int userId)
usunąć danego użytkownika z urządzenia,
|
abstract
boolean
|
setDeviceOwner(String componentName, int userId)
Ustaw komponent administratora urządzenia jako właściciela urządzenia u danego użytkownika.
|
abstract
void
|
setSetting(String namespace, String key, String value)
Zobacz setSetting(int, String, String, String) i wykonane przez użytkownika systemowego.
|
abstract
void
|
setSetting(int userId, String namespace, String key, String value)
Dodaje wartość ustawienia do przestrzeni nazw danego użytkownika.
|
abstract
boolean
|
startUser(int userId)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.
|
abstract
boolean
|
startUser(int userId, boolean waitFlag)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.
|
abstract
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać na nim działania).
|
abstract
boolean
|
stopUser(int userId)
Zatrzymuje danego użytkownika.
|
abstract
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Zatrzymanie danego użytkownika.
|
abstract
boolean
|
switchUser(int userId)
Przełącz się na innego użytkownika o domyślnym czasie oczekiwania.
|
abstract
boolean
|
switchUser(int userId, long timeout)
Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem.
|
abstract
Bugreport
|
takeBugreport()
Przyjmuje zgłoszenie o błędzie i zwraca je w obiekcie Bugreport , aby je obsłużyć.
|
abstract
String
|
uninstallPackage(String packageName)
Odinstaluj pakiet Androida z urządzenia.
|
abstract
String
|
uninstallPackageForUser(String packageName, int userId)
Odinstaluj pakiet Androida z urządzenia danego użytkownika.
|
default
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
W razie potrzeby poczekaj, aż snapuserd zakończy działanie.
|
Metody publiczne
canSwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
Zwraca informację, czy można przełączyć się na użytkownika systemu bez interfejsu.
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. |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
Spróbuj zamknąć wszystkie okna z błędami wyświetlane obecnie w interfejsie urządzenia.
Zwroty |
boolean |
true , jeśli nie było żadnych dialogów lub zostały one usunięte.
false w innych przypadkach. |
clearLastConnectedWifiNetwork
public abstract void clearLastConnectedWifiNetwork ()
Czyści ostatnią połączoną sieć Wi-Fi. Należy go wywołać podczas uruchamiania nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi użytą w poprzednim teście po ponownym uruchomieniu urządzenia.
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Połącza się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi()
lub ITestDevice.clearLastConnectedWifiNetwork()
.
Parametry |
wifiSsidToPsk |
: mapa identyfikatorów SSID sieci Wi-Fi z hasłami. |
Zwroty |
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Połącza się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi()
lub ITestDevice.clearLastConnectedWifiNetwork()
.
Parametry |
wifiSsidToPsk |
: mapa identyfikatorów SSID sieci Wi-Fi z hasłami. |
scanSsid |
boolean : czy skanować ukryte identyfikatory SSID tej sieci. |
Zwroty |
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
Połącza się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z określoną siecią Wi-Fi.
Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi()
lub ITestDevice.clearLastConnectedWifiNetwork()
.
Parametry |
wifiSsid |
String : nazwa sieci Wi-Fi, z którą chcesz się połączyć |
wifiPsk |
String : hasło PSK lub null, jeśli nie jest zaszyfrowane |
Zwroty |
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Połącza się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do czasu nawiązania połączenia z określoną siecią Wi-Fi.
Po nawiązaniu połączenia instancja będzie próbować przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie wywołana funkcja ITestDevice.disconnectFromWifi()
lub ITestDevice.clearLastConnectedWifiNetwork()
.
Parametry |
wifiSsid |
String : nazwa sieci Wi-Fi, z którą chcesz się połączyć |
wifiPsk |
String : hasło PSK lub null, jeśli nie jest zaszyfrowane |
scanSsid |
boolean : czy skanować ukryte identyfikatory SSID tej sieci. |
Zwroty |
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Wariant connectToWifiNetwork(String, String)
, który łączy się tylko wtedy, gdy urządzenie nie ma obecnie połączenia z internetem.
Parametry |
scanSsid |
boolean : czy skanować ukryty identyfikator SSID tej sieci |
Zwroty |
boolean |
true jeśli urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
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 urządzenie jest połączone z siecią Wi-Fi. false w innym przypadku |
createUser
public abstract int createUser (String name)
Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.
Parametry |
name |
String : użytkownika, którego chcesz utworzyć na urządzeniu |
Zwroty |
int |
liczba całkowita identyfikatora użytkownika, |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
Utwórz użytkownika z danym imieniem i podanymi flagami
Parametry |
name |
String : użytkownika, którego chcesz utworzyć na urządzeniu |
guest |
boolean : włącz flagę użytkownika – gość podczas tworzenia. |
ephemeral |
boolean : włącz flagę użytkownika --ephemeral podczas tworzenia. |
Zwroty |
int |
identyfikator utworzonego użytkownika. |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Utwórz użytkownika z danym imieniem i podanymi flagami
Parametry |
name |
String : użytkownika, którego chcesz utworzyć na urządzeniu |
guest |
boolean : włącz flagę użytkownika – gość podczas tworzenia. |
ephemeral |
boolean : włącz flagę użytkownika --ephemeral podczas tworzenia. |
forTesting |
boolean : włącz flagę testu --for-testing podczas tworzenia. |
Zwroty |
int |
identyfikator utworzonego użytkownika. |
createUserNoThrow
public abstract int createUserNoThrow (String name)
Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.
Parametry |
name |
String : użytkownika, którego chcesz utworzyć na urządzeniu |
Zwroty |
int |
wartość całkowita identyfikatora utworzonego użytkownika lub -1 w przypadku błędu. |
disableKeyguard
public abstract void disableKeyguard ()
Próby wyłączenia blokady klawiatury.
Najpierw zaczekaj, aż przesłanie danych wejściowych będzie gotowe. Stanie się to mniej więcej w tym samym czasie, gdy urządzenie zgłosi BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna implementacja frameworku ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie zamknięcia blokady ekranu (działa tylko w przypadku blokad niezabezpieczonych)
disableNetworkMonitor
public abstract boolean disableNetworkMonitor ()
Wyłącza monitorowanie sieci na urządzeniu.
Zwroty |
boolean |
true , jeśli monitoring został wyłączony. false
jeśli nie udało się. |
disconnectFromWifi
public abstract boolean disconnectFromWifi ()
rozłącza się z siecią Wi-Fi.
Usuwa wszystkie sieci z listy znanych sieci i wyłącza Wi-Fi.
Zwroty |
boolean |
true , jeśli połączenie z siecią Wi-Fi zostało utracone. false
jeśli nie udało się zakończyć połączenia. |
doesFileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje dla danego użytkownika.
Parametry |
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu, które ma zostać sprawdzone |
userId |
int : identyfikator użytkownika, którego dotyczy sprawdzanie istnienia pliku |
Zwroty |
boolean |
true , jeśli plik istnieje, false w przeciwnym razie. |
dumpHeap
public abstract File dumpHeap (String process,
String devicePath)
Spróbuj zrzucić stos z system_server. Usuwanie zrzutu ekranu należy do osoby wywołującej.
Parametry |
process |
String : nazwa procesu urządzenia, w którym ma zostać utworzony kopia pamięci podręcznej. |
devicePath |
String : ścieżka na urządzeniu, na której ma się znajdować zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia. |
Zwroty |
File |
ERROR(/File) zawierający raport. Wartość null, jeśli coś się nie udało. |
enableNetworkMonitor
public abstract boolean enableNetworkMonitor ()
Umożliwia monitorowanie sieci na urządzeniu.
Zwroty |
boolean |
true , jeśli monitorowanie zostało włączone. false
jeśli nie udało się. |
getActiveApexes
public abstract getActiveApexes ()
Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.
getAllSettings
public abstract getAllSettings (String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw.
Parametry |
namespace |
String : musi być jedną z tych wartości: {"system", "secure", "global"} |
Zwroty |
|
mapę par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana. |
getAndroidId
public abstract String getAndroidId (int userId)
Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.
getAndroidIds
public abstract getAndroidIds ()
Utwórz mapę identyfikatorów Androida, które pasują do identyfikatorów użytkowników. Nie ma pewności, że w przypadku każdego identyfikatora użytkownika uda się znaleźć powiązany z nim identyfikator Androida, więc niektóre identyfikatory użytkowników mogą być równe null.
Zwroty |
|
Mapa identyfikatorów Androida dopasowanych do identyfikatorów użytkowników. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.
Parametry |
packageName |
String |
getAppPackageInfos
public abstract getAppPackageInfos ()
Pobierać informacje o pakietach zainstalowanych na urządzeniu.
getBugreport
public abstract InputStreamSource getBugreport ()
Pobiera raport o błędzie z urządzenia.
Zapewniamy, że ta implementacja będzie działać na urządzeniu bez karty SD (lub gdy karta SD nie jest jeszcze zamontowana).
getBugreportz
public abstract InputStreamSource getBugreportz ()
Pobiera raport o błędzie z urządzenia. Plik bugreport w formacie ZIP zawiera główny raport o błędzie oraz inne pliki logów, które są przydatne do debugowania.
Obsługiwane tylko w przypadku wersji „adb” > 1.0.36
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
Zwraca bieżący stan urządzenia lub wartość null, jeśli wystąpiły jakieś problemy.
getCurrentUser
public abstract int getCurrentUser ()
Zwraca identyfikator bieżącego użytkownika. W przypadku błędu zwraca wartość -10000.
getFoldableStates
public abstract getFoldableStates ()
Zwraca listę stanów składania urządzenia. Można go uzyskać za pomocą polecenia „cmd device_state
print-states”.
getInstalledPackageNames
public abstract getInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji obecnych na urządzeniu.
Zwroty |
|
ERROR(/Set) nazw pakietów String , które są obecnie zainstalowane na urządzeniu. |
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 |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest on obsługiwany.
getMainUserId
public abstract Integer getMainUserId ()
Zwraca identyfikator głównego użytkownika.
Zwroty |
Integer |
userId głównego użytkownika, jeśli taki istnieje, lub null, jeśli nie ma głównego użytkownika. |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.
public abstract int getMaxNumberOfRunningUsersSupported ()
Pobierz maksymalną liczbę obsługiwanych jednocześnie uruchomionych użytkowników. Domyślna wartość to 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ślna wartość to 0.
Zwroty |
int |
liczba całkowita wskazująca liczbę obsługiwanych użytkowników; |
getOptions
public abstract TestDeviceOptions getOptions ()
Pobierz opcje testowania urządzenia.
getPrimaryUserId
public abstract Integer getPrimaryUserId ()
Zwraca podstawowy identyfikator użytkownika.
Zwroty |
Integer |
userId głównego użytkownika, jeśli taki istnieje, lub null, jeśli nie ma głównego użytkownika. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
Robi zrzut ekranu z urządzenia. Zalecamy użycie getScreenshot(String)
zamiast kodowania JPEG, aby zmniejszyć rozmiar.
Parametry |
format |
String : obsługiwane PNG, JPEG |
rescale |
boolean : czy zrzut ekranu ma zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu |
getScreenshot
public abstract InputStreamSource getScreenshot (long displayId)
Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania. Format: PNG.
DO ZROBIENIA: rozszerz implementacje powyżej, aby obsługiwały opcje „format” i „rescale”.
Parametry |
displayId |
long : identyfikator wyświetlacza ekranu, z którego ma być zrobiony zrzut ekranu. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format)
Robi zrzut ekranu z urządzenia.
Zalecamy użycie funkcji getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.
Parametry |
format |
String : obsługiwane PNG, JPEG |
getScreenshot
public abstract InputStreamSource getScreenshot ()
Robi zrzut ekranu z urządzenia.
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
Zwraca wartość żądanego ustawienia.
namespace musi być jedną z tych wartości: {"system", "secure", "global"}
Parametry |
userId |
int |
namespace |
String |
key |
String |
Zwroty |
String |
wartość powiązana z nazwą przestrzeni nazw:kluczem użytkownika. Wartość null, jeśli nie znaleziono. |
getSetting
public abstract String getSetting (String namespace,
String key)
Zobacz getSetting(int, String, String)
i wykonane przez użytkownika systemowego.
Parametry |
namespace |
String |
key |
String |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie są to pakiety niesystemowe i zaktualizowane pakiety systemowe.
Zwroty |
|
ERROR(/Set) nazwy pakietów String , których nie można odinstalować, zainstalowanych obecnie na urządzeniu. |
getUserFlags
public abstract int getUserFlags (int userId)
Znajdowanie i zwracanie flag danego użytkownika.
Flagi są definiowane w klasie „android.content.pm.UserInfo” w projekcie Android Open Source.
Zwroty |
int |
flagi powiązane z podanym identyfikatorem użytkownika (userId), jeśli został znaleziony, lub -10000 w innych przypadkach. |
getUserInfos
public abstract getUserInfos ()
Pobiera mapę useId na urządzeniu do UserInfo
. Jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami, zostanie zwrócony błąd DeviceRuntimeException
.
Zwroty |
|
lista obiektów UserInfo. |
Rzuty |
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException |
|
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
W przeciwnym razie zwraca -10000.
hasFeature
public abstract boolean hasFeature (String feature)
Sprawdzanie, czy funkcja jest dostępna na urządzeniu
Parametry |
feature |
String : format, który powinien być użyty: „feature:” czy „”. |
Zwroty |
boolean |
Wartość „prawda”, jeśli udało się znaleźć funkcję. W przeciwnym razie wartość „fałsz”. |
installPackage
public abstract String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
installPackage
public abstract String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
Uwaga: tej funkcji należy używać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty |
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu. |
installPackageForUser
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
instalować pakiet Androida na urządzeniu danego użytkownika.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
userId |
int : liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
installPackageForUser
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Instalowanie pakietu Androida na urządzeniu danego użytkownika.
Uwaga: tej funkcji należy używać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji |
userId |
int : liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty |
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Instalowanie aplikacji na Androida utworzonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone).
Informacje o podziale pliku APK na kilka plików znajdziesz na stronie „https://developer.android.com/studio/build/configure-apk-splits”.
Parametry |
packageFiles |
: pliki APK na urządzeniu |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty |
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem. Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.
Uwaga: tej funkcji należy używać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.
Parametry |
packageFiles |
: ścieżki do zdalnych plików APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty |
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Instalowanie przez danego użytkownika aplikacji na Androida złożonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone)
Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.
Parametry |
packageFiles |
: pliki APK na urządzeniu |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
userId |
int : liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty |
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Instalowanie przez danego użytkownika aplikacji na Androida złożonej z kilku plików APK (jeden główny i dodatkowe pakiety podzielone)
Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.
Uwaga: tej funkcji należy używać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.
Parametry |
packageFiles |
: pliki APK na urządzeniu |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji |
userId |
int : liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty |
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu. |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem. Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „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 przeprowadzić ponowną instalację |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty |
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu. |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jeden główny i dodatkowe pakiety podzielone), które znajdują się na urządzeniu z Androidem. Aby dowiedzieć się, jak podzielić plik APK na kilka plików, otwórz stronę „https://developer.android.com/studio/build/configure-apk-splits”.
Uwaga: tej funkcji należy używać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.
Parametry |
remoteApkPaths |
: ścieżki do zdalnych plików APK |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : czy wszystkie uprawnienia w czasie działania powinny być przyznawane w momencie instalacji |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
Rzuty |
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli uprawnienia czasu działania nie są obsługiwane przez platformę na urządzeniu. |
isHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
Zwraca informację, czy główny użytkownik jest stałym administratorem i czy nie można go usunąć ani obniżyć jego uprawnień do poziomu nieadministratora.
isMultiUserSupported
public abstract boolean isMultiUserSupported ()
Określa, czy obsługiwany jest tryb wielu użytkowników.
Zwroty |
boolean |
true, jeśli obsługiwane jest korzystanie przez wielu użytkowników, w przeciwnym razie false |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName,
String userId)
Przesyłanie zapytania do urządzenia o określonej nazwie pakietu i określonym identyfikatorem użytkownika w celu sprawdzenia, czy aplikacja jest obecnie zainstalowana na tym urządzeniu.
Parametry |
packageName |
String : pakiet, którego instalację sprawdzamy. |
userId |
String : identyfikator użytkownika, dla którego sprawdzamy, czy zainstalowano pakiet. Jeśli jest to wartość null, zostanie użyta wartość 0. |
Zwroty |
boolean |
Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
Wyszukaj na urządzeniu daną nazwę pakietu, aby sprawdzić, czy jest on zainstalowany.
Parametry |
packageName |
String |
Zwroty |
boolean |
Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
isUserRunning
public abstract boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest obecny.
Zwroty |
boolean |
Wartość „prawda”, jeśli użytkownik biega. W pozostałych przypadkach wartość „fałsz”. |
isUserSecondary
public abstract boolean isUserSecondary (int userId)
Zwraca informację, czy podany użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.
Zwroty |
boolean |
Prawda, jeśli użytkownik jest dodatkowy, w przeciwnym razie fałsz. |
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 „ludzkim” użytkownikiem, a zatem może uruchamiać czynności (zazwyczaj w wyświetlanym domyślnie widoku).
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „ludzkim” użytkownikiem, a zatem może uruchamiać na wyświetlaczu różne działania.
Parametry |
userId |
int |
displayId |
int |
isWifiEnabled
public abstract boolean isWifiEnabled ()
Sprawdź, czy Wi-Fi jest włączone.
Sprawdzanie, czy Wi-Fi jest włączone na urządzeniu. Przydatne do sprawdzania stanu Wi-Fi przed testami, które nie powinny być wykonywane z użyciem Wi-Fi, np. testy danych mobilnych.
Zwroty |
boolean |
true , jeśli Wi-Fi jest włączone. false , jeśli jest wyłączona |
listDisplayIds
public abstract listDisplayIds ()
Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys
SurfaceFlinger”.
Zwroty |
|
Lista wyświetlaczy. Domyślnie zawsze zwraca wartość domyślną 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public abstract listDisplayIdsForStartingVisibleBackgroundUsers ()
Pobiera listę wyświetlaczy, których można używać do start a user visible in the background
.
listUsers
public abstract listUsers ()
Pobiera listę użytkowników na urządzeniu. Wyjątek DeviceRuntimeException
zostanie rzucony, jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
Zwroty |
|
lista identyfikatorów użytkowników. |
Rzuty |
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException |
|
logBugreport
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w raportach dla zgłaszających.
Parametry |
dataName |
String : nazwa, pod którą zgłoszenie błędu zostanie przesłane. |
listener |
ITestLogger : ITestLogger do rejestrowania raportu o błędzie. |
Zwroty |
boolean |
Wartość true, jeśli rejestrowanie zakończyło się powodzeniem. W przeciwnym razie wartość false. |
notifySnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Poinformuj urządzenie, aby czekało na zakończenie snapuserd.
Parametry |
waitPhase |
SnapuserdWaitPhase |
removeAdmin
public abstract boolean removeAdmin (String componentName,
int userId)
Usuń danego administratora urządzenia w danym użytkowniku i wróć true
, jeśli operacja się powiedzie, w przeciwnym razie false
.
Parametry |
componentName |
String : administratora urządzenia, którego chcesz usunąć. |
userId |
int : użytkownika, w którego przestrzeni osobistej znajduje się administrator urządzenia. |
Zwroty |
boolean |
Wartość true (prawda), jeśli operacja się powiodła, a w przeciwnym razie – false (fałsz). |
removeOwners
public abstract void removeOwners ()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia.
removeUser
public abstract boolean removeUser (int userId)
usunąć danego użytkownika z urządzenia,
Parametry |
userId |
int : użytkownika, którego chcesz usunąć |
Zwroty |
boolean |
Wartość „prawda”, jeśli udało się usunąć użytkownika, w przeciwnym razie – „fałsz”. |
setDeviceOwner
public abstract boolean setDeviceOwner (String componentName,
int userId)
Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika.
Parametry |
componentName |
String : administrator urządzenia musi być jego właścicielem. |
userId |
int : kraju zamieszkania właściciela urządzenia. |
Zwroty |
boolean |
Wartość true (prawda), jeśli operacja się powiodła, a w przeciwnym razie – false (fałsz). |
setSetting
public abstract void setSetting (String namespace,
String key,
String value)
Zobacz setSetting(int, String, String, String)
i wykonane przez użytkownika systemowego.
Parametry |
namespace |
String |
key |
String |
value |
String |
setSetting
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
Dodanie wartości ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu urządzenia.
namespace musi być jedną z tych wartości: {"system", "secure", "global"}
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 on obecnie zatrzymany. Jeśli użytkownik jest już uruchomiony w tle, ta metoda nie wykonuje żadnej operacji.
Parametry |
userId |
int : użytkownik może uruchomić aplikację w tle |
Zwroty |
boolean |
Wartość true, jeśli użytkownik został uruchomiony w tle. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik jest już uruchomiony w tle, ta metoda nie wykonuje żadnej operacji. Możliwość podania dodatkowego parametru, aby poczekać na zastosowanie operacji.
Parametry |
userId |
int : użytkownik może uruchomić aplikację w tle |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie. |
Zwroty |
boolean |
Wartość true, jeśli użytkownik został uruchomiony w tle. |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać na nim działania).
UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature
itp.
Parametry |
userId |
int : użytkownik może uruchomić aplikację w tle |
displayId |
int : wyświetlanie informacji o początkowym użytkowniku na |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie. |
Zwroty |
boolean |
true jeśli użytkownik został uruchomiony i jest widoczny w tle. |
stopUser
public abstract boolean stopUser (int userId)
Zatrzymuje danego użytkownika. Jeśli użytkownik został już zatrzymany, ta metoda nie będzie miała żadnego działania.
Nie można zatrzymać bieżącego użytkownika ani użytkownika systemowego.
Parametry |
userId |
int : użytkownik musi się zatrzymać. |
Zwroty |
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Zatrzymanie danego użytkownika. Można podać dodatkowe flagi, aby zaczekać na wykonanie operacji i przymusowo zakończyć sesję użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemowego.
Parametry |
userId |
int : użytkownik musi się zatrzymać. |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik się zatrzyma. |
forceFlag |
boolean : wymuszenie zatrzymania przez użytkownika. |
Zwroty |
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
switchUser
public abstract boolean switchUser (int userId)
Przełącz się na innego użytkownika o domyślnym czasie oczekiwania. switchUser(int, long)
.
Zwroty |
boolean |
Prawda, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz. |
switchUser
public abstract boolean switchUser (int userId,
long timeout)
Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem.
Próba wyłączenia blokady ekranu po pomyślnej zmianie użytkownika.
Parametry |
userId |
int |
timeout |
long : czas oczekiwania przed zwróceniem wartości false w przypadku błędu switch-user. |
Zwroty |
boolean |
Prawda, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz. |
takeBugreport
public abstract Bugreport takeBugreport ()
Przyjmuje zgłoszenie o błędzie i zwraca je w obiekcie Bugreport
, aby je obsłużyć. W przypadku problemów zwraca wartość null. Plik, na który wskazuje obiekt Bugreport, musi zostać oczyszczony za pomocą funkcji Bugreport.close()
.
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 , jeśli operacja się powiodła. |
uninstallPackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
Odinstaluj pakiet Androida z urządzenia danego użytkownika.
Parametry |
packageName |
String : pakiet na Androida do odinstalowania |
userId |
int : liczba całkowita identyfikatora użytkownika, dla którego ma zostać odinstalowana aplikacja. |
Zwroty |
String |
String z kodem błędu lub null , jeśli operacja się powiodła. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
W razie potrzeby poczekaj, aż snapuserd zakończy działanie.
Parametry |
currentPhase |
SnapuserdWaitPhase |