Urządzenie testowe

public class TestDevice
extends NativeDevice

java.lang.Object
com.android.tradefed.device.NativeDevice
com.android.tradefed.device.TestDevice


Wdrożenie ITestDevice dla pełnowymiarowego urządzenia z systemem Android

Streszczenie

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 zwolnienia blokady klawiatury.

Konstruktorzy publiczni

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Metody publiczne

boolean clearErrorDialogs ()

Spróbuj odrzucić wszystkie okna dialogowe błędów aktualnie wyświetlane 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)

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 pomocnicza do określenia, czy plik na urządzeniu istnieje.

boolean doesFileExist (String deviceFilePath, int userId)

Metoda pomocnicza określająca, 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 APEX-ach aktywowanych na urządzeniu.

getAllSettings (String namespace)

Zwróć pary klucz-wartość żądanej przestrzeni nazw.

String getAndroidId (int userId)

Znajdź i zwróć identyfikator Androida skojarzony z identyfikatorem użytkownika, null, jeśli nie zostanie znaleziony.

getAndroidIds ()

Utwórz mapę identyfikatorów Androida, które pasują 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.

DeviceFoldableState getCurrentFoldableState ()

Zwraca bieżący stan składania urządzenia lub null, jeśli wystąpiły jakieś problemy.

int getCurrentUser ()

Zwróć identyfikator aktualnie działającego 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.

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.

String getMicrodroidCID ()
Integer getPrimaryUserId ()

Zwraca identyfikator głównego użytkownika.

InputStreamSource getScreenshot ()

Pobiera zrzut ekranu z urządzenia.

InputStreamSource getScreenshot (String format, boolean rescale)

Pobiera zrzut ekranu z urządzenia.

InputStreamSource getScreenshot (String format)

Pobiera zrzut ekranu z urządzenia.

InputStreamSource getScreenshot (long displayId)

Pobiera zrzut ekranu z urządzenia o podanym identyfikatorze wyświetlacza.

String getSetting (String namespace, String key)

Zobacz getSetting(int, String, String) i wykonywane na użytkowniku systemu.

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 skojarzony z identyfikatorem użytkownika, jeśli zostanie 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, 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, 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, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

boolean isAppEnumerationSupported ()

Sprawdź, czy platforma na urządzeniu obsługuje wyliczanie aplikacji

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 aktualnie zainstalowane, czy nie.

boolean isPackageInstalled (String packageName, String userId)

Zapytaj urządzenie o podaną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest aktualnie zainstalowane dla tego użytkownika.

boolean isUserRunning (int userId)

Sprawdź, czy dany użytkownik jest uruchomiony.

boolean isUserSecondary (int userId)

Zwróć, czy określony użytkownik jest użytkownikiem pomocniczym zgodnie z jego flagami.

listDisplayIds ()

Zbierz listę dostępnych wyświetlaczy id na urządzeniu zgłoszoną przez "dumpsys SurfaceFlinger".

listUsers ()

Pobiera listę użytkowników na urządzeniu.

void postInvocationTearDown (Throwable exception)

Dodatkowe kroki dla określonego urządzenia wymaganego czyszczenia, które zostaną wykonane po zakończeniu wywołania.

boolean removeAdmin (String componentName, int userId)

Usuń administratora danego urządzenia w danym użytkowniku i zwróć true , jeśli się powiedzie, false w przeciwnym razie.

void removeOwners ()

Jak najlepiej usuń wszystkich dotychczasowych 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 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 aktualnie zatrzymany.

boolean startUser (int userId, boolean waitFlag)

Uruchamia danego użytkownika w tle, jeśli jest aktualnie zatrzymany.

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 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.

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.

Metody chronione

AaptParser createParser (File appFile)
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

Wykonaj ponowne uruchomienie adb.

long getCheckNewUserSleep ()

Wystawiony do testów.

long getHostCurrentTime ()

Wystawiony do testów

void prePostBootSetup ()

Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po uruchomieniu.

Pola

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Polecenia, których można użyć do zwolnienia blokady klawiatury.

Konstruktorzy publiczni

Urządzenie testowe

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Metody publiczne

wyczyśćErrorDialogs

public boolean clearErrorDialogs ()

Spróbuj odrzucić wszystkie okna dialogowe błędów aktualnie wyświetlane w interfejsie użytkownika urządzenia.

Zwroty
boolean true , jeśli nie było żadnych okien dialogowych lub okna dialogowe zostały pomyślnie wyczyszczone. false inaczej.

Rzuty
DeviceNotAvailableException

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

Rzuty
DeviceNotAvailableException

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 --gość podczas tworzenia

