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 odzyskiwania urządzenia w przypadku urządzeń, które nie odpowiadają.

Podsumowanie

Stałe

int UNKNOWN_API_LEVEL

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

Metody publiczne

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

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

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 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, Map<String, String> 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 executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... commandArgs)

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

abstract CommandResult executeAdbV2Command(long timeout, Map<String, String> envMap, 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(Map<String, String> 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)

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

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 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, 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, 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)

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, 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 executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, 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 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, IShellOutputReceiver receiver)

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 fastbootOemRamdumpNow()

Metoda pomocnicza, która wywołuje zrzut pamięci RAM w trybie fastboot.

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Pobierz poziom interfejsu API urządzenia.

abstract int getApiLevelFull()

Podobna do funkcji getApiLevel(), ale zwraca pełną wersję.

abstract String getBasebandVersion()

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

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

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

abstract Map<Long, String> getBootHistory()

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

abstract Map<Long, String> 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 przydzielone, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Zwraca buforowaną wartość DeviceDescriptor, jeśli urządzenie jest przydzielone, 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 nim bez przekazywania rzeczywistego obiektu urządzenia.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

abstract TestDeviceState getDeviceState()

Pobierz stan urządzenia.

abstract long getDeviceTimeOffset(Date date)

Pomaga w określaniu różnicy czasu między urządzeniem a danym 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 nic nie jest podłączone lub w inny sposób nie pojawia się w /proc/mounts jako punkt podłączania.

abstract List<ITestDevice.MountPointInfo> 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 danego 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()

Metoda ułatwiająca uzyskanie 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 List<File> 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()

Określa, czy do wyczyszczenia partycji na urządzeniu ma być używane polecenie 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 jest plikiem wykonywalnym, 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 zwolnienia miejsca na urządzeniu, 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, long timeout)

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 File i zwraca ten File.

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

Pobiera plik z urządzenia.

abstract File pullFile(String remoteFilePath)

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

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

Pobiera plik z urządzenia.

abstract boolean pullFile(String remoteFilePath, File localFile)

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 tymczasowym File i zwracania odwołania do tego 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, Set<String> 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, int userId)

Przekaż plik na urządzenie.

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

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

abstract boolean pushFile(File localFile, String deviceFilePath)

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.

default String reboot(String command, String reason)

Ponownie uruchamia urządzenie za pomocą podanego parametru command.

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

Blokuje działanie 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 odzyskiwania).

Blokuje działanie 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, tzn. 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()

Umożliwia zapisywanie na partycji dostawcy na urządzeniu.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, Collection<ITestLifeCycleReceiver> listeners)

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

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

Wygodna metoda wykonywania runInstrumentationTests(IRemoteAndroidTestRunner,Collection) z co najmniej 1 odbiornikiem przekazanym jako parametr.

abstract boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)

Podobnie jak 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 uruchamia 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 dla urządzenia

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 śledzimy 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()

Przestań rejestrować dane wyjściowe logcat z urządzenia i odrzuć 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 na odpowiedź urządzenia i jego dostępność 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 urządzenie w stanie „adb sideload”

abstract boolean waitForDeviceNotAvailable(long waitTime)

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

abstract void waitForDeviceOnline()

Blokuje do momentu, aż urządzenie będzie widoczne przez adb.

abstract void waitForDeviceOnline(long waitTime)

Blokuje do momentu, aż urządzenie 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 obsługiwanym poziomie. Ta metoda uwzględnia jeszcze nieopublikowane funkcje, zanim poziom interfejsu API zostanie podniesiony.

Parametry
strictMinLevel int: najniższy możliwy poziom, który obsługuje tę funkcję.
Zwraca
boolean 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 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 pliku na urządzeniu.
userId int: identyfikator użytkownika do usunięcia.
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_serverProcessInfo.
Zwraca
boolean true – jeśli urządzenie zostało zrestartowane programowo.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
RuntimeException jeśli urządzenie ma nietypowy powód uruchomienia,
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 TimeUnit. Miękkie ponowne uruchomienie oznacza ponowne uruchomienie system_server poza twardym ponownym uruchomieniem urządzenia (np. na żądanie). Bieżący czas utcEpochTime urządzenia 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.
Zwraca
boolean true – jeśli urządzenie zostało zrestartowane programowo.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
RuntimeException jeśli urządzenie ma nietypowy powód uruchomienia,
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.

