Klasy zagnieżdżone |
---|
class | TestDevice.MicrodroidBuilder Konstruktor używany do tworzenia Microdroid TestDevice. |
Pola |
---|
public static final String | DISMISS_KEYGUARD_CMD Polecenia, których można użyć do odrzucenia blokady klawiatury. |
Metody publiczne |
---|
boolean | canSwitchToHeadlessSystemUser () Zwraca, czy można przełączyć się na bezgłowego użytkownika SYSTEM. |
boolean | clearErrorDialogs () Spróbuj odrzucić wszystkie okna dialogowe błędów wyświetlane obecnie 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 o podanej nazwie i dostarczonych flagach |
int | createUser (String name, boolean guest, boolean ephemeral) Utwórz użytkownika o podanej nazwie i dostarczonych flagach |
int | createUserNoThrow (String name) Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
void | disableKeyguard () Próby wyłączenia blokady klawiatury. |
boolean | doesFileExist (String deviceFilePath) Metoda pomocnika w celu ustalenia, czy plik na urządzeniu istnieje. |
boolean | doesFileExist (String deviceFilePath, int userId) Metoda pomocnika w celu określenia, czy plik na urządzeniu istnieje dla danego użytkownika. |
File | dumpHeap (String process, String devicePath) Spróbuj zrzucić stertę z serwera system_server. |
| getActiveApexes () Pobierz informacje o aktywowanych na urządzeniu APEXach. |
| getAllSettings (String namespace) Zwróć pary klucz-wartość żądanej przestrzeni nazw. |
String | getAndroidId (int userId) Znajdź i zwróć identyfikator Androida powiązany z identyfikatorem użytkownika, null, jeśli nie został znaleziony. |
| getAndroidIds () Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników. |
PackageInfo | getAppPackageInfo (String packageName) Pobierz informacje o pakiecie zainstalowanym na urządzeniu. |
| getAppPackageInfos () Pobierz 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 składania urządzenia lub wartość null, jeśli wystąpiły problemy. |
int | getCurrentUser () Zwróć identyfikator bieżącego uruchomionego użytkownika. |
| getFoldableStates () Zwraca listę składanych stanów na urządzeniu. |
| getInstalledPackageNames () Pobierz nazwy pakietów aplikacji obecnych na urządzeniu. |
KeyguardControllerState | getKeyguardState () Zwróć obiekt, aby uzyskać aktualny stan blokady klawiatury lub wartość null, jeśli nie jest obsługiwana. |
Integer | getMainUserId () Zwraca główny identyfikator użytkownika. |
| getMainlineModuleInfo () Uzyskaj informacje o głównych modułach 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 główny identyfikator 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) Przechwytuje zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. |
String | getSetting (String namespace, String key) Zobacz getSetting(int, String, String) i wykonaj na użytkowniku systemowym. |
String | getSetting (int userId, String namespace, String key) Zwróć 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 do UserInfo na urządzeniu. |
int | getUserSerialNumber (int userId) Zwróć numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, -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, boolean reinstall, boolean grantPermissions, 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 | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Zainstaluj pakiet Android na urządzeniu dla danego użytkownika. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Zainstaluj pakiet Android na urządzeniu dla danego użytkownika. |
String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) |
String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) |
boolean | isAppEnumerationSupported () Sprawdź, czy platforma na urządzeniu obsługuje wyliczanie aplikacji |
boolean | isHeadlessSystemUserMode () Zwraca informację, czy urządzenie używa trybu użytkownika systemu bezobsługowego. |
boolean | isMainUserPermanentAdmin () Zwraca informację, czy główny użytkownik jest stałym administratorem i nie może zostać usunięty ani zdegradowany do statusu innego niż administrator. |
boolean | isMultiUserSupported () Określa, czy obsługiwany jest tryb wielu użytkowników. |
boolean | isPackageInstalled (String packageName) Zapytaj urządzenie o daną nazwę pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie. |
boolean | isPackageInstalled (String packageName, String userId) Zapytaj urządzenie o daną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest ono aktualnie zainstalowane dla tego użytkownika. |
boolean | isUserRunning (int userId) Sprawdź, czy dany użytkownik jest uruchomiony. |
boolean | isUserSecondary (int userId) Zwraca, czy określony użytkownik jest użytkownikiem drugorzędnym 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 ekranie. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Zwraca, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
boolean | isVisibleBackgroundUsersSupported () Zwraca, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle. |
| listDisplayIds () Zbierz listę dostępnych identyfikatorów wyświetlaczy na urządzeniu, zgłoszoną przez „dumpsys SurfaceFlinger”. |
| listDisplayIdsForStartingVisibleBackgroundUsers () Pobiera listę ekranów, których można użyć 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, aby zgłosić błąd i zalogować go do reporterów. |
void | postInvocationTearDown (Throwable exception) Dodatkowe kroki związane z wymaganym czyszczeniem urządzenia, 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 zwróć true , jeśli się powiedzie, w przeciwnym razie zwróć false . |
void | removeOwners () Jak najlepiej usuń wszystkich istniejących właścicieli profili urządzeń. |
boolean | removeUser (int userId) Usuń danego użytkownika z urządzenia. |
boolean | setDeviceOwner (String componentName, int userId) Ustaw komponent administratora urządzenia jako właściciela urządzenia dla danego użytkownika. |
void | setSetting (String namespace, String key, String value) Zobacz setSetting(int, String, String, String) i wykonaj 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 microdroid, jeśli takie istnieje. |
boolean | startUser (int userId) Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. |
boolean | startUser (int userId, boolean waitFlag) Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Uruchamia danego użytkownika w tle, widocznego na danym ekranie (tj. pozwalając użytkownikowi na uruchamianie działań na tym ekranie). |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Zatrzymaj danego użytkownika. |
boolean | stopUser (int userId) Zatrzymuje danego użytkownika. |
boolean | supportsMicrodroid () Sprawdza warunki wstępne do uruchomienia mikrodroida. |
boolean | supportsMicrodroid (boolean protectedVm) Sprawdza warunki wstępne do uruchomienia mikrodroida. |
boolean | switchUser (int userId) Przełącz się na inny identyfikator użytkownika z domyślnym limitem czasu. |
boolean | switchUser (int userId, long timeout) Przełącz się na inny identyfikator użytkownika z podanym limitem czasu jako terminem. |
Bugreport | takeBugreport () Weź raport o błędzie i zwróć go do obiektu 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. |
Pola
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Polecenia, których można użyć do odrzucenia blokady klawiatury.
Konstruktory publiczne
Metody publiczne
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Zwraca, czy można przełączyć się na bezgłowego użytkownika SYSTEM.
wyczyść dialogi błędów
public boolean clearErrorDialogs ()
Spróbuj odrzucić wszystkie okna dialogowe błędów wyświetlane obecnie w interfejsie urządzenia.
Zwroty |
---|
boolean | true Jeśli żadne okna dialogowe nie były obecne lub okna dialogowe zostały pomyślnie wyczyszczone. false inaczej. |
Stwórz użytkownika
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 dla utworzonego identyfikatora użytkownika |
Stwórz użytkownika
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Utwórz użytkownika o podanej nazwie i dostarczonych flagach
Parametry |
---|
name | String : użytkownika do utworzenia 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 |
Stwórz użytkownika
public int createUser (String name,
boolean guest,
boolean ephemeral)
Utwórz użytkownika o podanej nazwie i dostarczonych flagach
Parametry |
---|
name | String : użytkownika do utworzenia 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 |
utwórzUserNoThrow
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 dla utworzonego identyfikatora użytkownika lub -1 w przypadku błędu. |
wyłącz ochronę klawiatury
public void disableKeyguard ()
Próby wyłączenia blokady klawiatury.
Najpierw poczekaj, aż wysyłka danych wejściowych będzie gotowa, dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ obecna implementacja frameworka ma sporadyczne warunki wyścigu. Następnie wysyłane jest polecenie usunięcia blokady klawiatury (działa tylko na niezabezpieczonych)
czyPlikIstnieje
public boolean doesFileExist (String deviceFilePath)
Metoda pomocnika w celu ustalenia, czy plik na urządzeniu istnieje.
Parametry |
---|
deviceFilePath | String : bezwzględna ścieżka do pliku na urządzeniu do sprawdzenia |
Zwroty |
---|
boolean | true , jeśli plik istnieje, false w przeciwnym razie. |
czyPlikIstnieje
public boolean doesFileExist (String deviceFilePath,
int userId)
Metoda pomocnika w celu określenia, czy plik na urządzeniu istnieje dla danego użytkownika.
Parametry |
---|
deviceFilePath | String : bezwzględna ścieżka do pliku na urządzeniu do sprawdzenia |
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. |
sterta zrzutu
public File dumpHeap (String process,
String devicePath)
Spróbuj zrzucić stertę z serwera system_server. Wyczyszczenie zrzuconego pliku jest obowiązkiem dzwoniącego.
Parametry |
---|
process | String : nazwa procesu urządzenia, na którym ma zostać zrzut. |
devicePath | String : ścieżka na urządzeniu, gdzie umieścić zrzut. Musi to być lokalizacja, w której zezwalają na to uprawnienia. |
Zwroty |
---|
File | ERROR(/File) zawierający raport. Null, jeśli coś się nie powiedzie. |
getActiveApexs
public getActiveApexes ()
Pobierz informacje o aktywowanych na urządzeniu APEXach.
pobierz wszystkie ustawienia
public getAllSettings (String namespace)
Zwróć pary klucz-wartość żądanej przestrzeni nazw.
Parametry |
---|
namespace | String : musi być jednym z {"system", "bezpieczny", "globalny"} |
Zwroty |
---|
| mapa par klucz-wartość. Null, jeśli przestrzeń nazw nie jest obsługiwana. |
pobierz identyfikator Androida
public String getAndroidId (int userId)
Znajdź i zwróć identyfikator Androida powiązany z identyfikatorem użytkownika, null, jeśli nie został znaleziony.
pobierz identyfikatory Androida
public getAndroidIds ()
Utwórz mapę znalezionych identyfikatorów Androida pasujących do identyfikatorów użytkowników. Nie ma gwarancji, że każdy identyfikator użytkownika znajdzie identyfikator Androida powiązany z tą funkcją, więc niektóre identyfikatory użytkowników mogą być zgodne z wartością null.
Zwroty |
---|
| Znaleziono mapę identyfikatorów Androida pasujących do identyfikatorów użytkowników. |
pobierz informacje o pakiecie aplikacji
public PackageInfo getAppPackageInfo (String packageName)
Pobierz informacje o pakiecie zainstalowanym na urządzeniu.
Parametry |
---|
packageName | String |
getAppPackageInfos
public getAppPackageInfos ()
Pobierz informacje o pakietach zainstalowanych na urządzeniu.
pobierz raport Bugre
public InputStreamSource getBugreport ()
Pobiera raport o błędzie z urządzenia.
Wdrożenie tego gwarantuje kontynuację pracy na urządzeniu bez karty SD (lub tam, gdzie karta SD nie jest jeszcze zamontowana).
pobierz Bugreportz
public InputStreamSource getBugreportz ()
Pobiera raport o błędzie z urządzenia. 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” > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Zwraca bieżący stan składania urządzenia lub wartość null, jeśli wystąpiły problemy.
pobierzCurrentUser
public int getCurrentUser ()
Zwróć identyfikator bieżącego uruchomionego użytkownika. W przypadku błędu zwróć -10000.
getFoldableStates
public getFoldableStates ()
Zwraca listę składanych stanów na urządzeniu. Można uzyskać za pomocą „cmd device_state print-states”.
getInstalledPackageNames
public getInstalledPackageNames ()
Pobierz nazwy pakietów aplikacji obecnych na urządzeniu.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Zwróć obiekt, aby uzyskać aktualny stan blokady klawiatury lub wartość null, jeśli nie jest obsługiwana.
getGłówny identyfikator użytkownika
public Integer getMainUserId ()
Zwraca główny identyfikator użytkownika.
Zwroty |
---|
Integer | userId głównego użytkownika, jeśli istnieje, i null, jeśli nie ma głównego użytkownika. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Uzyskaj informacje o głównych modułach zainstalowanych na urządzeniu.
public int getMaxNumberOfRunningUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych jednocześnie działających użytkowników. Domyślnie 0.
Zwroty |
---|
int | liczba całkowita wskazująca liczbę jednocześnie uruchomionych użytkowników |
public int getMaxNumberOfUsersSupported ()
Uzyskaj maksymalną liczbę obsługiwanych użytkowników. Domyślnie 0.
Zwroty |
---|
int | liczba całkowita wskazująca liczbę obsługiwanych użytkowników |
getPrimaryUserId
public Integer getPrimaryUserId ()
Zwraca główny identyfikator użytkownika.
Zwroty |
---|
Integer | userId głównego użytkownika, jeśli istnieje, i null, jeśli nie ma głównego 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. Zalecane użycie getScreenshot(String)
zamiast kodowania JPEG dla mniejszego rozmiaru.
Parametry |
---|
format | String : obsługiwany PNG, JPEG |
rescale | boolean : jeśli zrzut ekranu powinien zostać przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu |
pobierz zrzut ekranu
public InputStreamSource getScreenshot (String format)
Pobiera zrzut ekranu z urządzenia. Zalecane użycie getScreenshot(format) zamiast kodowania JPEG dla mniejszego rozmiaru
Parametry |
---|
format | String : obsługiwany PNG, JPEG |
pobierz zrzut ekranu
public InputStreamSource getScreenshot (long displayId)
Przechwytuje zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. Format to PNG.
DO ZROBIENIA: rozszerz powyższe implementacje, aby obsługiwały „format” i „przeskalowanie”
Parametry |
---|
displayId | long : identyfikator ekranu, z którego ma zostać pobrany zrzut ekranu. |
getSetting
public String getSetting (String namespace,
String key)
Zobacz getSetting(int, String, String)
i wykonaj na użytkowniku systemowym.
Parametry |
---|
namespace | String |
key | String |
getSetting
public String getSetting (int userId,
String namespace,
String key)
Zwróć wartość żądanego ustawienia. przestrzeń nazw musi być jedną z: {"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 została znaleziona. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Pobierz nazwy pakietów aplikacji, które można odinstalować. Jest to obecnie definiowane jako pakiety niesystemowe i zaktualizowane pakiety systemowe.
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 skojarzone z podanym identyfikatorem użytkownika, jeśli zostały znalezione, -10000 we wszystkich innych przypadkach. |
pobierz informacje o użytkowniku
public getUserInfos ()
Pobiera mapę useId do UserInfo
na urządzeniu. Zgłosi wyjątek DeviceRuntimeException
, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.
Zwroty |
---|
| lista obiektów UserInfo. |
pobierz numer seryjny użytkownika
public int getUserSerialNumber (int userId)
Zwróć numer seryjny powiązany z identyfikatorem użytkownika, jeśli został znaleziony, -10000 w innych przypadkach.
maFunkcja
public boolean hasFeature (String feature)
Sprawdź, czy funkcja jest dostępna na urządzeniu.
Parametry |
---|
feature | String : jaki format powinien mieć postać „feature: " Lub " "bezpośrednio. |
Zwroty |
---|
boolean | Prawda, jeśli funkcja została znaleziona, w przeciwnym razie fałsz. |
pakiet instalacyjny
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 przeprowadzić ponowną instalację |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji. |
Zwroty |
---|
String | ERROR(/String) z kodem błędu lub null , jeśli się powiedzie. |
pakiet instalacyjny
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 użycia, które wymagają jawnej kontroli przyznawania uprawnień w czasie wykonywania podczas instalacji.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : jeśli wszystkie uprawnienia w czasie wykonywania powinny zostać przyznane w czasie instalacji |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji. |
Zwroty |
---|
String | ERROR(/String) z kodem błędu lub null , jeśli się powiedzie. |
pakiet instalacyjny
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 użycia, które wymagają jawnej kontroli przyznawania uprawnień w czasie wykonywania podczas instalacji.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
certFile | File : true , jeśli należy przeprowadzić ponowną instalację |
reinstall | boolean : jeśli wszystkie uprawnienia w czasie wykonywania powinny zostać przyznane w czasie instalacji |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji. |
Zwroty |
---|
String | ERROR(/String) z kodem błędu lub null , jeśli się powiedzie. |
zainstaluj pakiet dla użytkownika
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Zainstaluj pakiet Android na urządzeniu dla danego użytkownika.
Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają jawnej kontroli przyznawania uprawnień w czasie wykonywania podczas instalacji.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : jeśli wszystkie uprawnienia w czasie wykonywania powinny zostać przyznane w czasie instalacji |
userId | int : całkowity identyfikator użytkownika, dla którego ma zostać zainstalowana. |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji. |
Zwroty |
---|
String | ERROR(/String) z kodem błędu lub null , jeśli się powiedzie. |
zainstaluj pakiet dla użytkownika
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Zainstaluj pakiet Android na urządzeniu dla danego użytkownika.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
userId | int : całkowity identyfikator użytkownika, dla którego ma zostać zainstalowana. |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h' dla dostępnych opcji. |
Zwroty |
---|
String | ERROR(/String) z kodem błędu lub null , jeśli się powiedzie. |
zainstaluj pakiety
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Parametry |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
zainstaluj pakiety
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parametry |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
installPakietyDlaUżytkownika
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Parametry |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
installPakietyDlaUż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 |
isAppEnumerationObsługiwane
public boolean isAppEnumerationSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje wyliczanie aplikacji
Zwroty |
---|
boolean | Prawda, jeśli obsługiwane jest wyliczanie aplikacji, w przeciwnym razie fałsz |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Zwraca informację, czy urządzenie używa trybu użytkownika systemu bezobsługowego.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Zwraca informację, czy główny użytkownik jest stałym administratorem i nie może zostać usunięty ani zdegradowany do statusu innego niż administrator.
jest obsługiwany przez wielu użytkowników
public boolean isMultiUserSupported ()
Określa, czy obsługiwany jest tryb wielu użytkowników.
Zwroty |
---|
boolean | true , jeśli obsługiwana jest funkcja wielu użytkowników, w przeciwnym razie false |
jest zainstalowany pakiet
public boolean isPackageInstalled (String packageName)
Zapytaj urządzenie o daną nazwę pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie.
Parametry |
---|
packageName | String |
Zwroty |
---|
boolean | Prawda, jeśli pakiet jest zgłaszany jako zainstalowany. Fałsz inaczej. |
jest zainstalowany pakiet
public boolean isPackageInstalled (String packageName,
String userId)
Zapytaj urządzenie o daną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest ono aktualnie zainstalowane dla tego 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. W przypadku wartości null zostanie użyte zero użytkownika podstawowego. |
Zwroty |
---|
boolean | Prawda, jeśli pakiet jest zgłaszany jako zainstalowany. Fałsz inaczej. |
jest uruchomionym użytkownikiem
public boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest uruchomiony.
Zwroty |
---|
boolean | Prawda, jeśli użytkownik jest uruchomiony, fałsz we wszystkich innych przypadkach. |
isUserSecondary
public boolean isUserSecondary (int userId)
Zwraca, czy określony użytkownik jest użytkownikiem drugorzędnym zgodnie z jego flagami.
Zwroty |
---|
boolean | true , jeśli użytkownik jest drugorzędny, w przeciwnym razie false . |
jest widoczny dla użytkownika
public boolean isUserVisible (int userId)
Sprawdza, czy dany użytkownik jest widoczny.
Użytkownik „widoczny” to użytkownik, który wchodzi w interakcję z użytkownikiem „człowiekiem”, a zatem może uruchamiać działania uruchamiające (zwykle na ekranie domyślnym).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Sprawdza, czy dany użytkownik jest widoczny na danym ekranie.
Użytkownik „widoczny” to użytkownik, który wchodzi w interakcję z użytkownikiem „człowiekiem”, a zatem może uruchamiać działania na tym ekranie.
Parametry |
---|
userId | int |
displayId | int |
lista Wyświetlane identyfikatory
public listDisplayIds ()
Zbierz listę dostępnych identyfikatorów wyświetlaczy na urządzeniu, zgłoszoną przez „dumpsys SurfaceFlinger”.
Zwroty |
---|
| Lista wyświetlaczy. Default zawsze zwraca domyślne wyświetlanie 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Pobiera listę ekranów, których można użyć do start a user visible in the background
.
listaUżytkownicy
public listUsers ()
Pobiera listę użytkowników na urządzeniu. Zgłosi wyjątek DeviceRuntimeException
, jeśli dane wyjściowe z urządzenia nie będą zgodne z oczekiwaniami.
Zwroty |
---|
| lista identyfikatorów użytkowników. |
dziennik Bugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Metoda pomocnicza, aby zgłosić błąd i zalogować go do reporterów.
Parametry |
---|
dataName | String : nazwa, pod którą zostanie zgłoszony raport o błędzie. |
listener | ITestLogger : ITestLogger do rejestrowania raportu o błędzie. |
Zwroty |
---|
boolean | Prawda, jeśli rejestrowanie się powiodło, w przeciwnym razie fałsz. |
postInwokacjaTearDown
public void postInvocationTearDown (Throwable exception)
Dodatkowe kroki związane z wymaganym czyszczeniem urządzenia, które zostaną wykonane po zakończeniu wywołania.
Parametry |
---|
exception | Throwable : jeśli istnieje, ostatni wyjątek zgłoszony przez niepowodzenie wywołania. |
usuńAdmin
public boolean removeAdmin (String componentName,
int userId)
Usuń danego administratora urządzenia w danym użytkowniku i zwróć true
, jeśli się powiedzie, w przeciwnym razie zwróć false
.
Parametry |
---|
componentName | String : administratora urządzenia do usunięcia. |
userId | int : użytkownika, w którym mieszka administrator urządzenia. |
Zwroty |
---|
boolean | Prawda, jeśli się powiedzie, fałsz w przeciwnym razie. |
usuńWłaściciele
public void removeOwners ()
Jak najlepiej usuń wszystkich istniejących właścicieli profili urządzeń.
usuń użytkownika
public boolean removeUser (int userId)
Usuń danego użytkownika z urządzenia.
Parametry |
---|
userId | int : użytkownika do usunięcia |
Zwroty |
---|
boolean | true , jeśli pomyślnie usunęliśmy użytkownika, w przeciwnym razie false . |
ustaw właściciela urządzenia
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, który ma być właścicielem urządzenia. |
userId | int : użytkownika, w którym mieszka właściciel urządzenia. |
Zwroty |
---|
boolean | Prawda, jeśli się powiedzie, fałsz w przeciwnym razie. |
zestawUstawienie
public void setSetting (String namespace,
String key,
String value)
Zobacz setSetting(int, String, String, String)
i wykonaj na użytkowniku systemowym.
Parametry |
---|
namespace | String |
key | String |
value | String |
zestawUstawienie
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: {"system", "secure", "global"}
Parametry |
---|
userId | int |
namespace | String |
key | String |
value | String |
zamknij Microdroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Wyłącza urządzenie microdroid, jeśli takie istnieje.
Parametry |
---|
microdroidDevice | ITestDevice |
startUżytkownik
public boolean startUser (int userId)
Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda to NOOP.
Parametry |
---|
userId | int : użytkownika, aby rozpocząć w tle |
Zwroty |
---|
boolean | true Jeśli użytkownik został pomyślnie uruchomiony w tle. |
startUżytkownik
public boolean startUser (int userId,
boolean waitFlag)
Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany. Jeśli użytkownik już działa w tle, ta metoda to NOOP. Możliwość podania dodatkowej flagi oczekiwania na efekt operacji.
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 | true Jeśli użytkownik został pomyślnie uruchomiony w tle. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznego na danym ekranie (tj. pozwalając użytkownikowi na uruchamianie działań na tym 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, aby rozpocząć w tle |
displayId | int : wyświetl, aby rozpocząć widoczność użytkownika |
waitFlag | boolean : spowoduje, że polecenie będzie czekać, aż użytkownik zostanie uruchomiony i odblokowany. |
Zwroty |
---|
boolean | true Jeśli użytkownik został pomyślnie uruchomiony widoczny w tle. |
stopUżytkownik
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Zatrzymaj danego użytkownika. Możliwe podanie dodatkowych flag, aby czekać na efekt operacji i wymusić zamknięcie 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ć, aż użytkownik zostanie zatrzymany. |
forceFlag | boolean : wymusi zatrzymanie użytkownika. |
Zwroty |
---|
boolean | true , jeśli użytkownik został pomyślnie zatrzymany. |
stopUżytkownik
public boolean stopUser (int userId)
Zatrzymuje danego użytkownika. Jeśli użytkownik jest już zatrzymany, ta metoda jest 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ł pomyślnie zatrzymany. |
obsługuje Microdroida
public boolean supportsMicrodroid ()
Sprawdza warunki wstępne do uruchomienia mikrodroida.
Zwroty |
---|
boolean | zwraca true, jeśli warunki wstępne są spełnione, w przeciwnym razie zwraca false. |
obsługuje Microdroida
public boolean supportsMicrodroid (boolean protectedVm)
Sprawdza warunki wstępne do uruchomienia mikrodroida.
Parametry |
---|
protectedVm | boolean : prawda, jeśli microdroid ma działać na chronionej maszynie wirtualnej. |
Zwroty |
---|
boolean | zwraca true, jeśli warunki wstępne są spełnione, w przeciwnym razie zwraca false. |
Zmień użytkownika
public boolean switchUser (int userId)
Przełącz się na inny identyfikator użytkownika z domyślnym limitem czasu. switchUser(int, long)
.
Zwroty |
---|
boolean | Prawda, jeśli nowy userId jest zgodny z dostawcą userId. Fałsz inaczej. |
Zmień użytkownika
public boolean switchUser (int userId,
long timeout)
Przełącz się na inny identyfikator użytkownika z podanym limitem czasu jako terminem. Próba wyłączenia blokady klawiatury po zmianie użytkownika zakończy się pomyślnie.
Parametry |
---|
userId | int |
timeout | long : czekać przed zwróceniem wartości false w przypadku niepowodzenia przełączania użytkownika. |
Zwroty |
---|
boolean | Prawda, jeśli nowy userId jest zgodny z dostawcą userId. Fałsz inaczej. |
weź Bugreport
public Bugreport takeBugreport ()
Weź raport o błędzie i zwróć go do obiektu Bugreport
, aby go obsłużyć. Zwróć wartość null w przypadku problemu. Plik, do którego odwołuje się obiekt Bugreport, musi zostać wyczyszczony za pomocą Bugreport.close()
.
Odinstaluj pakiet
public String uninstallPackage (String packageName)
Odinstaluj pakiet Androida z urządzenia.
Parametry |
---|
packageName | String : pakiet Androida do odinstalowania |
Zwroty |
---|
String | ERROR(/String) z kodem błędu lub null , jeśli się powiedzie. |
odinstaluj pakiet dla użytkownika
public String uninstallPackageForUser (String packageName,
int userId)
Odinstaluj pakiet Androida z urządzenia dla danego użytkownika.
Parametry |
---|
packageName | String : pakiet Androida do odinstalowania |
userId | int : identyfikator użytkownika będący liczbą całkowitą, dla którego ma zostać odinstalowany. |
Zwroty |
---|
String | ERROR(/String) z kodem błędu lub null , jeśli się powiedzie. |
Metody chronione
utwórz Parser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Wykonaj ponowne uruchomienie adb.
Parametry |
---|
rebootMode | NativeDevice.RebootMode : tryb tego ponownego uruchomienia. |
reason | String : dla tego ponownego uruchomienia. |
getBugreportzInternal
protected File getBugreportzInternal ()
Wewnętrzna metoda pomocnika, aby pobrać plik ZIP raportu błędów jako ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Wystawiony do testów.
getHostCurrentTime
protected long getHostCurrentTime ()
Wystawiony do testów
Konfiguracja prePostBoot
protected void prePostBootSetup ()
Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po rozruchu.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2023-04-28 UTC.
[]
[]