Wdrożenie ITestDevice dla pełnowymiarowego urządzenia z systemem Android
Zapewnia niezawodne i nieco wyższy poziom interfejsu API do IDevice IDevice .
Ponawia próbę wykonania poleceń urządzenia dla konfigurowalnej ilości i udostępnia interfejs odzyskiwania urządzenia dla urządzeń, które nie odpowiadają.
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem.
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem.
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem.
jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać.
wyczyśćOstatniePołączoneSiećWifi
public abstract void clearLastConnectedWifiNetwork ()
Czyści ostatnią podłączoną sieć Wi-Fi. Powinno to zostać wywołane podczas rozpoczynania nowego wywołania, aby uniknąć łączenia się z siecią Wi-Fi używaną w poprzednim teście po ponownym uruchomieniu urządzenia.
Połącz z siecią Wifi
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do momentu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .
Parametry
wifiSsidToPsk
: Mapa identyfikatorów SSID Wi-Fi na hasła.
scanSsid
boolean : czy skanować w poszukiwaniu ukrytych identyfikatorów SSID dla tej sieci.
Zwroty
boolean
true , jeśli pomyślnie połączono z siecią Wi-Fi. false inaczej
jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać.
Połącz z siecią Wifi
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Łączy się z siecią Wi-Fi.
Włącza Wi-Fi i blokuje do momentu nawiązania połączenia z jedną z sieci Wi-Fi podanych na mapie wifiSsidToPsk. Po nawiązaniu połączenia instancja będzie próbowała przywrócić połączenie po każdym ponownym uruchomieniu, dopóki nie zostanie ITestDevice#disconnectFromWifi() lub ITestDevice#clearLastConnectedWifiNetwork() .
Parametry
wifiSsidToPsk
: Mapa identyfikatorów SSID Wi-Fi na hasła.
Zwroty
boolean
true , jeśli pomyślnie połączono z siecią Wi-Fi. false inaczej
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)
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.
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.
jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać.
UnsupportedOperationException
jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu.
installPackageForUser
public abstract 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.
jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać.
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu). Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Parametry
packageFiles
: lokalne pliki apk
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.
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
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
packageFiles
: zdalne ścieżki plików 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.
jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać.
UnsupportedOperationException
jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu.
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu) dla danego użytkownika. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
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
packageFiles
: lokalne pliki apk
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.
jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać.
UnsupportedOperationException
jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu.
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Zainstaluj aplikację na Androida złożoną z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu) dla danego użytkownika. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Parametry
packageFiles
: lokalne pliki apk
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.
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
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
remoteApkPaths
: zdalne ścieżki plików apk
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.
jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać.
UnsupportedOperationException
jeśli uprawnienia wykonawcze nie są obsługiwane przez platformę na urządzeniu.
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Zainstaluj aplikację na Androida składającą się z kilku plików APK (jednego głównego i dodatkowego podzielonego pakietu), które znajdują się na urządzeniu z Androidem. Zobacz „https://developer.android.com/studio/build/configure-apk-splits”, jak podzielić apk na kilka plików.
Parametry
remoteApkPaths
: zdalne ścieżki plików apk
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.
public abstract 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.
Sprawdza, czy Wi-Fi jest włączone na urządzeniu. Przydatne do sprawdzania statusu Wi-Fi przed testami, które nie powinny być uruchamiane z Wi-Fi, np. testy danych mobilnych.
Zwroty
boolean
true , jeśli Wi-Fi jest włączone. false , jeśli wyłączone
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"}
public abstract 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.
public abstract 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.
public abstract 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.
jeśli połączenie z urządzeniem zostanie utracone i nie można go odzyskać.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.