Zwraca
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: ścieżka bezwzględna do pliku na urządzeniu, który ma zostać sprawdzony
Zwraca
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.

Zwraca
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.
Zwraca
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.
Zwraca
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, 
                Map<String, String> 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 Map: środowisko, które ma być ustawione dla polecenia
commandArgs String: polecenie adb i argumenty do uruchomienia.
Zwraca
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 (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.
Zwraca
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.
Zwraca
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, 
                Map<String, String> envMap, 
                int retryAttempts, 
                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 Map: środowisko, które ma być ustawione dla polecenia
retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.
commandArgs String: polecenie adb i argumenty do uruchomienia.
Zwraca
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, 
                Map<String, String> 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 Map: środowisko, które ma być ustawione dla polecenia
commandArgs String: polecenie adb i argumenty do uruchomienia.
Zwraca
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.
Zwraca
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.
Zwraca
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.
Zwraca
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 (Map<String, String> 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 Map: zmienne środowiskowe systemu, z którymi uruchomiono polecenie fastboot
commandArgs String: polecenie fastboot i argumenty do uruchomienia.
Zwraca
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
Zwraca
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ć żadnej odpowiedzi; jednostka określona w timeUnit
timeUnit TimeUnit: jednostka dla maxTimeToOutputShellResponse
retryAttempts int: maksymalna liczba ponownych prób wykonania polecenia, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli operacje 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,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ć.

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, jeśli nie powiedzie się ono 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ć.

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.
Zwraca
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, 
                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: File, który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.
pipeToOutput OutputStream: 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, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.
Zwraca
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
Zwraca
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: File, który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.
Zwraca
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: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.
Zwraca
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, 
                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: File, który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.
pipeToOutput OutputStream: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.
pipeToError OutputStream: 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, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.
Zwraca
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, 
                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
pipeAsInput File: File, który zostanie przekazany jako dane wejściowe do polecenia, lub wartość null.
pipeToOutput OutputStream: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście, lub wartość null.
pipeToError OutputStream: 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
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, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.
Zwraca
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, jeśli nie powiedzie się ono z powodu wyjątku. Jeśli retryAttempts nie zostaną wykonane, zostanie zgłoszony wyjątek DeviceNotResponsiveException.
Zwraca
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, 
                IShellOutputReceiver receiver)

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.
receiver IShellOutputReceiver: IShellOutputReceiver, do którego mają być kierowane dane wyjściowe powłoki.
Zwraca
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ć.

fastbootOemRamdumpNow

public abstract CommandResult fastbootOemRamdumpNow ()

Metoda pomocnicza, która wywołuje zrzut pamięci RAM w trybie fastboot.

Ta metoda wykonuje polecenie „oem ramdump now”. W przeciwieństwie do ERROR(/#executeFastbootCommand()) nie próbuje ponownie wykonać polecenia ani przywrócić urządzenia, jeśli polecenie się nie powiedzie lub stan jest nieprawidłowy, ponieważ zamierzonym wynikiem jest awaria urządzenia. Oczekiwane użycie, gdy urządzenie jest już w trybie fastboot.

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

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 tworzy nowy system plików na urządzeniu.

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

Parametry
partition String: partycja do wyczyszczenia
Zwraca
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.

Zwraca
int liczba całkowita wskazująca poziom interfejsu API urządzenia.
Zgłasza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getApiLevelFull

public abstract int getApiLevelFull ()

Podobna do funkcji getApiLevel(), ale zwraca pełną wersję.

Zwraca
int liczba całkowita wskazująca pełny 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 informacja 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.

Zwraca
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 baterii urządzenia lub wartość null, jeśli poziom baterii jest niedostępny.

Zwraca
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.
Zwraca
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 Map<Long, String> getBootHistory ()

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

Zwraca
Map<Long, String> Mapa czasu rozruchu (czas UTC w sekundach od początku epoki) i przyczyny rozruchu
Zgłasza
DeviceNotAvailableException

getBootHistorySince

public abstract Map<Long, String> 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. Bieżący czas utcEpochTime urządzenia w milisekundach można uzyskać za pomocą metody getDeviceDate().

Parametry
utcEpochTime long: czas urządzenia od początku epoki.
timeUnit TimeUnit: jednostka czasu TimeUnit.
Zwraca
Map<Long, String> 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 urządzenia w jego obecnym stanie. (np. jeśli urządzenie jest w trybie Fastboot Mode, spróbuje pobrać wersję z tego trybu).

Zwraca
String wersję String programu rozruchowego 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.

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

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

Zwraca
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ń).

Zwraca
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 przydzielone, w przeciwnym razie zwraca bieżącą wartość DeviceDescriptor.

Zwraca
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Parametry
shortDescriptor boolean: czy ograniczyć opis do minimum informacji
Zwraca
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.
Zwraca
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.

Zwraca
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Pobierz klasę urządzenia.

Zwraca
String klasa urządzenia String,

getDeviceDate

public abstract long getDeviceDate ()

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

Zwraca
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 nim bez przekazywania rzeczywistego obiektu urządzenia.

Zwraca
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Parametry
shortDescriptor boolean: czy ograniczyć opis do minimum informacji
Zwraca
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Pobierz stan urządzenia.

Zwraca
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Pomaga w określaniu różnicy czasu między urządzeniem a danym Date. wewnętrznie używać czasu epoki.

Parametry
date Date

Zwraca
long różnica w milisekundach
Zgłasza
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Pobieranie strumienia stdout i stderr emulatora

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

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

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

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

Zwraca
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

Parametry
variableName String: nazwa zmiennej;
Zwraca
String wartość właściwości lub null, jeśli nie istnieje.
Zgłasza
UnsupportedOperationException
DeviceNotAvailableException
UnsupportedOperationException

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 „/” (np. obsługiwana jest składnia „/system” i „system”).
Zwraca
IFileEntry 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 od adb i ponownie połączone. Dlatego wywołujący nie powinni przechowywać odwołania do IDevice, ponieważ może ono stać się nieaktualne.

Zwraca
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.
Zwraca
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().

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

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

    Zwraca
    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, nie ponosząc potencjalnie dużych kosztów związanych z zajętością miejsca na dysku, które wiążą się z uzyskaniem pełnego zrzutu getLogcat().

    Parametry
    maxBytes int: maksymalna ilość danych do zwrócenia. Powinna to być ilość, która zmieści się w pamięci.
    Zwraca
    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.

    Zwraca
    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”)
    Zwraca
    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
    Zwraca
    String punkt podłączania 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 nic nie jest podłączone lub w inny sposób nie pojawia się w /proc/mounts jako punkt podłączania.

    Parametry
    mountpoint String

    Zwraca
    ITestDevice.MountPointInfo List MountPointInfo zawierający informacje z pliku „/proc/mounts”.
    Zgłasza
    DeviceNotAvailableException

    Zobacz też:

    getMountPointInfo

    public abstract List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

    Zwraca
    List<ITestDevice.MountPointInfo> 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

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

    Zwraca
    String String nazwa typu produktu; 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 ()

    Metoda ułatwiająca uzyskanie wersji produktu tego urządzenia.

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

    Zwraca
    String String nazwę wersji produktu 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
    Zwraca
    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.

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

    Zwraca
    String numer seryjny String;

    getTombstones

    public abstract List<File> getTombstones ()

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

    metoda jest wykonywana w miarę możliwości, więc jeśli z jakiegokolwiek powodu nie uda się pobrać znacznika usunięcia, nie będzie go na liście. Tylko DeviceNotAvailableException spowoduje wcześniejsze zakończenie metody.

    Zwraca
    List<File> Lista plików oznaczonych jako usunięte. Jeśli nie ma takich plików, 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.

    Zwraca
    long

    getTrackingSerial

    public String getTrackingSerial ()

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

    Zwraca
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

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

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

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Zwraca
    boolean true jeśli urządzenie ma obecnie dostęp do roota 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 ()

    Zwraca
    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

    Zwraca
    boolean Wartość „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

    Zwraca
    boolean Ma wartość true, jeśli obejście blokady niskiego docelowego pakietu SDK jest obsługiwane. W przeciwnym razie ma wartość false.
    Zgłasza
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Sprawdź, czy debugfs jest zamontowany.

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

    Zwraca
    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

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

    Zwraca
    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 jest plikiem wykonywalnym, w przeciwnym razie zwraca wartość Fałsz.

    Parametry
    fullPath String

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

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

    Zwraca
    boolean Wartość true, jeśli uprawnienia w czasie działania aplikacji 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.

    Zwraca
    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.
    Zwraca
    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 w przypadku niepowodzenia rejestrowania.

    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 zwolnienia miejsca na urządzeniu, które zostaną wykonane po zakończeniu wywołania.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Dodatkowe czynności wymagane do zwolnienia miejsca na urządzeniu, 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.device.DeviceNotAvailableException
    com.android.tradefed.targetprep.TargetSetupError
    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.
    Zwraca
    boolean true – czy 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, 
                long timeout)

    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
    timeout long: limit czasu pobierania polecenia
    Zwraca
    boolean true – czy 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
    Zwraca
    boolean true – czy 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 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.
    Zwraca
    File 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, 
                int userId, 
                long timeout)

    Pobiera plik z urządzenia.

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.
    localFile File: lokalny plik, w którym mają być przechowywane treści. Jeśli nie jest pusta, jej zawartość zostanie zastąpiona.
    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.
    timeout long: limit czasu polecenia pobierania pliku
    Zwraca
    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)

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

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.
    Zwraca
    File 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, 
                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 mają być przechowywane treści. Jeśli nie jest pusta, jej zawartość zostanie zastąpiona.
    userId int: identyfikator użytkownika, z którego chcesz pobrać dane.
    Zwraca
    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)

    Pobiera plik z urządzenia.

    Parametry
    remoteFilePath String: ścieżka bezwzględna do pliku na urządzeniu.
    localFile File: lokalny plik, w którym mają być przechowywane treści. Jeśli nie jest pusta, jej zawartość zostanie zastąpiona.
    Zwraca
    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.
    Zwraca
    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 tymczasowym File i zwracania odwołania do tego 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.
    Zwraca
    File 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 miejsca docelowego zdalnego
    userId int: identyfikator użytkownika, do którego ma zostać wysłane powiadomienie.
    Zwraca
    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, 
                Set<String> 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 miejsca docelowego zdalnego
    excludedDirectories Set: Zestaw nazw wykluczonych katalogów, które nie powinny być przesyłane.
    Zwraca
    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 miejsca docelowego zdalnego
    Zwraca
    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 chcesz wysłać powiadomienie.
    Zwraca
    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 funkcji 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;
    Zwraca
    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
    Zwraca
    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
    Zwraca
    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ć.

    uruchomić ponownie|zrestartować

    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.

    uruchomić ponownie|zrestartować

    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 działanie do momentu, aż urządzenie będzie dostępne.

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

    Parametry
    reason String: przyczynę ponownego uruchomienia lub null, jeśli nie podano przyczyny.
    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest dostępne po ponownym uruchomieniu.

    uruchomić ponownie|zrestartować

    public String reboot (String command, 
                String reason)

    Ponownie uruchamia urządzenie za pomocą podanego parametru command.

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

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

    Parametry
    command String: polecenie przekazane do `adb`. Zwróć uwagę, że jest ono przekazywane „w stanie nienaruszonym”, więc to wywołujący musi w razie potrzeby podać odpowiedni cudzysłów (zwłaszcza jeśli polecenie zawiera wiele części oddzielonych spacją).
    reason String: przyczynę ponownego uruchomienia lub null, jeśli nie podano przyczyny.
    Zwraca
    String

    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, dopóki urządzenie nie przejdzie 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 odzyskiwania).

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

    Parametry
    autoReboot boolean: czy po instalacji z pliku urządzenie ma się automatycznie uruchomić ponownie.
    Zgłasza
    DeviceNotAvailableException jeśli po ponownym uruchomieniu urządzenie nie jest w trybie sideload.

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

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

    Blokuje działanie 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 sideload.

    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: przyczynę ponownego uruchomienia lub null, jeśli nie podano przyczyny.
    Zgłasza
    DeviceNotAvailableException jeśli urządzenie nie jest dostępne po ponownym uruchomieniu.

    Zobacz też:

    rebootUserspace

    public abstract void rebootUserspace ()

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

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

    OSTRZEŻENIE. Ponowne uruchamianie w przestrzeni użytkownika jest obecnie w fazie rozwoju. Używasz go 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, tzn. 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 ()

    Umożliwia zapisywanie na partycji dostawcy na urządzeniu. Może ponownie uruchomić urządzenie.

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

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                Collection<ITestLifeCycleReceiver> 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 uruchomione ponownie. W razie potrzeby rozmówcy mogą spróbować ponownie.

    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, a wyjątek DeviceNotAvailableException zostanie zgłoszony.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy
    listeners Collection: detektory wyników testu
    Zwraca
    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.

    runInstrumentationTests

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

    Wygodna metoda wykonywania runInstrumentationTests(IRemoteAndroidTestRunner,Collection) z co najmniej 1 odbiornikiem przekazanym jako parametr.

    Parametry
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner, który przeprowadza testy
    listeners ITestLifeCycleReceiver: odbiorcy wyników testu
    Zwraca
    boolean true jeśli polecenie testowe zostało wykonane. false – jeśli nie udało się ukończyć operacji, ale przywracanie się powiodło.
    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, 
                Collection<ITestLifeCycleReceiver> listeners)

    Podobnie jak ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection), ale przeprowadza test dla danego użytkownika.

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners Collection

    Zwraca
    boolean

    Zgłasza
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Parametry
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Zwraca
    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.
    Zwraca
    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 problemów 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 „Odzyskuj 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 śledzimy 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() i stopLogcat() w kontekście wywołania TF, ponieważ framework TF uruchamia i zatrzymuje logcat.

    startTradeInModeTesting

    public abstract boolean startTradeInModeTesting (int timeoutMs)

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

    Parametry
    timeoutMs int

    Zwraca
    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 ()

    Przestań rejestrować dane wyjściowe logcat z urządzenia i odrzuć 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.

    Zwraca
    String numer seryjny urządzenia TCP lub null, jeśli nie udało się 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.

    Zwraca
    boolean true, jeśli przełączenie 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ść /tmp/files do /sdcard/files.

    Parametry
    localFileDir File: lokalny katalog plików zawierający pliki do rekurencyjnego wypychania.
    deviceFilePath String: bezwzględna ścieżka 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.
    Zwraca
    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ść.

    Zwraca
    boolean true – jeśli operacja się powiodła 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.
    Zwraca
    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.

    Zwraca
    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.
    Zwraca
    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 na odpowiedź urządzenia i jego dostępność bez uwzględniania ścieżki przywracania.

    Parametry
    waitTime long

    Zwraca
    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.
    Zwraca
    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 urządzenie w stanie „adb sideload”

    Parametry
    waitTime long: czas oczekiwania w milisekundach.
    Zwraca
    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, np. nie było widoczne w adb.

    Parametry
    waitTime long: czas oczekiwania w milisekundach.
    Zwraca
    boolean true, jeśli urządzenie stanie się niedostępne przed upływem czasu. W innych przypadkach false

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Blokuje do momentu, aż urządzenie 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 do momentu, aż urządzenie 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.
    Zwraca
    boolean true jeśli urządzenie zacznie odpowiadać przed upływem czasu waitTime.