INativeDevice
public
interface
INativeDevice
| com.android.tradefed.device.INativeDevice |
Zapewnia niezawodny interfejs API o nieco wyższym poziomie niż ddmlib IDevice.
Ponawia polecenia urządzenia przez konfigurowalny czas i udostępnia interfejs przywracania urządzenia w przypadku urządzeń, które nie odpowiadają.
Podsumowanie
Stałe | |
|---|---|
int |
UNKNOWN_API_LEVEL
Wartość domyślna, gdy nie można wykryć poziomu interfejsu API |
Metody publiczne | |
|---|---|
abstract
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym poziomie obsługi. |
abstract
void
|
clearLogcat()
Usuwa wszystkie zgromadzone dane logcat. |
abstract
void
|
deleteFile(String deviceFilePath)
Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu. |
abstract
void
|
deleteFile(String deviceFilePath, int userId)
Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu. |
abstract
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione przez porównanie bieżącego serwera systemowego z poprzednim serwerem systemowym |
abstract
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione od czasu UTC od początku epoki z urządzenia i jego |
abstract
boolean
|
disableAdbRoot()
Wyłącza uprawnienia roota ADB. |
abstract
boolean
|
doesFileExist(String deviceFilePath)
Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu. |
abstract
boolean
|
enableAdbRoot()
Włącza uprawnienia roota ADB. |
abstract
String
|
executeAdbCommand(long timeout, String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
abstract
String
|
executeAdbCommand(String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe. |
abstract
String
|
executeAdbCommand(long timeout,
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
abstract
CommandResult
|
executeAdbV2Command(long timeout,
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
abstract
CommandResult
|
executeAdbV2Command(String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe. |
abstract
CommandResult
|
executeAdbV2Command(long timeout, String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania. |
abstract
CommandResult
|
executeFastbootCommand(long timeout, String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe. |
abstract
CommandResult
|
executeFastbootCommand(String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty. |
abstract
CommandResult
|
executeLongFastbootCommand(String... commandArgs)
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe. |
abstract
CommandResult
|
executeLongFastbootCommand(
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe ze zmiennymi środowiskowymi systemu. |
abstract
String
|
executeShellCommand(String command)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Wykonuje podane polecenie powłoki adb, ponawiając je wielokrotnie, jeśli się nie powiedzie. |
abstract
CommandResult
|
executeShellV2Command(String command)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt |
abstract
CommandResult
|
executeShellV2Command(String command, OutputStream pipeToOutput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia. |
abstract
CommandResult
|
fastbootWipePartition(String partition)
Metoda pomocnicza, która czyści partycję urządzenia. |
abstract
int
|
getApiLevel()
Pobierz poziom interfejsu API urządzenia. |
abstract
String
|
getBasebandVersion()
Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. |
abstract
Integer
|
getBattery()
Zwraca bieżący poziom naładowania baterii urządzenia lub wartość null, jeśli poziom naładowania baterii jest niedostępny. |
abstract
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Zwraca wartość logiczną danej właściwości. |
abstract
|
getBootHistory()
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchamiania i przyczyną uruchomienia. |
abstract
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchamiania i przyczyną uruchamiania od podanego czasu od początku epoki na urządzeniu oraz określoną jednostką czasu. |
abstract
String
|
getBootloaderVersion()
Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia. |
abstract
String
|
getBuildAlias()
Pobierz alias kompilacji, na której obecnie działa urządzenie. |
abstract
String
|
getBuildFlavor()
Pobierz wersję kompilacji urządzenia. |
abstract
String
|
getBuildId()
Pobierz kompilację, na której obecnie działa urządzenie. |
abstract
String
|
getBuildSigningKeys()
Zwraca typ klucza użytego do podpisania obrazu urządzenia. Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń). |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor()
Zwraca buforowaną wartość |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Zwraca buforowaną wartość |
abstract
String[]
|
getChildren(String deviceFilePath)
Alternatywa dla używania |
abstract
AbstractConnection
|
getConnection()
Zwraca połączenie powiązane z urządzeniem. |
abstract
String
|
getDeviceClass()
Pobierz klasę urządzenia. |
abstract
long
|
getDeviceDate()
Zwraca datę urządzenia w milisekundach od początku epoki. |
abstract
DeviceDescriptor
|
getDeviceDescriptor()
Zwróć |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Zwróć |
abstract
TestDeviceState
|
getDeviceState()
Pobierz stan urządzenia. |
abstract
long
|
getDeviceTimeOffset(Date date)
Funkcja pomocnicza do uzyskiwania różnicy czasu między urządzeniem a podanym |
abstract
InputStreamSource
|
getEmulatorOutput()
Pobieranie strumienia stdout i stderr emulatora |
abstract
long
|
getExternalStoreFreeSpace()
Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia. |
abstract
String
|
getFastbootProductType()
Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot. |
abstract
String
|
getFastbootProductVariant()
Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot. |
abstract
String
|
getFastbootSerialNumber()
Zwraca numer seryjny trybu fastboot. |
abstract
String
|
getFastbootVariable(String variableName)
Pobierz z urządzenia wartość podanej zmiennej fastboot. |
abstract
IFileEntry
|
getFileEntry(String path)
Pobieranie odwołania do pliku zdalnego na urządzeniu. |
abstract
IDevice
|
getIDevice()
Zwraca odwołanie do powiązanej biblioteki ddmlib |
abstract
long
|
getIntProperty(String name, long defaultValue)
Zwraca wartość całkowitą danej właściwości z urządzenia. |
abstract
long
|
getLastExpectedRebootTimeMillis()
Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie, w milisekundach od EPOCH, zgodnie z wartością zwracaną przez |
abstract
int
|
getLaunchApiLevel()
Pobierz poziom API, na którym urządzenie zostało uruchomione po raz pierwszy. |
abstract
InputStreamSource
|
getLogcat()
Pobiera strumień zrzutu danych logcat. |
abstract
InputStreamSource
|
getLogcat(int maxBytes)
Pobiera strumień zrzutu ostatnich |
abstract
InputStreamSource
|
getLogcatDump()
Pobierz zrzut bieżącego dziennika logcat z urządzenia. |
abstract
InputStreamSource
|
getLogcatSince(long date)
Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty. |
abstract
String
|
getMountPoint(String mountName)
Zwraca punkt podłączenia. |
abstract
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Zwraca wartość |
abstract
|
getMountPointInfo()
Zwraca przeanalizowaną wersję informacji z pliku /proc/mounts na urządzeniu. |
abstract
long
|
getPartitionFreeSpace(String partition)
Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia. |
abstract
ProcessInfo
|
getProcessByName(String processName)
Metoda pomocnicza uruchamia polecenia „pidof” i „stat” i zwraca obiekt |
abstract
String
|
getProcessPid(String process)
Zwraca identyfikator procesu usługi lub wartość null, jeśli wystąpił błąd. |
abstract
String
|
getProductType()
Wygodna metoda uzyskiwania typu produktu tego urządzenia. |
abstract
String
|
getProductVariant()
Wygodna metoda pobierania wersji produktu tego urządzenia. |
abstract
String
|
getProperty(String name)
Pobierz z urządzenia wartość danej właściwości. |
abstract
ITestDevice.RecoveryMode
|
getRecoveryMode()
Pobierz bieżący tryb odzyskiwania używany na urządzeniu. |
abstract
String
|
getSerialNumber()
Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia. |
abstract
|
getTombstones()
Pobierz i zwróć listę znaczników usunięcia z urządzeń. |
abstract
long
|
getTotalMemory()
Zwraca łączny rozmiar pamięci fizycznej w bajtach lub –1 w przypadku błędu wewnętrznego. |
default
String
|
getTrackingSerial()
Na potrzeby zarządzania urządzeniem pobierz numer seryjny używany do śledzenia urządzenia. |
abstract
boolean
|
getUseFastbootErase()
Sprawdza, czy do wyczyszczenia partycji na urządzeniu należy użyć polecenia fastboot erase czy fastboot format. |
abstract
boolean
|
isAdbRoot()
|
abstract
boolean
|
isAdbTcp()
|
abstract
boolean
|
isAppEnumerationSupported()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczanie aplikacji |
abstract
boolean
|
isBypassLowTargetSdkBlockSupported()
Sprawdzanie, czy platforma na urządzeniu obsługuje omijanie blokady niskiego docelowego pakietu SDK podczas instalowania aplikacji |
abstract
boolean
|
isDebugfsMounted()
Sprawdź, czy debugfs jest zamontowany. |
abstract
boolean
|
isDeviceEncrypted()
Wyświetla informację o tym, czy urządzenie jest zaszyfrowane. |
abstract
boolean
|
isDirectory(String deviceFilePath)
Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość Fałsz. |
abstract
boolean
|
isEncryptionSupported()
Wyświetla informację o tym, czy urządzenie obsługuje szyfrowanie. |
abstract
boolean
|
isExecutable(String fullPath)
Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu prowadzi do pliku wykonywalnego, w przeciwnym razie zwraca wartość Fałsz. |
abstract
boolean
|
isHeadless()
Zwraca wartość „true”, jeśli urządzenie nie ma ekranu, w przeciwnym razie zwraca wartość „false”. |
abstract
boolean
|
isRuntimePermissionSupported()
Sprawdzanie, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania |
abstract
boolean
|
isStateBootloaderOrFastbootd()
Zwraca wartość „prawda”, jeśli urządzenie jest w stanie |
abstract
boolean
|
logAnrs(ITestLogger logger)
Zbiera i rejestruje błędy ANR z urządzenia. |
abstract
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Zapisz wiadomość w logcat urządzenia. |
abstract
void
|
mountDebugfs()
Podłącz debugfs. |
abstract
void
|
nonBlockingReboot()
Wydaje polecenie ponownego uruchomienia urządzenia i zwraca wynik po zakończeniu polecenia oraz gdy urządzenie nie jest już widoczne dla adb. |
abstract
void
|
postBootSetup()
Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu. |
default
void
|
postInvocationTearDown()
Ta metoda została wycofana.
Użyj w zamian zasady |
abstract
void
|
postInvocationTearDown(Throwable invocationException)
Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania. |
default
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe czynności wymagane do skonfigurowania urządzenia, które zostaną wykonane na urządzeniu przed wywołaniem przepływu. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir)
Rekursywne pobieranie zawartości katalogu z urządzenia. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Rekursywne pobieranie zawartości katalogu z urządzenia. |
abstract
File
|
pullFile(String remoteFilePath, int userId)
Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym |
abstract
File
|
pullFile(String remoteFilePath)
Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym |
abstract
boolean
|
pullFile(String remoteFilePath, File localFile)
Pobiera plik z urządzenia. |
abstract
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Pobiera plik z urządzenia. |
abstract
String
|
pullFileContents(String remoteFilePath)
Pobiera plik z urządzenia i zwraca jego zawartość. |
abstract
File
|
pullFileFromExternal(String remoteFilePath)
Wygodna metoda pobierania pliku z pamięci zewnętrznej urządzenia, zapisywania go w lokalnym pliku tymczasowym |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath, int userId)
Rekursywne przekazywanie zawartości katalogu na urządzenie. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath,
Rekursywne przesyłanie zawartości katalogu na urządzenie z wykluczeniem niektórych katalogów, które są filtrowane. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath)
Rekursywne przekazywanie zawartości katalogu na urządzenie. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Wariant |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath)
Przekazywanie pliku na urządzenie. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, int userId)
Przekaż plik na urządzenie. |
abstract
boolean
|
pushString(String contents, String deviceFilePath)
Przesyłanie na urządzenie pliku utworzonego z ciągu znaków |
abstract
void
|
reboot()
Uruchamia ponownie urządzenie w trybie adb. |
abstract
void
|
reboot(String reason)
Uruchamia ponownie urządzenie w trybie adb z podanym parametrem |
abstract
void
|
rebootIntoBootloader()
Uruchamia ponownie urządzenie w trybie programu rozruchowego. |
abstract
void
|
rebootIntoFastbootd()
Uruchamia ponownie urządzenie w trybie fastbootd. |
abstract
void
|
rebootIntoRecovery()
Uruchamia ponownie urządzenie w trybie odzyskiwania adb. |
abstract
void
|
rebootIntoSideload(boolean autoReboot)
Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania). Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku |
abstract
void
|
rebootIntoSideload()
Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania). Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku |
abstract
void
|
rebootUntilOnline()
Alternatywa dla |
abstract
void
|
rebootUntilOnline(String reason)
Alternatywa dla |
abstract
void
|
rebootUserspace()
Ponowne uruchomienie tylko części urządzenia w przestrzeni użytkownika. |
abstract
void
|
rebootUserspaceUntilOnline()
Alternatywa dla |
abstract
void
|
remountSystemReadOnly()
Ustaw partycję systemową na urządzeniu jako tylko do odczytu. |
abstract
void
|
remountSystemWritable()
Ustaw partycję systemową na urządzeniu jako zapisywalną. |
abstract
void
|
remountVendorReadOnly()
Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu. |
abstract
void
|
remountVendorWritable()
Ustaw partycję dostawcy na urządzeniu jako zapisywalną. |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Wygodna metoda wykonywania |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Uruchamia testy z instrumentacją i umożliwia przywracanie urządzeń. |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Tak samo jak |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Tak samo jak |
abstract
void
|
setDate(Date date)
Ustawia datę na urządzeniu Uwaga: ustawienie daty na urządzeniu wymaga dostępu do roota. |
abstract
void
|
setOptions(TestDeviceOptions options)
Ustaw |
abstract
boolean
|
setProperty(String propKey, String propValue)
Ustawia na urządzeniu podaną wartość właściwości. |
abstract
void
|
setRecovery(IDeviceRecovery recovery)
Ustaw numer |
abstract
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Ustaw bieżący tryb odzyskiwania, który ma być używany na urządzeniu. |
abstract
void
|
setTrackingSerial(String trackingSerial)
Do celów zarządzania urządzeniami śledź numer seryjny, którego używamy do odwoływania się do urządzenia. |
abstract
void
|
setUseFastbootErase(boolean useFastbootErase)
Określ, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format. |
abstract
void
|
startLogcat()
Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle. |
abstract
boolean
|
startTradeInModeTesting(int timeoutMs)
Włącz tryb testowania wymiany za dopłatą. |
abstract
void
|
stopEmulatorOutput()
Zamknij i usuń dane wyjściowe emulatora. |
abstract
void
|
stopLogcat()
Zatrzymuje rejestrowanie danych wyjściowych logcat z urządzenia i odrzuca aktualnie zapisane dane logcat. |
abstract
void
|
stopTradeInModeTesting()
Zakończ testowanie trybu wymiany za dopłatą. |
abstract
String
|
switchToAdbTcp()
Przełącz urządzenie w tryb adb-over-tcp. |
abstract
boolean
|
switchToAdbUsb()
Przełącz urządzenie w tryb adb over usb. |
abstract
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem. |
abstract
boolean
|
unlockDevice()
Odblokowuje urządzenie, jeśli jest ono zaszyfrowane. |
abstract
void
|
unmountDebugfs()
Odłącz debugfs. |
abstract
boolean
|
waitForBootComplete(long timeOut)
Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia. |
abstract
boolean
|
waitForDeviceAvailable()
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. |
abstract
boolean
|
waitForDeviceAvailable(long waitTime)
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. |
abstract
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne, bez uwzględniania ścieżki przywracania. |
abstract
void
|
waitForDeviceBootloader()
Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot. |
abstract
boolean
|
waitForDeviceInRecovery(long waitTime)
Blokuje możliwość przejścia urządzenia w stan „adb recovery” (uwaga: różni się od |
abstract
boolean
|
waitForDeviceInSideload(long waitTime)
Blokuje możliwość przejścia urządzenia w stan „adb sideload” |
abstract
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blokuje urządzenie, aby było niedostępne, tzn. nie było widoczne w adb. |
abstract
void
|
waitForDeviceOnline()
Blokuje, dopóki urządzenie nie będzie widoczne przez adb. |
abstract
void
|
waitForDeviceOnline(long waitTime)
Blokuje, dopóki urządzenie nie będzie widoczne przez adb. |
abstract
boolean
|
waitForDeviceShell(long waitTime)
Czeka, aż urządzenie odpowie na podstawowe polecenie powłoki adb. |
Stałe
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
Wartość domyślna, gdy nie można wykryć poziomu interfejsu API
Wartość stała: -1 (0xffffffff)
Metody publiczne
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym poziomie obsługi. Ta metoda uwzględnia jeszcze nieopublikowane funkcje, zanim zostanie podniesiony poziom interfejsu API.
| Parametry | |
|---|---|
strictMinLevel |
int: najniższy możliwy poziom, który obsługuje tę funkcję. |
| Zwroty | |
|---|---|
boolean |
Wartość „prawda”, jeśli poziom jest obsługiwany. W przeciwnym razie ma wartość Fałsz. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
clearLogcat
public abstract void clearLogcat ()
Usuwa wszystkie zgromadzone dane logcat.
Jest to przydatne w sytuacjach, gdy chcesz mieć pewność, że funkcja ITestDevice.getLogcat() zwraca tylko dane logowania wygenerowane po określonym momencie (np. po wgraniu nowej wersji urządzenia).
deleteFile
public abstract void deleteFile (String deviceFilePath)
Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.
| Parametry | |
|---|---|
deviceFilePath |
String: ścieżka bezwzględna pliku na urządzeniu. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
deleteFile
public abstract void deleteFile (String deviceFilePath,
int userId)Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.
| Parametry | |
|---|---|
deviceFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
userId |
int: identyfikator użytkownika, z którego chcesz usunąć dane. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
deviceSoftRestarted
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione przez porównanie bieżącego serwera systemowego z poprzednim serwerem systemowym ProcessInfo. Aby skorzystać z promocji ProcessInfo, użyj getProcessByName(String).
| Parametry | |
|---|---|
prevSystemServerProcess |
ProcessInfo: poprzedni proces system_server ProcessInfo. |
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie zostało ponownie uruchomione. |
| Zgłasza | |
|---|---|
RuntimeException |
jeśli urządzenie ma nietypowy powód uruchomienia. |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
deviceSoftRestartedSince
public abstract boolean deviceSoftRestartedSince (long utcEpochTime,
TimeUnit timeUnit)Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione od czasu UTC od początku epoki z urządzenia i jego ERROR(/TimeUnit). Miękkie ponowne uruchomienie oznacza ponowne uruchomienie serwera systemowego poza twardym ponownym uruchomieniem urządzenia (np. na żądanie). Bieżący czas urządzenia utcEpochTime w milisekundach można uzyskać za pomocą metody getDeviceDate().
| Parametry | |
|---|---|
utcEpochTime |
long: czas urządzenia w sekundach od początku epoki. |
timeUnit |
TimeUnit: jednostka czasu TimeUnit dla danego parametru utcEpochTime. |
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie zostało ponownie uruchomione. |
| Zgłasza | |
|---|---|
RuntimeException |
jeśli urządzenie ma nietypowy powód uruchomienia. |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
disableAdbRoot
public abstract boolean disableAdbRoot ()
Wyłącza uprawnienia roota adb.
Wyłączenie uprawnień roota adb może spowodować odłączenie urządzenia od adb. Ta metoda będzie blokować działanie programu do momentu, aż urządzenie będzie dostępne.
| Zwroty | |
|---|---|
boolean |
true, jeśli się uda. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
doesFileExist
public abstract boolean doesFileExist (String deviceFilePath)
Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu.
| Parametry | |
|---|---|
deviceFilePath |
String: bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony. |
| Zwroty | |
|---|---|
boolean |
true, jeśli plik istnieje, false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
enableAdbRoot
public abstract boolean enableAdbRoot ()
Włącza uprawnienia roota ADB. Jeśli ustawienie „enable-root” ma wartość „false”, zostanie zarejestrowany komunikat i zwrócona wartość bez włączania dostępu do roota.
Włączenie adb root może spowodować odłączenie urządzenia od adb. Ta metoda będzie blokować działanie programu do momentu, aż urządzenie będzie dostępne.
| Zwroty | |
|---|---|
boolean |
true, jeśli się uda. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeAdbCommand
public abstract String executeAdbCommand (long timeout,
String... commandArgs)Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu. |
commandArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
String |
standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
commandArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
String |
standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeAdbCommand
public abstract String executeAdbCommand (long timeout,
envMap,
String... commandArgs) Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu. |
envMap |
: środowisko, które ma być ustawione dla polecenia |
commandArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
String |
standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeAdbV2Command
public abstract CommandResult executeAdbV2Command (long timeout,envMap, String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu. |
envMap |
: środowisko, które ma być ustawione dla polecenia |
commandArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeAdbV2Command
public abstract CommandResult executeAdbV2Command (String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
commandArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeAdbV2Command
public abstract CommandResult executeAdbV2Command (long timeout, String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.
executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu. |
commandArgs |
String: polecenie adb i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeFastbootCommand
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe.
Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.
| Parametry | |
|---|---|
timeout |
long: czas w milisekundach, po którym polecenie wygasa. |
commandArgs |
String: polecenie fastboot i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeFastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty.
Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.
| Parametry | |
|---|---|
commandArgs |
String: polecenie fastboot i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe.
Identyczna z funkcją executeFastbootCommand(String), ale używa dłuższego czasu oczekiwania.
| Parametry | |
|---|---|
commandArgs |
String: polecenie fastboot i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe ze zmiennymi środowiskowymi systemu.
Identyczna z funkcją executeFastbootCommand(String), ale używa dłuższego czasu oczekiwania.
| Parametry | |
|---|---|
envVarMap |
: zmienne środowiskowe systemu, z którymi jest uruchamiane polecenie fastboot; |
commandArgs |
String: polecenie fastboot i argumenty do uruchomienia; |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeShellCommand
public abstract String executeShellCommand (String command)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako String.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
| Zwroty | |
|---|---|
String |
dane wyjściowe powłoki, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeShellCommand
public abstract void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeToOutputShellResponse,
TimeUnit timeUnit,
int retryAttempts)Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki. |
maxTimeToOutputShellResponse |
long: maksymalny czas, w którym polecenie może nie generować odpowiedzi; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts
nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeShellCommand
public abstract void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeoutForCommand,
long maxTimeToOutputShellResponse,
TimeUnit timeUnit,
int retryAttempts)Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki. |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
maxTimeToOutputShellResponse |
long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeShellCommand
public abstract void executeShellCommand (String command,
IShellOutputReceiver receiver)Wykonuje podane polecenie powłoki adb, ponawiając je wielokrotnie, jeśli się nie powiedzie.
Prostsza forma funkcji executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) z wartościami domyślnymi.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.
| Parametry | |
|---|---|
command |
String: polecenie, które ma zostać uruchomione. |
| Zwroty | |
|---|---|
CommandResult |
Wynik w języku: CommandResult. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia i stderr. stdout jest kierowany do określonego strumienia.
| Parametry | |
|---|---|
command |
String: polecenie, które ma zostać uruchomione. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null. |
| Zwroty | |
|---|---|
CommandResult |
Wynik w języku: CommandResult. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.
| Parametry | |
|---|---|
command |
String: polecenie, które ma zostać uruchomione. |
pipeAsInput |
File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null. |
| Zwroty | |
|---|---|
CommandResult |
Wynik w języku: CommandResult. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zwroty | |
|---|---|
CommandResult |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
Zobacz też:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
| Zwroty | |
|---|---|
CommandResult |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
Zobacz też:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
pipeAsInput |
File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null. |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zwroty | |
|---|---|
CommandResult |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
Zobacz też:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.
| Parametry | |
|---|---|
command |
String: polecenie adb shell do uruchomienia |
pipeAsInput |
File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null. |
pipeToError |
OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowany standardowy błąd, lub wartość null. |
maxTimeoutForCommand |
long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit |
timeUnit |
TimeUnit: jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
| Zwroty | |
|---|---|
CommandResult |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
Zobacz też:
fastbootWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
Metoda pomocnicza, która czyści partycję urządzenia.
Jeśli getUseFastbootErase() ma wartość true, do wyczyszczenia partycji zostanie użyte polecenie fastboot erase. Przy następnym uruchomieniu urządzenia musi ono utworzyć system plików.
W przeciwnym razie używany jest format fastboot, który utworzy nowy system plików na urządzeniu.
Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.
| Parametry | |
|---|---|
partition |
String: partycja do wyczyszczenia |
| Zwroty | |
|---|---|
CommandResult |
obiekt CommandResult zawierający dane wyjściowe polecenia; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
getApiLevel
public abstract int getApiLevel ()
Pobierz poziom interfejsu API urządzenia. Domyślna wartość to UNKNOWN_API_LEVEL.
| Zwroty | |
|---|---|
int |
liczba całkowita wskazująca poziom interfejsu API urządzenia; |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getBasebandVersion
public abstract String getBasebandVersion ()
Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. Pobieranie wersji radia
jest zależne od urządzenia, więc może nie zwracać prawidłowych informacji na wszystkich urządzeniach. Ta metoda korzysta z właściwości gsm.version.baseband, aby zwracać prawidłowe informacje o wersji.
W przypadku niektórych urządzeń CDMA ta wartość jest niedokładna, a wersja zwrócona w tym miejscu może nie być zgodna z wersją zgłoszoną przez fastboot i może nie zwracać wersji radia CDMA.
W skrócie: ta metoda podaje dokładną wersję tylko wtedy, gdy właściwość gsm.version.baseband jest taka sama jak wersja zwracana przez fastboot getvar version-baseband.
| Zwroty | |
|---|---|
String |
String wersja pasma podstawowego lub null, jeśli nie można jej określić (urządzenie nie ma radia lub nie można odczytać ciągu znaków wersji); |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
getBattery
public abstract Integer getBattery ()
Zwraca bieżący poziom naładowania baterii urządzenia lub wartość null, jeśli poziom naładowania baterii jest niedostępny.
| Zwroty | |
|---|---|
Integer |
|
getBooleanProperty
public abstract boolean getBooleanProperty (String name,
boolean defaultValue)Zwraca wartość logiczną danej właściwości.
| Parametry | |
|---|---|
name |
String: nazwa usługi |
defaultValue |
boolean: wartość domyślna, która ma zostać zwrócona, jeśli właściwość jest pusta lub nie istnieje. |
| Zwroty | |
|---|---|
boolean |
true, jeśli właściwość ma wartość "1", "y", "yes", "on" lub "true"; false, jeśli właściwość ma wartość "0", "n", "no", "off", "false" lub defaultValue; w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBootHistory
public abstractgetBootHistory ()
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia.
| Zwroty | |
|---|---|
|
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBootHistorySince
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchamiania od podanego czasu od początku epoki na urządzeniu oraz określoną jednostką czasu. Aktualny czas urządzenia utcEpochTime w milisekundach można uzyskać za pomocą metody getDeviceDate().
| Parametry | |
|---|---|
utcEpochTime |
long: czas urządzenia od początku epoki. |
timeUnit |
TimeUnit: jednostka czasu TimeUnit. |
| Zwroty | |
|---|---|
|
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getBootloaderVersion
public abstract String getBootloaderVersion ()
Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia.
Spróbuje pobrać wersję programu rozruchowego z bieżącego stanu urządzenia. (np. jeśli urządzenie jest w trybie Fastboot Mode, spróbuje pobrać wersję z tego trybu).
| Zwroty | |
|---|---|
String |
wersję programu rozruchowego String lub null, jeśli nie można jej znaleźć; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
getBuildAlias
public abstract String getBuildAlias ()
Pobierz alias kompilacji, na której obecnie działa urządzenie.
Alias kompilacji jest zwykle bardziej czytelnym ciągiem znaków niż identyfikator kompilacji (zwykle numer w przypadku kompilacji na urządzenia Nexus). Na przykład ostateczna wersja Androida 4.2 ma alias kompilacji JDQ39 i identyfikator kompilacji 573038.
| Zwroty | |
|---|---|
String |
alias kompilacji lub identyfikator kompilacji, jeśli nie można go pobrać. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getBuildFlavor
public abstract String getBuildFlavor ()
Pobierz wersję kompilacji urządzenia.
| Zwroty | |
|---|---|
String |
wersja kompilacji lub wartość null, jeśli nie można jej pobrać. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getBuildId
public abstract String getBuildId ()
Pobierz kompilację, na której obecnie działa urządzenie.
| Zwroty | |
|---|---|
String |
identyfikator kompilacji lub IBuildInfo.UNKNOWN_BUILD_ID, jeśli nie udało się go pobrać. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
Zwraca typ klucza użytego do podpisania obrazu urządzenia.
Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń).
| Zwroty | |
|---|---|
String |
Klucz podpisywania, jeśli został znaleziony, w przeciwnym razie wartość null. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.
| Zwroty | |
|---|---|
DeviceDescriptor |
|
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.
| Parametry | |
|---|---|
shortDescriptor |
boolean: czy ograniczyć opis do minimum informacji |
| Zwroty | |
|---|---|
DeviceDescriptor |
|
getChildren
public abstract String[] getChildren (String deviceFilePath)
Alternatywa dla używania IFileEntry, która czasami nie działa z powodu uprawnień.
| Parametry | |
|---|---|
deviceFilePath |
String: ścieżka na urządzeniu, w której ma się odbywać wyszukiwanie. |
| Zwroty | |
|---|---|
String[] |
Tablica ciągów znaków zawierająca wszystkie pliki w ścieżce na urządzeniu. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getConnection
public abstract AbstractConnection getConnection ()
Zwraca połączenie powiązane z urządzeniem.
| Zwroty | |
|---|---|
AbstractConnection |
|
getDeviceClass
public abstract String getDeviceClass ()
Pobierz klasę urządzenia.
| Zwroty | |
|---|---|
String |
klasa urządzenia String, |
getDeviceDate
public abstract long getDeviceDate ()
Zwraca datę urządzenia w milisekundach od początku epoki.
| Zwroty | |
|---|---|
long |
datę urządzenia w formacie epoki; |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o urządzeniu bez przekazywania rzeczywistego obiektu urządzenia.
| Zwroty | |
|---|---|
DeviceDescriptor |
|
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o urządzeniu bez przekazywania rzeczywistego obiektu urządzenia.
| Parametry | |
|---|---|
shortDescriptor |
boolean: czy ograniczyć opis do minimum informacji |
| Zwroty | |
|---|---|
DeviceDescriptor |
|
getDeviceState
public abstract TestDeviceState getDeviceState ()
Pobierz stan urządzenia.
| Zwroty | |
|---|---|
TestDeviceState |
|
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
Funkcja pomocnicza do uzyskiwania różnicy czasu między urządzeniem a podanym ERROR(/Date). wewnętrznie używać czasu epoki.
| Parametry | |
|---|---|
date |
Date |
| Zwroty | |
|---|---|
long |
różnicę w milisekundach, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Pobieranie strumienia stdout i stderr emulatora
| Zwroty | |
|---|---|
InputStreamSource |
dane wyjściowe emulatora, |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia.
| Zwroty | |
|---|---|
long |
ilość wolnego miejsca w KB, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
getFastbootProductType
public abstract String getFastbootProductType ()
Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.
Tej metody należy używać tylko wtedy, gdy urządzenie ma być w trybie fastboot. Jest to nieco bezpieczniejsza odmiana ogólnej metody getProductType(), ponieważ w tym przypadku interfejs ITestDevice wie, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.
| Zwroty | |
|---|---|
String |
nazwę typu produktu String lub null, jeśli nie można jej określić. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.
Tej metody należy używać tylko wtedy, gdy urządzenie ma być w trybie fastboot. Jest to nieco bezpieczniejsza odmiana ogólnej metody getProductType(), ponieważ w tym przypadku interfejs ITestDevice wie, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.
| Zwroty | |
|---|---|
String |
nazwę typu produktu String lub null, jeśli nie można jej określić. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
Zwraca numer seryjny trybu fastboot.
| Zwroty | |
|---|---|
String |
|
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
Pobierz z urządzenia wartość podanej zmiennej fastboot.
| Parametry | |
|---|---|
variableName |
String: nazwa zmiennej; |
| Zwroty | |
|---|---|
String |
wartość właściwości lub null, jeśli nie istnieje. |
| Zgłasza | |
|---|---|
|
UnsupportedOperationException |
DeviceNotAvailableException |
|
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Pobieranie odwołania do pliku zdalnego na urządzeniu.
| Parametry | |
|---|---|
path |
String: ścieżka pliku do pobrania. Może to być ścieżka bezwzględna lub ścieżka względna do „/” (obsługiwana jest składnia „/system” i „system”). |
| Zwroty | |
|---|---|
IFileEntry |
wartość IFileEntry lub null, jeśli nie można znaleźć pliku pod podanym adresem path. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getIDevice
public abstract IDevice getIDevice ()
Zwraca odwołanie do powiązanej biblioteki ddmlib IDevice.
Nowy IDevice może być przydzielany przez DDMS za każdym razem, gdy urządzenie zostanie odłączone i ponownie połączone z adb. Dlatego wywołujący nie powinni przechowywać odwołania do IDevice, ponieważ może ono stać się nieaktualne.
| Zwroty | |
|---|---|
IDevice |
IDevice |
getIntProperty
public abstract long getIntProperty (String name,
long defaultValue)Zwraca wartość całkowitą danej właściwości z urządzenia.
| Parametry | |
|---|---|
name |
String: nazwa usługi |
defaultValue |
long: wartość domyślna, która ma zostać zwrócona, jeśli właściwość jest pusta lub nie istnieje. |
| Zwroty | |
|---|---|
long |
wartość właściwości lub defaultValue, jeśli właściwość jest pusta, nie istnieje lub nie ma wartości całkowitej. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie, w milisekundach od EPOCH, zgodnie z wartością zwracaną przez System.currentTimeMillis().
| Zwroty | |
|---|---|
long |
|
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
Pobierz poziom API, na którym urządzenie zostało uruchomione po raz pierwszy. Domyślna wartość to UNKNOWN_API_LEVEL.
| Zwroty | |
|---|---|
int |
liczba całkowita wskazująca pierwszy uruchomiony poziom interfejsu API urządzenia; |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getLogcat
public abstract InputStreamSource getLogcat ()
Pobiera strumień zrzutu danych logcat.
Działa w 2 trybach:
TestDeviceOptions.getMaxLogcatDataSize() bajtów bieżącej zawartości rejestrowanego w tle logcatu.
| Zwroty | |
|---|---|
InputStreamSource |
|
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Pobiera strumień zrzutu ostatnich maxBytes danych logcat.
Przydatne w sytuacjach, gdy chcesz często robić zrzuty przechwyconych danych logcat bez ponoszenia potencjalnie dużych kosztów związanych z zajmowaniem miejsca na dysku przez pełny zrzut getLogcat().
| Parametry | |
|---|---|
maxBytes |
int: maksymalna ilość danych do zwrócenia. Powinna to być ilość, która
zmieści się w pamięci. |
| Zwroty | |
|---|---|
InputStreamSource |
|
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Pobierz zrzut bieżącego dziennika logcat z urządzenia. W przeciwieństwie do metody getLogcat() ta metoda zawsze zwraca statyczny zrzut logcat.
Ma tę wadę, że jeśli urządzenie jest niedostępne, nic nie zostanie zwrócone.
| Zwroty | |
|---|---|
InputStreamSource |
InputStreamSource danych logcat. Jeśli nie uda się przechwycić danych logcat, zwracany jest pusty strumień. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty. Należy używać czasu na urządzeniu getDeviceDate().
| Parametry | |
|---|---|
date |
long: w milisekundach od początku epoki, kiedy rozpocząć zrzut, aż do chwili obecnej.
(można go uzyskać za pomocą polecenia „date +%s”) |
| Zwroty | |
|---|---|
InputStreamSource |
|
getMountPoint
public abstract String getMountPoint (String mountName)
Zwraca punkt podłączenia.
Wysyła zapytanie bezpośrednio do urządzenia, jeśli informacje w pamięci podręcznej w IDevice są niedostępne.
DO ZROBIENIA: przenieś to działanie do IDevice.getMountPoint(String)
| Parametry | |
|---|---|
mountName |
String: nazwa punktu podłączania |
| Zwroty | |
|---|---|
String |
punkt podłączenia lub null |
Zobacz też:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Zwraca wartość MountPointInfo odpowiadającą określonej ścieżce punktu podłączania lub null, jeśli w tej ścieżce nie ma niczego podłączonego lub w inny sposób nie pojawia się ona w pliku /proc/mounts jako punkt podłączania.
| Parametry | |
|---|---|
mountpoint |
String |
| Zwroty | |
|---|---|
ITestDevice.MountPointInfo |
ERROR(/List) z MountPointInfo zawierający informacje z pliku „/proc/mounts”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
Zobacz też:
getMountPointInfo
public abstractgetMountPointInfo ()
Zwraca przeanalizowaną wersję informacji z pliku /proc/mounts na urządzeniu.
| Zwroty | |
|---|---|
|
ERROR(/List) z MountPointInfo zawierający informacje z pliku „/proc/mounts”. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia.
| Parametry | |
|---|---|
partition |
String |
| Zwroty | |
|---|---|
long |
ilość wolnego miejsca w KB, |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
Metoda pomocnicza uruchamia polecenia „pidof” i „stat” i zwraca obiekt ProcessInfo z identyfikatorem PID i czasem rozpoczęcia danego procesu.
| Parametry | |
|---|---|
processName |
String: ciąg znaków z nazwą procesu. |
| Zwroty | |
|---|---|
ProcessInfo |
ProcessInfo dla danego procesu o nazwie processName |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getProcessPid
public abstract String getProcessPid (String process)
Zwraca identyfikator procesu usługi lub wartość null, jeśli wystąpił błąd.
| Parametry | |
|---|---|
process |
String: Ciąg znaków z nazwą procesu. |
| Zwroty | |
|---|---|
String |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
getProductType
public abstract String getProductType ()
Wygodna metoda uzyskiwania typu produktu tego urządzenia.
Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.
| Zwroty | |
|---|---|
String |
nazwę typu produktu String; Nie może mieć wartości null. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie można go przywrócić lub jeśli nie można określić typu produktu. |
getProductVariant
public abstract String getProductVariant ()
Wygodna metoda pobierania wersji produktu tego urządzenia.
Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.
| Zwroty | |
|---|---|
String |
nazwę wersji produktu String lub null, jeśli nie można jej określić; |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
getProperty
public abstract String getProperty (String name)
Pobierz z urządzenia wartość danej właściwości.
| Parametry | |
|---|---|
name |
String: nazwa usługi |
| Zwroty | |
|---|---|
String |
wartość właściwości lub null, jeśli nie istnieje. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Pobierz bieżący tryb odzyskiwania używany na urządzeniu.
| Zwroty | |
|---|---|
ITestDevice.RecoveryMode |
bieżący tryb odzyskiwania używany na urządzeniu; |
getSerialNumber
public abstract String getSerialNumber ()
Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia.
| Zwroty | |
|---|---|
String |
numer seryjny String; |
getTombstones
public abstractgetTombstones ()
Pobierz i zwróć listę znaczników usunięcia z urządzeń. Wymaga dostępu do roota.
metoda działa w trybie „najlepsze starania”, więc jeśli z jakiegokolwiek powodu nie uda się pobrać znacznika usunięcia, nie będzie go na liście. Tylko instrukcja DeviceNotAvailableException spowoduje wcześniejsze zakończenie metody.
| Zwroty | |
|---|---|
|
Lista plików tombstone. Jeśli nie ma plików tombstone, lista jest pusta. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
Zobacz też:
getTotalMemory
public abstract long getTotalMemory ()
Zwraca łączny rozmiar pamięci fizycznej w bajtach lub –1 w przypadku błędu wewnętrznego.
| Zwroty | |
|---|---|
long |
|
getTrackingSerial
public String getTrackingSerial ()
Na potrzeby zarządzania urządzeniem pobierz numer seryjny używany do śledzenia urządzenia.
| Zwroty | |
|---|---|
String |
|
getUseFastbootErase
public abstract boolean getUseFastbootErase ()
Sprawdza, czy do wyczyszczenia partycji na urządzeniu należy użyć polecenia fastboot erase czy fastboot format.
| Zwroty | |
|---|---|
boolean |
true czy zostanie użyte polecenie fastboot erase, czy false polecenie fastboot format. |
Zobacz też:
isAdbRoot
public abstract boolean isAdbRoot ()
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie ma obecnie dostęp do roota przez ADB, false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
isAdbTcp
public abstract boolean isAdbTcp ()
| Zwroty | |
|---|---|
boolean |
true jeśli urządzenie jest połączone z adb-over-tcp, false
w przeciwnym razie. |
isAppEnumerationSupported
public abstract boolean isAppEnumerationSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje wyliczanie aplikacji
| Zwroty | |
|---|---|
boolean |
Prawda, jeśli wyliczanie aplikacji jest obsługiwane, w przeciwnym razie fałsz. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
isBypassLowTargetSdkBlockSupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje omijanie blokady niskiego docelowego pakietu SDK podczas instalowania aplikacji
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli obejście blokady niskiego docelowego pakietu SDK jest obsługiwane, w przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
isDebugfsMounted
public abstract boolean isDebugfsMounted ()
Sprawdź, czy debugfs jest zamontowany.
| Zwroty | |
|---|---|
boolean |
true, jeśli debugfs jest zamontowany |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
isDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Wyświetla informację o tym, czy urządzenie jest zaszyfrowane.
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie jest zaszyfrowane. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
isDirectory
public abstract boolean isDirectory (String deviceFilePath)
Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość Fałsz.
| Parametry | |
|---|---|
deviceFilePath |
String |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Wyświetla informację o tym, czy urządzenie obsługuje szyfrowanie.
| Zwroty | |
|---|---|
boolean |
true – jeśli urządzenie obsługuje szyfrowanie. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
isExecutable
public abstract boolean isExecutable (String fullPath)
Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu prowadzi do pliku wykonywalnego, w przeciwnym razie zwraca wartość Fałsz.
| Parametry | |
|---|---|
fullPath |
String |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
isHeadless
public abstract boolean isHeadless ()
Zwraca wartość „true”, jeśli urządzenie nie ma ekranu, w przeciwnym razie zwraca wartość „false”.
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
isRuntimePermissionSupported
public abstract boolean isRuntimePermissionSupported ()
Sprawdzanie, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli uprawnienia czasu działania są obsługiwane. W przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
isStateBootloaderOrFastbootd
public abstract boolean isStateBootloaderOrFastbootd ()
Zwraca wartość „prawda”, jeśli urządzenie jest w stanie TestDeviceState.FASTBOOT lub TestDeviceState.FASTBOOTD.
| Zwroty | |
|---|---|
boolean |
|
logAnrs
public abstract boolean logAnrs (ITestLogger logger)
Zbiera i rejestruje błędy ANR z urządzenia.
| Parametry | |
|---|---|
logger |
ITestLogger: ITestLogger do rejestrowania błędów ANR. |
| Zwroty | |
|---|---|
boolean |
Wartość true, jeśli rejestrowanie się powiodło. W przeciwnym razie wartość false. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
logOnDevice
public abstract void logOnDevice (String tag,
Log.LogLevel level,
String format,
Object... args)Zapisz wiadomość w logcat urządzenia. Jest to bezpieczne wywołanie, które nie spowoduje błędu nawet wtedy, gdy rejestrowanie się nie powiedzie.
| Parametry | |
|---|---|
tag |
String: tag, pod którym rejestrujemy wiadomość w logcat. |
level |
Log.LogLevel: poziom debugowania wiadomości w logcat. |
format |
String: format wiadomości. |
args |
Object: argumenty, które mają zostać zastąpione za pomocą String.format(). |
mountDebugfs
public abstract void mountDebugfs ()
Podłącz debugfs.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
nonBlockingReboot
public abstract void nonBlockingReboot ()
Wydaje polecenie ponownego uruchomienia urządzenia i zwraca wynik po zakończeniu polecenia oraz gdy urządzenie nie jest już widoczne dla adb.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
postBootSetup
public abstract void postBootSetup ()
Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.
Powinien być wywoływany po pełnym uruchomieniu lub udostępnieniu urządzenia.
W normalnych okolicznościach nie trzeba wywoływać tej metody bezpośrednio, ponieważ implementacje powinny automatycznie wykonywać te czynności podczas ponownego uruchamiania.
Może być konieczne wywołanie tej funkcji, gdy urządzenie uruchamia się ponownie z powodu innych zdarzeń (np. po zakończeniu polecenia aktualizacji fastboot).
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
postInvocationTearDown
public void postInvocationTearDown ()
Ta metoda została wycofana.
Zamiast niej używaj zasady postInvocationTearDown(Throwable).
Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.
| Parametry | |
|---|---|
invocationException |
Throwable: jeśli wystąpił błąd wywołania, jest to ostateczny wyjątek. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe czynności wymagane do skonfigurowania urządzenia, które zostaną wykonane na urządzeniu przed wywołaniem przepływu.
| Parametry | |
|---|---|
info |
IBuildInfo: IBuildInfo urządzenia. |
attributes |
MultiMap: atrybuty przechowywane w kontekście wywołania. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
TargetSetupError |
|
pullDir
public abstract boolean pullDir (String deviceFilePath,
File localDir)Rekursywne pobieranie zawartości katalogu z urządzenia.
| Parametry | |
|---|---|
deviceFilePath |
String: bezwzględna ścieżka pliku źródła zdalnego |
localDir |
File: lokalny katalog, do którego mają być pobierane pliki. |
| Zwroty | |
|---|---|
boolean |
true jeśli plik został pobrany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pullDir
public abstract boolean pullDir (String deviceFilePath,
File localDir,
int userId)Rekursywne pobieranie zawartości katalogu z urządzenia.
| Parametry | |
|---|---|
deviceFilePath |
String: bezwzględna ścieżka pliku źródła zdalnego |
localDir |
File: lokalny katalog, do którego mają być pobierane pliki. |
userId |
int: identyfikator użytkownika, z którego chcesz pobrać dane |
| Zwroty | |
|---|---|
boolean |
true jeśli plik został pobrany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pullFile
public abstract File pullFile (String remoteFilePath,
int userId)Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
userId |
int: identyfikator użytkownika, z którego chcesz pobrać dane. |
| Zwroty | |
|---|---|
File |
ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pullFile
public abstract File pullFile (String remoteFilePath)
Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
| Zwroty | |
|---|---|
File |
ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pullFile
public abstract boolean pullFile (String remoteFilePath,
File localFile)Pobiera plik z urządzenia.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
localFile |
File: lokalny plik, w którym będą przechowywane treści. Jeśli nie jest pusta, zawartość zostanie zastąpiona. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został pobrany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pullFile
public abstract boolean pullFile (String remoteFilePath,
File localFile,
int userId)Pobiera plik z urządzenia.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
localFile |
File: lokalny plik, w którym będą przechowywane treści. Jeśli nie jest pusta, zawartość zostanie zastąpiona. |
userId |
int: identyfikator użytkownika, z którego chcesz pobrać dane. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został pobrany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pullFileContents
public abstract String pullFileContents (String remoteFilePath)
Pobiera plik z urządzenia i zwraca jego zawartość.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka bezwzględna do pliku na urządzeniu. |
| Zwroty | |
|---|---|
String |
String zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
Wygodna metoda pobierania pliku z pamięci zewnętrznej urządzenia, zapisywania go w lokalnym pliku tymczasowym ERROR(/File) i zwracania odwołania do tego pliku File.
| Parametry | |
|---|---|
remoteFilePath |
String: ścieżka do pliku na urządzeniu, względna w stosunku do punktu montowania zewnętrznej pamięci masowej urządzenia |
| Zwroty | |
|---|---|
File |
ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta). |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pushDir
public abstract boolean pushDir (File localDir,
String deviceFilePath,
int userId)Rekursywne przekazywanie zawartości katalogu na urządzenie.
| Parametry | |
|---|---|
localDir |
File: katalog lokalny do wypychania |
deviceFilePath |
String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego |
userId |
int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pushDir
public abstract boolean pushDir (File localDir,
String deviceFilePath,
excludedDirectories) Rekursywne przesyłanie zawartości katalogu na urządzenie z wykluczeniem niektórych katalogów, które są filtrowane.
| Parametry | |
|---|---|
localDir |
File: katalog lokalny do wypychania |
deviceFilePath |
String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego |
excludedDirectories |
: Zestaw nazw wykluczonych katalogów, które nie powinny być przesyłane. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pushDir
public abstract boolean pushDir (File localDir,
String deviceFilePath)Rekursywne przekazywanie zawartości katalogu na urządzenie.
| Parametry | |
|---|---|
localDir |
File: katalog lokalny do wypychania |
deviceFilePath |
String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pushFile
public abstract boolean pushFile (File localFile,
String deviceFilePath,
boolean evaluateContentProviderNeeded)Wariant pushFile(File, String), który może opcjonalnie uwzględniać ocenę potrzeb dostawcy treści.
| Parametry | |
|---|---|
localFile |
File: plik lokalny do przesłania |
deviceFilePath |
String: bezwzględna ścieżka pliku w miejscu docelowym |
evaluateContentProviderNeeded |
boolean: czy sprawdzić, czy potrzebujemy dostawcy treści. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pushFile
public abstract boolean pushFile (File localFile,
String deviceFilePath)Przekaż plik na urządzenie. Domyślnie używa dostawcy treści.
| Parametry | |
|---|---|
localFile |
File: plik lokalny do przesłania |
deviceFilePath |
String: bezwzględna ścieżka pliku w miejscu docelowym |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pushFile
public abstract boolean pushFile (File localFile,
String deviceFilePath,
int userId)Przekaż plik na urządzenie. Domyślnie używa dostawcy treści.
| Parametry | |
|---|---|
localFile |
File: plik lokalny do przesłania |
deviceFilePath |
String: bezwzględna ścieżka pliku w miejscu docelowym |
userId |
int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie. |
| Zwroty | |
|---|---|
boolean |
true – jeśli plik został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
pushString
public abstract boolean pushString (String contents,
String deviceFilePath)Przesyłanie na urządzenie pliku utworzonego z ciągu znaków
| Parametry | |
|---|---|
contents |
String: zawartość pliku do przesłania, |
deviceFilePath |
String: bezwzględna ścieżka pliku w miejscu docelowym |
| Zwroty | |
|---|---|
boolean |
true, jeśli ciąg znaków został przesłany. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
Uruchom ponownie
public abstract void reboot ()
Uruchamia ponownie urządzenie w trybie adb.
Blokuje działanie do momentu, aż urządzenie będzie dostępne.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu; |
Uruchom ponownie
public abstract void reboot (String reason)
Uruchamia ponownie urządzenie w trybie adb z podanym parametrem reason, który będzie zachowywany po ponownym uruchomieniu.
Blokuje do momentu, aż urządzenie stanie się dostępne.
Przyczynę ostatniego ponownego uruchomienia można uzyskać, wysyłając zapytanie o właściwość sys.boot.reason.
| Parametry | |
|---|---|
reason |
String: przyczyna ponownego uruchomienia lub null, jeśli nie podano przyczyny. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu; |
rebootIntoBootloader
public abstract void rebootIntoBootloader ()
Uruchamia ponownie urządzenie w trybie programu rozruchowego.
Blokuje działanie do momentu przejścia urządzenia w tryb programu rozruchowego.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
rebootIntoFastbootd
public abstract void rebootIntoFastbootd ()
Uruchamia ponownie urządzenie w trybie fastbootd.
Blokuje działanie do momentu przejścia urządzenia w tryb fastbootd.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
rebootIntoRecovery
public abstract void rebootIntoRecovery ()
Uruchamia ponownie urządzenie w trybie odzyskiwania adb.
Blokuje do momentu przejścia urządzenia w tryb odzyskiwania
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu; |
rebootIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania).
Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku
| Parametry | |
|---|---|
autoReboot |
boolean: czy po wgraniu aplikacji urządzenie ma się automatycznie uruchomić ponownie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli po ponownym uruchomieniu urządzenie nie jest w trybie instalacji z boku. |
rebootIntoSideload
public abstract void rebootIntoSideload ()
Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania).
Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli po ponownym uruchomieniu urządzenie nie jest w trybie instalacji z boku. |
rebootUntilOnline
public abstract void rebootUntilOnline ()
Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu; |
rebootUntilOnline
public abstract void rebootUntilOnline (String reason)
Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
| Parametry | |
|---|---|
reason |
String: przyczyna ponownego uruchomienia lub null, jeśli nie podano przyczyny. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie jest niedostępne po ponownym uruchomieniu; |
Zobacz też:
rebootUserspace
public abstract void rebootUserspace ()
Ponowne uruchomienie tylko części urządzenia w przestrzeni użytkownika.
Blokuje do momentu, aż urządzenie stanie się dostępne.
OSTRZEŻENIE. Ponowne uruchamianie w przestrzeni użytkownika jest obecnie w fazie rozwoju. Korzystasz z tej funkcji na własne ryzyko.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu; |
rebootUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
Alternatywa dla rebootUserspace() ()}, która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu; |
remountSystemReadOnly
public abstract void remountSystemReadOnly ()
Ustaw partycję systemową na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
remountSystemWritable
public abstract void remountSystemWritable ()
Ustaw partycję systemową na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
remountVendorReadOnly
public abstract void remountVendorReadOnly ()
Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
remountVendorWritable
public abstract void remountVendorWritable ()
Ustaw partycję dostawcy na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Wygodna metoda wykonywania ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z co najmniej 1 odbiorcą przekazanym jako parametr.
| Parametry | |
|---|---|
runner |
IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy. |
listeners |
ITestLifeCycleReceiver: odbiorcy wyników testu |
| Zwroty | |
|---|---|
boolean |
true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć, ale przywracanie zakończyło się powodzeniem. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie można go przywrócić, np. polecenie testowe nie zostało wykonane, a przywracanie się nie powiodło. |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Uruchamia testy z instrumentacją i umożliwia przywracanie urządzeń.
Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu, a funkcja zwróci wartość „false”. Polecenie testowe nie zostanie ponownie uruchomione. W razie potrzeby rozmówcy mogą ponowić próbę.
Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się nie powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu (testRunFailed), a następnie zostanie zgłoszony wyjątek DeviceNotAvailableException.
| Parametry | |
|---|---|
runner |
IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy. |
listeners |
: odbiorcy wyników testu |
| Zwroty | |
|---|---|
boolean |
true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć z powodu wyjątku w komunikacji z urządzeniem, ale przywracanie zakończyło się pomyślnie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie można go przywrócić, np. polecenie testowe nie zostało wykonane, a przywracanie się nie powiodło. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Podobnie jak ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), ale
przeprowadza test dla danego użytkownika.
| Parametry | |
|---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Tak samo jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...), ale przeprowadza test dla danego użytkownika.
| Parametry | |
|---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
| Zwroty | |
|---|---|
boolean |
|
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
|
setDate
public abstract void setDate (Date date)
Ustawia datę na urządzeniu
Uwaga: ustawienie daty na urządzeniu wymaga dostępu do roota.
| Parametry | |
|---|---|
date |
Date: określ konkretną datę; jeśli null, użyje daty hosta. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
setOptions
public abstract void setOptions (TestDeviceOptions options)
Ustaw TestDeviceOptions dla urządzenia
| Parametry | |
|---|---|
options |
TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey,
String propValue)Ustawia na urządzeniu podaną wartość właściwości. Wymaga, aby adb root miało wartość true.
| Parametry | |
|---|---|
propKey |
String: klucz, który ma zostać ustawiony. |
propValue |
String: wartość właściwości do ustawienia. |
| Zwroty | |
|---|---|
boolean |
zwraca True, jeśli polecenie setprop zostało wykonane prawidłowo, a w przeciwnym razie zwraca wartość False. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Ustaw numer IDeviceRecovery, który ma być używany na tym urządzeniu. Należy go ustawić, gdy urządzenie zostanie po raz pierwszy przydzielone.
| Parametry | |
|---|---|
recovery |
IDeviceRecovery: IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Ustaw bieżący tryb odzyskiwania, który ma być używany na urządzeniu.
Służy do określania metody odzyskiwania, która ma być używana w przypadku problemu z komunikacją z urządzeniem. Zalecamy używanie tej metody tylko w razie potrzeby (np. gdy platforma nie działa itp.).
| Parametry | |
|---|---|
mode |
ITestDevice.RecoveryMode: czy tryb „przywracaj tylko do momentu połączenia z siecią” ma być włączony. |
setTrackingSerial
public abstract void setTrackingSerial (String trackingSerial)
Do celów zarządzania urządzeniami śledź numer seryjny, którego używamy do odwoływania się do urządzenia.
| Parametry | |
|---|---|
trackingSerial |
String |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Określ, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format.
| Parametry | |
|---|---|
useFastbootErase |
boolean: true, jeśli ma być użyte polecenie fastboot erase, lub false, jeśli ma być użyte polecenie fastboot format. |
Zobacz też:
startLogcat
public abstract void startLogcat ()
Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle.
Nie będzie to miało wpływu, jeśli dane wyjściowe logcat są już rejestrowane. Dane można później pobrać za pomocą funkcji getLogcat.
Gdy urządzenie nie jest już używane, należy wywołać funkcję stopLogcat().
Zwykle nie trzeba wywoływać funkcji startLogcat() i stopLogcat() w kontekście wywołania TF, ponieważ framework TF uruchamia i zatrzymuje logcat.
startTradeInModeTesting
public abstract boolean startTradeInModeTesting (int timeoutMs)
Włącz tryb testowania wymiany za dopłatą. Urządzenie zostanie wyczyszczone i uruchomione ponownie.
| Parametry | |
|---|---|
timeoutMs |
int |
| Zwroty | |
|---|---|
boolean |
Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Zamknij i usuń dane wyjściowe emulatora.
stopLogcat
public abstract void stopLogcat ()
Zatrzymuje rejestrowanie danych wyjściowych logcat z urządzenia i odrzuca aktualnie zapisane dane logcat.
Nie będzie mieć wpływu, jeśli dane wyjściowe logcat nie są rejestrowane.
stopTradeInModeTesting
public abstract void stopTradeInModeTesting ()
Zakończ testowanie trybu wymiany za dopłatą. Urządzenie uruchomi się ponownie.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
switchToAdbTcp
public abstract String switchToAdbTcp ()
Przełącz urządzenie w tryb adb-over-tcp.
| Zwroty | |
|---|---|
String |
numer seryjny urządzenia TCP lub null, jeśli nie można było przełączyć urządzenia. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Przełącz urządzenie w tryb adb over usb.
| Zwroty | |
|---|---|
boolean |
true, jeśli przełączanie się powiodło, w przeciwnym razie false. |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
syncFiles
public abstract boolean syncFiles (File localFileDir,
String deviceFilePath)Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem.
Decyduje, które pliki przesłać, porównując sygnatury czasowe plików lokalnych z ich zdalnymi odpowiednikami. Na urządzenie zostaną przesłane tylko „nowsze” lub nieistniejące pliki. Dlatego obciążenie powinno być stosunkowo małe, jeśli zestaw plików na urządzeniu jest już aktualny.
Ukryte pliki (których nazwy zaczynają się od „.”) zostaną zignorowane.
Przykład użycia: syncFiles("/tmp/files", "/sdcard") utworzy katalog /sdcard/files, jeśli jeszcze nie istnieje, i rekursywnie przeniesie zawartość katalogu /tmp/files do katalogu /sdcard/files.
| Parametry | |
|---|---|
localFileDir |
File: lokalny katalog plików zawierający pliki do rekurencyjnego wypychania. |
deviceFilePath |
String: ścieżka bezwzględna do katalogu głównego zdalnego miejsca docelowego. Wszystkie katalogi w tej ścieżce pliku muszą być czytelne. Na przykład próba przesłania pliku do katalogu /data/local/tmp, gdy adb nie ma uprawnień roota, zakończy się niepowodzeniem. |
| Zwroty | |
|---|---|
boolean |
true, jeśli pliki zostały zsynchronizowane. false w przeciwnym razie. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
unlockDevice
public abstract boolean unlockDevice ()
Odblokowuje urządzenie, jeśli jest ono zaszyfrowane.
Ta metoda może ponownie uruchomić platformę, ale nie wywoła funkcjipostBootSetup(). Dlatego urządzenie może nie być w pełni gotowe do testowania, gdy ta metoda zwróci wartość.
| Zwroty | |
|---|---|
boolean |
true – jeśli operacja się powiedzie lub urządzenie nie jest zaszyfrowane. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli urządzenie nie obsługuje szyfrowania. |
unmountDebugfs
public abstract void unmountDebugfs ()
Odłącz debugfs.
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia.
| Parametry | |
|---|---|
timeOut |
long: czas w milisekundach, przez jaki należy czekać na ustawienie flagi. |
| Zwroty | |
|---|---|
boolean |
wartość true, jeśli flaga zakończenia uruchamiania urządzenia jest ustawiona w okresie oczekiwania; |
| Zgłasza | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable ()
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. Używa domyślnego limitu czasu.
| Zwroty | |
|---|---|
boolean |
Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable (long waitTime)
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania.
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli urządzenie nadal nie odpowiada po upływie czasu waitTime. |
waitForDeviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Czeka, aż urządzenie będzie odpowiadać i będzie dostępne, bez uwzględniania ścieżki przywracania.
| Parametry | |
|---|---|
waitTime |
long |
| Zwroty | |
|---|---|
boolean |
Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli jest niedostępne. |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
waitForDeviceBootloader
public abstract void waitForDeviceBootloader ()
Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot. Użyj domyślnego limitu czasu.
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
waitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Blokuje możliwość przejścia urządzenia w stan „adb recovery” (uwaga: różni się od IDeviceRecovery).
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
true jeśli urządzenie uruchomi się w trybie odzyskiwania przed upływem czasu.
W innych przypadkach false |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Blokuje możliwość przejścia urządzenia w stan „adb sideload”
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
true, jeśli urządzenie uruchomi się w trybie sideload przed upływem czasu. W innych przypadkach false
|
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blokuje urządzenie, aby było niedostępne, tzn. nie było widoczne w adb.
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
true, jeśli urządzenie stanie się niedostępne przed upływem czasu.
W innych przypadkach false |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
Blokuje się, dopóki urządzenie nie będzie widoczne przez adb. Używa domyślnego limitu czasu
Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
waitForDeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
Blokuje, dopóki urządzenie nie będzie widoczne przez adb.
Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zgłasza | |
|---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
waitForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Czeka, aż urządzenie odpowie na podstawowe polecenie powłoki adb.
| Parametry | |
|---|---|
waitTime |
long: czas oczekiwania w milisekundach |
| Zwroty | |
|---|---|
boolean |
true, jeśli urządzenie zacznie odpowiadać przed upływem czasu waitTime. |