INativeDevice
public
interface
INativeDevice
com.android.tradefed.device.INativeDevice |
Zapewnia niezawodny interfejs API o nieco wyższym poziomie dla biblioteki IDevice
.
Powtarza polecenia urządzenia przez konfigurowalną liczbę razy i zapewnia interfejs odzyskiwania 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 dana funkcja jest obecnie obsługiwana z uwzględnieniem minimalnego poziomu obsługi. |
abstract
void
|
clearLogcat()
Usuwa wszystkie zgromadzone dane logcat. |
abstract
void
|
deleteFile(String deviceFilePath)
Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu. |
abstract
void
|
deleteFile(String deviceFilePath, int userId)
Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu. |
abstract
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
Metoda pomocnicza do sprawdzania, czy urządzenie zostało zrestartowane, porównując bieżący system_server z poprzednim system_server |
abstract
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało ponownie uruchomione od czasu rozpoczęcia epoki UTC na urządzeniu i jego |
abstract
boolean
|
disableAdbRoot()
Wyłącza rootowanie adb. |
abstract
boolean
|
doesFileExist(String deviceFilePath)
Metoda pomocnicza służąca do określenia, czy plik na urządzeniu istnieje. |
abstract
boolean
|
enableAdbRoot()
Włącza 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
|
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, aby kontrolować zachowanie 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, aby kontrolować zachowanie polecenia. |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Wykonuje podane polecenie adb shell, powtarzając próbę kilka razy, jeśli polecenie się nie powiedzie. |
abstract
CommandResult
|
executeShellV2Command(String command)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako obiekt |
abstract
CommandResult
|
executeShellV2Command(String command, OutputStream pipeToOutput)
Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca wyniki jako |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput)
Metoda pomocnicza, która wykonuje polecenie adb shell 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, aby kontrolować zachowanie polecenia. |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Wykonuje polecenie adb shell z większą liczbą parametrów, aby kontrolować zachowanie 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, aby kontrolować zachowanie 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, aby kontrolować zachowanie 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 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 i przyczyną uruchamiania. |
abstract
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia od podanego czasu od epoki na urządzeniu oraz w określonej jednostce czasu. |
abstract
String
|
getBootloaderVersion()
Wygodna metoda uzyskania wersji programu rozruchowego tego urządzenia. |
abstract
String
|
getBuildAlias()
Pobierz alias kompilacji, która jest obecnie używana na urządzeniu. |
abstract
String
|
getBuildFlavor()
Pobierz wersję kompilacji dla urządzenia. |
abstract
String
|
getBuildId()
Pobierz wersję, która jest obecnie uruchomiona na urządzeniu. |
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 element |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Zwraca element |
abstract
String[]
|
getChildren(String deviceFilePath)
Alternatywa dla |
abstract
AbstractConnection
|
getConnection()
Zwraca połączenie powiązane z urządzeniem. |
abstract
String
|
getDeviceClass()
Pobieranie klasy urządzenia. |
abstract
long
|
getDeviceDate()
Zwraca datę urządzenia w milisekundach od początku epoki. |
abstract
DeviceDescriptor
|
getDeviceDescriptor()
Zwracać |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Zwracać |
abstract
TestDeviceState
|
getDeviceState()
Pobierz stan urządzenia. |
abstract
long
|
getDeviceTimeOffset(Date date)
Pomocnik do uzyskiwania różnicy czasowej między urządzeniem a danym |
abstract
InputStreamSource
|
getEmulatorOutput()
Pobieranie strumienia danych z stdout i stderr emulatora |
abstract
long
|
getExternalStoreFreeSpace()
Metoda pomocnicza służąca do określenia ilości wolnego miejsca na zewnętrznej pamięci urządzenia. |
abstract
String
|
getFastbootProductType()
Wygodna metoda uzyskiwania typu urządzenia w trybie Fastboot. |
abstract
String
|
getFastbootProductVariant()
Wygodna metoda uzyskiwania typu urządzenia w trybie Fastboot. |
abstract
String
|
getFastbootSerialNumber()
Zwraca numer seryjny trybu fastboot. |
abstract
String
|
getFastbootVariable(String variableName)
Pobiera z urządzenia podawaną wartość zmiennej fastboot. |
abstract
IFileEntry
|
getFileEntry(String path)
Pobiera odwołanie do zdalnego pliku na urządzeniu. |
abstract
IDevice
|
getIDevice()
Zwraca odwołanie do powiązanej biblioteki ddmlib |
abstract
long
|
getIntProperty(String name, long defaultValue)
Zwraca wartość liczby całkowitej danej właściwości na urządzeniu. |
abstract
long
|
getLastExpectedRebootTimeMillis()
Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie (w milisekundach od EPOCH), zwracany przez |
abstract
int
|
getLaunchApiLevel()
Uzyskaj poziom interfejsu API, który został uruchomiony jako pierwszy na urządzeniu. |
abstract
InputStreamSource
|
getLogcat()
Pobiera strumień zrzutów danych logcat. |
abstract
InputStreamSource
|
getLogcat(int maxBytes)
Pobiera strumień zrzutów ostatnich |
abstract
InputStreamSource
|
getLogcatDump()
Pobierz zrzut bieżącego dziennika logcat z urządzenia. |
abstract
InputStreamSource
|
getLogcatSince(long date)
Pobiera strumień zrzutów z zapisanymi danymi logcat od podanej daty. |
abstract
String
|
getMountPoint(String mountName)
Zwraca punkt montowania. |
abstract
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Zwraca |
abstract
|
getMountPointInfo()
Zwraca zanalizowaną wersję informacji w katalogu /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” oraz zwraca obiekt |
abstract
String
|
getProcessPid(String process)
Zwraca PID usługi lub wartość null, jeśli wystąpił błąd. |
abstract
String
|
getProductType()
Wygodna metoda uzyskiwania typu produktu na tym urządzeniu. |
abstract
String
|
getProductVariant()
Wygodna metoda uzyskiwania wersji produktu tego urządzenia. |
abstract
String
|
getProperty(String name)
Pobiera wartość danej właściwości z urządzenia. |
abstract
ITestDevice.RecoveryMode
|
getRecoveryMode()
Uzyskaj informacje o bieżącym trybie odzyskiwania używanym na urządzeniu. |
abstract
String
|
getSerialNumber()
Wygodna metoda uzyskania numeru seryjnego tego urządzenia. |
abstract
|
getTombstones()
Pobieranie i zwracanie listy nagrobków z urządzeń. |
abstract
long
|
getTotalMemory()
Zwraca łączny rozmiar fizycznej pamięci w bajtach lub -1 w przypadku błędu wewnętrznego. |
default
String
|
getTrackingSerial()
Aby zarządzać urządzeniem, uzyskaj numer seryjny używany do śledzenia urządzenia. |
abstract
boolean
|
getUseFastbootErase()
Określ, czy chcesz użyć fastboot erase czy fastboot format do wyczyszczenia partycji na urządzeniu. |
abstract
boolean
|
isAdbRoot()
|
abstract
boolean
|
isAdbTcp()
|
abstract
boolean
|
isAppEnumerationSupported()
Sprawdź, czy platforma na urządzeniu obsługuje enumerację aplikacji |
abstract
boolean
|
isBypassLowTargetSdkBlockSupported()
Sprawdź, czy platforma na urządzeniu obsługuje pomijanie blokady niskiego docelowego poziomu interfejsu SDK podczas instalowania aplikacji |
abstract
boolean
|
isDebugfsMounted()
Sprawdź, czy debugfs jest zamontowany. |
abstract
boolean
|
isDeviceEncrypted()
Zwraca wartość wskazującą, czy urządzenie jest zaszyfrowane. |
abstract
boolean
|
isDirectory(String deviceFilePath)
Zwraca wartość „True”, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość „False”. |
abstract
boolean
|
isEncryptionSupported()
Zwraca wartość wskazującą, czy szyfrowanie jest obsługiwane na urządzeniu. |
abstract
boolean
|
isExecutable(String fullPath)
Zwraca wartość Prawda, jeśli ścieżka do pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie zwraca wartość Fałsz. |
abstract
boolean
|
isHeadless()
Zwraca wartość „true”, jeśli urządzenie jest bez głowicy (bez ekranu), w przeciwnym razie zwraca wartość „false”. |
abstract
boolean
|
isRuntimePermissionSupported()
Sprawdź, 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 na urządzeniu. |
abstract
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Zaloguj wiadomość w logcat urządzenia. |
abstract
void
|
mountDebugfs()
Zamontuj debugfs. |
abstract
void
|
nonBlockingReboot()
Wydając polecenie ponownego uruchomienia urządzenia, wraca po jego wykonaniu i gdy urządzenie nie jest już widoczne dla adb. |
abstract
void
|
postBootSetup()
Postępuj zgodnie z instrukcjami, aby skonfigurować urządzenie do testowania po każdym uruchomieniu. |
default
void
|
postInvocationTearDown()
Ta metoda została wycofana.
Zamiast niej użyj kolumny |
abstract
void
|
postInvocationTearDown(Throwable invocationException)
Dodatkowe czynności związane z czyszczeniem, które są wymagane na urządzeniu, zostaną wykonane po zakończeniu wywołania. |
default
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe czynności wymagane do konfiguracji na urządzeniu, które zostaną wykonane na urządzeniu przed rozpoczęciem procesu wywołania. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir)
Rekursywnie pobieraj zawartość katalogu z urządzenia. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Rekursywnie pobieraj zawartość katalogu z urządzenia. |
abstract
File
|
pullFile(String remoteFilePath, int userId)
Pobiera plik z urządzenia, przechowuje go w lokalnym folderze tymczasowym |
abstract
File
|
pullFile(String remoteFilePath)
Pobiera plik z urządzenia, przechowuje go w lokalnym folderze 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 zewnętrznej pamięci urządzenia, przechowywania go w lokalnym pliku tymczasowym |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath, int userId)
Rekursywnie przesyłaj zawartość katalogu na urządzenie. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath,
Rekursywnie przesyłaj zawartość katalogu na urządzenie, wykluczając niektóre katalogi, które są filtrowane. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath)
Rekursywnie przesyłaj zawartość katalogu na urządzenie. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Wariant |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath)
Przesyłanie pliku na urządzenie. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, int userId)
Przesyłanie pliku na urządzenie. |
abstract
boolean
|
pushString(String contents, String deviceFilePath)
Przesyłanie na urządzenie pliku utworzonego na podstawie ciągu znaków |
abstract
void
|
reboot()
Uruchom ponownie urządzenie w trybie adb. |
abstract
void
|
reboot(String reason)
Uruchom ponownie urządzenie w trybie adb z danymi |
abstract
void
|
rebootIntoBootloader()
Uruchom ponownie urządzenie w trybie programu rozruchowego. |
abstract
void
|
rebootIntoFastbootd()
Uruchom ponownie urządzenie w trybie Fastboot. |
abstract
void
|
rebootIntoRecovery()
Uruchom ponownie urządzenie w trybie odzyskiwania adb. |
abstract
void
|
rebootIntoSideload(boolean autoReboot)
Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb w ramach funkcji odzyskiwania). Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload |
abstract
void
|
rebootIntoSideload()
Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb w ramach funkcji odzyskiwania). Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload |
abstract
void
|
rebootUntilOnline()
Alternatywa dla |
abstract
void
|
rebootUntilOnline(String reason)
Alternatywa dla |
abstract
void
|
rebootUserspace()
Uruchomi ponownie tylko część 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 partycję do zapisu. |
abstract
void
|
remountVendorReadOnly()
Ustaw partycję dostawcy na urządzeniu jako partycję tylko do odczytu. |
abstract
void
|
remountVendorWritable()
Ustaw partycję dostawcy na urządzeniu jako partycję do zapisu. |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Metoda ułatwiająca wykonywanie funkcji |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Uruchamia testy z instrumentacją i zapewnia odzyskiwanie urządzenia. |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
To samo co |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
To samo co |
abstract
void
|
setDate(Date date)
ustawia datę na urządzeniu; Uwaga: ustawienie daty na urządzeniu wymaga uprawnień roota |
abstract
void
|
setOptions(TestDeviceOptions options)
Ustaw |
abstract
boolean
|
setProperty(String propKey, String propValue)
Ustawia daną wartość właściwości na urządzeniu. |
abstract
void
|
setRecovery(IDeviceRecovery recovery)
Ustaw |
abstract
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Ustaw bieżący tryb odzyskiwania do użycia na urządzeniu. |
abstract
void
|
setTrackingSerial(String trackingSerial)
W celu zarządzania urządzeniami śledź numer seryjny, którego używamy do identyfikowania urządzenia. |
abstract
void
|
setUseFastbootErase(boolean useFastbootErase)
Określ, czy chcesz użyć fastboot erase (szybkie kasowanie) czy fastboot format (szybkie formatowanie) do wyczyszczenia partycji na urządzeniu. |
abstract
void
|
startLogcat()
Rozpocznij przechwytywanie danych logcat z urządzenia w tle. |
abstract
boolean
|
startTradeInModeTesting(int timeoutMs)
Włącz testowanie trybu wymiany. |
abstract
void
|
stopEmulatorOutput()
Zamknij i usuń dane wyjściowe emulatora. |
abstract
void
|
stopLogcat()
Zatrzymaj przechwytywanie danych wyjściowych logcat z urządzenia i usuń aktualnie zapisane dane logcat. |
abstract
void
|
stopTradeInModeTesting()
Zatrzymaj 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 przez USB. |
abstract
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Synchronizuje stopniowo zawartość lokalnego katalogu plików na urządzeniu. |
abstract
boolean
|
unlockDevice()
Odblokowuje urządzenie, jeśli jest ono zaszyfrowane. |
abstract
void
|
unmountDebugfs()
Odmontuj debugfs. |
abstract
boolean
|
waitForBootComplete(long timeOut)
Blokuje do momentu ustawienia flagi „boot complete”. |
abstract
boolean
|
waitForDeviceAvailable()
Czeka, aż urządzenie będzie gotowe do testowania. |
abstract
boolean
|
waitForDeviceAvailable(long waitTime)
Czeka, aż urządzenie będzie gotowe do testowania. |
abstract
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Czeka, aż urządzenie będzie gotowe do działania i dostępne, bez uwzględniania ścieżki odzyskiwania. |
abstract
void
|
waitForDeviceBootloader()
Blokuje, dopóki urządzenie nie będzie widoczne w Fastboot. |
abstract
boolean
|
waitForDeviceInRecovery(long waitTime)
Blokuje urządzenie w stanie „adb recovery” (uwaga: jest to stan inny niż |
abstract
boolean
|
waitForDeviceInSideload(long waitTime)
Blokuje urządzenie w stanie „adb sideload”. |
abstract
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blokuje dostęp do urządzenia, np. uniemożliwia dostęp do 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 zareaguje na podstawowe polecenie adb shell. |
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 dana funkcja jest obecnie obsługiwana z uwzględnieniem minimalnego poziomu obsługi. Ta metoda uwzględnia funkcje, które nie zostały jeszcze opublikowane, zanim podniesiesz poziom interfejsu API.
Parametry | |
---|---|
strictMinLevel |
int : najniższy możliwy poziom ścisły obsługujący tę funkcję. |
Zwroty | |
---|---|
boolean |
Prawda, jeśli poziom jest obsługiwany. W przeciwnym razie ma wartość Fałsz. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
clearLogcat
public abstract void clearLogcat ()
Usuwa wszystkie zgromadzone dane logcat.
Jest to przydatne, gdy chcesz mieć pewność, że ITestDevice.getLogcat()
zwróci tylko dane dziennika utworzone po określonym momencie (np. po przeflashowaniu nowej wersji urządzenia).
deleteFile
public abstract void deleteFile (String deviceFilePath)
Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deleteFile
public abstract void deleteFile (String deviceFilePath, int userId)
Metoda pomocnicza do usuwania plików lub katalogów na urządzeniu.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu. |
userId |
int : identyfikator użytkownika, z którego mają zostać usunięte dane. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deviceSoftRestarted
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Metoda pomocnicza do sprawdzania, czy urządzenie zostało zrestartowane, porównując bieżący system_server z poprzednim system_server ProcessInfo
. Aby skorzystać z promocji ProcessInfo
, użyj getProcessByName(String)
.
Parametry | |
---|---|
prevSystemServerProcess |
ProcessInfo : poprzedni proces system_serverProcessInfo . |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie zostało zrestartowane |
Rzuty | |
---|---|
RuntimeException |
jeśli urządzenie ma nieprawidłowy powód uruchamiania; |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deviceSoftRestartedSince
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza służąca do sprawdzania, czy urządzenie zostało ponownie uruchomione od czasu rozpoczęcia epoki UTC na urządzeniu i jego ERROR(/TimeUnit)
. Miękkie ponowne uruchomienie to ponowne uruchomienie system_servera poza twardym restartem urządzenia (np. żądanym przez użytkownika). Bieżący czas UTC urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate()
.
Parametry | |
---|---|
utcEpochTime |
long : czas na urządzeniu w sekundach od początku epoki. |
timeUnit |
TimeUnit : jednostka czasu TimeUnit dla podanego czasu utcEpochTime. |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie zostało zrestartowane |
Rzuty | |
---|---|
RuntimeException |
jeśli urządzenie ma nieprawidłowy powód uruchamiania; |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
disableAdbRoot
public abstract boolean disableAdbRoot ()
Wyłącza rootowanie adb.
Wyłączenie roota adb może spowodować odłączenie urządzenia od adb. Ta metoda zablokuje urządzenie do czasu, gdy będzie ono dostępne.
Zwroty | |
---|---|
boolean |
true w przypadku powodzenia. |
Rzuty | |
---|---|
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 służąca do określenia, czy plik na urządzeniu istnieje.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu do sprawdzenia |
Zwroty | |
---|---|
boolean |
true , jeśli plik istnieje, false w przeciwnym razie. |
Rzuty | |
---|---|
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 roota adb. Jeśli ustawienie „enable-root” ma wartość „false”, zostanie zarejestrowana wiadomość i zwrócona wartość bez włączania root.
Włączenie funkcji adb root może spowodować odłączenie urządzenia od adb. Ta metoda zablokuje urządzenie do czasu, gdy będzie ono dostępne.
Zwroty | |
---|---|
boolean |
true w przypadku powodzenia. |
Rzuty | |
---|---|
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.
Zamiast tego, w miarę możliwości, należy używać funkcji executeShellCommand(String)
, ponieważ zapewnia ona lepszą skuteczność i wykrywanie błędów.
Parametry | |
---|---|
timeout |
long : czas w milisekundach, po którym urządzenie jest uważane za niedziałające. Wartość 0 oznacza brak limitu czasu. |
commandArgs |
String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String |
stdout z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuty | |
---|---|
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.
Zamiast tego, w miarę możliwości, należy używać funkcji executeShellCommand(String)
, ponieważ zapewnia ona lepszą skuteczność i wykrywanie błędów.
Parametry | |
---|---|
commandArgs |
String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String |
stdout z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuty | |
---|---|
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.
Zamiast tego, w miarę możliwości, należy używać funkcji executeShellCommand(String)
, ponieważ zapewnia ona lepszą skuteczność i wykrywanie błędów.
Parametry | |
---|---|
timeout |
long : czas w milisekundach, po którym urządzenie jest uważane za niedziałające. Wartość 0 oznacza brak limitu czasu. |
envMap |
: środowisko do ustawienia dla polecenia |
commandArgs |
String : polecenie adb i argumenty do uruchomienia |
Zwroty | |
---|---|
String |
stdout z polecenia. null , jeśli polecenie nie zostało wykonane. |
Rzuty | |
---|---|
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.
Ma być używany, gdy urządzenie jest już w trybie fastboot.
Parametry | |
---|---|
timeout |
long : czas w milisekundach do wygaśnięcia polecenia |
commandArgs |
String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult |
CommandResult zawierający dane wyjściowe polecenia. |
Rzuty | |
---|---|
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.
Ma być używany, gdy urządzenie jest już w trybie fastboot.
Parametry | |
---|---|
commandArgs |
String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult |
CommandResult zawierający dane wyjściowe polecenia. |
Rzuty | |
---|---|
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.
To samo co executeFastbootCommand(String)
, ale z dłuższym czasem oczekiwania.
Parametry | |
---|---|
commandArgs |
String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult |
CommandResult zawierający dane wyjściowe polecenia. |
Rzuty | |
---|---|
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.
To samo co executeFastbootCommand(String)
, ale z dłuższym czasem oczekiwania.
Parametry | |
---|---|
envVarMap |
: zmienne środowiskowe systemu, z którymi działa polecenie fastboot |
commandArgs |
String : polecenie fastboot i argumenty do uruchomienia |
Zwroty | |
---|---|
CommandResult |
CommandResult zawierający dane wyjściowe polecenia. |
Rzuty | |
---|---|
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 |
Rzuty | |
---|---|
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, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver : IShellOutputReceiver , do którego ma być kierowane wyjście powłoki. |
maxTimeToOutputShellResponse |
long : maksymalny czas, przez który komenda może nie generować żadnej odpowiedzi; jednostka podana w parametrze timeUnit |
timeUnit |
TimeUnit : jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba prób ponownego wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttemptsnie powiedzie się, zostanie rzucony wyjątek DeviceNotResponsiveException. |
Rzuty | |
---|---|
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, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
receiver |
IShellOutputReceiver : IShellOutputReceiver , do którego ma być kierowane wyjście powłoki. |
maxTimeoutForCommand |
long : maksymalny limit czasu wykonania polecenia; jednostka podana w parasm timeUnit |
maxTimeToOutputShellResponse |
long : maksymalny czas, przez który komenda może nie generować odpowiedzi; jednostka podana w parametrze timeUnit |
timeUnit |
TimeUnit : jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba prób ponownego wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie powiedzie się, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
Rzuty | |
---|---|
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 adb shell, powtarzając próbę kilka razy, jeśli polecenie się nie powiedzie.
Prostsza forma 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 ma być kierowane wyjście powłoki. |
Rzuty | |
---|---|
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 adb shell i zwraca wyniki jako obiekt CommandResult
wypełniony odpowiednimi danymi wyjściowymi polecenia, tj. stdout i stderr.
Parametry | |
---|---|
command |
String : polecenie, które ma zostać wykonane. |
Zwroty | |
---|---|
CommandResult |
Wynik w języku CommandResult . |
Rzuty | |
---|---|
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 adb shell i zwraca wyniki jako CommandResult
właściwie wypełnione danymi wyjściowymi polecenia i stderr. Dane wyjściowe stdout są kierowane do określonego strumienia.
Parametry | |
---|---|
command |
String : polecenie, które ma zostać wykonane. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null. |
Zwroty | |
---|---|
CommandResult |
Wynik w języku CommandResult . |
Rzuty | |
---|---|
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 adb shell i zwraca wyniki jako obiekt CommandResult
wypełniony odpowiednimi danymi wyjściowymi polecenia, tj. stdout i stderr.
Parametry | |
---|---|
command |
String : polecenie, które ma zostać wykonane. |
pipeAsInput |
File : ERROR(/File) , który zostanie przekazany jako dane wejściowe do polecenia, lub null. |
Zwroty | |
---|---|
CommandResult |
Wynik w języku CommandResult . |
Rzuty | |
---|---|
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, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
maxTimeoutForCommand |
long : maksymalny limit czasu wykonania polecenia; jednostka podana w parasm timeUnit |
timeUnit |
TimeUnit : jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba prób ponownego wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie powiedzie się, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
Zwroty | |
---|---|
CommandResult |
Rzuty | |
---|---|
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, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
maxTimeoutForCommand |
long : maksymalny limit czasu wykonania polecenia; jednostka podana w parasm timeUnit |
timeUnit |
TimeUnit : jednostka dla maxTimeToOutputShellResponse |
Zwroty | |
---|---|
CommandResult |
Rzuty | |
---|---|
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, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
pipeAsInput |
File : ERROR(/File) , który zostanie przekazany jako dane wejściowe do polecenia, lub null. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null. |
maxTimeoutForCommand |
long : maksymalny limit czasu wykonania polecenia; jednostka podana w parasm timeUnit |
timeUnit |
TimeUnit : jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba prób ponownego wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie powiedzie się, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
Zwroty | |
---|---|
CommandResult |
Rzuty | |
---|---|
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, aby kontrolować zachowanie polecenia.
Parametry | |
---|---|
command |
String : polecenie adb shell do uruchomienia |
pipeAsInput |
File : ERROR(/File) , który zostanie przekazany jako dane wejściowe do polecenia, lub null. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , gdzie standardowe dane wyjściowe zostaną przekierowane lub będą miały wartość null. |
pipeToError |
OutputStream : ERROR(/OutputStream) , gdzie standardowy błąd zostanie przekierowany lub ustawiony na null. |
maxTimeoutForCommand |
long : maksymalny limit czasu wykonania polecenia; jednostka podana w parasm timeUnit |
timeUnit |
TimeUnit : jednostka dla maxTimeToOutputShellResponse |
retryAttempts |
int : maksymalna liczba prób ponownego wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie powiedzie się, zostanie zgłoszony wyjątek DeviceNotResponsiveException. |
Zwroty | |
---|---|
CommandResult |
Rzuty | |
---|---|
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()
= true
, partycja zostanie wyczyszczona za pomocą szybkiego formatowania. Przy następnym uruchomieniu urządzenie musi utworzyć system plików.
W przeciwnym razie używany jest format fastboot, który tworzy nowy system plików na urządzeniu.
Ma być używany, gdy urządzenie jest już w trybie fastboot.
Parametry | |
---|---|
partition |
String : partycja, którą chcesz wymazać |
Zwroty | |
---|---|
CommandResult |
CommandResult zawierający dane wyjściowe polecenia. |
Rzuty | |
---|---|
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; |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. Wersja radiowa zależy od urządzenia, więc może nie zwracać prawidłowych informacji na wszystkich urządzeniach. Ta metoda polega na zwracaniu prawidłowej informacji o wersji za pomocą właściwości gsm.version.baseband.
W przypadku niektórych urządzeń CDMA może to być nieprawidłowe, a zwrócona wersja może nie odpowiadać wersji zgłoszonej przez fastboot. Może też nie zwracać wersji dla radia CDMA.
TL;DR: ta metoda podaje dokładną wersję tylko wtedy, gdy właściwość gsm.version.baseband jest taka sama jak wersja zwrócona przez fastboot getvar version-baseband
.
Zwroty | |
---|---|
String |
wersję pasma podstawowego String lub null , jeśli nie można jej określić (urządzenie nie ma radia lub nie można odczytać ciągu wersji). |
Rzuty | |
---|---|
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 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 właściwości |
defaultValue |
boolean : wartość domyślna zwracana, 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. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchamiania.
Zwroty | |
---|---|
|
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i powodu rozruchu |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia od podanego czasu od epoki na urządzeniu oraz w określonej jednostce czasu. Bieżący czas UTC urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate()
.
Parametry | |
---|---|
utcEpochTime |
long : czas na urządzeniu od początku epoki. |
timeUnit |
TimeUnit : jednostka czasu TimeUnit . |
Zwroty | |
---|---|
|
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i powodu rozruchu |
Rzuty | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public abstract String getBootloaderVersion ()
Wygodna metoda uzyskania wersji programu rozruchowego tego urządzenia.
Spróbuje pobrać wersję bootloadera z obecnego stanu urządzenia. (jeśli urządzenie jest w trybie fastboot, spróbuje pobrać wersję z fastboot)
Zwroty | |
---|---|
String |
wersję programu rozruchowego String lub null , jeśli nie można go znaleźć; |
Rzuty | |
---|---|
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, która jest obecnie używana na urządzeniu.
Alias kompilacji jest zwykle czytelniejszym ciągiem znaków niż identyfikator kompilacji (zwykle numer w przypadku kompilacji Nexusa). Na przykład ostateczna wersja Androida 4.2 ma alias kompilacji JDQ39 i identyfikator kompilacji 573038.
Zwroty | |
---|---|
String |
aliasu kompilacji lub, jeśli nie można go pobrać, użyć identyfikatora kompilacji. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
Pobierz wersję kompilacji dla urządzenia.
Zwroty | |
---|---|
String |
wersję kompilacji lub null, jeśli nie udało się jej pobrać |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Pobierz wersję, która jest obecnie uruchomiona na urządzeniu.
Zwroty | |
---|---|
String |
identyfikator kompilacji lub IBuildInfo.UNKNOWN_BUILD_ID , jeśli nie udało się go pobrać; |
Rzuty | |
---|---|
|
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. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Zwraca element DeviceDescriptor
z pamięci podręcznej, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżący element DeviceDescriptor
.
Zwroty | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Zwraca element DeviceDescriptor
z pamięci podręcznej, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżący element DeviceDescriptor
.
Parametry | |
---|---|
shortDescriptor |
boolean : czy ograniczyć opis do niezbędnych informacji |
Zwroty | |
---|---|
DeviceDescriptor |
getChildren
public abstract String[] getChildren (String deviceFilePath)
Alternatywa dla IFileEntry
, która czasami nie działa z powodu uprawnień.
Parametry | |
---|---|
deviceFilePath |
String : ścieżka na urządzeniu, na której ma być przeprowadzone wyszukiwanie |
Zwroty | |
---|---|
String[] |
Tablica ciągów znaków zawierająca wszystkie pliki na ścieżce na urządzeniu. |
Rzuty | |
---|---|
|
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 ()
Pobieranie klasy 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. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Zwracać DeviceDescriptor
z informacjami o urządzeniu, aby uzyskać informacje bez przekazywania rzeczywistego obiektu urządzenia.
Zwroty | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Zwracać DeviceDescriptor
z informacjami o urządzeniu, aby uzyskać informacje bez przekazywania rzeczywistego obiektu urządzenia.
Parametry | |
---|---|
shortDescriptor |
boolean : czy ograniczyć opis do niezbędnych informacji |
Zwroty | |
---|---|
DeviceDescriptor |
getDeviceState
public abstract TestDeviceState getDeviceState ()
Pobierz stan urządzenia.
Zwroty | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
Pomocnik do uzyskiwania różnicy czasowej między urządzeniem a danym ERROR(/Date)
. Używaj wewnętrznie czasu ery.
Parametry | |
---|---|
date |
Date |
Zwroty | |
---|---|
long |
różnica w milisekundach |
Rzuty | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Pobieranie strumienia danych z stdout i stderr emulatora
Zwroty | |
---|---|
InputStreamSource |
dane wyjściowe emulatora |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
Metoda pomocnicza służąca do określenia ilości wolnego miejsca na zewnętrznej pamięci urządzenia.
Zwroty | |
---|---|
long |
ilość wolnego miejsca w KB. |
Rzuty | |
---|---|
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 urządzenia w trybie Fastboot.
Z tej metody należy korzystać tylko wtedy, gdy urządzenie ma być w trybie szybkiego uruchamiania. W tym przypadku jest to nieco bezpieczniejsza opcja niż ogólna metoda getProductType()
, ponieważ ITestDevice będzie wiedzieć, 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ć; |
Rzuty | |
---|---|
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 urządzenia w trybie Fastboot.
Z tej metody należy korzystać tylko wtedy, gdy urządzenie ma być w trybie szybkiego uruchamiania. W tym przypadku jest to nieco bezpieczniejsza opcja niż ogólna metoda getProductType()
, ponieważ ITestDevice będzie wiedzieć, 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ć; |
Rzuty | |
---|---|
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)
Pobiera z urządzenia podawaną wartość zmiennej fastboot.
Parametry | |
---|---|
variableName |
String : nazwa zmiennej |
Zwroty | |
---|---|
String |
wartość właściwości lub null , jeśli nie istnieje |
Rzuty | |
---|---|
|
UnsupportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Pobiera odwołanie do zdalnego pliku na urządzeniu.
Parametry | |
---|---|
path |
String : ścieżka do pliku do pobrania. Może to być ścieżka bezwzględna lub względna względem znaku „/”. (czyli obsługiwana jest składnia „/system” i „system”). |
Zwroty | |
---|---|
IFileEntry |
IFileEntry lub null , jeśli nie można znaleźć pliku w folderze path |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
Zwraca odwołanie do powiązanej biblioteki ddmlib IDevice
.
Nowe IDevice
może zostać przydzielone przez DDMS za każdym razem, gdy urządzenie rozłączy się i ponownie połączy z adb. Dlatego osoby dzwoniące nie powinny przechowywać odwołania do IDevice
, ponieważ może ono się zdezaktualizować.
Zwroty | |
---|---|
IDevice |
IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
Zwraca wartość liczby całkowitej danej właściwości na urządzeniu.
Parametry | |
---|---|
name |
String : nazwa właściwości |
defaultValue |
long : wartość domyślna zwracana, jeśli właściwość jest pusta lub nie istnieje. |
Zwroty | |
---|---|
long |
wartość właściwości lub wartość defaultValue , jeśli właściwość jest pusta, nie istnieje lub nie ma wartości całkowitej. |
Rzuty | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie (w milisekundach od EPOCH), zwracany przez System.currentTimeMillis()
.
Zwroty | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
Uzyskaj poziom interfejsu API, który został uruchomiony jako pierwszy na urządzeniu. Domyślna wartość to UNKNOWN_API_LEVEL
.
Zwroty | |
---|---|
int |
liczba całkowita wskazująca pierwszy uruchomiony poziom interfejsu API urządzenia; |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Pobiera strumień zrzutów danych logcat.
Działa w 2 trybach:
TestDeviceOptions.getMaxLogcatDataSize()
bajtów bieżącej zawartości przechwytywania logcat w tle.
Zwroty | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Pobiera strumień zrzutów ostatnich maxBytes
zapisanych danych logcat.
Przydaje się, gdy chcesz często tworzyć zrzuty uchwycone dane logcat, nie ponosząc przy tym potencjalnie dużych kosztów miejsca na dysku, jakie wiąże się z uzyskiwaniem całego zrzutu getLogcat()
.
Parametry | |
---|---|
maxBytes |
int : maksymalna ilość danych do zwrócenia. Powinien to być rozmiar, który 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 polecenia getLogcat()
ta metoda zawsze zwraca statyczny zrzut logcat.
Ma to tę wadę, że jeśli urządzenie jest niedostępne, nie zostanie zwrócona żadna wartość.
Zwroty | |
---|---|
InputStreamSource |
InputStreamSource danych logcat. Jeśli nie uda się przechwycić danych logcat, zwrócony zostanie pusty strumień. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Pobiera strumień zrzutów z zapisanymi danymi logcat od podanej daty. Należy użyć czasu na urządzeniu.getDeviceDate()
Parametry | |
---|---|
date |
long : w milisekundach od początku epoki do chwili obecnej.
(można go uzyskać za pomocą polecenia „date +%s”) |
Zwroty | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
Zwraca punkt montowania.
Jeśli informacje z poziomu pamięci podręcznej w IDevice
są niedostępne, wysyła zapytanie bezpośrednio do urządzenia.
DO ZROBIENIA: przenieś to zachowanie do IDevice.getMountPoint(String)
Parametry | |
---|---|
mountName |
String : nazwa punktu podłączania |
Zwroty | |
---|---|
String |
punkt podłączania lub null |
Zobacz też:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Zwraca MountPointInfo
odpowiadający określonej ścieżce punktu podłączania lub null
, jeśli ta ścieżka nie ma nic podłączonego lub nie pojawia się w /proc/mounts jako punkt podłączania.
Parametry | |
---|---|
mountpoint |
String |
Zwroty | |
---|---|
ITestDevice.MountPointInfo |
ERROR(/List) z MountPointInfo zawierający informacje z katalogu „/proc/mounts”. |
Rzuty | |
---|---|
DeviceNotAvailableException |
Zobacz też:
getMountPointInfo
public abstractgetMountPointInfo ()
Zwraca zanalizowaną wersję informacji w katalogu /proc/mounts na urządzeniu.
Zwroty | |
---|---|
|
ERROR(/List) z MountPointInfo zawierający informacje z katalogu „/proc/mounts”. |
Rzuty | |
---|---|
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. |
Rzuty | |
---|---|
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” oraz zwraca obiekt ProcessInfo
z PID-em i czasem rozpoczęcia danego procesu.
Parametry | |
---|---|
processName |
String : ciąg znaków z nazwą procesu. |
Zwroty | |
---|---|
ProcessInfo |
Informacje o procesie o danej nazwie |
Rzuty | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Zwraca PID usługi lub wartość null, jeśli wystąpił błąd.
Parametry | |
---|---|
process |
String : ciąg znaków z nazwą procesu. |
Zwroty | |
---|---|
String |
Rzuty | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
Wygodna metoda uzyskiwania typu produktu na tym urządzeniu.
Ta metoda zadziała, jeśli urządzenie jest w trybie adb lub Fastboot.
Zwroty | |
---|---|
String |
nazwa typu produktu String . nie może być puste |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostało 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 uzyskiwania wersji produktu tego urządzenia.
Ta metoda zadziała, jeśli urządzenie jest w trybie adb lub Fastboot.
Zwroty | |
---|---|
String |
nazwę wersji produktu String lub null , jeśli nie można jej określić; |
Rzuty | |
---|---|
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)
Pobiera wartość danej właściwości z urządzenia.
Parametry | |
---|---|
name |
String : nazwa właściwości |
Zwroty | |
---|---|
String |
wartość właściwości lub null , jeśli nie istnieje |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Uzyskaj informacje o bieżącym trybie odzyskiwania używanym na urządzeniu.
Zwroty | |
---|---|
ITestDevice.RecoveryMode |
bieżący tryb odzyskiwania używany na urządzeniu. |
getSerialNumber
public abstract String getSerialNumber ()
Wygodna metoda uzyskania numeru seryjnego tego urządzenia.
Zwroty | |
---|---|
String |
numer seryjny String , |
getTombstones
public abstractgetTombstones ()
Pobieranie i zwracanie listy nagrobków z urządzeń. Wymaga uprawnień root.
Ta metoda działa w najlepszy możliwy sposób, więc jeśli z jakiegokolwiek powodu nie uda się wyodrębnić jednego nagrobka, nie będzie on widoczny na liście. Metoda zostanie przerwana tylko przez instrukcję DeviceNotAvailableException
.
Zwroty | |
---|---|
|
Lista plików nagłówków, pusta, jeśli nie ma nagłówka. |
Rzuty | |
---|---|
DeviceNotAvailableException |
Zobacz też:
getTotalMemory
public abstract long getTotalMemory ()
Zwraca łączny rozmiar fizycznej pamięci w bajtach lub -1 w przypadku błędu wewnętrznego.
Zwroty | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
Aby zarządzać urządzeniem, uzyskaj numer seryjny używany do śledzenia urządzenia.
Zwroty | |
---|---|
String |
getUseFastbootErase
public abstract boolean getUseFastbootErase ()
Określ, czy chcesz użyć fastboot erase czy fastboot format do wyczyszczenia partycji na urządzeniu.
Zwroty | |
---|---|
boolean |
true , jeśli ma zostać użyte szybkie kasowanie, lub false , jeśli ma zostać użyte szybkie formatowanie. |
Zobacz też:
isAdbRoot
public abstract boolean isAdbRoot ()
Zwroty | |
---|---|
boolean |
true , jeśli urządzenie ma obecnie dostęp roota adb, false w przeciwnym razie. |
Rzuty | |
---|---|
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 innym przypadku. |
isAppEnumerationSupported
public abstract boolean isAppEnumerationSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje enumerację aplikacji
Zwroty | |
---|---|
boolean |
Wartość true, jeśli zliczanie aplikacji jest obsługiwane, w przeciwnym razie wartość false |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje pomijanie blokady niskiego docelowego poziomu interfejsu SDK podczas instalowania aplikacji
Zwroty | |
---|---|
boolean |
Wartość Prawda, jeśli objęcie blokadą niskiego docelowego pakietu SDK jest obsługiwane, w przeciwnym razie wartość Fałsz |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDebugfsMounted
public abstract boolean isDebugfsMounted ()
Sprawdź, czy debugfs jest zamontowany.
Zwroty | |
---|---|
boolean |
true , jeśli debugfs jest zamontowany |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Zwraca wartość wskazującą, czy urządzenie jest zaszyfrowane.
Zwroty | |
---|---|
boolean |
true jeśli urządzenie jest zaszyfrowane. |
Rzuty | |
---|---|
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ść „True”, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość „False”.
Parametry | |
---|---|
deviceFilePath |
String |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Zwraca wartość wskazującą, czy szyfrowanie jest obsługiwane na urządzeniu.
Zwroty | |
---|---|
boolean |
true , jeśli urządzenie obsługuje szyfrowanie. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isExecutable
public abstract boolean isExecutable (String fullPath)
Zwraca wartość Prawda, jeśli ścieżka do pliku na urządzeniu jest plikiem wykonywalnym, w przeciwnym razie zwraca wartość Fałsz.
Parametry | |
---|---|
fullPath |
String |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isHeadless
public abstract boolean isHeadless ()
Zwraca wartość „true”, jeśli urządzenie jest bez głowicy (bez ekranu), w przeciwnym razie zwraca wartość „false”.
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public abstract boolean isRuntimePermissionSupported ()
Sprawdź, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania
Zwroty | |
---|---|
boolean |
Wartość „PRAWDA”, jeśli uprawnienia czasu działania są obsługiwane, w przeciwnym razie wartość „FAŁSZ”. |
Rzuty | |
---|---|
|
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 na urządzeniu.
Parametry | |
---|---|
logger |
ITestLogger : ITestLogger do rejestrowania błędów ANR. |
Zwroty | |
---|---|
boolean |
Wartość true, jeśli rejestrowanie zakończyło się powodzeniem. W przeciwnym razie wartość false. |
Rzuty | |
---|---|
DeviceNotAvailableException |
logOnDevice
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Zaloguj wiadomość w logcat urządzenia. To bezpieczne wywołanie, które nie spowoduje błędu nawet wtedy, gdy logowanie 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 ()
Zamontuj debugfs.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
nonBlockingReboot
public abstract void nonBlockingReboot ()
Wydając polecenie ponownego uruchomienia urządzenia, wraca po jego wykonaniu i gdy urządzenie nie jest już widoczne dla adb.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public abstract void postBootSetup ()
Postępuj zgodnie z instrukcjami, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.
Należy go wywołać po całkowitym uruchomieniu/udostępnieniu urządzenia.
Zazwyczaj nie trzeba wywoływać tej metody w sposób jawny, ponieważ implementacje powinny wykonywać te czynności automatycznie podczas ponownego uruchamiania.
Funkcja może być wywoływana, gdy urządzenie uruchamia się ponownie z powodu innych zdarzeń (np. po zakończeniu polecenia fastboot update).
Rzuty | |
---|---|
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żyj zasady postInvocationTearDown(Throwable)
.
Dodatkowe czynności związane z czyszczeniem, które są wymagane na urządzeniu, zostaną wykonane po zakończeniu wywołania.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Dodatkowe czynności związane z czyszczeniem, które są wymagane na urządzeniu, zostaną wykonane po zakończeniu wywołania.
Parametry | |
---|---|
invocationException |
Throwable : jeśli występuje, to ostatnie wyjątek wywołany przez błąd wywołania. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Dodatkowe czynności wymagane do konfiguracji na urządzeniu, które zostaną wykonane na urządzeniu przed rozpoczęciem procesu wywołania.
Parametry | |
---|---|
info |
IBuildInfo : IBuildInfo urządzenia. |
attributes |
MultiMap : atrybuty zapisane w kontekście wywołania |
Rzuty | |
---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
TargetSetupError |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Rekursywnie pobieraj zawartość katalogu z urządzenia.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku źródłowego zdalnego |
localDir |
File : lokalny katalog, do którego mają być przenoszone pliki |
Zwroty | |
---|---|
boolean |
true – jeśli plik został pobrany. false w innych przypadkach. |
Rzuty | |
---|---|
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)
Rekursywnie pobieraj zawartość katalogu z urządzenia.
Parametry | |
---|---|
deviceFilePath |
String : bezwzględna ścieżka do pliku źródłowego zdalnego |
localDir |
File : lokalny katalog, do którego mają być przenoszone pliki |
userId |
int : identyfikator użytkownika, z którego mają być pobierane dane |
Zwroty | |
---|---|
boolean |
true – jeśli plik został pobrany. false w innych przypadkach. |
Rzuty | |
---|---|
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, przechowuje go w lokalnym folderze tymczasowym ERROR(/File)
i zwraca ten File
.
Parametry | |
---|---|
remoteFilePath |
String : bezwzględna ścieżka do pliku na urządzeniu. |
userId |
int : identyfikator użytkownika, z którego mają być pobierane 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). |
Rzuty | |
---|---|
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, przechowuje go w lokalnym folderze tymczasowym ERROR(/File)
i zwraca ten File
.
Parametry | |
---|---|
remoteFilePath |
String : bezwzględna ścieżka 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). |
Rzuty | |
---|---|
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 : bezwzględna ścieżka do pliku na urządzeniu. |
localFile |
File : lokalny plik do przechowywania treści. Jeśli nie jest pusty, jego zawartość zostanie zastąpiona. |
Zwroty | |
---|---|
boolean |
true – jeśli plik został pomyślnie pobrany. false w innych przypadkach. |
Rzuty | |
---|---|
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 : bezwzględna ścieżka do pliku na urządzeniu. |
localFile |
File : lokalny plik do przechowywania treści. Jeśli nie jest pusty, jego zawartość zostanie zastąpiona. |
userId |
int : identyfikator użytkownika, z którego mają być pobierane dane |
Zwroty | |
---|---|
boolean |
true – jeśli plik został pomyślnie pobrany. false w innych przypadkach. |
Rzuty | |
---|---|
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 : bezwzględna ścieżka 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). |
Rzuty | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
Wygodna metoda pobierania pliku z zewnętrznej pamięci urządzenia, przechowywania 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 w stosunku do punktu zamontowania 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). |
Rzuty | |
---|---|
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)
Rekursywnie przesyłaj zawartość katalogu na urządzenie.
Parametry | |
---|---|
localDir |
File : lokalny katalog do wypychania, |
deviceFilePath |
String : bezwzględna ścieżka do pliku w zdalnym miejscu docelowym |
userId |
int : identyfikator użytkownika, do którego przesyłane są dane |
Zwroty | |
---|---|
boolean |
true – jeśli plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
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)
Rekursywnie przesyłaj zawartość katalogu na urządzenie, wykluczając niektóre katalogi, które są filtrowane.
Parametry | |
---|---|
localDir |
File : lokalny katalog do wypychania, |
deviceFilePath |
String : bezwzględna ścieżka do pliku w zdalnym miejscu docelowym |
excludedDirectories |
: zestaw nazw wykluczonych katalogów, których nie należy przesyłać. |
Zwroty | |
---|---|
boolean |
true – jeśli plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
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)
Rekursywnie przesyłaj zawartość katalogu na urządzenie.
Parametry | |
---|---|
localDir |
File : lokalny katalog do wypychania, |
deviceFilePath |
String : bezwzględna ścieżka do pliku w zdalnym miejscu docelowym |
Zwroty | |
---|---|
boolean |
true – jeśli plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
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ę potrzeby dostawcy treści.
Parametry | |
---|---|
localFile |
File : plik lokalny do przesłania |
deviceFilePath |
String : bezwzględna ścieżka do pliku docelowego na zdalnym serwerze |
evaluateContentProviderNeeded |
boolean : czy sprawdzić, czy potrzebujemy dostawcy treści |
Zwroty | |
---|---|
boolean |
true – jeśli plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
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)
Przesyłanie pliku na urządzenie. Domyślnie za pomocą dostawcy treści.
Parametry | |
---|---|
localFile |
File : plik lokalny do przesłania |
deviceFilePath |
String : bezwzględna ścieżka do pliku docelowego na zdalnym serwerze |
Zwroty | |
---|---|
boolean |
true – jeśli plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
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)
Przesyłanie pliku na urządzenie. Domyślnie za pomocą dostawcy treści.
Parametry | |
---|---|
localFile |
File : plik lokalny do przesłania |
deviceFilePath |
String : bezwzględna ścieżka do pliku docelowego na zdalnym serwerze |
userId |
int : identyfikator użytkownika, do którego przesyłane są dane |
Zwroty | |
---|---|
boolean |
true – jeśli plik został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
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 na podstawie ciągu znaków
Parametry | |
---|---|
contents |
String : zawartość pliku do przesłania |
deviceFilePath |
String : bezwzględna ścieżka do pliku docelowego na zdalnym serwerze |
Zwroty | |
---|---|
boolean |
true – jeśli ciąg znaków został przesłany. false w innych przypadkach. |
Rzuty | |
---|---|
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 ()
Uruchom ponownie urządzenie w trybie adb.
Blokuje, dopóki urządzenie nie stanie się dostępne.
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu |
Uruchom ponownie
public abstract void reboot (String reason)
Uruchom ponownie urządzenie w trybie adb z danymi reason
, które mają być zachowane po ponownym uruchomieniu.
Blokuje, dopóki urządzenie nie stanie się dostępne.
Przyczynę ostatniego ponownego uruchomienia można uzyskać, wysyłając zapytanie do właściwości sys.boot.reason
.
Parametry | |
---|---|
reason |
String : przyczyna ponownego uruchomienia lub null , jeśli nie podano powodu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu |
rebootIntoBootloader
public abstract void rebootIntoBootloader ()
Uruchom ponownie urządzenie w trybie programu rozruchowego.
Blokuje, dopóki urządzenie nie znajdzie się w trybie programu rozruchowego.
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
rebootIntoFastbootd
public abstract void rebootIntoFastbootd ()
Uruchom ponownie urządzenie w trybie Fastboot.
Blokuje, dopóki urządzenie nie znajdzie się w trybie Fastboot.
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
rebootIntoRecovery
public abstract void rebootIntoRecovery ()
Uruchom ponownie urządzenie w trybie odzyskiwania adb.
Blokuje urządzenie, dopóki nie wejdzie w tryb odzyskiwania
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu |
rebootIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb w ramach funkcji odzyskiwania).
Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload
Parametry | |
---|---|
autoReboot |
boolean : czy urządzenie ma się automatycznie ponownie uruchomić po zainstalowaniu aplikacji przez sideload |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli po ponownym uruchomieniu urządzenie nie jest w trybie sideload |
rebootIntoSideload
public abstract void rebootIntoSideload ()
Uruchom ponownie urządzenie w trybie ładowania bocznego adb (zauważ, że jest to specjalny tryb w ramach funkcji odzyskiwania).
Blokuje do momentu, gdy urządzenie wejdzie w tryb sideload
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli po ponownym uruchomieniu urządzenie nie jest w trybie sideload |
rebootUntilOnline
public abstract void rebootUntilOnline ()
Alternatywa dla reboot()
, która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.
Rzuty | |
---|---|
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 powodu. |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli urządzenie nie jest dostępne po ponownym uruchomieniu |
Zobacz też:
rebootUserspace
public abstract void rebootUserspace ()
Uruchomi ponownie tylko część urządzenia w przestrzeni użytkownika.
Blokuje, dopóki urządzenie nie stanie się dostępne.
OSTRZEŻENIE. Funkcja ponownego uruchamiania w przestrzeni użytkownika jest obecnie aktywnie rozwijana. Korzystaj z niej na własne ryzyko.
Rzuty | |
---|---|
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.
Rzuty | |
---|---|
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 spowodować ponowne uruchomienie urządzenia.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountSystemWritable
public abstract void remountSystemWritable ()
Ustaw partycję systemową na urządzeniu jako partycję do zapisu. Może spowodować ponowne uruchomienie urządzenia.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorReadOnly
public abstract void remountVendorReadOnly ()
Ustaw partycję dostawcy na urządzeniu jako partycję tylko do odczytu. Może spowodować ponowne uruchomienie urządzenia.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorWritable
public abstract void remountVendorWritable ()
Ustaw partycję dostawcy na urządzeniu jako partycję do zapisu. Może spowodować ponowne uruchomienie urządzenia.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Metoda ułatwiająca wykonywanie funkcji ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
z co najmniej 1 słuchaczem przekazanym jako parametr.
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , który przeprowadza testy |
listeners |
ITestLifeCycleReceiver : słuchacze wyników testu |
Zwroty | |
---|---|
boolean |
true , jeśli polecenie testowe zostało wykonane. false – jeśli nie udało się go ukończyć, ale udało się przywrócić; |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostało utracone i nie można go przywrócić. Przykład: polecenie testowe nie zostało wykonane i nie udało się przywrócić urządzenia. |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Uruchamia testy z instrumentacją i zapewnia odzyskiwanie urządzenia.
Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a przywrócenie się powiedzie, wszyscy słuchacze zostaną poinformowani o testRunFailed i zwrócona zostanie wartość „false”. Polecenie testu nie zostanie ponownie wykonane. W razie potrzeby rozmówcy mogą spróbować ponownie.
Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a przywrócenie nie powiedzie się, wszyscy słuchacze zostaną poinformowani o testRunFailed i wyjątek DeviceNotAvailableException zostanie rzucony.
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner , który przeprowadza testy |
listeners |
: odbiornik wyników testu |
Zwroty | |
---|---|
boolean |
true , jeśli polecenie testowe zostało wykonane. false , jeśli nie udało się go wykonać z powodu wyjątku dotyczącego komunikacji z urządzeniem, ale odzyskiwanie zakończyło się pomyślnie |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostało utracone i nie można go przywrócić. Przykład: polecenie testowe nie zostało wykonane i nie udało się przywrócić urządzenia. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
To samo co ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
, ale test jest przeprowadzany w przypadku danego użytkownika.
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
To samo co ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, ale test jest przeprowadzany w przypadku danego użytkownika.
Parametry | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
Zwroty | |
---|---|
boolean |
Rzuty | |
---|---|
DeviceNotAvailableException |
setDate
public abstract void setDate (Date date)
ustawia datę na urządzeniu;
Uwaga: ustawienie daty na urządzeniu wymaga uprawnień roota
Parametry | |
---|---|
date |
Date : określenie konkretnej daty; jeśli null , zostanie użyta data hosta |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setOptions
public abstract void setOptions (TestDeviceOptions options)
Ustaw TestDeviceOptions
na urządzeniu
Parametry | |
---|---|
options |
TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
Ustawia daną wartość właściwości na urządzeniu. Wymaga, aby adb root był ustawiony na 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 zakończyło się pomyślnie, w przeciwnym razie zwraca wartość False. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Ustaw IDeviceRecovery
do użycia na tym urządzeniu. Należy go ustawić, gdy urządzenie jest po raz pierwszy przypisywane.
Parametry | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Ustaw bieżący tryb odzyskiwania do użycia na urządzeniu.
Służy do określenia metody odzyskiwania, gdy wystąpi problem z komunikacją urządzenia. Zalecamy stosowanie tej metody tylko wtedy, gdy jest to konieczne (na przykład gdy platforma jest niedostępna).
Parametry | |
---|---|
mode |
ITestDevice.RecoveryMode : czy włączyć tryb „Przywróć do stanu online”. |
setTrackingSerial
public abstract void setTrackingSerial (String trackingSerial)
W celu zarządzania urządzeniami śledź numer seryjny, którego używamy do identyfikowania urządzenia.
Parametry | |
---|---|
trackingSerial |
String |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Określ, czy chcesz użyć fastboot erase (szybkie kasowanie) czy fastboot format (szybkie formatowanie) do wyczyszczenia partycji na urządzeniu.
Parametry | |
---|---|
useFastbootErase |
boolean : true , jeśli chcesz użyć polecenia fastboot erase, lub false , jeśli chcesz użyć polecenia fastboot format. |
Zobacz też:
startLogcat
public abstract void startLogcat ()
Rozpocznij przechwytywanie danych logcat z urządzenia w tle.
Nie będzie mieć zastosowania, jeśli dane logcat są już rejestrowane. Dane można później pobrać za pomocą getLogcat.
Gdy urządzenie nie jest już używane, należy wywołać funkcję stopLogcat()
.
Zwykle nie trzeba wywoływać funkcji startLogcat()
ani stopLogcat()
w kontekście wywołania TF, ponieważ logcat jest uruchamiany i zatrzymywany przez framework TF.
startTradeInModeTesting
public abstract boolean startTradeInModeTesting (int timeoutMs)
Włącz testowanie trybu wymiany. Urządzenie zostanie wyczyszczone i zrestartowane.
Parametry | |
---|---|
timeoutMs |
int |
Zwroty | |
---|---|
boolean |
Wartość „PRAWDA”, jeśli udało się, w przeciwnym razie „FAŁSZ”. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Zamknij i usuń dane wyjściowe emulatora.
stopLogcat
public abstract void stopLogcat ()
Zatrzymaj przechwytywanie danych wyjściowych logcat z urządzenia i usuń aktualnie zapisane dane logcat.
Nie będzie mieć żadnego wpływu, jeśli dane wyjściowe logcat nie są przechwytywane.
stopTradeInModeTesting
public abstract void stopTradeInModeTesting ()
Zatrzymaj testowanie trybu wymiany za dopłatą. Urządzenie uruchomi się ponownie.
Rzuty | |
---|---|
|
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. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Przełącz urządzenie w tryb adb przez USB.
Zwroty | |
---|---|
boolean |
true , jeśli przełączenie się powiodło, w przeciwnym razie false . |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
syncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Synchronizuje stopniowo zawartość lokalnego katalogu plików na urządzeniu.
Określa, które pliki przesłać, porównując sygnatury czasowe plików lokalnych z ich odpowiednikami na zdalnym komputerze. Na urządzenie będą przesyłane tylko nowe lub nieistniejące pliki. Dlatego koszty dodatkowe powinny być stosunkowo niewielkie, jeśli zestaw plików na urządzeniu jest już aktualny.
Ukryte pliki (z nazwami zaczynającymi się od „.”) zostaną zignorowane.
Przykład użycia: syncFiles("/tmp/files", "/sdcard") utworzy katalog /sdcard/files, jeśli jeszcze nie istnieje, i rekursywnie prześle zawartość katalogu /tmp/files do katalogu /sdcard/files.
Parametry | |
---|---|
localFileDir |
File : lokalny katalog plików zawierający pliki do rekurencyjnego przesyłania. |
deviceFilePath |
String : ścieżka bezwzględna do pliku docelowego na zdalnym komputerze. Wszystkie katalogi w ścieżce pliku muszą być czytelne. Przesyłanie do katalogu /data/local/tmp, gdy adb nie jest rootem, zakończy się niepowodzeniem. |
Zwroty | |
---|---|
boolean |
true , jeśli pliki zostały zsynchronizowane. false w innych przypadkach. |
Rzuty | |
---|---|
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ć framework, ale nie wywoła funkcjipostBootSetup()
. Dlatego po zastosowaniu tej metody urządzenie może nie być w pełni gotowe do przetestowania.
Zwroty | |
---|---|
boolean |
true , jeśli operacja się powiedzie lub urządzenie nie jest zaszyfrowane. |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić. |
UnsupportedOperationException |
jeśli szyfrowanie nie jest obsługiwane na urządzeniu. |
unmountDebugfs
public abstract void unmountDebugfs ()
Odmontuj debugfs.
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Blokuje do momentu ustawienia flagi „boot complete”.
Parametry | |
---|---|
timeOut |
long : czas oczekiwania w ms na ustawienie flagi |
Zwroty | |
---|---|
boolean |
Prawda, jeśli w okresie limitu czasu ustawiona jest flaga uruchamiania urządzenia. |
Rzuty | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForDeviceAvailable
public abstract boolean waitForDeviceAvailable ()
Czeka, aż urządzenie będzie gotowe do testowania. Używa domyślnego limitu czasu.
Zwroty | |
---|---|
boolean |
Prawda, jeśli urządzenie jest dostępne, fałsz, jeśli odzyskiwanie jest wyłączone i niedostępne. |
Rzuty | |
---|---|
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 gotowe do testowania.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
Prawda, jeśli urządzenie jest dostępne, fałsz, jeśli odzyskiwanie jest wyłączone i niedostępne. |
Rzuty | |
---|---|
DeviceNotAvailableException |
jeśli urządzenie nadal nie reaguje po upływie czasu oczekiwania. |
waitForDeviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Czeka, aż urządzenie będzie gotowe do działania i dostępne, bez uwzględniania ścieżki odzyskiwania.
Parametry | |
---|---|
waitTime |
long |
Zwroty | |
---|---|
boolean |
Prawda, jeśli urządzenie jest dostępne, fałsz, jeśli nie. |
Rzuty | |
---|---|
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, dopóki urządzenie nie będzie widoczne w Fastboot. Użyj domyślnego limitu czasu.
Rzuty | |
---|---|
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 urządzenie w stanie „adb recovery” (uwaga: jest to stan inny niż IDeviceRecovery
).
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie uruchomi się w trybie odzyskiwania przed upływem czasu.
false w innych przypadkach |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Blokuje urządzenie w stanie „adb sideload”.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
true jeśli urządzenie uruchomi się w trybie sideload przed upływem czasu. false
w innych przypadkach |
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blokuje dostęp do urządzenia, np. uniemożliwia dostęp do adb.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
true , jeśli urządzenie nie będzie dostępne przed upływem czasu.
false w innych przypadkach |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
Blokuje, dopóki urządzenie nie będzie widoczne przez adb. Używa domyślnego limitu czasu
Pamiętaj, że urządzenie może nie reagować na polecenia po zakończeniu. Zamiast tego użyj waitForDeviceAvailable()
.
Rzuty | |
---|---|
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 urządzenie może nie reagować na polecenia po zakończeniu. Zamiast tego użyj waitForDeviceAvailable()
.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Rzuty | |
---|---|
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 zareaguje na podstawowe polecenie adb shell.
Parametry | |
---|---|
waitTime |
long : czas oczekiwania w ms |
Zwroty | |
---|---|
boolean |
true , jeśli urządzenie zacznie reagować przed upływem czasu waitTime. |