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 tej maszynie.
|
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
dla pełnego zestawu na urządzeniu z Androidem
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 istnieje dla danego użytkownika.
|
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()
Utwórz mapę 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 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 uruchomionych 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)
W przeciwnym razie zwraca -10000.
|
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)
Instalowanie pakietu Androida na urządzeniu danego użytkownika.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Instalowanie pakietu 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 zliczanie 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)
Wyszukaj na urządzeniu daną nazwę pakietu, aby sprawdzić, czy jest on zainstalowany.
|
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.
|
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)
Sprawdza, 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 raportach dla zgłaszających.
|
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óć true , jeśli operacja się powiedzie, w przeciwnym razie false .
|
void
|
removeOwners()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia.
|
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)
Dodanie wartości 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ć na nim działania).
|
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 chcesz 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 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. |
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 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. |
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 chcesz 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 zamknięcia 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, które ma zostać sprawdzone |
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 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 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. |
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 ()
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 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 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 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 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 ma być zrobiony zrzut ekranu. |
getScreenshot
public 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 |
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:kluczem 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)
W przeciwnym razie zwraca -10000.
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:” czy „”. |
Zwroty |
boolean |
Wartość „prawda”, jeśli udało się znaleźć funkcję. 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 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 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. |
installPackage
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
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 |
certFile |
File : true , jeśli należy przeprowadzić ponowną instalację |
reinstall |
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. |
installPackageForUser
public 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. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Instalowanie pakietu 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. |
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 zliczanie aplikacji
Zwroty |
boolean |
Wartość true (prawda), jeśli zliczanie aplikacji jest obsługiwane, w przeciwnym razie wartość false (fałsz). |
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 |
true, jeśli obsługiwane jest korzystanie przez wielu użytkowników, w przeciwnym razie false |
isPackageInstalled
public 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. |
isPackageInstalled
public 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. |
isUserRunning
public 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 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)
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 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 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)
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óć 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 void removeOwners ()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia.
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ść „prawda”, jeśli udało się usunąć użytkownika, w przeciwnym razie – „fałsz”. |
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ć 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). |
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)
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 |
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ć 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 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. |
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 : użytkownik musi się 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 , jeśli operacja się powiodła. |
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 : 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)
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.