TestDevice
public
class
TestDevice
extends NativeDevice
Znane bezpośrednie podklasy
ManagedRemoteDevice |
Urządzenie działające w maszynie wirtualnej, którą zarządzamy zdalnie za pomocą instancji Tradefed w maszynie wirtualnej.
|
NestedRemoteDevice |
Przykład urządzenia działającego w ramach zdalnej maszyny wirtualnej Cuttlefish.
|
RemoteAndroidDevice |
Wdrożenie ITestDevice na urządzeniu z Androidem z pełnym stosem połączonym za pomocą adb connect.
|
|
Implementacja ITestDevice
na urządzeniu z pełnym zestawem Androida
Podsumowanie
Fieldsem |
public
static
final
String |
DISMISS_KEYGUARD_CMD
Polecenia, których można używać do zamykania ekranu blokady.
|
Metody publiczne |
boolean
|
canSwitchToHeadlessSystemUser()
Zwraca informację, czy można przełączyć się na użytkownika systemu bez interfejsu.
|
boolean
|
clearErrorDialogs()
Spróbuj zamknąć wszystkie okna z błędami wyświetlane obecnie w interfejsie urządzenia.
|
int
|
createUser(String name)
Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Utwórz użytkownika z danym imieniem i podanymi flagami
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Utwórz użytkownika z danym imieniem i podanymi flagami
|
int
|
createUserNoThrow(String name)
Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.
|
void
|
disableKeyguard()
Próbuje wyłączyć blokadę klawiatury.
|
boolean
|
doesFileExist(String deviceFilePath)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu danego użytkownika istnieje.
|
File
|
dumpHeap(String process, String devicePath)
Spróbuj zrzucić stos z system_server.
|
|
getActiveApexes()
Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.
|
|
getAllSettings(String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw.
|
String
|
getAndroidId(int userId)
Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.
|
|
getAndroidIds()
Tworzenie mapy identyfikatorów Androida, które pasują do identyfikatorów użytkowników.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.
|
|
getAppPackageInfos()
Pobierać informacje o pakietach zainstalowanych na urządzeniu.
|
InputStreamSource
|
getBugreport()
Pobiera raport o błędzie z urządzenia.
|
InputStreamSource
|
getBugreportz()
Pobiera raport o błędzie z urządzenia.
|
DeviceFoldableState
|
getCurrentFoldableState()
Zwraca bieżący stan urządzenia, które można złożyć, lub wartość null, jeśli wystąpiły jakieś problemy.
|
int
|
getCurrentUser()
Zwraca identyfikator bieżącego użytkownika.
|
|
getFoldableStates()
Zwraca listę stanów składania urządzenia.
|
|
getInstalledPackageNames()
Pobierz nazwy pakietów aplikacji obecnych na urządzeniu.
|
KeyguardControllerState
|
getKeyguardState()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest on obsługiwany.
|
Integer
|
getMainUserId()
Zwraca identyfikator głównego użytkownika.
|
|
getMainlineModuleInfo()
Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.
|
int
|
getMaxNumberOfRunningUsersSupported()
Pobierz maksymalną liczbę obsługiwanych jednocześnie użytkowników.
|
int
|
getMaxNumberOfUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników.
|
Integer
|
getPrimaryUserId()
Zwraca podstawowy identyfikator użytkownika.
|
InputStreamSource
|
getScreenshot()
Robi zrzut ekranu z urządzenia.
|
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Robi zrzut ekranu z urządzenia.
|
InputStreamSource
|
getScreenshot(long displayId)
Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania.
|
InputStreamSource
|
getScreenshot(String format)
Robi zrzut ekranu z urządzenia.
|
String
|
getSetting(String namespace, String key)
Zobacz getSetting(int, String, String) i wykonane przez użytkownika systemowego.
|
String
|
getSetting(int userId, String namespace, String key)
Zwraca wartość żądanego ustawienia.
|
|
getUninstallablePackageNames()
Pobierz nazwy pakietów aplikacji, które można odinstalować.
|
int
|
getUserFlags(int userId)
Znajdowanie i zwracanie flag danego użytkownika.
|
|
getUserInfos()
Pobiera mapę useId na urządzeniu do UserInfo .
|
int
|
getUserSerialNumber(int userId)
Zwraca numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, lub -10000 w innych przypadkach.
|
boolean
|
hasFeature(String feature)
Sprawdzanie, czy funkcja jest dostępna na urządzeniu
|
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
|
String
|
installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu danego użytkownika.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu danego użytkownika.
|
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
boolean
|
isAppEnumerationSupported()
Sprawdź, czy platforma na urządzeniu obsługuje enumerację aplikacji
|
boolean
|
isHeadlessSystemUserMode()
Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.
|
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.
|
boolean
|
isMultiUserSupported()
Określa, czy obsługiwany jest tryb wielu użytkowników.
|
boolean
|
isPackageInstalled(String packageName)
Wysłać zapytanie do urządzenia o określonej nazwie pakietu, aby sprawdzić, czy jest on zainstalowany.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Przesyłać zapytanie do urządzenia o określoną nazwę pakietu i określony identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana na tym urządzeniu.
|
boolean
|
isUserRunning(int userId)
Sprawdź, czy dany użytkownik jest obecny.
|
boolean
|
isUserSecondary(int userId)
Zwraca informację, czy podany użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.
|
boolean
|
isUserVisible(int userId)
Sprawdzanie, czy dany użytkownik jest widoczny.
|
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.
|
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) .
|
boolean
|
isVisibleBackgroundUsersSupported()
Zwraca informację, czy urządzenie pozwala użytkownikom na uruchamianie aplikacji w tle.
|
|
listDisplayIds()
Pobierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, jak podaje „dumpsys
SurfaceFlinger”.
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Pobiera listę wyświetlaczy, których można używać do start a user visible in the background .
|
|
listUsers()
Pobiera listę użytkowników na urządzeniu.
|
boolean
|
logBugreport(String dataName, ITestLogger listener)
Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w dzienniku autorów.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Dodatkowe czynności związane z czyszczeniem, które są wymagane na urządzeniu, zostaną wykonane po zakończeniu wywołania.
|
boolean
|
removeAdmin(String componentName, int userId)
Usuń danego administratora urządzenia w danym użytkowniku i wróć wartość true , jeśli operacja się powiedzie, lub false w przeciwnym razie.
|
void
|
removeOwners()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia, stosując zasadę możliwie najlepszej obsługi.
|
boolean
|
removeUser(int userId)
usunąć danego użytkownika z urządzenia.
|
boolean
|
setDeviceOwner(String componentName, int userId)
Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika.
|
void
|
setFirstBootloaderReboot()
|
void
|
setSetting(String namespace, String key, String value)
Zobacz setSetting(int, String, String, String) i wykonane przez użytkownika systemowego.
|
void
|
setSetting(int userId, String namespace, String key, String value)
Dodaje wartość ustawienia do przestrzeni nazw danego użytkownika.
|
void
|
shutdownMicrodroid(ITestDevice microdroidDevice)
Wyłącza urządzenie microdroid, jeśli takie istnieje.
|
boolean
|
startUser(int userId)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.
|
boolean
|
startUser(int userId, boolean waitFlag)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany.
|
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać czynności na tym wyświetlaczu).
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Zatrzymanie danego użytkownika.
|
boolean
|
stopUser(int userId)
Zatrzymuje danego użytkownika.
|
boolean
|
supportsMicrodroid()
Sprawdzanie warunków wstępnych do uruchomienia mikrodroida.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Sprawdzanie warunków wstępnych do uruchomienia mikrodroida.
|
boolean
|
switchUser(int userId)
Przełącz się na innego użytkownika o domyślnym czasie oczekiwania.
|
boolean
|
switchUser(int userId, long timeout)
Przełącz się na innego użytkownika z podanym czasem oczekiwania jako terminem.
|
Bugreport
|
takeBugreport()
Przyjmuje zgłoszenie o błędzie i zwraca je w obiekcie Bugreport , aby je obsłużyć.
|
String
|
uninstallPackage(String packageName)
Odinstaluj pakiet Androida z urządzenia.
|
String
|
uninstallPackageForUser(String packageName, int userId)
Odinstaluj pakiet Androida z urządzenia danego użytkownika.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Fieldsem
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Polecenia, których można używać do zamykania ekranu blokady.
Konstruktory publiczne
Metody publiczne
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Zwraca informację, czy można przełączyć się na użytkownika systemu bez interfejsu.
clearErrorDialogs
public 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. |
createUser
public int createUser (String name)
Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.
Parametry |
name |
String : użytkownika, którego należy utworzyć na urządzeniu |
Zwroty |
int |
liczba całkowita identyfikatora użytkownika, |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Utwórz użytkownika z danym imieniem i podanymi flagami
Parametry |
name |
String : użytkownika, którego należy utworzyć na urządzeniu |
guest |
boolean : włącz flagę użytkownika – gość podczas tworzenia. |
ephemeral |
boolean : włącz flagę użytkownika --ephemeral podczas tworzenia. |
forTesting |
boolean : włącz flagę testu --for-testing podczas tworzenia. |
Zwroty |
int |
identyfikator utworzonego użytkownika. |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
Utwórz użytkownika z danym imieniem i podanymi flagami
Parametry |
name |
String : użytkownika, którego należy utworzyć na urządzeniu |
guest |
boolean : włącz flagę użytkownika – gość podczas tworzenia. |
ephemeral |
boolean : włącz flagę użytkownika --ephemeral podczas tworzenia. |
Zwroty |
int |
identyfikator utworzonego użytkownika. |
createUserNoThrow
public int createUserNoThrow (String name)
Utwórz użytkownika o danej nazwie i flagami domyślnymi 0.
Parametry |
name |
String : użytkownika, którego należy utworzyć na urządzeniu |
Zwroty |
int |
wartość całkowita identyfikatora utworzonego użytkownika lub -1 w przypadku błędu. |
disableKeyguard
public void disableKeyguard ()
Próbuje wyłączyć blokadę klawiatury.
Najpierw zaczekaj, aż przesłanie danych wejściowych będzie gotowe. Stanie się to mniej więcej w tym samym czasie, gdy urządzenie zgłosi BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna implementacja frameworku ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie odrzucenia blokady ekranu (działa tylko w przypadku blokad niezabezpieczonych)
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje.
Parametry |
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu do sprawdzenia |
Zwroty |
boolean |
true , jeśli plik istnieje, false w przeciwnym razie. |
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu danego użytkownika istnieje.
Parametry |
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu do sprawdzenia |
userId |
int : identyfikator użytkownika, którego dotyczy sprawdzanie istnienia pliku |
Zwroty |
boolean |
true , jeśli plik istnieje, false w przeciwnym razie. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Spróbuj zrzucić stos z system_server. Usuwanie zrzutu ekranu należy do osoby wywołującej.
Parametry |
process |
String : nazwa procesu urządzenia, w którym ma zostać utworzony kopia pamięci podręcznej. |
devicePath |
String : ścieżka na urządzeniu, na której ma się znaleźć zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia. |
Zwroty |
File |
ERROR(/File) zawierający raport. Wartość null, jeśli coś się nie udało. |
getActiveApexes
public getActiveApexes ()
Pobiera informacje o aktywnej na urządzeniu aplikacji APEX.
getAllSettings
public 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 String getAndroidId (int userId)
Znajdź i zwróć identyfikator android-id powiązany z userId, null, jeśli nie znaleziono.
getAndroidIds
public getAndroidIds ()
Tworzenie mapy identyfikatorów Androida, które pasują do identyfikatorów użytkowników. Nie ma pewności, że w przypadku każdego identyfikatora użytkownika uda się znaleźć powiązany z nim identyfikator Androida, więc niektóre identyfikatory użytkowników mogą być równe null.
Zwroty |
|
Mapa identyfikatorów Androida dopasowanych do identyfikatorów użytkowników. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Pobieranie informacji o pakiecie zainstalowanym na urządzeniu.
Parametry |
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Pobierać informacje o pakietach zainstalowanych na urządzeniu.
getBugreport
public 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 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 DeviceFoldableState getCurrentFoldableState ()
Zwraca bieżący stan urządzenia, które można złożyć, lub wartość null, jeśli wystąpiły jakieś problemy.
getCurrentUser
public int getCurrentUser ()
Zwraca identyfikator bieżącego użytkownika. W przypadku błędu zwraca wartość -10000.
getFoldableStates
public getFoldableStates ()
Zwraca listę stanów składania urządzenia. Można go uzyskać za pomocą polecenia „cmd device_state
print-states”.
getInstalledPackageNames
public 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. |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest on obsługiwany.
getMainUserId
public 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 getMainlineModuleInfo ()
Pobieranie informacji o głównych modułach zainstalowanych na urządzeniu.
public int getMaxNumberOfRunningUsersSupported ()
Pobierz maksymalną liczbę obsługiwanych jednocześnie użytkowników. Domyślna wartość to 0.
Zwroty |
int |
liczba całkowita wskazująca liczbę jednocześnie działających użytkowników; |
public 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; |
getPrimaryUserId
public 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 InputStreamSource getScreenshot ()
Robi zrzut ekranu z urządzenia.
getScreenshot
public 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 InputStreamSource getScreenshot (long displayId)
Wykonuje zrzut ekranu z urządzenia o danym identyfikatorze wyświetlania. Format: PNG.
DO ZROBIENIA: rozszerz implementacje powyżej, aby obsługiwały opcje „format” i „rescale”.
Parametry |
displayId |
long : identyfikator wyświetlacza ekranu, z którego chcesz zrobić zrzut ekranu. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Robi zrzut ekranu z urządzenia.
Zalecamy użycie metody getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.
Parametry |
format |
String : obsługiwane PNG, JPEG |
getSetting
public String getSetting (String namespace,
String key)
Zobacz getSetting(int, String, String)
i wykonane przez użytkownika systemowego.
Parametry |
namespace |
String |
key |
String |
getSetting
public String getSetting (int userId,
String namespace,
String key)
Zwraca wartość żądanego ustawienia.
namespace musi być jedną z tych wartości: {"system", "secure", "global"}
Parametry |
userId |
int |
namespace |
String |
key |
String |
Zwroty |
String |
wartość powiązana z nazwą przestrzeni nazw:klucz użytkownika. Wartość null, jeśli nie znaleziono. |
getUninstallablePackageNames
public 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 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 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. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Zwraca numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, lub -10000 w innych przypadkach.
hasFeature
public boolean hasFeature (String feature)
Sprawdzanie, czy funkcja jest dostępna na urządzeniu
Parametry |
feature |
String : format, który powinien być użyty: „feature:” lub „”. |
Zwroty |
boolean |
Wartość „PRAWDA”, jeśli udało się znaleźć element, w przeciwnym razie wartość „FAŁSZ”. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy ponownie zainstalować aplikację |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy ponownie zainstalować aplikację |
grantPermissions |
boolean : czy wszystkie uprawnienia czasu działania powinny być przyznawane w momencie instalacji |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackage
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Zainstaluj na urządzeniu pakiet Androida.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.
Parametry |
packageFile |
File : plik APK do zainstalowania |
certFile |
File : true , jeśli należy ponownie zainstalować aplikację |
reinstall |
boolean : czy wszystkie uprawnienia czasu działania powinny być przyznawane w momencie instalacji |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu danego użytkownika.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest jawna kontrola uprawnień w czasie działania w momencie instalacji.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy ponownie zainstalować aplikację |
grantPermissions |
boolean : czy wszystkie uprawnienia czasu działania powinny być przyznawane w momencie instalacji |
userId |
int : liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu danego użytkownika.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy ponownie zainstalować aplikację |
userId |
int : liczba całkowita identyfikatora użytkownika, dla którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz, wpisując „adb shell pm -h”. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Parametry |
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parametry |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Parametry |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
userId |
int |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Parametry |
packageFiles |
|
reinstall |
boolean |
userId |
int |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Parametry |
remoteApkPaths |
|
reinstall |
boolean |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parametry |
remoteApkPaths |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje enumerację aplikacji
Zwroty |
boolean |
Wartość true, jeśli zliczanie aplikacji jest obsługiwane, w przeciwnym razie wartość false |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Zwraca informację, czy urządzenie używa trybu użytkownika systemu bez interfejsu graficznego.
isMainUserPermanentAdmin
public 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 boolean isMultiUserSupported ()
Określa, czy obsługiwany jest tryb wielu użytkowników.
Zwroty |
boolean |
wartość „PRAWDA”, jeśli obsługa wielu użytkowników jest możliwa, w przeciwnym razie wartość „FAŁSZ”. |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Wysłać zapytanie do urządzenia o określonej nazwie pakietu, aby sprawdzić, czy jest on zainstalowany.
Parametry |
packageName |
String |
Zwroty |
boolean |
Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Przesyłać zapytanie do urządzenia o określoną nazwę pakietu i określony identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana na tym urządzeniu.
Parametry |
packageName |
String : pakiet, którego instalację sprawdzamy. |
userId |
String : identyfikator użytkownika, dla którego sprawdzamy, czy zainstalowano pakiet. Jeśli wartość jest pusta, zostanie użyta wartość zero. |
Zwroty |
boolean |
Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
isUserRunning
public boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest obecny.
Zwroty |
boolean |
Wartość „prawda”, jeśli użytkownik biega, a w pozostałych przypadkach – „fałsz”. |
isUserSecondary
public 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 boolean isUserVisible (int userId)
Sprawdzanie, czy dany użytkownik jest widoczny.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „ludzkim” użytkownikiem, a zatem może uruchamiać czynności (zazwyczaj w wyświetlanym domyślnie widoku).
isUserVisibleOnDisplay
public 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 |
listDisplayIds
public 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 listDisplayIdsForStartingVisibleBackgroundUsers ()
Pobiera listę wyświetlaczy, których można używać do start a user visible in the background
.
listUsers
public 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. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w dzienniku autorów.
Parametry |
dataName |
String : nazwa, pod którą zgłoszenie błędu zostanie przesłane. |
listener |
ITestLogger : ITestLogger do rejestrowania raportu o błędzie. |
Zwroty |
boolean |
Wartość true, jeśli rejestrowanie zakończyło się powodzeniem. W przeciwnym razie wartość false. |
notifySnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parametry |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Dodatkowe czynności związane z czyszczeniem, które są wymagane na urządzeniu, zostaną wykonane po zakończeniu wywołania.
Parametry |
exception |
Throwable : jeśli występuje, to ostatnie wyjątek wywołany przez błąd wywołania. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Usuń danego administratora urządzenia w danym użytkowniku i wróć wartość true
, jeśli operacja się powiedzie, lub false
w przeciwnym razie.
Parametry |
componentName |
String : administratora urządzenia, którego chcesz usunąć. |
userId |
int : użytkownika, w którego przestrzeni osobistej znajduje się administrator urządzenia. |
Zwroty |
boolean |
Wartość true (prawda), jeśli operacja zakończyła się powodzeniem, w przeciwnym razie ma wartość false (fałsz). |
removeOwners
public void removeOwners ()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia, stosując zasadę możliwie najlepszej obsługi.
removeUser
public boolean removeUser (int userId)
usunąć danego użytkownika z urządzenia.
Parametry |
userId |
int : użytkownika, którego chcesz usunąć |
Zwroty |
boolean |
Wartość „true”, jeśli udało się usunąć użytkownika, a w przeciwnym razie – „false”. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika.
Parametry |
componentName |
String : administrator urządzenia musi być właścicielem urządzenia. |
userId |
int : kraju zamieszkania właściciela urządzenia. |
Zwroty |
boolean |
Wartość true (prawda), jeśli operacja zakończyła się powodzeniem, w przeciwnym razie ma wartość false (fałsz). |
setFirstBootloaderReboot
public void setFirstBootloaderReboot ()
setSetting
public 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 void setSetting (int userId,
String namespace,
String key,
String value)
Dodaje wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu.
namespace musi być jedną z tych wartości: {"system", "secure", "global"}
Parametry |
userId |
int |
namespace |
String |
key |
String |
value |
String |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Wyłącza urządzenie microdroid, jeśli takie istnieje.
Parametry |
microdroidDevice |
ITestDevice |
startUser
public 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 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 boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać czynności na tym wyświetlaczu).
UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature
itp.
Parametry |
userId |
int : użytkownik może uruchomić aplikację w tle |
displayId |
int : wyświetlanie informacji o początku sesji użytkownika na |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie. |
Zwroty |
boolean |
true jeśli użytkownik został uruchomiony i jest widoczny w tle. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Zatrzymanie danego użytkownika. Można podać dodatkowe flagi, aby zaczekać na wykonanie operacji i przymusowo zakończyć sesję użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemowego.
Parametry |
userId |
int : zatrzymać. |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik się zatrzyma. |
forceFlag |
boolean : wymuszenie zatrzymania przez użytkownika. |
Zwroty |
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
stopUser
public boolean stopUser (int userId)
Zatrzymuje danego użytkownika. Jeśli użytkownik został już zatrzymany, ta metoda nie będzie miała żadnego działania.
Nie można zatrzymać bieżącego użytkownika ani użytkownika systemowego.
Parametry |
userId |
int : zatrzymać. |
Zwroty |
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
obsługuje Microdroid
public boolean supportsMicrodroid ()
Sprawdzanie warunków wstępnych do uruchomienia mikrodroida.
Zwroty |
boolean |
zwraca wartość true, jeśli warunki wstępne są spełnione, a w przeciwnym razie zwraca wartość false. |
obsługuje Microdroid
public boolean supportsMicrodroid (boolean protectedVm)
Sprawdzanie warunków wstępnych do uruchomienia mikrodroida.
Parametry |
protectedVm |
boolean : wartość true, jeśli microdroid ma działać na chronionej maszynie wirtualnej. |
Zwroty |
boolean |
zwraca wartość true, jeśli warunki wstępne są spełnione, a w przeciwnym razie zwraca wartość false. |
switchUser
public 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 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 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 String uninstallPackage (String packageName)
Odinstaluj pakiet Androida z urządzenia.
Parametry |
packageName |
String : pakiet na Androida do odinstalowania |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
Odinstaluj pakiet Androida z urządzenia danego użytkownika.
Parametry |
packageName |
String : pakiet na Androida do odinstalowania |
userId |
int : całkowita wartość identyfikatora użytkownika, dla którego ma zostać odinstalowana aplikacja. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Parametry |
currentPhase |
SnapuserdWaitPhase |
Chronione metody
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Uruchom ponownie urządzenie za pomocą adb.
Parametry |
rebootMode |
NativeDevice.RebootMode : tryb ponownego uruchamiania. |
reason |
String : w przypadku tego restartu. |
getBugreportzInternal
protected File getBugreportzInternal ()
Metoda pomocnicza wewnętrzna służąca do pobierania pliku zip z bugreportem jako ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Wyeksponowane do testowania.
getHostCurrentTime
protected long getHostCurrentTime ()
Udostępnione do testowania
prePostBootSetup
protected void prePostBootSetup ()
Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po uruchomieniu.