ephemeral boolean : włącz flagę użytkownika --ephemeral podczas tworzenia

Zwroty
int id utworzonego użytkownika

Rzuty
DeviceNotAvailableException

utwórzUżytkownikaNieRzucaj

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 dla błędu.

Rzuty
DeviceNotAvailableException

wyłącz ochronę klawiatury

public void disableKeyguard ()

Próby wyłączenia blokady klawiatury.

Najpierw poczekaj na gotowość wysyłania danych wejściowych, dzieje się to mniej więcej w tym samym czasie, gdy urządzenie zgłasza BOOT_COMPLETE, najwyraźniej asynchronicznie, ponieważ w obecnej implementacji frameworka zdarzają się sporadyczne sytuacje wyścigu. Następnie wysyłane jest polecenie wyłączenia blokady klawiatury (działa tylko na niezabezpieczonych)

Rzuty
DeviceNotAvailableException

czyFileExist

public boolean doesFileExist (String deviceFilePath)

Metoda pomocnicza do określenia, 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, w przeciwnym razie false .

Rzuty
DeviceNotAvailableException

czyFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Metoda pomocnicza określająca, czy plik na urządzeniu istnieje dla danego użytkownika.

Parametry
deviceFilePath String : bezwzględna ścieżka pliku na urządzeniu do sprawdzenia

userId int : identyfikator użytkownika, według którego należy sprawdzić istnienie pliku

Zwroty
boolean true , jeśli plik istnieje, w przeciwnym razie false .

Rzuty
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Spróbuj zrzucić stertę z serwera system_server. Obowiązkiem dzwoniącego jest oczyszczenie zrzuconego pliku.

Parametry
process String : nazwa procesu urządzenia do zrzutu.

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.

Rzuty
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Pobierz informacje o APEX-ach aktywowanych na urządzeniu.

Zwroty
ERROR(/Set) ApexInfo aktualnie aktywowany na urządzeniu

Rzuty
DeviceNotAvailableException

pobierz wszystkie ustawienia

public  getAllSettings (String namespace)

Zwróć pary klucz-wartość żądanej przestrzeni nazw.

Parametry
namespace String : musi być jednym z {"system", "secure", "global"}

Zwroty
mapa par klucz-wartość. Null, jeśli przestrzeń nazw nie jest obsługiwana.

Rzuty
DeviceNotAvailableException

pobierz identyfikator Androida

public String getAndroidId (int userId)

Znajdź i zwróć identyfikator Androida skojarzony z identyfikatorem użytkownika, null, jeśli nie zostanie znaleziony.

Parametry
userId int

Zwroty
String

Rzuty
DeviceNotAvailableException

pobierz identyfikatory Androida

public  getAndroidIds ()

Utwórz mapę identyfikatorów Androida, które pasują 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.

Rzuty
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Pobierz informacje o pakiecie zainstalowanym na urządzeniu.

Parametry
packageName String

Zwroty
PackageInfo PackageInfo lub null , jeśli nie można pobrać informacji

Rzuty
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Pobierz informacje o pakietach zainstalowanych na urządzeniu.

Zwroty
ERROR(/List) PackageInfo s zainstalowanych na urządzeniu.

Rzuty
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Zwraca bieżący stan składania urządzenia lub null, jeśli wystąpiły jakieś problemy.

Zwroty
DeviceFoldableState

Rzuty
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Zwróć identyfikator aktualnie działającego użytkownika. W przypadku błędu zwróć -10000.

Zwroty
int

Rzuty
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Zwraca listę składanych stanów na urządzeniu. Można uzyskać za pomocą "cmd device_state print-states".

Zwroty

Rzuty
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

Pobierz nazwy pakietów aplikacji obecne na urządzeniu.

Zwroty
ERROR(/Set) nazw pakietów String aktualnie zainstalowanych na urządzeniu.

Rzuty
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Zwróć obiekt, aby uzyskać bieżący stan blokady klawiatury lub null, jeśli nie jest obsługiwany.

Zwroty
KeyguardControllerState KeyguardControllerState zawierający migawkę stanu ochrony klawiatury i zwraca wartość Null, jeśli zapytanie Keyguard nie jest obsługiwane.

Rzuty
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Uzyskaj informacje o głównych modułach zainstalowanych na urządzeniu.

Zwroty
ERROR(/Set) modułów String mainline aktualnie zainstalowanych na urządzeniu.

Rzuty
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

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 działających użytkowników

Rzuty
DeviceNotAvailableException

pobierzMaksymalnąLiczbęObsługiwanychUż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

Rzuty
DeviceNotAvailableException

