TestDevice
public
class
TestDevice
extends NativeDevice
Znane bezpośrednie podklasy
Zarządzane urządzenie zdalne |
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 |
Implementacja interfejsu ITestDevice na urządzeniu z Androidem w pełnym stosie 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 używane do zamykania blokady klawiszy.
|
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 z danym imieniem i domyślnymi flagami 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Utwórz użytkownika z podaną nazwą 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 podanej nazwie i domyślnych flagach 0.
|
void
|
disableKeyguard()
Próby wyłączenia blokady klawiatury.
|
boolean
|
doesFileExist(String deviceFilePath)
Metoda pomocnicza określająca, czy plik istnieje na urządzeniu.
|
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()
Pobieranie informacji o punktach APEX aktywowanych na urządzeniu.
|
|
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 obecnie uruchomionego konta 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()
Pobiera 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)
Pobiera 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)
Znajdź i zwróć flagi 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, oraz -10000 w pozostałych 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 pakiet na Androida na urządzeniu.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instalowanie pakietu na Androida na urządzeniu danego użytkownika.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Instalowanie pakietu na 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ługa wielu użytkowników jest obsługiwana.
|
boolean
|
isPackageInstalled(String packageName)
Wyślij do urządzenia zapytanie o podaną nazwę pakietu, aby sprawdzić, czy jest aktualnie zainstalowane.
|
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 uruchomiony.
|
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 kontekście 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óć 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)
Usuń 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
|
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)
Dodaj 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 inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem.
|
Bugreport
|
takeBugreport()
Przejmuje zgłoszenie błędu 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 z danym imieniem i domyślnymi flagami 0.
Parametry |
name |
String : użytkownika do utworzenia 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 podaną nazwą 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 podaną nazwą 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 z danym imieniem i domyślnymi flagami 0.
Parametry |
name |
String : użytkownika do utworzenia na urządzeniu |
Zwroty |
int |
liczba całkowita utworzonego identyfikatora użytkownika lub -1 – błąd. |
disableKeyguard
public void disableKeyguard ()
Próbuje wyłączyć blokadę klawiszy.
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 frameworka ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie odblokowania klawiatury (działa tylko w przypadku klawiatur 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óry ma zostać sprawdzony |
Zwroty |
boolean |
true , jeśli plik istnieje, lub false w innym przypadku. |
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Metoda pomocnicza do określenia, czy dany użytkownik istnieje na urządzeniu.
Parametry |
deviceFilePath |
String : ścieżka bezwzględna pliku na urządzeniu do sprawdzenia. |
userId |
int : identyfikator użytkownika, którego dotyczy sprawdzanie istnienia pliku |
Zwroty |
boolean |
true , jeśli plik istnieje, lub false w innym przypadku. |
zrzut stosu
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, na którym ma zostać utworzony stos pamięci. |
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 |
element 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 mieć wartość {"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ę znalezionych identyfikatorów Androida pasujących 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)
Pobranie informacji o pakiecie zainstalowanym na urządzeniu.
Parametry |
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Pobieranie informacji 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 obecnie uruchomionego konta użytkownika. W przypadku błędu zwraca wartość -10000.
getFoldableState,
public getFoldableStates ()
Zwraca listę stanów urządzenia składanego. Tę wartość można uzyskać za pomocą polecenia „cmd device_state”, „print-states”.
getInstalledPackageNames
public getInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji obecnych na urządzeniu.
getKeyguardState,
public KeyguardControllerState getKeyguardState ()
Zwróć obiekt, aby uzyskać bieżący stan blokady klucza lub wartość null, jeśli nie jest 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 ()
Uzyskaj informacje o modułach mainline 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 to PNG.
DO ZROBIENIA: rozszerz implementacje powyżej, aby obsługiwały opcje „format” i „rescale”.
Parametry |
displayId |
long : wyświetlany identyfikator ekranu, z którego zostanie wykonany 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 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 of useId do UserInfo
na urządzeniu. Jeśli dane wyjściowe z urządzenia będą niezgodne z oczekiwaniami, zostanie zwrócony kod DeviceRuntimeException
.
Zwroty |
|
lista obiektów UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
W przeciwnym razie zwraca -10000.
hasFeature
public boolean hasFeature (String feature)
Sprawdź, czy jakaś 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źć 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 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: ta funkcja powinna być wywoływana tylko w przypadkach użycia wymagających bezpośredniej kontroli nad przyznawaniem uprawnień czasu działania podczas 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: ta funkcja powinna być wywoływana tylko w przypadkach użycia wymagających bezpośredniej kontroli nad przyznawaniem uprawnień czasu działania podczas instalacji.
Parametry |
packageFile |
File : plik APK do zainstalowania |
certFile |
File : true , jeśli należy ponownie zainstalować aplikację |
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 na Androida na urządzeniu danego użytkownika.
Uwaga: ta funkcja powinna być wywoływana tylko w przypadkach użycia wymagających bezpośredniej kontroli nad przyznawaniem uprawnień czasu działania podczas instalacji.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : jeśli podczas instalacji powinny być przyznane wszystkie uprawnienia czasu działania. |
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. |
pakiet_instalacji
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Parametry |
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
pakiet_instalacji
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). |
Tryb użytkownika systemu bez interfejsu graficznego
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.
Obsługa wielu użytkowników
public boolean isMultiUserSupported ()
Określa, czy obsługiwany jest tryb wielu użytkowników.
Zwroty |
boolean |
Wartość true, jeśli obsługiwany jest wielu użytkowników, w przeciwnym razie wartość false (fałsz) |
isPackagePackage (Zainstalowany pakiet)
public boolean isPackageInstalled (String packageName)
Wyślij do urządzenia zapytanie o podaną nazwę pakietu, aby sprawdzić, czy jest aktualnie zainstalowane.
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)
Wyślij do urządzenia zapytanie o nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy to urządzenie jest obecnie zainstalowane dla tego użytkownika.
Parametry |
packageName |
String : pakiet, którego instalację sprawdzamy. |
userId |
String : identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli wartość to null, używany będzie użytkownik główny zero. |
Zwroty |
boolean |
Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
Użytkownik jest uruchomiony
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)
Zwracaj uwagę, czy określony użytkownik jest użytkownikiem dodatkowym, zgodnie z jego flagami.
Zwroty |
boolean |
true (prawda), jeśli użytkownik jest dodatkowym użytkownikiem, a w przeciwnym razie ma wartość false (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. Wartość domyślna zawsze zwraca wartość domyślną 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Pobiera listę wyświetlaczy, których można użyć w funkcji 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. |
Zgłaszanie błędów w logu
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” (prawda), jeśli logowanie zakończyło się powodzeniem. W przeciwnym razie ma wartość false (fałsz). |
notifySnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parametry |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Dodatkowe kroki wymagane do czyszczenia na danym urządzeniu, które 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). |
usuń właścicieli
public void removeOwners ()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia w miarę możliwości.
removeUser
public boolean removeUser (int userId)
Usuń 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 się powiodła, a w przeciwnym razie – false (fałsz). |
setSetting
public void setSetting (String namespace,
String key,
String value)
Zobacz metodę setSetting(int, String, String, String)
i wykonano ją na koncie użytkownika systemu.
Parametry |
namespace |
String |
key |
String |
value |
String |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
Dodaj wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu.
namespace musi być jedną z tych wartości: {"system", "secure", "global"}
Parametry |
userId |
int |
namespace |
String |
key |
String |
value |
String |
wyłącznik mikrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Wyłącza urządzenie mikrodroida, jeśli takie istnieje.
Parametry |
microdroidDevice |
ITestDevice |
startUser
public boolean startUser (int userId)
Uruchamia w tle dane użytkownika, jeśli jego działanie zostało zatrzymane. 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 |
true (prawda), jeśli użytkownik został uruchomiony w tle. |
Użytkownik początkowy
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ść dodania dodatkowej flagi, aby poczekać na zastosowanie operacji.
Parametry |
userId |
int : użytkownika, który rozpocznie się w tle |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie. |
Zwroty |
boolean |
true (prawda), jeśli użytkownik został uruchomiony w tle. |
startWidoczneTłoUżytkownik
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ą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 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ć działanie 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 dane 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 : true, jeśli mikrodroid 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. |
użytkownik przełączony
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 : nie udało się poczekać przed zwróceniem wartości false dla użytkownika Switch. |
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 ()
Przejmuje zgłoszenie błędu i zwraca je w obiekcie Bugreport
, aby je obsłużyć. W przypadku problemu zwróć 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 |
Metody chronione
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Ponownie uruchom narzędzie 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 raportami o błędach jako ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Przedstawione do testów.
getHostCurrentTime
protected long getHostCurrentTime ()
Udostępnione do testowania
Konfiguracja prePostBoot Setup
protected void prePostBootSetup ()
Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po uruchomieniu.