Urządzenie testowe
public
class
TestDevice
extends NativeDevice
Znane bezpośrednie podklasy
ManagedRemoteDevice |
Urządzenie działające w maszynie wirtualnej, którą zarządzamy zdalnie za pomocą instancji Tradefed w maszynie wirtualnej.
|
NestedRemoteDevice |
Przykład urządzenia działającego w ramach zdalnej maszyny wirtualnej Cuttlefish.
|
RemoteAndroidDevice |
Wdrożenie ITestDevice na urządzeniu z Androidem z pełnym stosem połączonym za pomocą adb connect.
|
|
Implementacja interfejsu ITestDevice
na urządzeniu z Androidem w wersji pełnoekranowej
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 dialogowe błędów aktualnie wyświetlane 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 z danym imieniem i domyślnymi flagami 0.
|
void
|
disableKeyguard()
Próby wyłączenia blokady 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 zrobić zrzut stosu z serwera 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 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()
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 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 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)
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)
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 pakiet na Androida na urządzeniu.
|
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ł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 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 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()
Zbierz listę identyfikatorów wyświetlaczy dostępnych na urządzeniu zgodnie z raportem „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 kroki wymagane do czyszczenia na danym urządzeniu, które 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 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)
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 mikrodroida, 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 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 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()
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 o podanej nazwie i domyślnych flagach 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ę testową --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 z danym imieniem i domyślnymi flagami 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. |
wyłączanie klawiszy
public void disableKeyguard ()
Próby wyłączenia blokady klawiatury.
Najpierw zaczekaj, aż przesłanie danych wejściowych będzie gotowe. Stanie się to mniej więcej w tym samym czasie, gdy urządzenie zgłosi BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna implementacja frameworka ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie odblokowania klawiatury (działa tylko w przypadku klawiatur niezabezpieczonych)
niePlikIstnieje
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. |
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, na którym ma zostać zapisana kopia. |
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 Androida powiązany z identyfikatorem użytkownika (jeśli nie zostanie znaleziony, wartość null).
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 z urządzenia raport o błędach. 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 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. |
getScreenshot
public InputStreamSource getScreenshot ()
Pobiera zrzut ekranu z urządzenia.
getScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
Robi zrzut ekranu z urządzenia. Aby zmniejszyć rozmiar pliku, zalecamy użycie zamiast niego pliku getScreenshot(String)
z kodowaniem JPEG.
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 |
Pobierz
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.
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 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 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”. |
pakiet_instalacyjny
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 , jeśli operacja się powiodła. |
pakiet_instalacyjny
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 ponownie zainstalować aplikację |
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. |
pakiet_instalacyjny
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 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 w przypadku powodzenia. |
zainstalujPakiet dla użytkownika
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Instalowanie pakietu Androida na urządzeniu danego użytkownika.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, gdy wymagana jest wyraźna kontrola udzielania uprawnień w czasie działania w momencie instalacji.
Parametry |
packageFile |
File : plik APK do zainstalowania |
reinstall |
boolean : true , jeśli należy ponownie zainstalować aplikację |
grantPermissions |
boolean : czy wszystkie uprawnienia 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 w przypadku powodzenia. |
zainstalujPakiet dla użytkownika
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 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 |
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 |
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 |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczenie 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ę o tym, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego statusu administratora.
isMultiUserSupported
public boolean isMultiUserSupported ()
Określa, czy obsługa wielu użytkowników jest obsługiwana.
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 pakiet jest zainstalowany. Jeśli wartość jest pusta, zostanie użyta wartość zero. |
Zwroty |
boolean |
Wartość Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
isUserRunning
public boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest obecny.
Zwroty |
boolean |
Wartość „prawda”, jeśli użytkownik biega. 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 osoba wchodząca w interakcję z „człowiekiem”, która może uruchamiać działania związane z uruchamianiem na tym ekranie.
Parametry |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Zbierz listę identyfikatorów wyświetlaczy dostępnych na urządzeniu zgodnie z raportem „dumpsys SurfaceFlinger”.
Zwroty |
|
Lista wyświetlaczy. Domyślnie zawsze zwraca wartość domyślną 0. |
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 |
|
listę identyfikatorów użytkowników. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Metoda pomocnicza do pobierania raportów o błędach i rejestrowania ich w dzienniku autorów.
Parametry |
dataName |
String : nazwa, pod którą będzie raportowany błąd. |
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 do usunięcia. |
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)
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)
Dodaje wartość ustawienia do przestrzeni nazw danego użytkownika. Niektóre ustawienia będą dostępne dopiero po ponownym uruchomieniu.
namespace musi być jedną z tych wartości: {"system", "secure", "global"}
Parametry |
userId |
int |
namespace |
String |
key |
String |
value |
String |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Wyłącza urządzenie microdroid, jeśli takie istnieje.
Parametry |
microdroidDevice |
ITestDevice |
startUser
public boolean startUser (int userId)
Uruchamia danego użytkownika w tle, jeśli jest on obecnie zatrzymany. Jeśli użytkownik działa już w tle, ta metoda to NOOP.
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żesz udostępnić dodatkową flagę oczekującą na wykonanie operacji.
Parametry |
userId |
int : użytkownik może uruchomić aplikację w tle |
waitFlag |
boolean : polecenie będzie oczekiwać, aż użytkownik zacznie działać i odblokuje urządzenie. |
Zwroty |
boolean |
Wartość true, jeśli użytkownik został uruchomiony w tle. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym wyświetlaczu (czyli pozwala użytkownikowi uruchamiać czynności na tym wyświetlaczu).
UWAGA: to polecenie nie sprawdza, czy użytkownik istnieje, czy wyświetlacz jest dostępny, device supports such feature
itp.
Parametry |
userId |
int : użytkownik może uruchomić aplikację w tle |
displayId |
int : wyświetlanie informacji o początkowym użytkowniku na |
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 podać dodatkowe flagi, aby zaczekać na wykonanie operacji i przymusowo zakończyć działanie użytkownika. Nie można zatrzymać bieżącego i systemowego użytkownika.
Parametry |
userId |
int : użytkownik musi się zatrzymać. |
waitFlag |
boolean : spowoduje, że polecenie będzie czekać na zatrzymanie użytkownika. |
forceFlag |
boolean : wymusi zatrzymanie 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 jest traktowana jako NOOP.
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ługujeMikrodroid
public boolean supportsMicrodroid ()
Sprawdza warunki wstępne uruchomienia mikrodroida.
Zwroty |
boolean |
zwraca wartość true, jeśli warunki wstępne są spełnione, a w przeciwnym razie zwraca wartość false. |
obsługujeMikrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Sprawdza warunki wstępne uruchomienia mikrodroida.
Parametry |
protectedVm |
boolean : wartość true, jeśli microdroid 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 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 inny identyfikator 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 ()
Przejmuje zgłoszenie błędu 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 na 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. |
Odinstaluj pakiet dla użytkownika
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 , jeśli operacja się powiodła. |
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 ()
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.