pobierzMicrodroidCID

public String getMicrodroidCID ()

Zwroty
String Zwraca CID maszyny wirtualnej microdroid. Jeśli TestDevice nie jest microdroidem, zwróć wartość null.

getPrimaryUserId

public Integer getPrimaryUserId ()

Zwraca identyfikator głównego użytkownika.

Zwroty
Integer identyfikator użytkownika głównego użytkownika, jeśli istnieje, i null, jeśli nie ma głównego użytkownika.

Rzuty
DeviceNotAvailableException

pobierz zrzut ekranu

public InputStreamSource getScreenshot ()

Pobiera zrzut ekranu z urządzenia.

Zwroty
InputStreamSource InputStreamSource zrzutu ekranu w formacie png lub null , jeśli zrzut ekranu się nie powiódł.

Rzuty
DeviceNotAvailableException

pobierz zrzut ekranu

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Pobiera zrzut ekranu z urządzenia. Zalecane jest użycie getScreenshot(String) zamiast kodowania JPEG dla mniejszych rozmiarów.

Parametry
format String : obsługiwane PNG, JPEG

rescale boolean : czy zrzut ekranu powinien być przeskalowany, aby zmniejszyć rozmiar wynikowego obrazu

Zwroty
InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null , jeśli zrzut ekranu się nie powiódł.

Rzuty
DeviceNotAvailableException

pobierz zrzut ekranu

public InputStreamSource getScreenshot (String format)

Pobiera zrzut ekranu z urządzenia. Zalecane jest użycie getScreenshot(format) zamiast kodowania JPEG dla mniejszych rozmiarów

Parametry
format String : obsługiwane PNG, JPEG

Zwroty
InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null , jeśli zrzut ekranu się nie powiódł.

Rzuty
DeviceNotAvailableException

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 o obsługę „formatu” i „przeskalowania”

Parametry
displayId long : identyfikator ekranu, z którego ma zostać pobrany zrzut ekranu.

Zwroty
InputStreamSource InputStreamSource zrzutu ekranu w formacie lub null , jeśli zrzut ekranu się nie powiódł.

Rzuty
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

Zobacz getSetting(int, String, String) i wykonywane na użytkowniku systemu.

Parametry
namespace String

key String

Zwroty
String

Rzuty
DeviceNotAvailableException

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

Zwróć wartość żądanego ustawienia. przestrzeń nazw musi być jedną z następujących: {"system", "bezpieczna", "globalna"}

Parametry
userId int

namespace String

key String

Zwroty
String wartość powiązana z namespace:key użytkownika. Null, jeśli nie znaleziono.

Rzuty
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Pobierz nazwy pakietów aplikacji, które można odinstalować. Jest to obecnie definiowane jako pakiety niesystemowe i zaktualizowane pakiety systemowe.

Zwroty
ERROR(/Set) nazw pakietów String do odinstalowania aktualnie zainstalowanych na urządzeniu.

Rzuty
DeviceNotAvailableException

zdobądź 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 Android Open Source Project.

Parametry
userId int

Zwroty
int flagi związane z podanym identyfikatorem użytkownika, jeśli zostaną znalezione, -10000 w innych przypadkach.

Rzuty
DeviceNotAvailableException

pobierzInformacjeUżytkownika

public  getUserInfos ()

Pobiera mapę useId do UserInfo na urządzeniu. DeviceRuntimeException , jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.

Zwroty
lista obiektów UserInfo.

Rzuty
DeviceNotAvailableException

pobierz numer seryjny użytkownika

public int getUserSerialNumber (int userId)

Zwróć numer seryjny skojarzony z identyfikatorem użytkownika, jeśli zostanie znaleziony, -10000 w innych przypadkach.

Parametry
userId int

Zwroty
int

Rzuty
DeviceNotAvailableException

ma funkcję

public boolean hasFeature (String feature)

Sprawdź, czy funkcja jest dostępna na urządzeniu.

Parametry
feature String : jaki format powinien mieć „cecha: " lub " " bezpośrednio.

Zwroty
boolean Prawda, jeśli funkcja zostanie znaleziona, w przeciwnym razie fałsz.

Rzuty
DeviceNotAvailableException

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', aby poznać dostępne opcje.

Zwroty
String String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

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, w których wymagana jest wyraźna kontrola nad przyznawaniem uprawnień w czasie wykonywania w czasie instalacji.

Parametry
packageFile File : plik apk do zainstalowania

certFile File : true , jeśli należy przeprowadzić ponowną instalację

reinstall boolean : czy wszystkie uprawnienia wykonawcze powinny być przyznane w czasie instalacji

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje.

