Zagnieżdżone klasy |
---|
class | TestDevice.MicrodroidBuilder Konstruktor używany do tworzenia urządzenia testowego Microdroid. |
Pola |
---|
public static final String | DISMISS_KEYGUARD_CMD Polecenia, których można użyć do zwolnienia blokady klawiatury. |
Metody publiczne |
---|
boolean | canSwitchToHeadlessSystemUser () Zwraca informację, czy można przełączyć się na użytkownika bezgłowego SYSTEM. |
boolean | clearErrorDialogs () Spróbuj odrzucić wszelkie okna dialogowe o błędach wyświetlane obecnie w interfejsie użytkownika 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 podanych flagach |
int | createUser (String name, boolean guest, boolean ephemeral) Utwórz użytkownika o podanej nazwie i podanych flagach |
int | createUserNoThrow (String name) Utwórz użytkownika o podanej nazwie i domyślnych flagach 0. |
void | disableKeyguard () Próba wyłączenia blokady klawiatury. |
boolean | doesFileExist (String deviceFilePath) Metoda pomocnicza służąca do ustalenia, czy plik na urządzeniu istnieje. |
boolean | doesFileExist (String deviceFilePath, int userId) Metoda pomocnicza służąca do ustalenia, czy dla danego użytkownika istnieje plik na urządzeniu. |
File | dumpHeap (String process, String devicePath) Spróbuj zrzucić stertę z serwera systemowego. |
| getActiveApexes () Pobierz informacje o APEXach aktywowanych na urządzeniu. |
| 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 zostanie 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łędach z urządzenia. |
DeviceFoldableState | getCurrentFoldableState () Zwraca bieżący stan składania urządzenia lub wartość null, jeśli wystąpiły pewne 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 obecne na urządzeniu. |
KeyguardControllerState | getKeyguardState () Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany. |
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 podstawowy 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) Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. |
String | getSetting (String namespace, String key) Zobacz getSetting(int, String, String) i wykonywane 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) Jeśli zostanie znaleziony, zwróć numer seryjny powiązany z identyfikatorem użytkownika, w pozostałych przypadkach -10000. |
boolean | hasFeature (String feature) Sprawdź, czy dana funkcja jest dostępna na urządzeniu. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Zainstaluj pakiet Android na urządzeniu. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Zainstaluj pakiet Android na urządzeniu. |
String | installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs) Zainstaluj pakiet Android 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 korzysta z trybu użytkownika systemu bezgłowego. |
boolean | isMainUserPermanentAdmin () Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani zmienić na inny niż administrator. |
boolean | isMultiUserSupported () Określa, czy obsługiwanych jest wielu użytkowników. |
boolean | isPackageInstalled (String packageName) Zapytaj urządzenie o podaną nazwę pakietu, aby sprawdzić, czy jest on aktualnie zainstalowany, czy nie. |
boolean | isPackageInstalled (String packageName, String userId) Zapytaj urządzenie o podaną 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 informację, czy określony użytkownik jest użytkownikiem dodatkowym zgodnie z jego flagami. |
boolean | isUserVisible (int userId) Sprawdza czy dany użytkownik jest widoczny. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Sprawdza czy dany użytkownik jest widoczny na danym wyświetlaczu. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Zwraca, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle w ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
boolean | isVisibleBackgroundUsersSupported () Zwraca informację, czy urządzenie pozwala na uruchamianie użytkowników widocznych w tle. |
| listDisplayIds () Zbierz listę dostępnych identyfikatorów wyświetlaczy na urządzeniu zgodnie z raportem „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 umożliwiająca przyjęcie raportu o błędzie i zalogowanie go do reporterów. |
void | postInvocationTearDown (Throwable exception) Dodatkowe kroki dotyczące wymaganego czyszczenia specyficznego dla urządzenia, które zostaną wykonane po zakończeniu wywołania. |
boolean | removeAdmin (String componentName, int userId) Usuń danego administratora urządzenia dla danego użytkownika i zwróć wartość true , jeśli się powiedzie, false w przeciwnym razie. |
void | removeOwners () Usuń wszystkich istniejących właścicieli profili urządzeń, 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 | 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, widocznym na danym ekranie (tzn. umożliwiając użytkownikowi uruchomienie 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 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 limitem czasu. |
boolean | switchUser (int userId, long timeout) Przełącz na inny identyfikator użytkownika z podanym limitem czasu jako ostatecznym 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 zwolnienia blokady klawiatury.
Konstruktorzy publiczni
Metody publiczne
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Zwraca informację, czy można przełączyć się na użytkownika bezgłowego SYSTEM.
wyczyść okno dialogowe błędów
public boolean clearErrorDialogs ()
Spróbuj odrzucić wszelkie okna dialogowe o błędach wyświetlane obecnie w interfejsie użytkownika urządzenia.
Zwroty |
---|
boolean | true , jeśli nie było żadnych okien dialogowych lub okna dialogowe zostały pomyślnie usunięte. inaczej false . |
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, który ma zostać utworzony 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 podanych flagach
Parametry |
---|
name | String : użytkownika, który ma zostać utworzony 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 podanych flagach
Parametry |
---|
name | String : użytkownika, który ma zostać utworzony 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, który ma zostać utworzony na urządzeniu |
Zwroty |
---|
int | liczba całkowita dla utworzonego identyfikatora użytkownika lub -1 w przypadku błędu. |
wyłącz Keyguarda
public void disableKeyguard ()
Próba wyłączenia blokady 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ż w bieżącej implementacji frameworka czasami zdarzają się wyścigi. Następnie wysyłane jest polecenie zwolnienia klawiatury (działa tylko na niezabezpieczonych)
czy plik istnieje
public boolean doesFileExist (String deviceFilePath)
Metoda pomocnicza służąca do ustalenia, czy plik na urządzeniu istnieje.
Parametry |
---|
deviceFilePath | String : bezwzględna ścieżka pliku na urządzeniu do sprawdzenia |
Zwroty |
---|
boolean | true , jeśli plik istnieje, false w przeciwnym razie. |
czy plik istnieje
public boolean doesFileExist (String deviceFilePath,
int userId)
Metoda pomocnicza służąca do ustalenia, czy dla danego użytkownika istnieje plik na urządzeniu.
Parametry |
---|
deviceFilePath | String : bezwzględna ścieżka pliku na urządzeniu do sprawdzenia |
userId | int : Identyfikator użytkownika, według którego sprawdzane jest 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 systemowego. Oczyszczenie zrzuconego pliku jest obowiązkiem dzwoniącego.
Parametry |
---|
process | String : nazwa procesu urządzenia, na którym ma zostać zrzucony plik. |
devicePath | String : ścieżka na urządzeniu, gdzie umieścić zrzut. Musi to być lokalizacja, w której pozwalają na to uprawnienia. |
Zwroty |
---|
File | ERROR(/File) zawierający raport. Null, jeśli coś się nie udało. |
pobierz ActiveApexy
public getActiveApexes ()
Pobierz informacje o APEXach aktywowanych na urządzeniu.
pobierzWszystkieUstawienia
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 zostanie 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ą mieć wartość 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 |
pobierzInformacje o pakiecie aplikacji
public getAppPackageInfos ()
Pobierz informacje o pakietach zainstalowanych na urządzeniu.
pobierz raport błędów
public InputStreamSource getBugreport ()
Pobiera raport o błędzie z urządzenia.
Implementacja tego gwarantuje dalszą pracę na urządzeniu bez karty SD (lub tam, gdzie karta SD nie jest jeszcze zamontowana).
pobierz Bugreportz
public InputStreamSource getBugreportz ()
Pobiera raport o błędach z urządzenia. Raport o błędach w formacie zip zawiera główny raport o błędach i inne pliki dziennika przydatne do debugowania.
Obsługiwane tylko dla „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 pewne problemy.
pobierz bieżącego użytkownika
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 obecne na urządzeniu.
pobierzKeyguardState
public KeyguardControllerState getKeyguardState ()
Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany.
pobierzIdMainUserId
public Integer getMainUserId ()
Zwraca główny identyfikator użytkownika.
Zwroty |
---|
Integer | userId głównego użytkownika, jeśli taki istnieje, i null, jeśli nie ma głównego użytkownika. |
pobierzMainlineModuleInfo
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. Wartość domyślna to 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. Wartość domyślna to 0.
Zwroty |
---|
int | liczba całkowita wskazująca liczbę obsługiwanych użytkowników |
pobierz identyfikator użytkownika podstawowego
public Integer getPrimaryUserId ()
Zwraca podstawowy identyfikator użytkownika.
Zwroty |
---|
Integer | userId głównego użytkownika, jeśli taki 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 jest użycie getScreenshot(String)
zamiast z kodowaniem JPEG w celu uzyskania mniejszego rozmiaru.
Parametry |
---|
format | String : obsługiwany format PNG, JPEG |
rescale | boolean : jeśli należy przeskalować zrzut ekranu, aby zmniejszyć rozmiar wynikowego obrazu |
pobierz zrzut ekranu
public InputStreamSource getScreenshot (String format)
Pobiera zrzut ekranu z urządzenia. Zalecane jest użycie getScreenshot(format) zamiast z kodowaniem JPEG w celu uzyskania mniejszego rozmiaru
Parametry |
---|
format | String : obsługiwany format PNG, JPEG |
pobierz zrzut ekranu
public InputStreamSource getScreenshot (long displayId)
Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza. Format to PNG.
DO ZROBIENIA: rozszerz powyższe implementacje, aby obsługiwały „formatowanie” i „przeskalowanie”
Parametry |
---|
displayId | long : identyfikator ekranu, z którego chcesz pobrać zrzut ekranu. |
pobierz ustawienie
public String getSetting (String namespace,
String key)
Zobacz getSetting(int, String, String)
i wykonywane na użytkowniku systemowym.
Parametry |
---|
namespace | String |
key | String |
pobierz ustawienie
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:kluczem użytkownika. Wartość null, jeśli nie została znaleziona. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Pobierz nazwy pakietów aplikacji, które można odinstalować. Obecnie definiuje się je jako pakiety niesystemowe i zaktualizowane pakiety systemowe.
Zwroty |
---|
| ERROR(/Set) nazw pakietów String , które można odinstalować, aktualnie zainstalowanych na urządzeniu. |
pobierz flagi użytkownika
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 identyfikatorem użytkownika, jeśli zostaną znalezione, -10000 w pozostałych przypadkach. |
pobierz informacje o użytkowniku
public getUserInfos ()
Pobiera mapę useId do UserInfo
na urządzeniu. Zgłosi DeviceRuntimeException
, jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
Zwroty |
---|
| lista obiektów UserInfo. |
pobierz numer seryjny użytkownika
public int getUserSerialNumber (int userId)
Jeśli zostanie znaleziony, zwróć numer seryjny powiązany z identyfikatorem użytkownika, w pozostałych przypadkach -10000.
ma funkcję
public boolean hasFeature (String feature)
Sprawdź, czy dana funkcja jest dostępna na urządzeniu.
Parametry |
---|
feature | String : jaki format powinien mieć „cechę: " Lub " „bezpośrednio. |
Zwroty |
---|
boolean | Prawda, jeśli zostanie znaleziona funkcja, w przeciwnym razie fałsz. |
zainstaluj pakiet
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Zainstaluj pakiet Android 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 powłoki pm -h”, aby zapoznać się z dostępnymi opcjami. |
Zwroty |
---|
String | String z kodem błędu lub null , jeśli się powiedzie. |
zainstaluj pakiet
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Zainstaluj pakiet Android na urządzeniu.
Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznaniem uprawnień wykonawczych w czasie instalacji.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : jeśli wszystkie uprawnienia wykonawcze powinny zostać przyznane podczas instalacji |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami. |
Zwroty |
---|
String | String z kodem błędu lub null , jeśli się powiedzie. |
zainstaluj pakiet
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Zainstaluj pakiet Android na urządzeniu.
Uwaga: Tę funkcję należy wywoływać tylko w przypadkach użycia, które wymagają wyraźnej kontroli nad przyznaniem uprawnień wykonawczych w czasie instalacji.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
certFile | File : true , jeśli należy przeprowadzić ponowną instalację |
reinstall | boolean : jeśli wszystkie uprawnienia wykonawcze powinny zostać przyznane podczas instalacji |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami. |
Zwroty |
---|
String | String z kodem błędu lub null , jeśli się powiedzie. |
zainstalujPakietDlaUż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ą wyraźnej kontroli nad przyznaniem uprawnień wykonawczych w czasie instalacji.
Parametry |
---|
packageFile | File : plik apk do zainstalowania |
reinstall | boolean : true , jeśli należy przeprowadzić ponowną instalację |
grantPermissions | boolean : jeśli wszystkie uprawnienia wykonawcze powinny zostać przyznane podczas instalacji |
userId | int : całkowity identyfikator użytkownika, dla którego chcesz dokonać instalacji. |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami. |
Zwroty |
---|
String | String z kodem błędu lub null , jeśli się powiedzie. |
zainstalujPakietDlaUż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 chcesz dokonać instalacji. |
extraArgs | String : opcjonalne dodatkowe argumenty do przekazania. Zobacz „adb powłoki pm -h”, aby zapoznać się z dostępnymi opcjami. |
Zwroty |
---|
String | 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 |
zainstalujPakietyDla Użytkownika
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Parametry |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
zainstalujPakietyDla Użytkownika
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Parametry |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
zainstaluj pakiety zdalne
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Parametry |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
zainstaluj pakiety zdalne
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parametry |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje wyliczanie aplikacji
Zwroty |
---|
boolean | True, jeśli obsługiwane jest wyliczanie aplikacji, false w przeciwnym razie |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Zwraca informację, czy urządzenie korzysta z trybu użytkownika systemu bezgłowego.
isMainUserStały administrator
public boolean isMainUserPermanentAdmin ()
Zwraca informację, czy główny użytkownik jest stałym administratorem i nie można go usunąć ani zmienić na inny niż administrator.
isMultiUserSupported
public boolean isMultiUserSupported ()
Określa, czy obsługiwanych jest wielu użytkowników.
Zwroty |
---|
boolean | true, jeśli obsługiwanych jest wielu użytkowników, false w przeciwnym razie |
jestZainstalowany pakiet
public boolean isPackageInstalled (String packageName)
Zapytaj urządzenie o podaną 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. Inaczej nieprawda. |
jestZainstalowany pakiet
public boolean isPackageInstalled (String packageName,
String userId)
Zapytaj urządzenie o podaną 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. Jeśli ma wartość null, użyte zostanie zero użytkownika głównego. |
Zwroty |
---|
boolean | Prawda, jeśli pakiet jest zgłaszany jako zainstalowany. Inaczej nieprawda. |
isUserRunning
public boolean isUserRunning (int userId)
Sprawdź, czy dany użytkownik jest uruchomiony.
Zwroty |
---|
boolean | Prawda, jeśli użytkownik jest uruchomiony, fałsz w każdym innym przypadku. |
jestUserSecondary
public boolean isUserSecondary (int userId)
Zwraca informację, czy określony użytkownik jest użytkownikiem dodatkowym zgodnie z jego flagami.
Zwroty |
---|
boolean | true, jeśli użytkownik jest drugorzędny, false w przeciwnym razie. |
jestUżytkownikWidoczny
public boolean isUserVisible (int userId)
Sprawdza czy dany użytkownik jest widoczny.
„Widoczny” użytkownik to użytkownik, który wchodzi w interakcję z „człowiekiem” i w związku z tym może uruchamiać działania (zwykle na ekranie domyślnym).
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 „człowiekiem” i w związku z tym może uruchamiać działania na tym ekranie.
Parametry |
---|
userId | int |
displayId | int |
listaDisplayIds
public listDisplayIds ()
Zbierz listę dostępnych identyfikatorów wyświetlaczy na urządzeniu zgodnie z raportem „dumpsys SurfaceFlinger”.
Zwroty |
---|
| Lista wyświetlaczy. Domyślne zawsze zwraca domyślny wyświetlacz 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 DeviceRuntimeException
, jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.
Zwroty |
---|
| lista identyfikatorów użytkowników. |
logBłędny raport
public boolean logBugreport (String dataName,
ITestLogger listener)
Metoda pomocnicza umożliwiająca przyjęcie raportu o błędzie i zalogowanie 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 powiodło się, w przeciwnym razie fałsz. |
postInwokacjaTearDown
public void postInvocationTearDown (Throwable exception)
Dodatkowe kroki dotyczące wymaganego czyszczenia specyficznego dla 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ńAdministratora
public boolean removeAdmin (String componentName,
int userId)
Usuń danego administratora urządzenia dla danego użytkownika i zwróć wartość true
, jeśli się powiedzie, false
w przeciwnym razie.
Parametry |
---|
componentName | String : administratora urządzenia, który ma zostać usunięty. |
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ścicieli
public void removeOwners ()
Usuń wszystkich istniejących właścicieli profili urządzeń, dokładając wszelkich starań.
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, false w przeciwnym razie. |
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 : administrator urządzenia 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. |
ustawUstawienie
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 |
ustawUstawienie
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 |
zamknięcieMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Wyłącza urządzenie microdroid, jeśli takie istnieje.
Parametry |
---|
microdroidDevice | ITestDevice |
uruchom użytkownika
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 jest NOOP.
Parametry |
---|
userId | int : użytkownika, aby rozpocząć w tle |
Zwroty |
---|
boolean | true, jeśli użytkownik został pomyślnie uruchomiony w tle. |
uruchom użytkownika
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 jest NOOP. Możliwość zapewnienia dodatkowej flagi oczekującej na efekt operacji.
Parametry |
---|
userId | int : użytkownika, aby rozpocząć w tle |
waitFlag | boolean : sprawi, ż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. |
startVisibleBackgroundUżytkownik
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Uruchamia danego użytkownika w tle, widocznym na danym ekranie (tzn. umożliwiając użytkownikowi uruchomienie 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świetlacz, na którym użytkownik będzie widoczny |
waitFlag | boolean : sprawi, ż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. |
zatrzymajUżytkownika
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Zatrzymaj danego użytkownika. Możliwość dostarczenia dodatkowych flag oczekujących na efekt operacji i wymuszenia zakończenia działania użytkownika. Nie można zatrzymać bieżącego użytkownika i użytkownika systemowego.
Parametry |
---|
userId | int : użytkownika, aby zatrzymać. |
waitFlag | boolean : sprawi, ż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. |
zatrzymajUżytkownika
public boolean stopUser (int userId)
Zatrzymuje danego użytkownika. Jeśli użytkownik został już zatrzymany, ta metoda jest NOOP. Nie można zatrzymać bieżącego użytkownika i użytkownika systemowego.
Parametry |
---|
userId | int : użytkownika, aby zatrzymać. |
Zwroty |
---|
boolean | true, jeśli użytkownik został pomyślnie zatrzymany. |
obsługujeMicroroid
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. |
obsługujeMicroroid
public boolean supportsMicrodroid (boolean protectedVm)
Sprawdza warunki wstępne uruchomienia mikrodroida.
Parametry |
---|
protectedVm | boolean : true, jeśli microdroid ma działać na chronionej maszynie wirtualnej. |
Zwroty |
---|
boolean | zwraca wartość true, jeśli warunki wstępne są spełnione, w przeciwnym razie zwraca wartość false. |
Zmień użytkownika
public boolean switchUser (int userId)
Przełącz na inny identyfikator użytkownika z domyślnym limitem czasu. switchUser(int, long)
.
Zwroty |
---|
boolean | Wartość true, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. Inaczej nieprawda. |
Zmień użytkownika
public boolean switchUser (int userId,
long timeout)
Przełącz na inny identyfikator użytkownika z podanym limitem czasu jako ostatecznym terminem. Próba wyłączenia blokady klawiatury po pomyślnej zmianie użytkownika.
Parametry |
---|
userId | int |
timeout | long : czekać przed zwróceniem wartości false w przypadku niepowodzenia przełączania użytkownika. |
Zwroty |
---|
boolean | Wartość true, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. Inaczej nieprawda. |
weź raport Bugre
public Bugreport takeBugreport ()
Weź raport o błędzie i zwróć go do obiektu Bugreport
, aby go obsłużyć. W przypadku problemu zwróć wartość null. Plik, do którego odwołuje się obiekt Bugreport, należy wyczyścić 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 | String z kodem błędu lub null , jeśli się powiedzie. |
odinstalujPakietForUser
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 : całkowity identyfikator użytkownika, dla którego chcesz odinstalować. |
Zwroty |
---|
String | String z kodem błędu lub null , jeśli się powiedzie. |
Metody chronione
utwórzParsera
protected AaptParser createParser (File appFile)
wykonaj AdbReboot
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 ()
Metoda wewnętrznego pomocnika, aby uzyskać plik zip raportu o błędach jako ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Wystawiony do testów.
pobierz HostCurrentTime
protected long getHostCurrentTime ()
Wystawiony do testów
konfiguracja przedPostBoot
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-12-01 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Brak potrzebnych mi informacji"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Zbyt skomplikowane / zbyt wiele czynności do wykonania"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Nieaktualne treści"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problem z tłumaczeniem"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problem z przykładami/kodem"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Inne"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Łatwo zrozumieć"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Rozwiązało to mój problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Inne"
}]