INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


Zapewnia niezawodny interfejs API o nieco wyższym poziomie niż ddmlib IDevice.

Ponawia polecenia urządzenia przez konfigurowalny czas i udostępnia interfejs przywracania urządzenia w przypadku urządzeń, które nie odpowiadają.

Podsumowanie

Stałe

int UNKNOWN_API_LEVEL

Wartość domyślna, gdy nie można wykryć poziomu interfejsu API

Metody publiczne

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym poziomie obsługi.

abstract void clearLogcat()

Usuwa wszystkie zgromadzone dane logcat.

abstract void deleteFile(String deviceFilePath)

Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.

abstract void deleteFile(String deviceFilePath, int userId)

Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione przez porównanie bieżącego serwera systemowego z poprzednim serwerem systemowym ProcessInfo.

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione od czasu UTC od początku epoki z urządzenia i jego ERROR(/TimeUnit).

abstract boolean disableAdbRoot()

Wyłącza uprawnienia roota ADB.

abstract boolean doesFileExist(String deviceFilePath)

Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu.

abstract boolean enableAdbRoot()

Włącza uprawnienia roota ADB.

abstract String executeAdbCommand(long timeout, String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

abstract String executeAdbCommand(String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.

abstract String executeAdbCommand(long timeout, envMap, String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

abstract CommandResult executeAdbV2Command(long timeout, envMap, String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

abstract CommandResult executeAdbV2Command(String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.

abstract CommandResult executeAdbV2Command(long timeout, String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

abstract CommandResult executeFastbootCommand(long timeout, String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe.

abstract CommandResult executeFastbootCommand(String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty.

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe.

abstract CommandResult executeLongFastbootCommand( envVarMap, String... commandArgs)

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

abstract void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

Wykonuje podane polecenie powłoki adb, ponawiając je wielokrotnie, jeśli się nie powiedzie.

abstract CommandResult executeShellV2Command(String command)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia i stderr.

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

abstract CommandResult executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

abstract CommandResult executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

abstract CommandResult executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

abstract CommandResult executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

abstract CommandResult fastbootWipePartition(String partition)

Metoda pomocnicza, która czyści partycję urządzenia.

abstract int getApiLevel()

Pobierz poziom interfejsu API urządzenia.

abstract String getBasebandVersion()

Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia.

abstract Integer getBattery()

Zwraca bieżący poziom naładowania baterii urządzenia lub wartość null, jeśli poziom naładowania baterii jest niedostępny.

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Zwraca wartość logiczną danej właściwości.

abstract getBootHistory()

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchamiania i przyczyną uruchomienia.

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem uruchamiania i przyczyną uruchamiania od podanego czasu od początku epoki na urządzeniu oraz określoną jednostką czasu.

abstract String getBootloaderVersion()

Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia.

abstract String getBuildAlias()

Pobierz alias kompilacji, na której obecnie działa urządzenie.

abstract String getBuildFlavor()

Pobierz wersję kompilacji urządzenia.

abstract String getBuildId()

Pobierz kompilację, na której obecnie działa urządzenie.

abstract String getBuildSigningKeys()

Zwraca typ klucza użytego do podpisania obrazu urządzenia.

Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń).

abstract DeviceDescriptor getCachedDeviceDescriptor()

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

abstract String[] getChildren(String deviceFilePath)

Alternatywa dla używania IFileEntry, która czasami nie działa z powodu uprawnień.

abstract AbstractConnection getConnection()

Zwraca połączenie powiązane z urządzeniem.

abstract String getDeviceClass()

Pobierz klasę urządzenia.

abstract long getDeviceDate()

Zwraca datę urządzenia w milisekundach od początku epoki.

abstract DeviceDescriptor getDeviceDescriptor()

Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o urządzeniu bez przekazywania rzeczywistego obiektu urządzenia.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o urządzeniu bez przekazywania rzeczywistego obiektu urządzenia.

abstract TestDeviceState getDeviceState()

Pobierz stan urządzenia.

abstract long getDeviceTimeOffset(Date date)

Funkcja pomocnicza do uzyskiwania różnicy czasu między urządzeniem a podanym ERROR(/Date).

abstract InputStreamSource getEmulatorOutput()

Pobieranie strumienia stdout i stderr emulatora

abstract long getExternalStoreFreeSpace()

Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia.

abstract String getFastbootProductType()

Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.

abstract String getFastbootProductVariant()

Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.

abstract String getFastbootSerialNumber()

Zwraca numer seryjny trybu fastboot.

abstract String getFastbootVariable(String variableName)

Pobierz z urządzenia wartość podanej zmiennej fastboot.

abstract IFileEntry getFileEntry(String path)

Pobieranie odwołania do pliku zdalnego na urządzeniu.

abstract IDevice getIDevice()

Zwraca odwołanie do powiązanej biblioteki ddmlib IDevice.

abstract long getIntProperty(String name, long defaultValue)

Zwraca wartość całkowitą danej właściwości z urządzenia.

abstract long getLastExpectedRebootTimeMillis()

Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie, w milisekundach od EPOCH, zgodnie z wartością zwracaną przez System.currentTimeMillis().

abstract int getLaunchApiLevel()

Pobierz poziom API, na którym urządzenie zostało uruchomione po raz pierwszy.

abstract InputStreamSource getLogcat()

Pobiera strumień zrzutu danych logcat.

abstract InputStreamSource getLogcat(int maxBytes)

Pobiera strumień zrzutu ostatnich maxBytes danych logcat.

abstract InputStreamSource getLogcatDump()

Pobierz zrzut bieżącego dziennika logcat z urządzenia.

abstract InputStreamSource getLogcatSince(long date)

Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty.

abstract String getMountPoint(String mountName)

Zwraca punkt podłączenia.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Zwraca wartość MountPointInfo odpowiadającą określonej ścieżce punktu podłączania lub null, jeśli w tej ścieżce nie ma niczego podłączonego lub w inny sposób nie pojawia się ona w pliku /proc/mounts jako punkt podłączania.

abstract getMountPointInfo()

Zwraca przeanalizowaną wersję informacji z pliku /proc/mounts na urządzeniu.

abstract long getPartitionFreeSpace(String partition)

Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia.

abstract ProcessInfo getProcessByName(String processName)

Metoda pomocnicza uruchamia polecenia „pidof” i „stat” i zwraca obiekt ProcessInfo z identyfikatorem PID i czasem rozpoczęcia procesu.

abstract String getProcessPid(String process)

Zwraca identyfikator procesu usługi lub wartość null, jeśli wystąpił błąd.

abstract String getProductType()

Wygodna metoda uzyskiwania typu produktu tego urządzenia.

abstract String getProductVariant()

Wygodna metoda pobierania wersji produktu tego urządzenia.

abstract String getProperty(String name)

Pobierz z urządzenia wartość danej właściwości.

abstract ITestDevice.RecoveryMode getRecoveryMode()

Pobierz bieżący tryb odzyskiwania używany na urządzeniu.

abstract String getSerialNumber()

Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia.

abstract getTombstones()

Pobierz i zwróć listę znaczników usunięcia z urządzeń.

abstract long getTotalMemory()

Zwraca łączny rozmiar pamięci fizycznej w bajtach lub –1 w przypadku błędu wewnętrznego.

default String getTrackingSerial()

Na potrzeby zarządzania urządzeniem pobierz numer seryjny używany do śledzenia urządzenia.

abstract boolean getUseFastbootErase()

Sprawdza, czy do wyczyszczenia partycji na urządzeniu należy użyć polecenia fastboot erase czy fastboot format.

abstract boolean isAdbRoot()
abstract boolean isAdbTcp()
abstract boolean isAppEnumerationSupported()

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

abstract boolean isBypassLowTargetSdkBlockSupported()

Sprawdzanie, czy platforma na urządzeniu obsługuje omijanie blokady niskiego docelowego pakietu SDK podczas instalowania aplikacji

abstract boolean isDebugfsMounted()

Sprawdź, czy debugfs jest zamontowany.

abstract boolean isDeviceEncrypted()

Wyświetla informację o tym, czy urządzenie jest zaszyfrowane.

abstract boolean isDirectory(String deviceFilePath)

Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość Fałsz.

abstract boolean isEncryptionSupported()

Wyświetla informację o tym, czy urządzenie obsługuje szyfrowanie.

abstract boolean isExecutable(String fullPath)

Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu prowadzi do pliku wykonywalnego, w przeciwnym razie zwraca wartość Fałsz.

abstract boolean isHeadless()

Zwraca wartość „true”, jeśli urządzenie nie ma ekranu, w przeciwnym razie zwraca wartość „false”.

abstract boolean isRuntimePermissionSupported()

Sprawdzanie, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania

abstract boolean isStateBootloaderOrFastbootd()

Zwraca wartość „prawda”, jeśli urządzenie jest w stanie TestDeviceState.FASTBOOT lub TestDeviceState.FASTBOOTD.

abstract boolean logAnrs(ITestLogger logger)

Zbiera i rejestruje błędy ANR z urządzenia.

abstract void logOnDevice(String tag, Log.LogLevel level, String format, Object... args)

Zapisz wiadomość w logcat urządzenia.

abstract void mountDebugfs()

Podłącz debugfs.

abstract void nonBlockingReboot()

Wydaje polecenie ponownego uruchomienia urządzenia i zwraca wynik po zakończeniu polecenia oraz gdy urządzenie nie jest już widoczne dla adb.

abstract void postBootSetup()

Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.

default void postInvocationTearDown()

Ta metoda została wycofana. Użyj w zamian zasady postInvocationTearDown(Throwable).

abstract void postInvocationTearDown(Throwable invocationException)

Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.

default void preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)

Dodatkowe czynności wymagane do skonfigurowania urządzenia, które zostaną wykonane na urządzeniu przed wywołaniem przepływu.

abstract boolean pullDir(String deviceFilePath, File localDir)

Rekursywne pobieranie zawartości katalogu z urządzenia.

abstract boolean pullDir(String deviceFilePath, File localDir, int userId)

Rekursywne pobieranie zawartości katalogu z urządzenia.

abstract File pullFile(String remoteFilePath, int userId)

Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File.

abstract File pullFile(String remoteFilePath)

Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File.

abstract boolean pullFile(String remoteFilePath, File localFile)

Pobiera plik z urządzenia.

abstract boolean pullFile(String remoteFilePath, File localFile, int userId)

Pobiera plik z urządzenia.

abstract String pullFileContents(String remoteFilePath)

Pobiera plik z urządzenia i zwraca jego zawartość.

abstract File pullFileFromExternal(String remoteFilePath)

Wygodna metoda pobierania pliku z pamięci zewnętrznej urządzenia, zapisywania go w lokalnym pliku tymczasowym ERROR(/File) i zwracania odwołania do tego pliku File.

abstract boolean pushDir(File localDir, String deviceFilePath, int userId)

Rekursywne przekazywanie zawartości katalogu na urządzenie.

abstract boolean pushDir(File localDir, String deviceFilePath, excludedDirectories)

Rekursywne przesyłanie zawartości katalogu na urządzenie z wykluczeniem niektórych katalogów, które są filtrowane.

abstract boolean pushDir(File localDir, String deviceFilePath)

Rekursywne przekazywanie zawartości katalogu na urządzenie.

abstract boolean pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

Wariant pushFile(File, String), który może opcjonalnie uwzględniać ocenę potrzeb dostawcy treści.

abstract boolean pushFile(File localFile, String deviceFilePath)

Przekazywanie pliku na urządzenie.

abstract boolean pushFile(File localFile, String deviceFilePath, int userId)

Przekaż plik na urządzenie.

abstract boolean pushString(String contents, String deviceFilePath)

Przesyłanie na urządzenie pliku utworzonego z ciągu znaków

abstract void reboot()

Uruchamia ponownie urządzenie w trybie adb.

abstract void reboot(String reason)

Uruchamia ponownie urządzenie w trybie adb z podanym parametrem reason, który będzie zachowywany po ponownym uruchomieniu.

abstract void rebootIntoBootloader()

Uruchamia ponownie urządzenie w trybie programu rozruchowego.

abstract void rebootIntoFastbootd()

Uruchamia ponownie urządzenie w trybie fastbootd.

abstract void rebootIntoRecovery()

Uruchamia ponownie urządzenie w trybie odzyskiwania adb.

abstract void rebootIntoSideload(boolean autoReboot)

Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania).

Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku

abstract void rebootIntoSideload()

Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania).

Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku

abstract void rebootUntilOnline()

Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

abstract void rebootUntilOnline(String reason)

Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

abstract void rebootUserspace()

Ponowne uruchomienie tylko części urządzenia w przestrzeni użytkownika.

abstract void rebootUserspaceUntilOnline()

Alternatywa dla rebootUserspace() ()}, która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

abstract void remountSystemReadOnly()

Ustaw partycję systemową na urządzeniu jako tylko do odczytu.

abstract void remountSystemWritable()

Ustaw partycję systemową na urządzeniu jako zapisywalną.

abstract void remountVendorReadOnly()

Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu.

abstract void remountVendorWritable()

Ustaw partycję dostawcy na urządzeniu jako zapisywalną.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

Wygodna metoda wykonywania ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z co najmniej 1 odbiorcą przekazanym jako parametr.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Uruchamia testy z instrumentacją i umożliwia przywracanie urządzeń.

abstract boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

Tak samo jak ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), ale przeprowadza test dla danego użytkownika.

abstract boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

Tak samo jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), ale przeprowadza test dla danego użytkownika.

abstract void setDate(Date date)

Ustawia datę na urządzeniu

Uwaga: ustawienie daty na urządzeniu wymaga dostępu do roota.

abstract void setOptions(TestDeviceOptions options)

Ustaw TestDeviceOptions na urządzeniu

abstract boolean setProperty(String propKey, String propValue)

Ustawia na urządzeniu podaną wartość właściwości.

abstract void setRecovery(IDeviceRecovery recovery)

Ustaw numer IDeviceRecovery, który ma być używany na tym urządzeniu.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

Ustaw bieżący tryb odzyskiwania, który ma być używany na urządzeniu.

abstract void setTrackingSerial(String trackingSerial)

Do celów zarządzania urządzeniami śledź numer seryjny, którego używamy do odwoływania się do urządzenia.

abstract void setUseFastbootErase(boolean useFastbootErase)

Określ, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format.

abstract void startLogcat()

Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle.

abstract boolean startTradeInModeTesting(int timeoutMs)

Włącz tryb testowania wymiany za dopłatą.

abstract void stopEmulatorOutput()

Zamknij i usuń dane wyjściowe emulatora.

abstract void stopLogcat()

Zatrzymuje rejestrowanie danych wyjściowych logcat z urządzenia i odrzuca aktualnie zapisane dane logcat.

abstract void stopTradeInModeTesting()

Zakończ testowanie trybu wymiany za dopłatą.

abstract String switchToAdbTcp()

Przełącz urządzenie w tryb adb-over-tcp.

abstract boolean switchToAdbUsb()

Przełącz urządzenie w tryb adb over usb.

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem.

abstract boolean unlockDevice()

Odblokowuje urządzenie, jeśli jest ono zaszyfrowane.

abstract void unmountDebugfs()

Odłącz debugfs.

abstract boolean waitForBootComplete(long timeOut)

Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia.

abstract boolean waitForDeviceAvailable()

Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania.

abstract boolean waitForDeviceAvailable(long waitTime)

Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania.

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Czeka, aż urządzenie będzie odpowiadać i będzie dostępne, bez uwzględniania ścieżki przywracania.

abstract void waitForDeviceBootloader()

Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot.

abstract boolean waitForDeviceInRecovery(long waitTime)

Blokuje możliwość przejścia urządzenia w stan „adb recovery” (uwaga: różni się od IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Blokuje możliwość przejścia urządzenia w stan „adb sideload”

abstract boolean waitForDeviceNotAvailable(long waitTime)

Blokuje urządzenie, aby było niedostępne, tzn. nie było widoczne w adb.

abstract void waitForDeviceOnline()

Blokuje, dopóki urządzenie nie będzie widoczne przez adb.

abstract void waitForDeviceOnline(long waitTime)

Blokuje, dopóki urządzenie nie będzie widoczne przez adb.

abstract boolean waitForDeviceShell(long waitTime)

Czeka, aż urządzenie odpowie na podstawowe polecenie powłoki adb.

Stałe

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Wartość domyślna, gdy nie można wykryć poziomu interfejsu API

Wartość stała: -1 (0xffffffff)

Metody publiczne

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Sprawdź, czy funkcja jest obecnie obsługiwana na minimalnym poziomie obsługi. Ta metoda uwzględnia jeszcze nieopublikowane funkcje, zanim zostanie podniesiony poziom interfejsu API.

Parametry
strictMinLevel int: najniższy możliwy poziom, który obsługuje tę funkcję.

Zwroty
boolean Wartość „prawda”, jeśli poziom jest obsługiwany. W przeciwnym razie ma wartość Fałsz.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

Usuwa wszystkie zgromadzone dane logcat.

Jest to przydatne w sytuacjach, gdy chcesz mieć pewność, że funkcja ITestDevice.getLogcat() zwraca tylko dane logowania wygenerowane po określonym momencie (np. po wgraniu nowej wersji urządzenia).

deleteFile

public abstract void deleteFile (String deviceFilePath)

Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.

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

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

Metoda pomocnicza do usuwania pliku lub katalogu na urządzeniu.

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

userId int: identyfikator użytkownika, z którego chcesz usunąć dane.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione przez porównanie bieżącego serwera systemowego z poprzednim serwerem systemowym ProcessInfo. Aby skorzystać z promocji ProcessInfo, użyj getProcessByName(String).

Parametry
prevSystemServerProcess ProcessInfo: poprzedni proces system_server ProcessInfo.

Zwroty
boolean true – jeśli urządzenie zostało ponownie uruchomione.

Zgłasza
RuntimeException jeśli urządzenie ma nietypowy powód uruchomienia.
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza sprawdzająca, czy urządzenie zostało ponownie uruchomione od czasu UTC od początku epoki z urządzenia i jego ERROR(/TimeUnit). Miękkie ponowne uruchomienie oznacza ponowne uruchomienie serwera systemowego poza twardym ponownym uruchomieniem urządzenia (np. na żądanie). Bieżący czas urządzenia utcEpochTime w milisekundach można uzyskać za pomocą metody getDeviceDate().

Parametry
utcEpochTime long: czas urządzenia w sekundach od początku epoki.

timeUnit TimeUnit: jednostka czasu TimeUnit dla danego parametru utcEpochTime.

Zwroty
boolean true – jeśli urządzenie zostało ponownie uruchomione.

Zgłasza
RuntimeException jeśli urządzenie ma nietypowy powód uruchomienia.
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

Wyłącza uprawnienia roota adb.

Wyłączenie uprawnień roota adb może spowodować odłączenie urządzenia od adb. Ta metoda będzie blokować działanie programu do momentu, aż urządzenie będzie dostępne.

Zwroty
boolean true, jeśli się uda.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

Metoda pomocnicza do sprawdzania, czy plik istnieje na urządzeniu.

Parametry
deviceFilePath String: bezwzględna ścieżka do pliku na urządzeniu, który ma zostać sprawdzony.

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

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

enableAdbRoot

public abstract boolean enableAdbRoot ()

Włącza uprawnienia roota ADB. Jeśli ustawienie „enable-root” ma wartość „false”, zostanie zarejestrowany komunikat i zwrócona wartość bez włączania dostępu do roota.

Włączenie adb root może spowodować odłączenie urządzenia od adb. Ta metoda będzie blokować działanie programu do momentu, aż urządzenie będzie dostępne.

Zwroty
boolean true, jeśli się uda.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

commandArgs String: polecenie adb i argumenty do uruchomienia;

Zwroty
String standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
commandArgs String: polecenie adb i argumenty do uruchomienia;

Zwroty
String standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

envMap : środowisko, które ma być ustawione dla polecenia

commandArgs String: polecenie adb i argumenty do uruchomienia;

Zwroty
String standardowe wyjście polecenia. null, jeśli nie udało się wykonać polecenia.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

envMap : środowisko, które ma być ustawione dla polecenia

commandArgs String: polecenie adb i argumenty do uruchomienia;

Zwroty
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
commandArgs String: polecenie adb i argumenty do uruchomienia;

Zwroty
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie adb jako polecenie systemowe z określonym czasem oczekiwania.

executeShellCommand(String) należy w miarę możliwości stosować zamiast niego, ponieważ ta metoda zapewnia lepsze wykrywanie błędów i skuteczność.

Parametry
timeout long: czas w milisekundach, po którym urządzenie jest uznawane za nieodpowiadające; 0L oznacza brak limitu czasu.

commandArgs String: polecenie adb i argumenty do uruchomienia;

Zwroty
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe.

Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.

Parametry
timeout long: czas w milisekundach, po którym polecenie wygasa.

commandArgs String: polecenie fastboot i argumenty do uruchomienia;

Zwroty
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Metoda pomocnicza, która wykonuje polecenie fastboot jako polecenie systemowe z domyślnym limitem czasu wynoszącym 2 minuty.

Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.

Parametry
commandArgs String: polecenie fastboot i argumenty do uruchomienia;

Zwroty
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe.

Identyczna z funkcją executeFastbootCommand(String), ale używa dłuższego czasu oczekiwania.

Parametry
commandArgs String: polecenie fastboot i argumenty do uruchomienia;

Zwroty
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

Metoda pomocnicza, która wykonuje długotrwałe polecenie fastboot jako polecenie systemowe ze zmiennymi środowiskowymi systemu.

Identyczna z funkcją executeFastbootCommand(String), ale używa dłuższego czasu oczekiwania.

Parametry
envVarMap : zmienne środowiskowe systemu, z którymi jest uruchamiane polecenie fastboot;

commandArgs String: polecenie fastboot i argumenty do uruchomienia;

Zwroty
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellCommand

public abstract String executeShellCommand (String command)

Metoda pomocnicza, która wykonuje polecenie adb shell i zwraca dane wyjściowe jako String.

Parametry
command String: polecenie adb shell do uruchomienia

Zwroty
String dane wyjściowe powłoki,

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki.

maxTimeToOutputShellResponse long: maksymalny czas, w którym polecenie może nie generować odpowiedzi; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki.

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

maxTimeToOutputShellResponse long: maksymalny czas, w którym polecenie może nie generować żadnej odpowiedzi; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Wykonuje podane polecenie powłoki adb, ponawiając je wielokrotnie, jeśli się nie powiedzie.

Prostsza forma funkcji executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) z wartościami domyślnymi.

Parametry
command String: polecenie adb shell do uruchomienia

receiver IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

Parametry
command String: polecenie, które ma zostać uruchomione.

Zwroty
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia i stderr. stdout jest kierowany do określonego strumienia.

Parametry
command String: polecenie, które ma zostać uruchomione.

pipeToOutput OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.

Zwroty
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

Metoda pomocnicza, która wykonuje polecenie powłoki adb i zwraca wyniki jako obiekt CommandResult prawidłowo wypełniony danymi wyjściowymi stanu polecenia, stdout i stderr.

Parametry
command String: polecenie, które ma zostać uruchomione.

pipeAsInput File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.

Zwroty
CommandResult Wynik w języku: CommandResult.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwroty
CommandResult

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

Zwroty
CommandResult

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

pipeAsInput File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.

pipeToOutput OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwroty
CommandResult

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Wykonuje polecenie adb shell z większą liczbą parametrów, które pozwalają kontrolować działanie polecenia.

Parametry
command String: polecenie adb shell do uruchomienia

pipeAsInput File: ERROR(/File), który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.

pipeToOutput OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.

pipeToError OutputStream: ERROR(/OutputStream) miejsce, do którego zostanie przekierowany standardowy błąd, lub wartość null.

maxTimeoutForCommand long: maksymalny czas oczekiwania na wykonanie polecenia; jednostka określona w timeUnit

timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse

retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia w przypadku niepowodzenia z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.

Zwroty
CommandResult

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Metoda pomocnicza, która czyści partycję urządzenia.

Jeśli getUseFastbootErase() ma wartość true, do wyczyszczenia partycji zostanie użyte polecenie fastboot erase. Przy następnym uruchomieniu urządzenia musi ono utworzyć system plików. W przeciwnym razie używany jest format fastboot, który utworzy nowy system plików na urządzeniu.

Oczekiwane użycie, gdy urządzenie jest już w trybie Fastboot.

Parametry
partition String: partycja do wyczyszczenia

Zwroty
CommandResult obiekt CommandResult zawierający dane wyjściowe polecenia;

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getApiLevel

public abstract int getApiLevel ()

Pobierz poziom interfejsu API urządzenia. Domyślna wartość to UNKNOWN_API_LEVEL.

Zwroty
int liczba całkowita wskazująca poziom interfejsu API urządzenia;

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Wygodna metoda uzyskiwania wersji pasma podstawowego (radia) tego urządzenia. Pobieranie wersji radia jest zależne od urządzenia, więc może nie zwracać prawidłowych informacji na wszystkich urządzeniach. Ta metoda korzysta z właściwości gsm.version.baseband, aby zwracać prawidłowe informacje o wersji. W przypadku niektórych urządzeń CDMA ta wartość jest niedokładna, a wersja zwrócona w tym miejscu może nie być zgodna z wersją zgłoszoną przez fastboot i może nie zwracać wersji radia CDMA. W skrócie: ta metoda podaje dokładną wersję tylko wtedy, gdy właściwość gsm.version.baseband jest taka sama jak wersja zwracana przez fastboot getvar version-baseband.

Zwroty
String String wersja pasma podstawowego lub null, jeśli nie można jej określić (urządzenie nie ma radia lub nie można odczytać ciągu znaków wersji);

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getBattery

public abstract Integer getBattery ()

Zwraca bieżący poziom naładowania baterii urządzenia lub wartość null, jeśli poziom naładowania baterii jest niedostępny.

Zwroty
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Zwraca wartość logiczną danej właściwości.

Parametry
name String: nazwa usługi

defaultValue boolean: wartość domyślna, która ma zostać zwrócona, jeśli właściwość jest pusta lub nie istnieje.

Zwroty
boolean true, jeśli właściwość ma wartość "1", "y", "yes", "on" lub "true"; false, jeśli właściwość ma wartość "0", "n", "no", "off", "false" lub defaultValue; w przeciwnym razie.

Zgłasza
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchomienia.

Zwroty
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu

Zgłasza
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Metoda pomocnicza zbiera mapę historii uruchamiania z czasem i przyczyną uruchamiania od podanego czasu od początku epoki na urządzeniu oraz określoną jednostką czasu. Aktualny czas urządzenia utcEpochTime w milisekundach można uzyskać za pomocą metody getDeviceDate().

Parametry
utcEpochTime long: czas urządzenia od początku epoki.

timeUnit TimeUnit: jednostka czasu TimeUnit.

Zwroty
Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu

Zgłasza
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Wygodna metoda uzyskiwania wersji programu rozruchowego tego urządzenia.

Spróbuje pobrać wersję programu rozruchowego z bieżącego stanu urządzenia. (np. jeśli urządzenie jest w trybie Fastboot Mode, spróbuje pobrać wersję z tego trybu).

Zwroty
String wersję programu rozruchowego String lub null, jeśli nie można jej znaleźć;

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getBuildAlias

public abstract String getBuildAlias ()

Pobierz alias kompilacji, na której obecnie działa urządzenie.

Alias kompilacji jest zwykle bardziej czytelnym ciągiem znaków niż identyfikator kompilacji (zwykle numer w przypadku kompilacji na urządzenia Nexus). Na przykład ostateczna wersja Androida 4.2 ma alias kompilacji JDQ39 i identyfikator kompilacji 573038.

Zwroty
String alias kompilacji lub identyfikator kompilacji, jeśli nie można go pobrać.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Pobierz wersję kompilacji urządzenia.

Zwroty
String wersja kompilacji lub wartość null, jeśli nie można jej pobrać.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Pobierz kompilację, na której obecnie działa urządzenie.

Zwroty
String identyfikator kompilacji lub IBuildInfo.UNKNOWN_BUILD_ID, jeśli nie udało się go pobrać.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

Zwraca typ klucza użytego do podpisania obrazu urządzenia.

Urządzenia z Androidem są zwykle podpisywane kluczami testowymi (jak w AOSP) lub kluczami wersji (kontrolowanymi przez poszczególnych producentów urządzeń).

Zwroty
String Klucz podpisywania, jeśli został znaleziony, w przeciwnym razie wartość null.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

Zwroty
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przypisane, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

Parametry
shortDescriptor boolean: czy ograniczyć opis do minimum informacji

Zwroty
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

Alternatywa dla używania IFileEntry, która czasami nie działa z powodu uprawnień.

Parametry
deviceFilePath String: ścieżka na urządzeniu, w której ma się odbywać wyszukiwanie.

Zwroty
String[] Tablica ciągów znaków zawierająca wszystkie pliki w ścieżce na urządzeniu.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Zwraca połączenie powiązane z urządzeniem.

Zwroty
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Pobierz klasę urządzenia.

Zwroty
String klasa urządzenia String,

getDeviceDate

public abstract long getDeviceDate ()

Zwraca datę urządzenia w milisekundach od początku epoki.

Zwroty
long datę urządzenia w formacie epoki;

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o urządzeniu bez przekazywania rzeczywistego obiektu urządzenia.

Zwroty
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Zwróć DeviceDescriptor z informacji o urządzeniu, aby uzyskać informacje o urządzeniu bez przekazywania rzeczywistego obiektu urządzenia.

Parametry
shortDescriptor boolean: czy ograniczyć opis do minimum informacji

Zwroty
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Pobierz stan urządzenia.

Zwroty
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Funkcja pomocnicza do uzyskiwania różnicy czasu między urządzeniem a podanym ERROR(/Date). wewnętrznie używać czasu epoki.

Parametry
date Date

Zwroty
long różnicę w milisekundach,

Zgłasza
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Pobieranie strumienia stdout i stderr emulatora

Zwroty
InputStreamSource dane wyjściowe emulatora,

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Metoda pomocnicza do określania ilości wolnego miejsca w pamięci zewnętrznej urządzenia.

Zwroty
long ilość wolnego miejsca w KB,

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getFastbootProductType

public abstract String getFastbootProductType ()

Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.

Tej metody należy używać tylko wtedy, gdy urządzenie ma być w trybie fastboot. Jest to nieco bezpieczniejsza odmiana ogólnej metody getProductType(), ponieważ w tym przypadku interfejs ITestDevice wie, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.

Zwroty
String nazwę typu produktu String lub null, jeśli nie można jej określić.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Wygodna metoda uzyskiwania typu produktu tego urządzenia, gdy jest ono w trybie fastboot.

Tej metody należy używać tylko wtedy, gdy urządzenie ma być w trybie fastboot. Jest to nieco bezpieczniejsza odmiana ogólnej metody getProductType(), ponieważ w tym przypadku interfejs ITestDevice wie, jak przywrócić urządzenie do trybu fastboot, jeśli jest ono w nieprawidłowym stanie lub nie odpowiada.

Zwroty
String nazwę typu produktu String lub null, jeśli nie można jej określić.

Zgłasza
DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Zwraca numer seryjny trybu fastboot.

Zwroty
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Pobierz z urządzenia wartość podanej zmiennej fastboot.

Parametry
variableName String: nazwa zmiennej;

Zwroty
String wartość właściwości lub null, jeśli nie istnieje.

Zgłasza
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Pobieranie odwołania do pliku zdalnego na urządzeniu.

Parametry
path String: ścieżka pliku do pobrania. Może to być ścieżka bezwzględna lub ścieżka względna do „/” (obsługiwana jest składnia „/system” i „system”).

Zwroty
IFileEntry wartość IFileEntry lub null, jeśli nie można znaleźć pliku pod podanym adresem path.

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Zwraca odwołanie do powiązanej biblioteki ddmlib IDevice.

Nowy IDevice może być przydzielany przez DDMS za każdym razem, gdy urządzenie zostanie odłączone i ponownie połączone z adb. Dlatego wywołujący nie powinni przechowywać odwołania do IDevice, ponieważ może ono stać się nieaktualne.

Zwroty
IDevice IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Zwraca wartość całkowitą danej właściwości z urządzenia.

Parametry
name String: nazwa usługi

defaultValue long: wartość domyślna, która ma zostać zwrócona, jeśli właściwość jest pusta lub nie istnieje.

Zwroty
long wartość właściwości lub defaultValue, jeśli właściwość jest pusta, nie istnieje lub nie ma wartości całkowitej.

Zgłasza
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Zwraca ostatni czas, w którym interfejsy API Tradefed wywołały ponowne uruchomienie, w milisekundach od EPOCH, zgodnie z wartością zwracaną przez System.currentTimeMillis().

Zwroty
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Pobierz poziom API, na którym urządzenie zostało uruchomione po raz pierwszy. Domyślna wartość to UNKNOWN_API_LEVEL.

Zwroty
int liczba całkowita wskazująca pierwszy uruchomiony poziom interfejsu API urządzenia;

Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Pobiera strumień zrzutu danych logcat.

Działa w 2 trybach:

  • Jeśli logcat jest obecnie rejestrowany w tle, funkcja zwróci maksymalnie TestDeviceOptions.getMaxLogcatDataSize() bajtów bieżącej zawartości rejestrowanego w tle logcatu.
  • W przeciwnym razie zwróci statyczny zrzut danych logcat, jeśli urządzenie odpowiada.

    Zwroty
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Pobiera strumień zrzutu ostatnich maxBytes danych logcat.

    Przydatne w sytuacjach, gdy chcesz często robić zrzuty przechwyconych danych logcat bez ponoszenia potencjalnie dużych kosztów związanych z zajmowaniem miejsca na dysku przez pełny zrzut getLogcat().

    Parametry
    maxBytes int: maksymalna ilość danych do zwrócenia. Powinna to być ilość, która zmieści się w pamięci.

    Zwroty
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    Pobierz zrzut bieżącego dziennika logcat z urządzenia. W przeciwieństwie do metody getLogcat() ta metoda zawsze zwraca statyczny zrzut logcat.

    Ma tę wadę, że jeśli urządzenie jest niedostępne, nic nie zostanie zwrócone.

    Zwroty
    InputStreamSource InputStreamSource danych logcat. Jeśli nie uda się przechwycić danych logcat, zwracany jest pusty strumień.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Pobiera strumień zrzutu przechwyconych danych logcat od podanej daty. Należy używać czasu na urządzeniu getDeviceDate().

    Parametry
    date long: w milisekundach od początku epoki, kiedy rozpocząć zrzut, aż do chwili obecnej. (można go uzyskać za pomocą polecenia „date +%s”)

    Zwroty
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Zwraca punkt podłączenia.

    Wysyła zapytanie bezpośrednio do urządzenia, jeśli informacje w pamięci podręcznej w IDevice są niedostępne.

    DO ZROBIENIA: przenieś to działanie do IDevice.getMountPoint(String)

    Parametry
    mountName String: nazwa punktu podłączania

    Zwroty
    String punkt podłączenia lub null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Zwraca wartość MountPointInfo odpowiadającą określonej ścieżce punktu podłączania lub null, jeśli w tej ścieżce nie ma niczego podłączonego lub w inny sposób nie pojawia się ona w pliku /proc/mounts jako punkt podłączania.

    Parametry
    mountpoint String

    Zwroty
    ITestDevice.MountPointInfo ERROR(/List)MountPointInfo zawierający informacje z pliku „/proc/mounts”.

    Zgłasza
    DeviceNotAvailableException

    Zobacz też:

    getMountPointInfo

    public abstract  getMountPointInfo ()

    Zwraca przeanalizowaną wersję informacji z pliku /proc/mounts na urządzeniu.

    Zwroty
    ERROR(/List)MountPointInfo zawierający informacje z pliku „/proc/mounts”.

    Zgłasza
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    Metoda pomocnicza do określania ilości wolnego miejsca na partycji urządzenia.

    Parametry
    partition String

    Zwroty
    long ilość wolnego miejsca w KB,

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Metoda pomocnicza uruchamia polecenia „pidof” i „stat” i zwraca obiekt ProcessInfo z identyfikatorem PID i czasem rozpoczęcia danego procesu.

    Parametry
    processName String: ciąg znaków z nazwą procesu.

    Zwroty
    ProcessInfo ProcessInfo dla danego procesu o nazwie processName

    Zgłasza
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Zwraca identyfikator procesu usługi lub wartość null, jeśli wystąpił błąd.

    Parametry
    process String: Ciąg znaków z nazwą procesu.

    Zwroty
    String

    Zgłasza
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Wygodna metoda uzyskiwania typu produktu tego urządzenia.

    Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.

    Zwroty
    String nazwę typu produktu String; Nie może mieć wartości null.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie można go przywrócić lub jeśli nie można określić typu produktu.

    getProductVariant

    public abstract String getProductVariant ()

    Wygodna metoda pobierania wersji produktu tego urządzenia.

    Ta metoda działa, gdy urządzenie jest w trybie adb lub fastboot.

    Zwroty
    String nazwę wersji produktu String lub null, jeśli nie można jej określić;

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    getProperty

    public abstract String getProperty (String name)

    Pobierz z urządzenia wartość danej właściwości.

    Parametry
    name String: nazwa usługi

    Zwroty
    String wartość właściwości lub null, jeśli nie istnieje.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Pobierz bieżący tryb odzyskiwania używany na urządzeniu.

    Zwroty
    ITestDevice.RecoveryMode bieżący tryb odzyskiwania używany na urządzeniu;

    getSerialNumber

    public abstract String getSerialNumber ()

    Wygodny sposób na uzyskanie numeru seryjnego tego urządzenia.

    Zwroty
    String numer seryjny String;

    getTombstones

    public abstract  getTombstones ()

    Pobierz i zwróć listę znaczników usunięcia z urządzeń. Wymaga dostępu do roota.

    metoda działa w trybie „najlepsze starania”, więc jeśli z jakiegokolwiek powodu nie uda się pobrać znacznika usunięcia, nie będzie go na liście. Tylko instrukcja DeviceNotAvailableException spowoduje wcześniejsze zakończenie metody.

    Zwroty
    Lista plików tombstone. Jeśli nie ma plików tombstone, lista jest pusta.

    Zgłasza
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

    Zwraca łączny rozmiar pamięci fizycznej w bajtach lub –1 w przypadku błędu wewnętrznego.

    Zwroty
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Na potrzeby zarządzania urządzeniem pobierz numer seryjny używany do śledzenia urządzenia.

    Zwroty
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Sprawdza, czy do wyczyszczenia partycji na urządzeniu należy użyć polecenia fastboot erase czy fastboot format.

    Zwroty
    boolean true czy zostanie użyte polecenie fastboot erase, czy false polecenie fastboot format.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Zwroty
    boolean true – jeśli urządzenie ma obecnie dostęp do roota przez ADB, false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Zwroty
    boolean true jeśli urządzenie jest połączone z adb-over-tcp, false w przeciwnym razie.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

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

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

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Sprawdzanie, czy platforma na urządzeniu obsługuje omijanie blokady niskiego docelowego pakietu SDK podczas instalowania aplikacji

    Zwroty
    boolean Wartość true, jeśli obejście blokady niskiego docelowego pakietu SDK jest obsługiwane, w przeciwnym razie wartość false.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Sprawdź, czy debugfs jest zamontowany.

    Zwroty
    boolean true, jeśli debugfs jest zamontowany

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Wyświetla informację o tym, czy urządzenie jest zaszyfrowane.

    Zwroty
    boolean true – jeśli urządzenie jest zaszyfrowane.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Zwraca wartość Prawda, jeśli ścieżka na urządzeniu jest katalogiem, w przeciwnym razie zwraca wartość Fałsz.

    Parametry
    deviceFilePath String

    Zwroty
    boolean

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Wyświetla informację o tym, czy urządzenie obsługuje szyfrowanie.

    Zwroty
    boolean true – jeśli urządzenie obsługuje szyfrowanie.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    Zwraca wartość Prawda, jeśli ścieżka pliku na urządzeniu prowadzi do pliku wykonywalnego, w przeciwnym razie zwraca wartość Fałsz.

    Parametry
    fullPath String

    Zwroty
    boolean

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Zwraca wartość „true”, jeśli urządzenie nie ma ekranu, w przeciwnym razie zwraca wartość „false”.

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Sprawdzanie, czy platforma na urządzeniu obsługuje przyznawanie uprawnień w czasie działania

    Zwroty
    boolean Wartość true, jeśli uprawnienia czasu działania są obsługiwane. W przeciwnym razie wartość false.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Zwraca wartość „prawda”, jeśli urządzenie jest w stanie TestDeviceState.FASTBOOT lub TestDeviceState.FASTBOOTD.

    Zwroty
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Zbiera i rejestruje błędy ANR z urządzenia.

    Parametry
    logger ITestLogger: ITestLogger do rejestrowania błędów ANR.

    Zwroty
    boolean Wartość true, jeśli rejestrowanie się powiodło. W przeciwnym razie wartość false.

    Zgłasza
    DeviceNotAvailableException

    logOnDevice

    public abstract void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    Zapisz wiadomość w logcat urządzenia. Jest to bezpieczne wywołanie, które nie spowoduje błędu nawet wtedy, gdy rejestrowanie się nie powiedzie.

    Parametry
    tag String: tag, pod którym rejestrujemy wiadomość w logcat.

    level Log.LogLevel: poziom debugowania wiadomości w logcat.

    format String: format wiadomości.

    args Object: argumenty, które mają zostać zastąpione za pomocą String.format().

    mountDebugfs

    public abstract void mountDebugfs ()

    Podłącz debugfs.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

    Wydaje polecenie ponownego uruchomienia urządzenia i zwraca wynik po zakończeniu polecenia oraz gdy urządzenie nie jest już widoczne dla adb.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    Wykonaj instrukcje, aby skonfigurować urządzenie do testowania po każdym uruchomieniu.

    Powinien być wywoływany po pełnym uruchomieniu lub udostępnieniu urządzenia.

    W normalnych okolicznościach nie trzeba wywoływać tej metody bezpośrednio, ponieważ implementacje powinny automatycznie wykonywać te czynności podczas ponownego uruchamiania.

    Może być konieczne wywołanie tej funkcji, gdy urządzenie uruchamia się ponownie z powodu innych zdarzeń (np. po zakończeniu polecenia aktualizacji fastboot).

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    postInvocationTearDown

    public void postInvocationTearDown ()

    Ta metoda została wycofana.
    Zamiast niej używaj zasady postInvocationTearDown(Throwable).

    Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Dodatkowe czynności wymagane do wyczyszczenia urządzenia, które zostaną wykonane po zakończeniu wywołania.

    Parametry
    invocationException Throwable: jeśli wystąpił błąd wywołania, jest to ostateczny wyjątek.

    preInvocationSetup

    public void preInvocationSetup (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Dodatkowe czynności wymagane do skonfigurowania urządzenia, które zostaną wykonane na urządzeniu przed wywołaniem przepływu.

    Parametry
    info IBuildInfo: IBuildInfo urządzenia.

    attributes MultiMap: atrybuty przechowywane w kontekście wywołania.

    Zgłasza
    com.android.tradefed.targetprep.TargetSetupError
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Rekursywne pobieranie zawartości katalogu z urządzenia.

    Parametry
    deviceFilePath String: bezwzględna ścieżka pliku źródła zdalnego

    localDir File: lokalny katalog, do którego mają być pobierane pliki.

    Zwroty
    boolean true jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir, 
                    int userId)

    Rekursywne pobieranie zawartości katalogu z urządzenia.

    Parametry
    deviceFilePath String: bezwzględna ścieżka pliku źródła zdalnego

    localDir File: lokalny katalog, do którego mają być pobierane pliki.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane

    Zwroty
    boolean true jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

    Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File.

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

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.

    Zwroty
    File ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pullFile

    public abstract File pullFile (String remoteFilePath)

    Pobiera plik z urządzenia, zapisuje go w lokalnym tymczasowym ERROR(/File) i zwraca ten File.

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

    Zwroty
    File ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Pobiera plik z urządzenia.

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

    localFile File: lokalny plik, w którym będą przechowywane treści. Jeśli nie jest pusta, zawartość zostanie zastąpiona.

    Zwroty
    boolean true – jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    Pobiera plik z urządzenia.

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

    localFile File: lokalny plik, w którym będą przechowywane treści. Jeśli nie jest pusta, zawartość zostanie zastąpiona.

    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.

    Zwroty
    boolean true – jeśli plik został pobrany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Pobiera plik z urządzenia i zwraca jego zawartość.

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

    Zwroty
    String String zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    Wygodna metoda pobierania pliku z pamięci zewnętrznej urządzenia, zapisywania go w lokalnym pliku tymczasowym ERROR(/File) i zwracania odwołania do tego pliku File.

    Parametry
    remoteFilePath String: ścieżka do pliku na urządzeniu, względna w stosunku do punktu montowania zewnętrznej pamięci masowej urządzenia

    Zwroty
    File ERROR(/File) zawierający zawartość pliku na urządzeniu lub null, jeśli kopiowanie nie powiodło się z jakiegokolwiek powodu (w tym z powodu problemów z systemem plików hosta).

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                    int userId)

    Rekursywne przekazywanie zawartości katalogu na urządzenie.

    Parametry
    localDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego

    userId int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie.

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Rekursywne przesyłanie zawartości katalogu na urządzenie z wykluczeniem niektórych katalogów, które są filtrowane.

    Parametry
    localDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego

    excludedDirectories : Zestaw nazw wykluczonych katalogów, które nie powinny być przesyłane.

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Rekursywne przekazywanie zawartości katalogu na urządzenie.

    Parametry
    localDir File: katalog lokalny do wypychania

    deviceFilePath String: bezwzględna ścieżka pliku do zdalnego miejsca docelowego

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    boolean evaluateContentProviderNeeded)

    Wariant pushFile(File, String), który może opcjonalnie uwzględniać ocenę potrzeb dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    deviceFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    evaluateContentProviderNeeded boolean: czy sprawdzić, czy potrzebujemy dostawcy treści.

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Przekaż plik na urządzenie. Domyślnie używa dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    deviceFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    int userId)

    Przekaż plik na urządzenie. Domyślnie używa dostawcy treści.

    Parametry
    localFile File: plik lokalny do przesłania

    deviceFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    userId int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie.

    Zwroty
    boolean true – jeśli plik został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Przesyłanie na urządzenie pliku utworzonego z ciągu znaków

    Parametry
    contents String: zawartość pliku do przesłania,

    deviceFilePath String: bezwzględna ścieżka pliku w miejscu docelowym

    Zwroty
    boolean true, jeśli ciąg znaków został przesłany. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    Uruchom ponownie

    public abstract void reboot ()

    Uruchamia ponownie urządzenie w trybie adb.

    Blokuje działanie do momentu, aż urządzenie będzie dostępne.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest dostępne po ponownym uruchomieniu;

    Uruchom ponownie

    public abstract void reboot (String reason)

    Uruchamia ponownie urządzenie w trybie adb z podanym parametrem reason, który będzie zachowywany po ponownym uruchomieniu.

    Blokuje do momentu, aż urządzenie stanie się dostępne.

    Przyczynę ostatniego ponownego uruchomienia można uzyskać, wysyłając zapytanie o właściwość sys.boot.reason.

    Parametry
    reason String: przyczyna ponownego uruchomienia lub null, jeśli nie podano przyczyny.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest dostępne po ponownym uruchomieniu;

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Uruchamia ponownie urządzenie w trybie programu rozruchowego.

    Blokuje działanie do momentu przejścia urządzenia w tryb programu rozruchowego.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Uruchamia ponownie urządzenie w trybie fastbootd.

    Blokuje działanie do momentu przejścia urządzenia w tryb fastbootd.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

    Uruchamia ponownie urządzenie w trybie odzyskiwania adb.

    Blokuje do momentu przejścia urządzenia w tryb odzyskiwania

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest dostępne po ponownym uruchomieniu;

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania).

    Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku

    Parametry
    autoReboot boolean: czy po wgraniu aplikacji urządzenie ma się automatycznie uruchomić ponownie.

    Zgłasza
    DeviceNotAvailableException jeśli po ponownym uruchomieniu urządzenie nie jest w trybie instalacji z boku.

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Uruchamia ponownie urządzenie w trybie instalowania z innego urządzenia (jest to specjalny tryb w ramach trybu odzyskiwania).

    Blokuje do momentu przejścia urządzenia w tryb wczytywania z boku

    Zgłasza
    DeviceNotAvailableException jeśli po ponownym uruchomieniu urządzenie nie jest w trybie instalacji z boku.

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest dostępne po ponownym uruchomieniu;

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

    Alternatywa dla reboot(), która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

    Parametry
    reason String: przyczyna ponownego uruchomienia lub null, jeśli nie podano przyczyny.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie jest niedostępne po ponownym uruchomieniu;

    Zobacz też:

    rebootUserspace

    public abstract void rebootUserspace ()

    Ponowne uruchomienie tylko części urządzenia w przestrzeni użytkownika.

    Blokuje do momentu, aż urządzenie stanie się dostępne.

    OSTRZEŻENIE. Ponowne uruchamianie w przestrzeni użytkownika jest obecnie w fazie rozwoju. Korzystasz z tej funkcji na własne ryzyko.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest dostępne po ponownym uruchomieniu;

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    Alternatywa dla rebootUserspace() ()}, która blokuje tylko do momentu, gdy urządzenie jest online, czyli widoczne dla adb.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest dostępne po ponownym uruchomieniu;

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

    Ustaw partycję systemową na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

    Ustaw partycję systemową na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Ustaw partycję dostawcy na urządzeniu jako tylko do odczytu. Może ponownie uruchomić urządzenie.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

    Ustaw partycję dostawcy na urządzeniu jako zapisywalną. Może ponownie uruchomić urządzenie.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    Wygodna metoda wykonywania ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) z co najmniej 1 odbiorcą przekazanym jako parametr.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy.

    listeners ITestLifeCycleReceiver: odbiorcy wyników testu

    Zwroty
    boolean true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć, ale przywracanie zakończyło się powodzeniem.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie można go przywrócić, np. polecenie testowe nie zostało wykonane, a przywracanie się nie powiodło.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Uruchamia testy z instrumentacją i umożliwia przywracanie urządzeń.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu, a funkcja zwróci wartość „false”. Polecenie testowe nie zostanie ponownie uruchomione. W razie potrzeby rozmówcy mogą ponowić próbę.

    Jeśli połączenie z urządzeniem zostanie utracone przed zakończeniem testu, a odzyskiwanie się nie powiedzie, wszyscy odbiorcy zostaną poinformowani o niepowodzeniu testu (testRunFailed), a następnie zostanie zgłoszony wyjątek DeviceNotAvailableException.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy.

    listeners : odbiorcy wyników testu

    Zwroty
    boolean true jeśli polecenie testowe zostało wykonane. false, jeśli nie udało się go ukończyć z powodu wyjątku w komunikacji z urządzeniem, ale przywracanie zakończyło się pomyślnie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie można go przywrócić, np. polecenie testowe nie zostało wykonane, a przywracanie się nie powiodło.

    runInstrumentationTestsAsUser

    public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    Podobnie jak ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), ale przeprowadza test dla danego użytkownika.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    Tak samo jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), ale przeprowadza test dla danego użytkownika.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Zwroty
    boolean

    Zgłasza
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Ustawia datę na urządzeniu

    Uwaga: ustawienie daty na urządzeniu wymaga dostępu do roota.

    Parametry
    date Date: określ konkretną datę; jeśli null, użyje daty hosta.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Ustaw TestDeviceOptions dla urządzenia

    Parametry
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Ustawia na urządzeniu podaną wartość właściwości. Wymaga, aby adb root miało wartość true.

    Parametry
    propKey String: klucz, który ma zostać ustawiony.

    propValue String: wartość właściwości do ustawienia.

    Zwroty
    boolean zwraca True, jeśli polecenie setprop zostało wykonane prawidłowo, a w przeciwnym razie zwraca wartość False.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Ustaw numer IDeviceRecovery, który ma być używany na tym urządzeniu. Należy go ustawić, gdy urządzenie zostanie po raz pierwszy przydzielone.

    Parametry
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Ustaw bieżący tryb odzyskiwania, który ma być używany na urządzeniu.

    Służy do określania metody odzyskiwania, która ma być używana w przypadku problemu z komunikacją z urządzeniem. Zalecamy używanie tej metody tylko w razie potrzeby (np. gdy platforma nie działa itp.).

    Parametry
    mode ITestDevice.RecoveryMode: czy tryb „przywracaj tylko do momentu połączenia z siecią” ma być włączony.

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

    Do celów zarządzania urządzeniami śledź numer seryjny, którego używamy do odwoływania się do urządzenia.

    Parametry
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Określ, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie fastboot erase czy fastboot format.

    Parametry
    useFastbootErase boolean: true, jeśli ma być użyte polecenie fastboot erase, lub false, jeśli ma być użyte polecenie fastboot format.

    startLogcat

    public abstract void startLogcat ()

    Rozpocznij przechwytywanie danych wyjściowych logcat z urządzenia w tle.

    Nie będzie to miało wpływu, jeśli dane wyjściowe logcat są już rejestrowane. Dane można później pobrać za pomocą funkcji getLogcat.

    Gdy urządzenie nie jest już używane, należy wywołać funkcję stopLogcat().

    Zwykle nie trzeba wywoływać funkcji startLogcat()stopLogcat() w kontekście wywołania TF, ponieważ framework TF uruchamia i zatrzymuje logcat.

    startTradeInModeTesting

    public abstract boolean startTradeInModeTesting (int timeoutMs)

    Włącz tryb testowania wymiany za dopłatą. Urządzenie zostanie wyczyszczone i uruchomione ponownie.

    Parametry
    timeoutMs int

    Zwroty
    boolean Wartość „prawda”, jeśli operacja się powiodła. W przeciwnym razie „fałsz”.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Zamknij i usuń dane wyjściowe emulatora.

    stopLogcat

    public abstract void stopLogcat ()

    Zatrzymuje rejestrowanie danych wyjściowych logcat z urządzenia i odrzuca aktualnie zapisane dane logcat.

    Nie będzie mieć wpływu, jeśli dane wyjściowe logcat nie są rejestrowane.

    stopTradeInModeTesting

    public abstract void stopTradeInModeTesting ()

    Zakończ testowanie trybu wymiany za dopłatą. Urządzenie uruchomi się ponownie.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Przełącz urządzenie w tryb adb-over-tcp.

    Zwroty
    String numer seryjny urządzenia TCP lub null, jeśli nie można było przełączyć urządzenia.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Przełącz urządzenie w tryb adb over usb.

    Zwroty
    boolean true, jeśli przełączanie się powiodło, w przeciwnym razie false.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Przyrostowo synchronizuje zawartość lokalnego katalogu plików z urządzeniem.

    Decyduje, które pliki przesłać, porównując sygnatury czasowe plików lokalnych z ich zdalnymi odpowiednikami. Na urządzenie zostaną przesłane tylko „nowsze” lub nieistniejące pliki. Dlatego obciążenie powinno być stosunkowo małe, jeśli zestaw plików na urządzeniu jest już aktualny.

    Ukryte pliki (których nazwy zaczynają się od „.”) zostaną zignorowane.

    Przykład użycia: syncFiles("/tmp/files", "/sdcard") utworzy katalog /sdcard/files, jeśli jeszcze nie istnieje, i rekursywnie przeniesie zawartość katalogu /tmp/files do katalogu /sdcard/files.

    Parametry
    localFileDir File: lokalny katalog plików zawierający pliki do rekurencyjnego wypychania.

    deviceFilePath String: ścieżka bezwzględna do katalogu głównego zdalnego miejsca docelowego. Wszystkie katalogi w tej ścieżce pliku muszą być czytelne. Na przykład próba przesłania pliku do katalogu /data/local/tmp, gdy adb nie ma uprawnień roota, zakończy się niepowodzeniem.

    Zwroty
    boolean true, jeśli pliki zostały zsynchronizowane. false w przeciwnym razie.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    unlockDevice

    public abstract boolean unlockDevice ()

    Odblokowuje urządzenie, jeśli jest ono zaszyfrowane.

    Ta metoda może ponownie uruchomić platformę, ale nie wywoła funkcji postBootSetup(). Dlatego urządzenie może nie być w pełni gotowe do testowania, gdy ta metoda zwróci wartość.

    Zwroty
    boolean true – jeśli operacja się powiedzie lub urządzenie nie jest zaszyfrowane.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.
    UnsupportedOperationException jeśli urządzenie nie obsługuje szyfrowania.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Odłącz debugfs.

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Blokuje do momentu ustawienia flagi zakończenia rozruchu urządzenia.

    Parametry
    timeOut long: czas w milisekundach, przez jaki należy czekać na ustawienie flagi.

    Zwroty
    boolean wartość true, jeśli flaga zakończenia uruchamiania urządzenia jest ustawiona w okresie oczekiwania;

    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania. Używa domyślnego limitu czasu.

    Zwroty
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Czeka, aż urządzenie będzie odpowiadać i będzie dostępne do testowania.

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli przywracanie jest wyłączone i niedostępne.

    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nadal nie odpowiada po upływie czasu waitTime.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Czeka, aż urządzenie będzie odpowiadać i będzie dostępne, bez uwzględniania ścieżki przywracania.

    Parametry
    waitTime long

    Zwroty
    boolean Wartość Prawda, jeśli urządzenie jest dostępne, lub Fałsz, jeśli jest niedostępne.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

    Blokuje działanie, dopóki urządzenie nie będzie widoczne w trybie fastboot. Użyj domyślnego limitu czasu.

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Blokuje możliwość przejścia urządzenia w stan „adb recovery” (uwaga: różni się od IDeviceRecovery).

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean true jeśli urządzenie uruchomi się w trybie odzyskiwania przed upływem czasu. W innych przypadkach false

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Blokuje możliwość przejścia urządzenia w stan „adb sideload”

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean true, jeśli urządzenie uruchomi się w trybie sideload przed upływem czasu. W innych przypadkach false

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blokuje urządzenie, aby było niedostępne, tzn. nie było widoczne w adb.

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean true, jeśli urządzenie stanie się niedostępne przed upływem czasu. W innych przypadkach false

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Blokuje się, dopóki urządzenie nie będzie widoczne przez adb. Używa domyślnego limitu czasu

    Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

    Blokuje, dopóki urządzenie nie będzie widoczne przez adb.

    Pamiętaj, że po zakończeniu procesu urządzenie może nie reagować na polecenia. Zamiast niej używaj zasady waitForDeviceAvailable().

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zgłasza
    DeviceNotAvailableException jeśli połączenie z urządzeniem zostanie utracone i nie będzie można go przywrócić.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

    Czeka, aż urządzenie odpowie na podstawowe polecenie powłoki adb.

    Parametry
    waitTime long: czas oczekiwania w milisekundach

    Zwroty
    boolean true, jeśli urządzenie zacznie odpowiadać przed upływem czasu waitTime.