Urządzenie testowe
public
class
TestDevice
extends NativeDevice
Znane podklasy bezpośrednie
|
Wdrożenie ITestDevice
na urządzeniu z Androidem w wersji pełnej
Podsumowanie
Fieldsem |
public
static
final
String |
DISMISS_KEYGUARD_CMD
Polecenia używane do zamykania blokady klawiszy.
|
Metody publiczne |
boolean
|
canSwitchToHeadlessSystemUser()
Wskazuje, czy można przełączyć się na użytkownika SYSTEMU bez interfejsu graficznego.
|
boolean
|
clearErrorDialogs()
Spróbuj zamknąć wszystkie okna dialogowe błędów aktualnie wyświetlane w interfejsie urządzenia.
|
int
|
createUser(String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 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 podaną nazwą i podanymi flagami
|
int
|
createUserNoThrow(String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
|
void
|
disableKeyguard()
Próbuje wyłączyć blokadę klawiszy.
|
boolean
|
doesFileExist(String deviceFilePath)
Metoda pomocnicza określająca, czy plik istnieje na urządzeniu.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Metoda pomocnicza do określenia, czy dany użytkownik istnieje na urządzeniu.
|
File
|
dumpHeap(String process, String devicePath)
Spróbuj zrobić zrzut stosu z serwera 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 Androida powiązany z identyfikatorem użytkownika (jeśli nie zostanie znaleziony, wartość null).
|
|
getAndroidIds()
Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Pobranie informacji o pakiecie zainstalowanym na urządzeniu.
|
|
getAppPackageInfos()
Pobieranie informacji o pakietach zainstalowanych na urządzeniu.
|
InputStreamSource
|
getBugreport()
Pobiera raport o błędzie z urządzenia.
|
InputStreamSource
|
getBugreportz()
Pobiera z urządzenia raport o błędach.
|
DeviceFoldableState
|
getCurrentFoldableState()
Zwraca bieżący stan urządzenia składanego lub wartość null, jeśli wystąpiły problemy.
|
int
|
getCurrentUser()
Zwraca identyfikator obecnie uruchomionego konta użytkownika.
|
|
getFoldableStates()
Zwraca listę stanów urządzenia składanego.
|
|
getInstalledPackageNames()
Pobierz nazwy pakietów aplikacji znajdujące się na urządzeniu.
|
KeyguardControllerState
|
getKeyguardState()
Zwróć obiekt, aby uzyskać bieżący stan blokady klucza lub wartość null, jeśli nie jest obsługiwany.
|
Integer
|
getMainUserId()
Zwraca główny identyfikator użytkownika.
|
|
getMainlineModuleInfo()
Uzyskaj informacje o modułach mainline zainstalowanych na urządzeniu.
|
int
|
getMaxNumberOfRunningUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających użytkowników.
|
int
|
getMaxNumberOfUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników.
|
Integer
|
getPrimaryUserId()
Zwraca identyfikator głównego użytkownika.
|
InputStreamSource
|
getScreenshot()
Pobiera zrzut ekranu z urządzenia.
|
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Pobiera zrzut ekranu z urządzenia.
|
InputStreamSource
|
getScreenshot(String format)
Pobiera zrzut ekranu z urządzenia.
|
InputStreamSource
|
getScreenshot(long displayId)
Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze.
|
String
|
getSetting(String namespace, String key)
Patrz: getSetting(int, String, String) i wykonano je na użytkowniku systemowym.
|
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 of useId do UserInfo na urządzeniu.
|
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)
Sprawdź, czy jakaś funkcja jest dostępna na urządzeniu.
|
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Zainstaluj pakiet na Androida na urządzeniu.
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj pakiet na Androida na urządzeniu.
|
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()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczenie aplikacji
|
boolean
|
isHeadlessSystemUserMode()
Wskazuje, czy urządzenie używa systemowego trybu użytkownika bez interfejsu graficznego.
|
boolean
|
isMainUserPermanentAdmin()
Wskazuje, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani zmienić na niższą wersję
osoba bez uprawnień administratora.
|
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)
Wyślij zapytanie do urządzenia o podaną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy jest obecnie
być zainstalowana lub nie dla danego użytkownika.
|
boolean
|
isUserRunning(int userId)
Sprawdź, czy dany użytkownik jest uruchomiony.
|
boolean
|
isUserSecondary(int userId)
Zwracaj uwagę, czy określony użytkownik jest użytkownikiem dodatkowym, zgodnie z jego flagami.
|
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()
Wskazuje, czy urządzenie pozwala na uruchamianie użytkowników w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .
|
boolean
|
isVisibleBackgroundUsersSupported()
Wskazuje, czy urządzenie zezwala na uruchamianie użytkowników w tle.
|
|
listDisplayIds()
Zbierz listę identyfikatorów wyświetlaczy dostępnych na urządzeniu zgodnie z zgłoszeniem „dumpsys”
SurfaceFlinger”.
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Pobiera listę wyświetlaczy, których można użyć w funkcji start a user visible in the background .
|
|
listUsers()
Pobiera listę użytkowników na urządzeniu.
|
boolean
|
logBugreport(String dataName, ITestLogger listener)
Metoda pomocnicza, która powoduje wygenerowanie raportu o błędzie i zarejestrowanie go u zgłaszających.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Dodatkowe kroki wymagane do czyszczenia danego urządzenia, które zostaną wykonane po wywołaniu
gotowe.
|
boolean
|
removeAdmin(String componentName, int userId)
Usuń danego administratora urządzenia z konta danego użytkownika i zwróć true , jeśli operacja się uda. W przeciwnym razie: false .
|
void
|
removeOwners()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia w miarę możliwości.
|
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
|
setSetting(String namespace, String key, String value)
Patrz: setSetting(int, String, String, String) i wykonano je na użytkowniku systemowym.
|
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 mikrodroida, jeśli takie istnieje.
|
boolean
|
startUser(int userId)
Uruchamia w tle dane użytkownika, jeśli jego działanie zostało zatrzymane.
|
boolean
|
startUser(int userId, boolean waitFlag)
Uruchamia w tle dane użytkownika, jeśli jego działanie zostało zatrzymane.
|
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Uruchamia użytkownika w tle, widoczny na danym wyświetlaczu (umożliwia użytkownikowi
uruchamianie działań na ekranie.
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Zatrzymać danego użytkownika.
|
boolean
|
stopUser(int userId)
Zatrzymuje dane użytkownika.
|
boolean
|
supportsMicrodroid()
Sprawdza warunki wstępne uruchomienia mikrodroida.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Sprawdza warunki wstępne uruchomienia mikrodroida.
|
boolean
|
switchUser(int userId)
Przełącz się na inny identyfikator użytkownika z domyślnym czasem oczekiwania.
|
boolean
|
switchUser(int userId, long timeout)
Przełącz się na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem.
|
Bugreport
|
takeBugreport()
Utwórz raport o błędzie i zwróć go w obiekcie Bugreport , aby go obsłużyć.
|
String
|
uninstallPackage(String packageName)
Odinstaluj pakiet na Androida z urządzenia.
|
String
|
uninstallPackageForUser(String packageName, int userId)
Odinstalować pakiet na Androida z urządzenia danego użytkownika.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Fieldsem
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Polecenia używane do zamykania blokady klawiszy.
Konstruktory publiczne
Metody publiczne
MożePrzełącz naUżytkownik systemu bez interfejsu graficznego
public boolean canSwitchToHeadlessSystemUser ()
Wskazuje, czy można przełączyć się na użytkownika SYSTEMU bez interfejsu graficznego.
ClearErrorDialogs
public boolean clearErrorDialogs ()
Spróbuj zamknąć wszystkie okna dialogowe błędów aktualnie wyświetlane w interfejsie urządzenia.
Zwroty |
boolean |
true , jeśli nie było żadnych okien dialogowych lub zostały one wyczyszczone.
W przeciwnym razie: false . |
utwórzUżytkownik
public int createUser (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
Parametry |
name |
String : użytkownika do utworzenia na urządzeniu |
Zwroty |
int |
liczba całkowita utworzona dla identyfikatora użytkownika |
utwórzUżytkownik
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 do utworzenia na urządzeniu |
guest |
boolean : włącz flagę użytkownika -- gość podczas tworzenia |
ephemeral |
boolean : włącz flagę użytkownika – na bieżąco podczas tworzenia |
forTesting |
boolean : włącz flagę testową --for-testing podczas tworzenia |
Zwroty |
int |
identyfikator utworzonego użytkownika |
utwórzUżytkownik
public int createUser (String name,
boolean guest,
boolean ephemeral)
Utwórz użytkownika z podaną nazwą i podanymi flagami
Parametry |
name |
String : użytkownika do utworzenia na urządzeniu |
guest |
boolean : włącz flagę użytkownika -- gość podczas tworzenia |
ephemeral |
boolean : włącz flagę użytkownika – na bieżąco podczas tworzenia |
Zwroty |
int |
identyfikator utworzonego użytkownika |
createUserNoThrow,
public int createUserNoThrow (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
Parametry |
name |
String : użytkownika do utworzenia na urządzeniu |
Zwroty |
int |
liczba całkowita utworzonego identyfikatora użytkownika lub -1 – błąd. |
wyłączanie klawiszy
public void disableKeyguard ()
Próbuje wyłączyć blokadę klawiszy.
Najpierw trzeba poczekać na gotowość pola do wysłania danych wejściowych. Dzieje się tak mniej więcej w tym samym czasie,
urządzenia zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna platforma
w implementacji sporadycznie występuje warunek wyścigu. Następnie wysyłane jest polecenie zamknięcia blokady klawiszy (działa
tylko w przypadku niezabezpieczonych)
niePlikIstnieje
public boolean doesFileExist (String deviceFilePath)
Metoda pomocnicza określająca, czy plik istnieje na urządzeniu.
Parametry |
deviceFilePath |
String : ścieżka bezwzględna pliku na urządzeniu do sprawdzenia. |
Zwroty |
boolean |
true , jeśli plik istnieje, lub false w innym przypadku. |
niePlikIstnieje
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, z którym ma być sprawdzane istnienie pliku. |
Zwroty |
boolean |
true , jeśli plik istnieje, lub false w innym przypadku. |
zrzut stosu
public File dumpHeap (String process,
String devicePath)
Spróbuj zrobić zrzut stosu z serwera system_server. Obowiązek posprzątania jest obowiązkiem rozmówcy
duplikat pliku.
Parametry |
process |
String : nazwa procesu urządzenia, na którym ma zostać zapisana kopia. |
devicePath |
String : ścieżka na urządzeniu, w której ma zostać zapisany zrzut. Musi to być lokalizacja, w której
uprawnień na to. |
Zwroty |
File |
element ERROR(/File) zawierający raport. Wartość null, jeśli coś się nie udało. |
getActiveApexes
public getActiveApexes ()
Pobieranie informacji o punktach APEX aktywowanych na urządzeniu.
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. |
PobierzAndroida
public String getAndroidId (int userId)
Znajdź i zwróć identyfikator Androida powiązany z identyfikatorem użytkownika (jeśli nie zostanie znaleziony, wartość null).
identyfikatory getAndroid
public getAndroidIds ()
Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników. Nie istnieje żadne ubezpieczenie,
Identyfikator znajdzie identyfikator Androida powiązany z tą funkcją, więc niektóre identyfikatory użytkownika mogą być zgodne z wartością null.
Zwroty |
|
Mapa znalezionych identyfikatorów Androida pasujących 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.
Gwarantujemy, że implementacja kodu będzie działać na urządzeniach bez karty SD.
(lub w sytuacji, gdy karta SD nie jest jeszcze podłączona).
getBugreportz
public InputStreamSource getBugreportz ()
Pobiera z urządzenia raport o błędach. Raport o błędzie w formacie ZIP zawiera główny raport o błędzie oraz
inne pliki dziennika, które mogą być przydatne podczas debugowania.
Obsługiwane tylko w przypadku „wersji adb” > 1.0.36
getCurrentFoldableState,
public DeviceFoldableState getCurrentFoldableState ()
Zwraca bieżący stan urządzenia składanego lub wartość null, jeśli wystąpiły problemy.
getCurrentUser.
public int getCurrentUser ()
Zwraca identyfikator obecnie uruchomionego konta użytkownika. W przypadku błędu ustaw -10000.
getFoldableState,
public getFoldableStates ()
Zwraca listę stanów urządzenia składanego. Można uzyskać za pomocą polecenia „cmd device_state”
Print-states”.
GetInstallNames (Nazwy pakietów)
public getInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji znajdujące się 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 główny identyfikator użytkownika.
Zwroty |
Integer |
identyfikator użytkownika głównego (jeśli istnieje) lub wartość null, jeśli nie ma głównego użytkownika; |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Uzyskaj informacje o modułach mainline zainstalowanych na urządzeniu.
Zwroty |
|
Na urządzeniu jest obecnie zainstalowanych ERROR(/Set) z String modułów mainline. |
public int getMaxNumberOfRunningUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających 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 identyfikator głównego użytkownika.
Zwroty |
Integer |
identyfikator użytkownika głównego (jeśli istnieje) lub wartość null, jeśli nie ma takiego użytkownika. |
Pobierz zrzut ekranu
public InputStreamSource getScreenshot ()
Pobiera zrzut ekranu z urządzenia.
Pobierz zrzut ekranu
public InputStreamSource getScreenshot (String format,
boolean rescale)
Pobiera zrzut ekranu z urządzenia. Zamiast niego zalecany jest komponent getScreenshot(String)
z kodowaniem JPEG, by zmniejszyć rozmiar obrazu.
Parametry |
format |
String : obsługiwany format PNG, JPEG |
rescale |
boolean : jeśli zrzut ekranu należy przeskalować, by zmniejszyć rozmiar wynikowego obrazu. |
Pobierz zrzut ekranu
public InputStreamSource getScreenshot (String format)
Pobiera zrzut ekranu z urządzenia.
W przypadku mniejszego rozmiaru zalecamy użycie zamiast tego metody getScreenshot(format) z kodowaniem JPEG
Parametry |
format |
String : obsługiwany format PNG, JPEG |
Pobierz zrzut ekranu
public InputStreamSource getScreenshot (long displayId)
Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze. Format to PNG.
DO ZROBIENIA: rozszerzenie powyższych implementacji o obsługę „formatu” i „zmiana skali”
Parametry |
displayId |
long : wyświetlany identyfikator ekranu, z którego zostanie wykonany zrzut ekranu. |
Pobierz
public String getSetting (String namespace,
String key)
Patrz: getSetting(int, String, String)
i wykonano je na użytkowniku systemowym.
Parametry |
namespace |
String |
key |
String |
Pobierz
public String getSetting (int userId,
String namespace,
String key)
Zwraca wartość żądanego ustawienia.
przestrzeń nazw musi mieć 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. Jeśli nie znaleziono wartości null. |
getOdinstalujablePackageNames
public getUninstallablePackageNames ()
Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie jest to zdefiniowane jako
oraz pakiety systemowe.
Zwroty |
|
ERROR(/Set) z String nazw pakietów z możliwością odinstalowania zainstalowanych obecnie
urządzenia. |
getUserFlags,
public int getUserFlags (int userId)
Znajdź i zwróć flagi danego użytkownika.
Flagi definiuje się w sekcji „android.content.pm.UserInfo”. w projekcie Android Open Source Project.
Zwroty |
int |
flagi powiązane z podanym identyfikatorem użytkownika (jeśli został znaleziony), a w pozostałych przypadkach – -10000. |
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 |
|
listę obiektów UserInfo. |
getUserSerialNumber,
public int getUserSerialNumber (int userId)
Zwraca numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, oraz -10000 w pozostałych przypadkach.
hasFeature
public boolean hasFeature (String feature)
Sprawdź, czy jakaś funkcja jest dostępna na urządzeniu.
Parametry |
feature |
String : jaki format powinien mieć „feature:” lub „” bezpośrednio. |
Zwroty |
boolean |
Wartość prawda, jeśli funkcja została znaleziona, a fałsz – w przeciwnym razie. |
pakiet_instalacyjny
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Zainstaluj pakiet na Androida na urządzeniu.
Parametry |
packageFile |
File : plik apk do zainstalowania; |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Patrz: „adb shell pm -h” dla dostępnych
. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
pakiet_instalacyjny
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj pakiet na Androida na urządzeniu.
Uwaga: tylko przypadki użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień czasu działania w
czas instalacji powinien wywoływać tę funkcję.
Parametry |
packageFile |
File : plik apk do zainstalowania; |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : jeśli podczas instalacji powinny zostać przyznane wszystkie uprawnienia czasu działania. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Patrz: „adb shell pm -h” dla dostępnych
. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
pakiet_instalacyjny
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Zainstaluj pakiet na Androida na urządzeniu.
Uwaga: tylko przypadki użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień czasu działania w
czas instalacji powinien wywoływać tę funkcję.
Parametry |
packageFile |
File : plik apk do zainstalowania; |
certFile |
File : true , jeśli należy przeprowadzić ponowną instalację |
reinstall |
boolean : jeśli podczas instalacji powinny zostać przyznane wszystkie uprawnienia czasu działania. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Patrz: „adb shell pm -h” dla dostępnych
. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
zainstalujPakiet dla użytkownika
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Instalowanie pakietu na Androida na urządzeniu danego użytkownika.
Uwaga: tylko przypadki użycia, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień czasu działania w
czas instalacji powinien wywoływać tę funkcję.
Parametry |
packageFile |
File : plik apk do zainstalowania; |
reinstall |
boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions |
boolean : jeśli podczas instalacji powinny zostać przyznane wszystkie uprawnienia czasu działania. |
userId |
int : liczba całkowita identyfikator użytkownika, u którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Patrz: „adb shell pm -h” dla dostępnych
. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
zainstalujPakiet dla użytkownika
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Instalowanie pakietu na 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 identyfikator użytkownika, u którego ma być zainstalowana aplikacja. |
extraArgs |
String : opcjonalne dodatkowe argumenty do przekazania. Patrz: „adb shell pm -h” dla dostępnych
. |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
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 |
zainstalujPakiety dla użytkownika
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Parametry |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
userId |
int |
extraArgs |
String |
zainstalujPakiety dla użytkownika
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Parametry |
packageFiles |
|
reinstall |
boolean |
userId |
int |
extraArgs |
String |
Zainstaluj pakiety zdalne
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Parametry |
remoteApkPaths |
|
reinstall |
boolean |
extraArgs |
String |
Zainstaluj pakiety zdalne
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parametry |
remoteApkPaths |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
Obsługiwane są aplikacje
public boolean isAppEnumerationSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczenie aplikacji
Zwroty |
boolean |
Wartość prawda, jeśli wyliczanie aplikacji jest obsługiwane. W przeciwnym razie ma wartość false (fałsz) |
Tryb użytkownika bez interfejsu graficznego
public boolean isHeadlessSystemUserMode ()
Wskazuje, czy urządzenie używa systemowego trybu użytkownika bez interfejsu graficznego.
isMainUserPermanentAdmin,
public boolean isMainUserPermanentAdmin ()
Wskazuje, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani zmienić na niższą wersję
osoba bez uprawnień administratora.
Obsługa wielu użytkowników
public boolean isMultiUserSupported ()
Określa, czy obsługa wielu użytkowników jest obsługiwana.
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 |
Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
isPackagePackage (Zainstalowany pakiet)
public boolean isPackageInstalled (String packageName,
String userId)
Wyślij zapytanie do urządzenia o podaną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy jest obecnie
być zainstalowana lub nie dla danego użytkownika.
Parametry |
packageName |
String : pakiet, który sprawdzamy, czy jest zainstalowany. |
userId |
String : identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli wartość to null, główny użytkownik
zostanie użyta wartość 0. |
Zwroty |
boolean |
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 uruchomiony.
Zwroty |
boolean |
Wartość „prawda”, jeśli użytkownik jest uruchomiony, a „fałsz” w pozostałych przypadkach. |
JestUżytkownikdodatkowy
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.
„Widoczne” Użytkownik to użytkownik, który wchodzi w interakcję z „człowiekiem” użytkownika, dzięki czemu może
czynności związane z uruchamianiem aplikacji (zwykle na ekranie domyślnym).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Sprawdza, czy dany użytkownik jest widoczny na danym wyświetlaczu.
„Widoczne” Użytkownik to użytkownik, który wchodzi w interakcję z „człowiekiem” użytkownika, dzięki czemu może
uruchomić działania związane z uruchomieniem na tym wyświetlaczu.
Parametry |
userId |
int |
displayId |
int |
listaDisplayIds
public listDisplayIds ()
Zbierz listę identyfikatorów wyświetlaczy dostępnych na urządzeniu zgodnie z zgłoszeniem „dumpsys”
SurfaceFlinger”.
Zwroty |
|
Lista wyświetlaczy. Wartość domyślna zawsze zwraca wartość domyślną 0. |
listaUżytkowników
public listUsers ()
Pobiera listę użytkowników na urządzeniu. Zwraca DeviceRuntimeException
, jeśli dane wyjściowe
z urządzenia nie jest zgodne z oczekiwaniami.
Zwroty |
|
listę identyfikatorów użytkowników. |
Zgłaszanie błędów w logu
public boolean logBugreport (String dataName,
ITestLogger listener)
Metoda pomocnicza, która powoduje wygenerowanie raportu o błędzie i zarejestrowanie go u zgłaszających.
Parametry |
dataName |
String : nazwa, pod którą będzie raportowany błąd. |
listener |
ITestLogger : ITestLogger , aby zapisać raport o błędzie. |
Zwroty |
boolean |
Wartość „true” (prawda), jeśli logowanie zakończyło się powodzeniem. W przeciwnym razie ma wartość false (fałsz). |
notificationSnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parametry |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Dodatkowe kroki wymagane do czyszczenia danego urządzenia, które zostaną wykonane po wywołaniu
gotowe.
Parametry |
exception |
Throwable : ostatni wyjątek zgłoszony w wyniku niepowodzenia wywołania. |
usuń administratora
public boolean removeAdmin (String componentName,
int userId)
Usuń danego administratora urządzenia z konta danego użytkownika i zwróć true
, jeśli operacja się uda. W przeciwnym razie: false
.
Parametry |
componentName |
String : administratora urządzenia do usunięcia. |
userId |
int : użytkownika, w którym mieszka administrator urządzenia. |
Zwroty |
boolean |
Wartość „true” (prawda), jeśli jest udana, albo „false” (fałsz). |
usuń właścicieli
public void removeOwners ()
Usuń wszystkich dotychczasowych właścicieli profilu urządzenia w miarę możliwości.
usuń użytkownika
public boolean removeUser (int userId)
Usunąć danego użytkownika z urządzenia.
Parametry |
userId |
int : użytkownika do usunięcia |
Zwroty |
boolean |
true (prawda), jeśli udało się usunąć użytkownika, w przeciwnym razie ma wartość false (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 : administratora urządzenia jako właściciela urządzenia. |
userId |
int : użytkownika, z którego korzysta właściciel urządzenia. |
Zwroty |
boolean |
Wartość „true” (prawda), jeśli jest udana, albo „false” (fałsz). |
UstawUstawienia
public void setSetting (String namespace,
String key,
String value)
Patrz: setSetting(int, String, String, String)
i wykonano je na użytkowniku systemowym.
Parametry |
namespace |
String |
key |
String |
value |
String |
UstawUstawienia
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 tylko
po restarcie.
przestrzeń nazw musi mieć 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 |
Użytkownik początkowy
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ż
która działa w tle, to NOOP.
Parametry |
userId |
int : użytkownika, który rozpocznie się 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 w tle dane użytkownika, jeśli jego działanie zostało zatrzymane. Jeśli użytkownik jest już
która działa w tle, to NOOP. Możliwe jest przesłanie dodatkowej flagi do oczekiwania
aby miała ona skutek.
Parametry |
userId |
int : użytkownika, który rozpocznie się w tle |
waitFlag |
boolean : polecenie będzie czekać na uruchomienie i odblokowanie użytkownika. |
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 użytkownika w tle, widoczny na danym wyświetlaczu (umożliwia użytkownikowi
uruchamianie działań na ekranie.
UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature
itp.
Parametry |
userId |
int : użytkownika, który rozpocznie się w tle |
displayId |
int : wyświetlacz, na którym będzie widoczny początkowy użytkownik |
waitFlag |
boolean : polecenie będzie czekać na uruchomienie i odblokowanie użytkownika. |
Zwroty |
boolean |
true , jeśli użytkownik został uruchomiony w tle. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Zatrzymać danego użytkownika. można udostępnić dodatkowe flagi oczekujące na zastosowanie operacji,
i wymuszenie zamknięcia konta użytkownika. Nie można zatrzymać bieżącego i systemowego użytkownika.
Parametry |
userId |
int : użytkownika do zatrzymania. |
waitFlag |
boolean : spowoduje, że polecenie będzie czekać na zatrzymanie użytkownika. |
forceFlag |
boolean : wymusi zatrzymanie użytkownika. |
Zwroty |
boolean |
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 jest traktowana jako NOOP.
Nie można zatrzymać bieżącego i systemowego użytkownika.
Parametry |
userId |
int : użytkownika do zatrzymania. |
Zwroty |
boolean |
true, jeśli użytkownik został zatrzymany. |
obsługujeMikrodroid
public boolean supportsMicrodroid ()
Sprawdza warunki wstępne uruchomienia mikrodroida.
Zwroty |
boolean |
zwraca wartość „true” (prawda), jeśli warunki wstępne są spełnione. W przeciwnym razie zwraca wartość „false” (fałsz). |
obsługujeMikrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Sprawdza warunki wstępne uruchomienia mikrodroida.
Parametry |
protectedVm |
boolean : true, jeśli mikrodroid ma działać na chronionej maszynie wirtualnej. |
Zwroty |
boolean |
zwraca wartość „true” (prawda), jeśli warunki wstępne są spełnione. W przeciwnym razie zwraca wartość „false” (fałsz). |
użytkownik przełączony
public boolean switchUser (int userId)
Przełącz się na inny identyfikator użytkownika z domyślnym czasem oczekiwania. switchUser(int, long)
.
Zwroty |
boolean |
Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą 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 inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem.
Spróbuj wyłączyć blokadę klawiszy po pomyślnym zmianie użytkownika.
Parametry |
userId |
int |
timeout |
long : nie udało się odczekać przed zwróceniem wartości false dla użytkownika Switch. |
Zwroty |
boolean |
Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz. |
ZgłośBugreport
public Bugreport takeBugreport ()
Utwórz raport o błędzie i zwróć go w obiekcie Bugreport
, aby go obsłużyć. Zwracana wartość null
w przypadku wystąpienia problemu. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony w programie Bugreport.close()
.
Odinstaluj pakiet
public String uninstallPackage (String packageName)
Odinstaluj pakiet na Androida z urządzenia.
Parametry |
packageName |
String : pakiet na Androida do odinstalowania |
Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
Odinstaluj pakiet dla użytkownika
public String uninstallPackageForUser (String packageName,
int userId)
Odinstalować pakiet na Androida z urządzenia danego użytkownika.
Parametry |
packageName |
String : pakiet na Androida do odinstalowania |
userId |
int : liczba całkowita identyfikator użytkownika, w przypadku którego chcesz odinstalować aplikację. |
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)
doAdbRestart
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Ponownie uruchom narzędzie adb.
Parametry |
rebootMode |
NativeDevice.RebootMode : tryb ponownego uruchamiania. |
reason |
String : ten restart. |
getBugreportzInternal
protected File getBugreportzInternal ()
Wewnętrzne narzędzie pomocnicze do pobierania pliku ZIP z raportem błędów w formacie ERROR(/File)
.
getCheckNowyUżytkownikSnu
protected long getCheckNewUserSleep ()
Przedstawione do testów.
getHostCurrentTime,
protected long getHostCurrentTime ()
Narażone do testowania
Konfiguracja prePostBoot Setup
protected void prePostBootSetup ()
Zezwala każdemu typowi urządzeń (AndroidNativeDevice, TestDevice) na zastąpienie tej metody w przypadku:
po rozruchu.