TestDevice
public
class
TestDevice
extends NativeDevice
Znane bezpośrednie podklasy
| ManagedRemoteDevice |
Urządzenie działające w maszynie wirtualnej, którą zdalnie zarządzamy za pomocą instancji Tradefed w maszynie wirtualnej.
|
| NestedRemoteDevice |
Reprezentacja urządzenia działającego na zdalnej maszynie wirtualnej Cuttlefish.
|
| RemoteAndroidDevice |
Implementacja ITestDevice na urządzeniu z Androidem połączonym za pomocą polecenia adb connect.
|
|
Wdrożenie ITestDevice na urządzeniu z Androidem
Podsumowanie
Metody publiczne |
boolean
|
canSwitchToHeadlessSystemUser()
Zwraca informację, czy można przełączyć się na użytkownika SYSTEM bez interfejsu graficznego.
|
boolean
|
clearErrorDialogs()
Próba zamknięcia wszystkich okien dialogowych z błędami, które są obecnie 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)
Utwórz użytkownika o danej nazwie i z podanymi flagami.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Utwórz użytkownika o danej nazwie i z podanymi flagami.
|
int
|
createUserNoThrow(String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
|
void
|
disableKeyguard()
próby wyłączenia ochrony klawiatury,
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Metoda pomocnicza do określania, czy plik na urządzeniu istnieje dla danego użytkownika.
|
boolean
|
doesFileExist(String deviceFilePath)
Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu.
|
File
|
dumpHeap(String process, String devicePath)
Spróbuj zrzucić stertę z procesu system_server.
|
|
getActiveApexes()
Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.
|
|
getAllSettings(String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw.
|
String
|
getAndroidId(int userId)
Znajduje i zwraca identyfikator Androida powiązany z identyfikatorem użytkownika. Jeśli nie zostanie znaleziony, zwraca wartość null.
|
|
getAndroidIds()
Utwórz mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Pobiera informacje 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łędzie.
|
DeviceFoldableState
|
getCurrentFoldableState()
Zwraca bieżący stan urządzenia składanego lub wartość null, jeśli wystąpiły problemy.
|
int
|
getCurrentUser()
Zwraca identyfikator aktualnie zalogowanego użytkownika.
|
|
getFoldableStates()
Zwraca listę stanów urządzenia składanego.
|
|
getInstalledPackageNames()
Pobierz nazwy pakietów aplikacji znajdujących się na urządzeniu.
|
KeyguardControllerState
|
getKeyguardState()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, lub wartość null, jeśli nie jest obsługiwany.
|
Integer
|
getMainUserId()
Zwraca główny identyfikator użytkownika.
|
|
getMainlineModuleInfo()
Pobiera informacje o modułach głównych zainstalowanych na urządzeniu.
|
int
|
getMaxNumberOfRunningUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników działających jednocześnie.
|
int
|
getMaxNumberOfUsersSupported()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników.
|
Integer
|
getPrimaryUserId()
Zwraca podstawowy identyfikator użytkownika.
|
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Robi zrzut ekranu urządzenia.
|
InputStreamSource
|
getScreenshot(long displayId)
Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza.
|
InputStreamSource
|
getScreenshot(String format)
Robi zrzut ekranu urządzenia.
|
InputStreamSource
|
getScreenshot()
Robi zrzut ekranu urządzenia.
|
String
|
getSetting(int userId, String namespace, String key)
Zwraca wartość żądanego ustawienia.
|
String
|
getSetting(String namespace, String key)
Patrz getSetting(int, String, String) i wykonywane na użytkowniku systemu.
|
|
getUninstallablePackageNames()
Pobierz nazwy pakietów aplikacji, które można odinstalować.
|
int
|
getUserFlags(int userId)
Znajdowanie i zwracanie flag danego użytkownika.
|
|
getUserInfos()
Pobiera mapę identyfikatorów użycia do UserInfo na urządzeniu.
|
int
|
getUserSerialNumber(int userId)
Zwraca numer seryjny powiązany z identyfikatorem userId, jeśli zostanie znaleziony, lub wartość -10000 w innych przypadkach.
|
boolean
|
hasFeature(String feature)
Sprawdź, czy funkcja jest dostępna na urządzeniu.
|
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
|
String
|
installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.
|
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Instaluje pliki APK w trybie przyrostowym.
|
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, 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 wyliczanie aplikacji
|
boolean
|
isHeadlessSystemUserMode()
Zwraca informację o tym, czy urządzenie korzysta z trybu użytkownika systemu bez interfejsu graficznego.
|
boolean
|
isMainUserPermanentAdmin()
Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego uprawnień do poziomu użytkownika bez uprawnień administracyjnych.
|
boolean
|
isMultiUserSupported()
Określa, czy obsługiwany jest tryb wielu użytkowników.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Wysyła zapytanie do urządzenia o daną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana dla tego użytkownika.
|
boolean
|
isPackageInstalled(String packageName)
Wysyłaj do urządzenia zapytania o daną nazwę pakietu, aby sprawdzić, czy jest on obecnie zainstalowany.
|
boolean
|
isUserRunning(int userId)
Sprawdź, czy dany użytkownik jest aktywny.
|
boolean
|
isUserSecondary(int userId)
Zwraca informację, czy określony 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 informację, czy urządzenie zezwala na uruchamianie użytkowników w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
|
boolean
|
isVisibleBackgroundUsersSupported()
Zwraca informację, czy urządzenie zezwala na uruchamianie użytkownikom widocznym w tle.
|
|
listDisplayIds()
Zbierz listę identyfikatorów dostępnych wyświetlaczy 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 służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.
|
boolean
|
removeAdmin(String componentName, int userId)
Usuwa administratora urządzenia z konta użytkownika i zwraca true, jeśli operacja się uda, a w przeciwnym razie false.
|
void
|
removeOwners()
Usuń wszystkich obecnych właścicieli profilu urządzenia, dokładając wszelkich starań.
|
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
|
setFirstBootloaderReboot()
|
void
|
setSetting(String namespace, String key, String value)
Patrz setSetting(int, String, String, String) i wykonywane na użytkowniku systemu.
|
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 umożliwia mu uruchamianie aktywności na tym wyświetlaczu).
|
boolean
|
stopUser(int userId)
Zatrzymuje danego użytkownika.
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Zatrzymanie danego 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 na inny identyfikator użytkownika z domyślnym czasem oczekiwania.
|
boolean
|
switchUser(int userId, long timeout)
Przełącz na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem.
|
Bugreport
|
takeBugreport()
Pobiera raport o błędzie i zwraca go w obiekcie Bugreport, aby go 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 dla danego użytkownika.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Stałe
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Polecenia, których można użyć do zamknięcia ekranu blokady.
Stała wartość:
"input keyevent 82"
Publiczne konstruktory
Metody publiczne
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Zwraca informację, czy można przełączyć się na użytkownika SYSTEM bez interfejsu graficznego.
clearErrorDialogs
public boolean clearErrorDialogs ()
Próba zamknięcia wszystkich okien dialogowych z błędami, które są obecnie wyświetlane w interfejsie urządzenia.
| Zwroty |
boolean |
true – jeśli nie było żadnych okien lub zostały one usunięte.
false w przeciwnym razie. |
createUser
public int createUser (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
| Parametry |
name |
String: użytkownika, który ma utworzyć na urządzeniu |
| Zwroty |
int |
liczba całkowita utworzonego identyfikatora użytkownika, |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
Utwórz użytkownika o danej nazwie i z podanymi flagami.
| Parametry |
name |
String: użytkownika, który ma utworzyć na urządzeniu |
guest |
boolean: włącz flagę użytkownika --guest podczas tworzenia. |
ephemeral |
boolean: włącz flagę użytkownika --ephemeral podczas tworzenia. |
| Zwroty |
int |
identyfikator utworzonego użytkownika, |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Utwórz użytkownika o danej nazwie i z podanymi flagami.
| Parametry |
name |
String: użytkownika, który ma utworzyć na urządzeniu |
guest |
boolean: włącz flagę użytkownika --guest 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, |
createUserNoThrow
public int createUserNoThrow (String name)
Utwórz użytkownika o podanej nazwie i domyślnych flagach 0.
| Parametry |
name |
String: użytkownika, który ma utworzyć na urządzeniu |
| Zwroty |
int |
liczba całkowita identyfikatora użytkownika utworzonego lub -1 w przypadku błędu. |
disableKeyguard
public void disableKeyguard ()
próby wyłączenia ochrony klawiatury,
Najpierw poczekaj, aż wysyłanie danych wejściowych będzie gotowe. Dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ bieżąca implementacja platformy czasami powoduje wyścig. Następnie wysyłane jest polecenie zamknięcia ekranu blokady (działa tylko w przypadku niezabezpieczonych ekranów blokady).
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Metoda pomocnicza do określania, czy plik na urządzeniu istnieje dla danego użytkownika.
| Parametry |
deviceFilePath |
String: bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony. |
userId |
int: identyfikator użytkownika, względem którego należy sprawdzić istnienie pliku. |
| Zwroty |
boolean |
true, jeśli plik istnieje, false w przeciwnym razie. |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu.
| Parametry |
deviceFilePath |
String: bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony. |
| Zwroty |
boolean |
true, jeśli plik istnieje, false w przeciwnym razie. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Spróbuj zrzucić stertę z procesu system_server. Za usunięcie zrzutu pliku odpowiada osoba wywołująca.
| Parametry |
process |
String: nazwa procesu na urządzeniu, w którym ma zostać wykonany zrzę pamięci. |
devicePath |
String: ścieżka na urządzeniu, w której ma zostać umieszczony 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 powiodło. |
getActiveApexes
public getActiveApexes ()
Pobiera informacje o pakietach APEX aktywowanych na urządzeniu.
getAllSettings
public getAllSettings (String namespace)
Zwraca pary klucz-wartość żądanej przestrzeni nazw.
| Parametry |
namespace |
String: musi mieć jedną z wartości: {"system", "secure", "global"} |
| Zwroty |
|
mapa par klucz-wartość. Wartość null, jeśli przestrzeń nazw nie jest obsługiwana. |
getAndroidId
public String getAndroidId (int userId)
Znajduje i zwraca identyfikator Androida powiązany z identyfikatorem użytkownika. Jeśli nie zostanie znaleziony, zwraca wartość null.
getAndroidIds
public getAndroidIds ()
Utwórz mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników. Nie ma gwarancji, że każdy identyfikator użytkownika znajdzie powiązany identyfikator Androida w tej funkcji, więc niektóre identyfikatory użytkowników mogą pasować do wartości null.
| Zwroty |
|
Mapa identyfikatorów Androida pasujących do identyfikatorów użytkowników. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Pobiera informacje 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 ta implementacja będzie nadal działać na urządzeniu bez karty SD (lub na urządzeniu, na którym karta SD nie jest jeszcze zamontowana).
getBugreportz
public InputStreamSource getBugreportz ()
Pobiera z urządzenia raport o błędzie. Raport o błędzie w formacie ZIP zawiera główny raport o błędzie i inne pliki dziennika, które są przydatne do debugowania.
Obsługiwane tylko w przypadku wersji „adb version” > 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 aktualnie zalogowanego użytkownika. W przypadku błędu zwróć wartość -10000.
getFoldableStates
public getFoldableStates ()
Zwraca listę stanów urządzenia składanego. Można je uzyskać za pomocą polecenia „cmd device_state
print-states”.
getInstalledPackageNames
public getInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji znajdujących się na urządzeniu.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Zwraca obiekt, aby uzyskać bieżący stan blokady ekranu, 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 taki istnieje, lub wartość null, jeśli nie ma użytkownika głównego. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Pobiera informacje o modułach głównych zainstalowanych na urządzeniu.
public int getMaxNumberOfRunningUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników działających jednocześnie. Domyślna wartość to 0.
| Zwroty |
int |
liczbę całkowitą wskazującą liczbę użytkowników działających jednocześnie, |
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 wartość null, jeśli nie ma głównego użytkownika. |
getScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
Robi zrzut ekranu urządzenia. Zalecamy używanie getScreenshot(String) zamiast tego formatu, ponieważ w przypadku kodowania JPEG rozmiar jest mniejszy.
| Parametry |
format |
String: obsługiwane formaty PNG i JPEG |
rescale |
boolean: czy zrzut ekranu ma zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu. |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. Format to PNG.
DO ZROBIENIA: rozszerzyć powyższe implementacje, aby obsługiwały parametry „format” i „rescale”
| Parametry |
displayId |
long: identyfikator ekranu, z którego ma zostać zrobiony zrzut. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Robi zrzut ekranu urządzenia.
Zalecamy używanie zamiast tego metody getScreenshot(format) z kodowaniem JPEG, aby uzyskać mniejszy rozmiar.
| Parametry |
format |
String: obsługiwane formaty PNG i JPEG |
getScreenshot
public InputStreamSource getScreenshot ()
Robi zrzut ekranu urządzenia.
getSetting
public String getSetting (int userId,
String namespace,
String key)
Zwraca wartość żądanego ustawienia.
Przestrzeń nazw 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. |
getSetting
public String getSetting (String namespace,
String key)
Patrz getSetting(int, String, String) i wykonywane na użytkowniku systemu.
| Parametry |
namespace |
String |
key |
String |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie są to pakiety inne niż systemowe i zaktualizowane pakiety systemowe.
| Zwroty |
|
ERROR(/Set) nazw pakietów, których nie można odinstalować, zainstalowanych obecnie na urządzeniu.String |
getUserFlags
public int getUserFlags (int userId)
Znajdź i zwróć flagi danego użytkownika.
Flagi są zdefiniowane w klasie „android.content.pm.UserInfo” w projekcie Android Open Source.
| Zwroty |
int |
flagi powiązane z podanym identyfikatorem użytkownika, jeśli zostaną znalezione, lub -10000 w innych przypadkach. |
getUserInfos
public getUserInfos ()
Pobiera mapę identyfikatorów użycia do UserInfo na urządzeniu. Zwróci błąd DeviceRuntimeException, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.
| Zwroty |
|
lista obiektów UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Zwraca numer seryjny powiązany z identyfikatorem userId, jeśli zostanie znaleziony, lub wartość -10000 w innych przypadkach.
hasFeature
public boolean hasFeature (String feature)
Sprawdź, czy funkcja jest dostępna na urządzeniu.
| Parametry |
feature |
String: format powinien mieć postać „feature:” lub bezpośrednio „”. |
| Zwroty |
boolean |
Wartość true, jeśli funkcja została znaleziona. W przeciwnym razie wartość false. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
| 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 w sekcji „adb shell pm -h”. |
| Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackage
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie 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 czasu działania powinny być przyznawane podczas instalacji. |
extraArgs |
String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „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 pakiet Androida na urządzeniu.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie 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 czasu działania powinny być przyznawane podczas instalacji. |
extraArgs |
String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”. |
| Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.
| Parametry |
packageFile |
File: plik APK do zainstalowania |
reinstall |
boolean: true, jeśli należy ponownie zainstalować aplikację. |
userId |
int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja. |
extraArgs |
String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”. |
| Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Zainstaluj pakiet Androida na urządzeniu dla danego użytkownika.
Uwaga: tę funkcję należy wywoływać tylko w przypadkach, które wymagają wyraźnej kontroli nad przyznawaniem uprawnień w czasie 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 czasu działania powinny być przyznawane podczas instalacji. |
userId |
int: identyfikator użytkownika (liczba całkowita), dla którego ma zostać zainstalowana aplikacja. |
extraArgs |
String: opcjonalne dodatkowe argumenty do przekazania. Dostępne opcje znajdziesz w sekcji „adb shell pm -h”. |
| Zwroty |
String |
String z kodem błędu lub null w przypadku powodzenia. |
installPackageWithIncrementalMode
public boolean installPackageWithIncrementalMode (File[] apkFiles,
String[] extraArgs,
String userId)
Instaluje pliki APK w trybie przyrostowym.
| Parametry |
apkFiles |
File: pliki APK do zainstalowania. |
extraArgs |
String |
userId |
String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
| Parametry |
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
| Parametry |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
| Parametry |
packageFiles |
|
reinstall |
boolean |
userId |
int |
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 |
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 ()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczanie aplikacji
| Zwroty |
boolean |
Prawda, jeśli wyliczanie aplikacji jest obsługiwane, w przeciwnym razie fałsz. |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Zwraca informację o tym, czy urządzenie korzysta z trybu użytkownika systemu bez interfejsu graficznego.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani obniżyć jego uprawnień do poziomu użytkownika bez uprawnień administracyjnych.
isMultiUserSupported
public boolean isMultiUserSupported ()
Określa, czy obsługiwany jest tryb wielu użytkowników.
| Zwroty |
boolean |
wartość „true”, jeśli obsługiwanych jest wielu użytkowników, w przeciwnym razie „false”. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Wysyła zapytanie do urządzenia o daną nazwę pakietu i identyfikator użytkownika, aby sprawdzić, czy aplikacja jest obecnie zainstalowana dla tego użytkownika.
| Parametry |
packageName |
String: pakiet, który sprawdzamy pod kątem instalacji. |
userId |
String: identyfikator użytkownika, dla którego sprawdzamy, czy pakiet jest zainstalowany. Jeśli wartość to null, używana będzie wartość zero. |
| Zwroty |
boolean |
Wartość true, jeśli pakiet jest zgłaszany jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Wysyłaj do urządzenia zapytania o daną nazwę pakietu, aby sprawdzić, czy jest on obecnie zainstalowany.
| Parametry |
packageName |
String |
| Zwroty |
boolean |
Wartość true, jeśli pakiet jest zgłaszany jako zainstalowany. W przeciwnym razie ma wartość Fałsz. |
isUserRunning
public boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest aktywny.
| Zwroty |
boolean |
Wartość „prawda”, jeśli użytkownik biegnie. W innych przypadkach wartość „fałsz”. |
isUserSecondary
public boolean isUserSecondary (int userId)
Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym na podstawie jego flag.
| Zwroty |
boolean |
Wartość „true”, jeśli użytkownik jest dodatkowy, w przeciwnym razie „false”. |
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 „prawdziwym” użytkownikiem i dlatego może uruchamiać działania (zwykle na domyślnym ekranie).
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 „prawdziwym” użytkownikiem i dlatego może uruchamiać działania na tym wyświetlaczu.
| Parametry |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Zbierz listę identyfikatorów dostępnych wyświetlaczy na urządzeniu, zgodnie z raportem „dumpsys SurfaceFlinger”.
| Zwroty |
|
Lista wyświetlaczy. Domyślna zawsze zwraca domyślny wyświetlacz 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Pobiera listę wyświetlaczy, których można używać do start a user visible in the background.
listUsers
public listUsers ()
Pobiera listę użytkowników na urządzeniu. Wyrzuci wyjątek DeviceRuntimeException, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.
| Zwroty |
|
lista identyfikatorów użytkowników; |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Metoda pomocnicza służąca do tworzenia raportu o błędzie i przesyłania go do osób zgłaszających.
| Parametry |
dataName |
String: nazwa, pod którą zostanie zgłoszony raport o błędzie. |
listener |
ITestLogger: ITestLogger, aby zarejestrować raport o błędzie. |
| Zwroty |
boolean |
Wartość true, jeśli rejestrowanie się powiodło. W przeciwnym razie wartość false. |
notifySnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
| Parametry |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.
| Parametry |
exception |
Throwable: jeśli wystąpił błąd wywołania, jest to ostateczny wyjątek. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Usuwa administratora urządzenia z konta użytkownika i zwraca true, jeśli operacja się uda, a w przeciwnym razie false.
| Parametry |
componentName |
String: administratora urządzenia do usunięcia. |
userId |
int: użytkownika, w którego profilu znajduje się administrator urządzenia. |
| Zwroty |
boolean |
Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”. |
removeOwners
public void removeOwners ()
Usuń wszystkich obecnych właścicieli profilu urządzenia, dokładając wszelkich starań.
removeUser
public boolean removeUser (int userId)
Usuń danego użytkownika z urządzenia.
| Parametry |
userId |
int: użytkownika, który ma zostać usunięty. |
| Zwroty |
boolean |
Wartość true, jeśli użytkownik został usunięty. W przeciwnym razie wartość 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: administratora urządzenia na właściciela urządzenia. |
userId |
int: użytkownika, w którego kraju mieszka właściciel urządzenia. |
| Zwroty |
boolean |
Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”. |
setFirstBootloaderReboot
public void setFirstBootloaderReboot ()
setSetting
public void setSetting (String namespace,
String key,
String value)
Patrz setSetting(int, String, String, String) i wykonywane na użytkowniku 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.
Przestrzeń nazw 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 już działa w tle, ta metoda nie wykonuje żadnej operacji.
| Parametry |
userId |
int: użytkownika, aby rozpocząć 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 już działa w tle, ta metoda nie wykonuje żadnej operacji. Możesz podać dodatkową flagę, aby poczekać, aż operacja zacznie działać.
| Parametry |
userId |
int: użytkownika, aby rozpocząć w tle |
waitFlag |
boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany. |
| 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 umożliwia mu uruchamianie aktywnoś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żytkownika, aby rozpocząć w tle |
displayId |
int: wyświetlany użytkownikowi na początku |
waitFlag |
boolean: spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany. |
| Zwroty |
boolean |
true – jeśli użytkownikowi udało się uruchomić widoczną w tle aplikację. |
stopUser
public boolean stopUser (int userId)
Zatrzymuje danego użytkownika. Jeśli użytkownik jest już zatrzymany, ta metoda nie wykonuje żadnych działań.
Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.
| Parametry |
userId |
int: użytkownika, którego chcesz zatrzymać. |
| Zwroty |
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Zatrzymanie danego użytkownika. Można podać dodatkowe flagi, aby poczekać na wprowadzenie zmian, i wymusić zakończenie sesji użytkownika. Nie można zatrzymać bieżącego użytkownika ani użytkownika systemu.
| Parametry |
userId |
int: użytkownika, którego chcesz zatrzymać. |
waitFlag |
boolean: spowoduje, że polecenie będzie czekać, aż użytkownik się zatrzyma. |
forceFlag |
boolean: wymusi zatrzymanie użytkownika. |
| Zwroty |
boolean |
Wartość true, jeśli użytkownik został zatrzymany. |
supportsMicrodroid
public boolean supportsMicrodroid ()
Sprawdza warunki wstępne uruchomienia mikrodroida.
| Zwroty |
boolean |
Zwraca wartość „true”, jeśli warunki wstępne są spełnione, w przeciwnym razie zwraca wartość „false”. |
supportsMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Sprawdza warunki wstępne uruchomienia mikrodroida.
| Parametry |
protectedVm |
boolean: wartość true, jeśli mikrodroid ma być uruchamiany na chronionej maszynie wirtualnej. |
| Zwroty |
boolean |
Zwraca wartość „true”, jeśli warunki wstępne są spełnione, w przeciwnym razie zwraca wartość „false”. |
switchUser
public boolean switchUser (int userId)
Przełącz na inny identyfikator użytkownika z domyślnym czasem oczekiwania. switchUser(int, long).
| Zwroty |
boolean |
Wartość „true”, 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 na inny identyfikator użytkownika z podanym czasem oczekiwania jako terminem.
Próba wyłączenia blokady ekranu po zmianie użytkownika zakończyła się powodzeniem.
| Parametry |
userId |
int |
timeout |
long: czas oczekiwania przed zwróceniem wartości false w przypadku niepowodzenia przełączania użytkownika. |
| Zwroty |
boolean |
Wartość „true”, jeśli nowy identyfikator użytkownika pasuje do dostawcy identyfikatora użytkownika. W przeciwnym razie ma wartość Fałsz. |
takeBugreport
public Bugreport takeBugreport ()
Pobiera raport o błędzie i zwraca go w obiekcie Bugreport, aby go obsłużyć. W razie problemu zwraca wartość null. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony 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 dla danego użytkownika.
| Parametry |
packageName |
String: pakiet na Androida do odinstalowania. |
userId |
int: identyfikator użytkownika (liczba całkowita), 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)
Wykonaj ponowne uruchomienie za pomocą ADB.
| Parametry |
rebootMode |
NativeDevice.RebootMode: tryb ponownego uruchomienia. |
reason |
String: w przypadku tego ponownego uruchomienia. |
getBugreportzInternal
protected File getBugreportzInternal ()
Wewnętrzna metoda pomocnicza do pobierania pliku ZIP bugreportz jako ERROR(/File).
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Udostępniono do testowania.
getHostCurrentTime
protected long getHostCurrentTime ()
Udostępniono do testowania
prePostBootSetup
protected void prePostBootSetup ()
Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w celu przeprowadzenia konfiguracji po uruchomieniu.