Zwroty
String String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

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, w których wymagana jest wyraźna kontrola nad przyznawaniem uprawnień w czasie wykonywania w czasie instalacji.

Parametry
packageFile File : plik apk do zainstalowania

reinstall boolean : true , jeśli należy przeprowadzić ponowną instalację

grantPermissions boolean : czy wszystkie uprawnienia wykonawcze powinny być przyznane w czasie instalacji

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje.

Zwroty
String String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

installPackageForUser

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, w których wymagana jest wyraźna kontrola nad przyznawaniem uprawnień w czasie wykonywania w czasie instalacji.

Parametry
packageFile File : plik apk do zainstalowania

reinstall boolean : true , jeśli należy przeprowadzić ponowną instalację

grantPermissions boolean : czy wszystkie uprawnienia wykonawcze powinny być przyznane w czasie instalacji

userId int : całkowity identyfikator użytkownika do zainstalowania.

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje.

Zwroty
String String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

installPackageForUser

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 do zainstalowania.

extraArgs String : opcjonalne dodatkowe argumenty do przekazania. Zobacz 'adb shell pm -h', aby poznać dostępne opcje.

Zwroty
String String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Parametry
packageFiles

reinstall boolean

extraArgs String

Zwroty
String

Rzuty
DeviceNotAvailableException

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Parametry
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

Zwroty
String

Rzuty
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Parametry
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

Zwroty
String

Rzuty
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Parametry
packageFiles

reinstall boolean

userId int

extraArgs String

Zwroty
String

Rzuty
DeviceNotAvailableException

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Parametry
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

Zwroty
String

Rzuty
DeviceNotAvailableException

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Parametry
remoteApkPaths

reinstall boolean

extraArgs String

Zwroty
String

Rzuty
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Sprawdź, czy platforma na urządzeniu obsługuje wyliczanie aplikacji

Zwroty
boolean Prawda, jeśli wyliczanie aplikacji jest obsługiwane, w przeciwnym razie fałsz

Rzuty
DeviceNotAvailableException

jest obsługiwana przez wielu użytkowników

public boolean isMultiUserSupported ()

Określa, czy obsługiwanych jest wielu użytkowników.

Zwroty
boolean prawda, jeśli obsługiwanych jest wielu użytkowników, w przeciwnym razie fałsz

Rzuty
DeviceNotAvailableException

czy pakiet jest zainstalowany

public boolean isPackageInstalled (String packageName)

Zapytaj urządzenie o podaną nazwę pakietu, aby sprawdzić, czy jest aktualnie zainstalowane, czy nie.

Parametry
packageName String

Zwroty
boolean Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie fałsz.

Rzuty
DeviceNotAvailableException

czy pakiet jest zainstalowany

public boolean isPackageInstalled (String packageName, 
                String userId)

Zapytaj urządzenie o podaną nazwę pakietu i podany identyfikator użytkownika, aby sprawdzić, czy jest 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, zostanie użyte zero użytkownika podstawowego.

Zwroty
boolean Prawda, jeśli pakiet jest zgłoszony jako zainstalowany. W przeciwnym razie fałsz.

Rzuty
DeviceNotAvailableException

jestUżytkownikUruchomiony

public boolean isUserRunning (int userId)

Sprawdź, czy dany użytkownik jest uruchomiony.

Parametry
userId int

Zwroty
boolean Prawda, jeśli użytkownik jest uruchomiony, we wszystkich pozostałych przypadkach fałsz.

Rzuty
DeviceNotAvailableException

jest drugorzędny użytkownik

public boolean isUserSecondary (int userId)

Zwróć, czy określony użytkownik jest użytkownikiem pomocniczym zgodnie z jego flagami.

Parametry
userId int

Zwroty
boolean prawda, jeśli użytkownik jest drugorzędny, w przeciwnym razie fałsz.

Rzuty
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

Zbierz listę dostępnych wyświetlaczy id na urządzeniu zgłoszoną przez "dumpsys SurfaceFlinger".

Zwroty
Lista wyświetlaczy. Domyślnie zawsze zwraca domyślny wyświetlacz 0.

Rzuty
DeviceNotAvailableException

listaUżytkownicy

public  listUsers ()

Pobiera listę użytkowników na urządzeniu. DeviceRuntimeException , jeśli dane wyjściowe z urządzenia nie są zgodne z oczekiwaniami.

Zwroty
lista identyfikatorów użytkowników.

Rzuty
DeviceNotAvailableException

postInwokacjaTearDown

public void postInvocationTearDown (Throwable exception)

Dodatkowe kroki dla określonego urządzenia wymaganego czyszczenia, 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ń administratora danego urządzenia w danym użytkowniku i zwróć true , jeśli się powiedzie, false w przeciwnym razie.

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, w przeciwnym razie fałsz.

Rzuty
DeviceNotAvailableException

usuńWłaściciele

public void removeOwners ()

Jak najlepiej usuń wszystkich dotychczasowych właścicieli profili urządzeń.

Rzuty
DeviceNotAvailableException

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 udało nam się usunąć użytkownika, w przeciwnym razie false.

Rzuty
DeviceNotAvailableException

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, 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, w przeciwnym razie fałsz.

Rzuty
DeviceNotAvailableException

ustawUstawienie

public void setSetting (String namespace, 
                String key, 
                String value)

Zobacz setSetting(int, String, String, String) i wykonywane na użytkowniku systemu.

Parametry
namespace String

key String

value String

Rzuty
DeviceNotAvailableException

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 następujących: {"system", "bezpieczna", "globalna"}

Parametry
userId int

namespace String

key String

value String

Rzuty
DeviceNotAvailableException

zamknijMikroroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Wyłącza urządzenie microdroid, jeśli takie istnieje.

Parametry
microdroidDevice ITestDevice

Rzuty
DeviceNotAvailableException

startUser

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 uruchomić w tle

Zwroty
boolean true , jeśli użytkownik został pomyślnie uruchomiony w tle.

Rzuty
DeviceNotAvailableException

startUser

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żliwe jest podanie dodatkowej flagi, aby poczekać na efekt operacji.

Parametry
userId int : użytkownika, aby uruchomić w tle

waitFlag boolean : sprawi, że polecenie zaczeka, aż użytkownik zostanie uruchomiony i odblokowany.

Zwroty
boolean true , jeśli użytkownik został pomyślnie uruchomiony w tle.

Rzuty
DeviceNotAvailableException

stopUżytkownik

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Zatrzymaj danego użytkownika. Możliwe jest zapewnienie dodatkowych flag, aby czekać na efekt operacji i wymusić zakończenie działania użytkownika. Nie można zatrzymać bieżącego i systemowego użytkownika.

Parametry
userId int : użytkownika do zatrzymania.

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.

Rzuty
DeviceNotAvailableException

stopUżytkownik

public boolean stopUser (int userId)

Zatrzymuje danego użytkownika. Jeśli użytkownik jest już zatrzymany, ta metoda to 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.

Rzuty
DeviceNotAvailableException

obsługujeMikroroid

public boolean supportsMicrodroid ()

Sprawdza warunki wstępne uruchomienia mikrodroida.

Zwroty
boolean zwraca prawdę, jeśli warunki wstępne są spełnione, w przeciwnym razie fałsz.

obsługujeMikroroid

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 prawdę, jeśli warunki wstępne są spełnione, w przeciwnym razie fałsz.

Zmień użytkownika

public boolean switchUser (int userId)

Przełącz się na inny identyfikator użytkownika z domyślnym limitem czasu. switchUser(int, long) .

Parametry
userId int

Zwroty
boolean Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie fałsz.

Rzuty
DeviceNotAvailableException

Zmień użytkownika

public boolean switchUser (int userId, 
                long timeout)

Przełącz się na inny identyfikator użytkownika z podanym limitem czasu jako terminem. Spróbuj wyłączyć blokadę klawiatury po pomyślnej zmianie użytkownika.

Parametry
userId int

timeout long : czekanie przed zwróceniem wartości false dla przełącznika-użytkownika nie powiodło się.

Zwroty
boolean Prawda, jeśli nowy identyfikator użytkownika jest zgodny z dostawcą identyfikatora użytkownika. W przeciwnym razie fałsz.

Rzuty
DeviceNotAvailableException

odinstalujPakiet

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 w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

odinstalujPakietDlaUż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 : całkowity identyfikator użytkownika do odinstalowania.

Zwroty
String String z kodem błędu lub null w przypadku powodzenia.

Rzuty
DeviceNotAvailableException

Metody chronione

utwórzPparser

protected AaptParser createParser (File appFile)

Parametry
appFile File

Zwroty
AaptParser

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 restartu.

Rzuty
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Wystawiony do testów.

Zwroty
long

pobierzHostCurrentTime

protected long getHostCurrentTime ()

Wystawiony do testów

Zwroty
long

prePostBootSetup

protected void prePostBootSetup ()

Umożliwia każdemu typowi urządzenia (AndroidNativeDevice, TestDevice) zastąpienie tej metody w przypadku określonej konfiguracji po uruchomieniu.

Rzuty
DeviceNotAvailableException