Thiết bị gốc

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Các lớp con gián tiếp đã biết IManagedTestDevice, ITestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice IManagedTestDevice Một ITestDevice có vòng đời được quản lý.  ITestDevice (Thiết bị thử nghiệm) Cung cấp API đáng tin cậy và cấp cao hơn một chút cho IDevice ddmlib.  LocalAndroidVirtualDevice Lớp dành cho các thiết bị ảo cục bộ chạy trên máy chủ TradeFed.  ManagedRemoteDevice Một thiết bị chạy bên trong máy ảo mà chúng tôi quản lý từ xa thông qua một thực thể Tradefeed trong máy ảo.  NativeDevice Phương thức triển khai mặc định của ITestDevice Thiết bị Android không ở trong ngăn xếp đầy đủ.  NestedRemoteDevice Hình minh hoạ thiết bị chạy trong máy ảo Mực nang từ xa.  RemoteAndroidDevice Việc triển khai ITestDevice cho thiết bị Android hoàn chỉnh ngăn xếp được kết nối qua adb connect.  RemoteAndroidVirtualDevice Mở rộng hành vi RemoteAndroidDevice cho một thiết bị Android đầy đủ ngăn xếp chạy trong Google Compute Engine (Gce).  TestDevice (Thiết bị thử nghiệm) Triển khai ITestDevice cho thiết bị Android đầy đủ ngăn xếp

---

Cung cấp API đáng tin cậy và cấp cao hơn một chút cho IDevice ddmlib.

Thử lại các lệnh trên thiết bị với số lượng có thể định cấu hình và cung cấp giao diện khôi phục thiết bị cho các thiết bị không phản hồi.

Tóm tắt

Hằng số
int	UNKNOWN_API_LEVEL Giá trị mặc định khi không thể phát hiện cấp độ API

Phương thức công khai
abstract boolean	checkApiLevelAgainstNextRelease(int strictMinLevel) Kiểm tra xem một tính năng hiện có được hỗ trợ ở mức tối thiểu được hỗ trợ hay không.
abstract void	clearLogcat() Xoá mọi dữ liệu logcat đã tích luỹ.
abstract void	deleteFile(String deviceFilePath) Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị.
abstract void	deleteFile(String deviceFilePath, int userId) Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị.
abstract boolean	deviceSoftRestarted(ProcessInfo prevSystemServerProcess) Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm hay không bằng cách so sánh system_server hiện tại với ProcessInfo system_server trước đó.
abstract boolean	deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit) Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm kể từ thời gian UTC kể từ thời gian bắt đầu của hệ thống từ thiết bị và ERROR(/TimeUnit) của thiết bị hay không.
abstract boolean	disableAdbRoot() Tắt adb gốc.
abstract boolean	doesFileExist(String deviceFilePath) Phương thức trợ giúp để xác định xem có tệp trên thiết bị hay không.
abstract boolean	enableAdbRoot() Bật thư mục gốc adb.
abstract String	executeAdbCommand(long timeout, String... commandArgs) Phương thức trợ giúp sẽ thực thi một lệnh adb dưới dạng một lệnh hệ thống với thời gian chờ được chỉ định.
abstract String	executeAdbCommand(String... commandArgs) Phương thức trợ giúp thực thi một lệnh adb dưới dạng một lệnh hệ thống.
abstract String	executeAdbCommand(long timeout, envMap, String... commandArgs) Phương thức trợ giúp sẽ thực thi một lệnh adb dưới dạng một lệnh hệ thống với thời gian chờ được chỉ định.
abstract CommandResult	executeFastbootCommand(long timeout, String... commandArgs) Phương thức trợ giúp thực thi lệnh khởi động nhanh dưới dạng lệnh hệ thống.
abstract CommandResult	executeFastbootCommand(String... commandArgs) Phương thức trợ giúp sẽ thực thi một lệnh khởi động nhanh dưới dạng một lệnh hệ thống với thời gian chờ mặc định là 2 phút.
abstract CommandResult	executeLongFastbootCommand(String... commandArgs) Phương thức trợ giúp giúp thực thi một lệnh khởi động nhanh chạy trong thời gian dài dưới dạng lệnh hệ thống.
abstract CommandResult	executeLongFastbootCommand( envVarMap, String... commandArgs) Phương thức trợ giúp giúp thực thi một lệnh khởi động nhanh chạy trong thời gian dài dưới dạng một lệnh hệ thống với các biến môi trường hệ thống.
abstract String	executeShellCommand(String command) Phương thức trợ giúp sẽ thực thi một lệnh shell adb và trả về kết quả dưới dạng String.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver) Thực thi lệnh adb shell đã cho, thử lại nhiều lần nếu lệnh không thành công.
abstract CommandResult	executeShellV2Command(String command) Phương thức trợ giúp sẽ thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách cùng với đầu ra trạng thái của lệnh là stdout và stderr.
abstract CommandResult	executeShellV2Command(String command, OutputStream pipeToOutput) Phương thức trợ giúp sẽ thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách cùng với đầu ra trạng thái và stderr của lệnh.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput) Phương thức trợ giúp sẽ thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách cùng với đầu ra trạng thái của lệnh là stdout và stderr.
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit) Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
abstract CommandResult	fastbootWipePartition(String partition) Phương thức trợ giúp giúp xoá sạch một phân vùng cho thiết bị.
abstract int	getApiLevel() Lấy cấp độ API của thiết bị.
abstract String	getBasebandVersion() Phương thức thuận tiện để mua phiên bản băng tần cơ sở (vô tuyến) của thiết bị này.
abstract Integer	getBattery() Trả về mức pin hiện tại của thiết bị hoặc trả về giá trị rỗng nếu không có mức pin.
abstract boolean	getBooleanProperty(String name, boolean defaultValue) Trả về giá trị boolean của thuộc tính đã cho.
abstract	getBootHistory() Phương thức trợ giúp thu thập bản đồ nhật ký khởi động, kèm theo thời gian khởi động và lý do khởi động.
abstract	getBootHistorySince(long utcEpochTime, TimeUnit timeUnit) Phương thức trợ giúp thu thập bản đồ nhật ký khởi động cùng với thời gian khởi động và lý do khởi động kể từ thời gian cụ thể kể từ thời gian bắt đầu của hệ thống từ thiết bị và đơn vị thời gian đã chỉ định.
abstract String	getBootloaderVersion() Phương thức thuận tiện để tải phiên bản trình tải khởi động của thiết bị này.
abstract String	getBuildAlias() Truy xuất bí danh của bản dựng mà thiết bị hiện đang chạy.
abstract String	getBuildFlavor() Truy xuất phiên bản bản dựng cho thiết bị.
abstract String	getBuildId() Truy xuất bản dựng mà thiết bị đang chạy.
abstract String	getBuildSigningKeys() Trả về loại khoá dùng để ký hình ảnh thiết bị Thông thường, các thiết bị Android có thể được ký bằng các khoá kiểm thử (như trong AOSP) hoặc khoá phát hành (do từng nhà sản xuất thiết bị kiểm soát)
abstract DeviceDescriptor	getCachedDeviceDescriptor() Trả về một DeviceDescriptor đã lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không sẽ trả về DeviceDescriptor hiện tại.
abstract DeviceDescriptor	getCachedDeviceDescriptor(boolean shortDescriptor) Trả về một DeviceDescriptor đã lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không sẽ trả về DeviceDescriptor hiện tại.
abstract String[]	getChildren(String deviceFilePath) Phương pháp thay thế cho việc sử dụng IFileEntry mà đôi khi không hoạt động do quyền.
abstract AbstractConnection	getConnection() Trả về kết nối liên kết với thiết bị.
abstract String	getDeviceClass() Lấy lớp thiết bị.
abstract long	getDeviceDate() Trả về ngày của thiết bị tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.
abstract DeviceDescriptor	getDeviceDescriptor() Trả về một DeviceDescriptor từ thông tin thiết bị để nhận thông tin về thiết bị đó mà không truyền đối tượng thiết bị thực.
abstract DeviceDescriptor	getDeviceDescriptor(boolean shortDescriptor) Trả về một DeviceDescriptor từ thông tin thiết bị để nhận thông tin về thiết bị đó mà không truyền đối tượng thiết bị thực.
abstract TestDeviceState	getDeviceState() Xem trạng thái của thiết bị.
abstract long	getDeviceTimeOffset(Date date) Giúp bạn tìm chênh lệch thời gian giữa thiết bị và một ERROR(/Date) cụ thể.
abstract InputStreamSource	getEmulatorOutput() Nhận luồng stdout và stderr của trình mô phỏng
abstract long	getExternalStoreFreeSpace() Phương pháp trợ giúp để xác định lượng dung lượng trống trên bộ nhớ ngoài của thiết bị.
abstract String	getFastbootProductType() Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ khởi động nhanh.
abstract String	getFastbootProductVariant() Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ khởi động nhanh.
abstract String	getFastbootSerialNumber() Trả về số sê-ri của chế độ khởi động nhanh.
abstract String	getFastbootVariable(String variableName) Truy xuất giá trị biến khởi động nhanh đã cho từ thiết bị.
abstract IFileEntry	getFileEntry(String path) Truy xuất tham chiếu đến tệp từ xa trên thiết bị.
abstract IDevice	getIDevice() Trả về tham chiếu đến IDevice ddmlib liên kết.
abstract long	getIntProperty(String name, long defaultValue) Trả về giá trị số nguyên của thuộc tính đã cho từ thiết bị.
abstract long	getLastExpectedRebootTimeMillis() Trả về lần gần đây nhất Trade tác API kích hoạt quá trình khởi động lại tính bằng mili giây kể từ khi EPOCH được System.currentTimeMillis() trả về.
abstract int	getLaunchApiLevel() Lấy Cấp độ API đầu tiên của thiết bị.
abstract InputStreamSource	getLogcat() Lấy một luồng tổng quan nhanh của dữ liệu logcat.
abstract InputStreamSource	getLogcat(int maxBytes) Lấy luồng ảnh chụp nhanh của maxBytes dữ liệu logcat đã thu thập gần đây nhất.
abstract InputStreamSource	getLogcatDump() Tải tệp kết xuất logcat hiện tại cho thiết bị.
abstract InputStreamSource	getLogcatSince(long date) Lấy một luồng tổng quan nhanh về dữ liệu logcat đã ghi bắt đầu từ ngày đã cung cấp.
abstract String	getMountPoint(String mountName) Trả về một điểm gắn.
abstract ITestDevice.MountPointInfo	getMountPointInfo(String mountpoint) Trả về một MountPointInfo tương ứng với đường dẫn điểm gắn được chỉ định, hoặc null nếu đường dẫn đó không có giá trị nào được gắn hoặc không xuất hiện trong /proc/Mua sắm dưới dạng một điểm gắn.
abstract	getMountPointInfo() Trả về phiên bản đã phân tích cú pháp của thông tin trong /proc/sticks trên thiết bị
abstract long	getPartitionFreeSpace(String partition) Phương pháp trợ giúp để xác định lượng dung lượng trống trên phân vùng thiết bị.
abstract ProcessInfo	getProcessByName(String processName) Phương thức trợ giúp sẽ chạy lệnh "pidof" và "stat" đồng thời trả về đối tượng ProcessInfo có PID và thời gian bắt đầu xử lý của quy trình cụ thể.
abstract String	getProcessPid(String process) Trả về pid của dịch vụ hoặc giá trị rỗng nếu xảy ra lỗi.
abstract String	getProductType() Phương thức thuận tiện để mua loại sản phẩm của thiết bị này.
abstract String	getProductVariant() Phương thức thuận tiện để mua biến thể sản phẩm của thiết bị này.
abstract String	getProperty(String name) Truy xuất giá trị thuộc tính đã cho từ thiết bị.
abstract ITestDevice.RecoveryMode	getRecoveryMode() Tải chế độ khôi phục hiện tại được dùng cho thiết bị.
abstract String	getSerialNumber() Phương thức thuận tiện để lấy số sê-ri của thiết bị này.
abstract	getTombstones() Tìm nạp và trả về danh sách tombstone trên các thiết bị.
abstract long	getTotalMemory() Trả về tổng kích thước bộ nhớ thực tính bằng byte hoặc -1 trong trường hợp có lỗi nội bộ
abstract boolean	getUseFastbootErase() Chọn sử dụng định dạng xoá khởi động nhanh hay định dạng khởi động nhanh để xoá sạch một phân vùng trên thiết bị.
abstract boolean	isAdbRoot()
abstract boolean	isAdbTcp()
abstract boolean	isAppEnumerationSupported() Kiểm tra xem nền tảng trên thiết bị có hỗ trợ tính năng liệt kê ứng dụng hay không
abstract boolean	isBypassLowTargetSdkBlockSupported() Kiểm tra xem nền tảng trên thiết bị có hỗ trợ bỏ qua khối sdk mục tiêu thấp khi cài đặt ứng dụng hay không
abstract boolean	isDebugfsMounted() Kiểm tra xem Debugfs đã được gắn kết hay chưa.
abstract boolean	isDeviceEncrypted() Trả về nếu thiết bị được mã hoá.
abstract boolean	isDirectory(String deviceFilePath) Trả về True nếu đường dẫn trên thiết bị là một thư mục, nếu không thì trả về false.
abstract boolean	isEncryptionSupported() Trả về nếu thiết bị hỗ trợ tính năng mã hoá.
abstract boolean	isExecutable(String fullPath) Trả về True nếu đường dẫn tệp trên thiết bị là tệp thực thi, nếu không thì trả về false.
abstract boolean	isHeadless() Trả về true nếu thiết bị không có giao diện người dùng (không có màn hình), trả về false nếu không có màn hình.
abstract boolean	isRuntimePermissionSupported() Kiểm tra xem nền tảng trên thiết bị có hỗ trợ cấp quyền khi bắt đầu chạy hay không
abstract boolean	isStateBootloaderOrFastbootd() Trả về giá trị true nếu thiết bị đang ở TestDeviceState#FASTBOOT hoặc TestDeviceState.FASTBOOTD.
abstract boolean	logAnrs(ITestLogger logger) Thu thập và ghi nhật ký lỗi ANR trên thiết bị.
abstract void	logOnDevice(String tag, Log.LogLevel level, String format, Object... args) Ghi lại thông điệp trong logcat của thiết bị.
abstract void	mountDebugfs() Gắn gỡ lỗi.
abstract void	nonBlockingReboot() Đưa ra lệnh để khởi động lại thiết bị và quay lại khi lệnh hoàn tất và khi thiết bị không còn hiển thị với adb.
abstract void	postBootSetup() Thực hiện hướng dẫn định cấu hình thiết bị để kiểm thử sau mỗi lần khởi động.
default void	postInvocationTearDown() Phương thức này không được dùng nữa. Thay vào đó, hãy sử dụng postInvocationTearDown(Throwable).
abstract void	postInvocationTearDown(Throwable invocationException) Các bước bổ sung để dọn dẹp bắt buộc theo thiết bị cụ thể sẽ được thực thi sau khi lệnh gọi hoàn tất.
default void	preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes) Các bước bổ sung để thiết lập bắt buộc theo thiết bị cụ thể sẽ được thực thi trên thiết bị trước quy trình gọi.
abstract boolean	pullDir(String deviceFilePath, File localDir) Lấy nội dung thư mục từ thiết bị theo cách đệ quy.
abstract boolean	pullDir(String deviceFilePath, File localDir, int userId) Lấy nội dung thư mục từ thiết bị theo cách đệ quy.
abstract File	pullFile(String remoteFilePath, int userId) Truy xuất một tệp ra khỏi thiết bị, lưu trữ tệp đó trong ERROR(/File) cục bộ tạm thời và trả về File đó.
abstract File	pullFile(String remoteFilePath) Truy xuất một tệp ra khỏi thiết bị, lưu trữ tệp đó trong ERROR(/File) cục bộ tạm thời và trả về File đó.
abstract boolean	pullFile(String remoteFilePath, File localFile) Truy xuất tệp ra khỏi thiết bị.
abstract boolean	pullFile(String remoteFilePath, File localFile, int userId) Truy xuất tệp ra khỏi thiết bị.
abstract String	pullFileContents(String remoteFilePath) Truy xuất tệp ra khỏi thiết bị và trả về nội dung.
abstract File	pullFileFromExternal(String remoteFilePath) Một phương thức tiện lợi để truy xuất một tệp từ bộ nhớ ngoài của thiết bị, lưu trữ tệp đó trong ERROR(/File) tạm thời cục bộ và trả về một tệp tham chiếu đến File đó.
abstract boolean	pushDir(File localDir, String deviceFilePath, int userId) Đẩy định kỳ các nội dung trong thư mục sang thiết bị.
abstract boolean	pushDir(File localDir, String deviceFilePath, excludedDirectories) Đẩy định kỳ các nội dung trong thư mục sang thiết bị, đồng thời loại trừ một số thư mục đã được lọc.
abstract boolean	pushDir(File localDir, String deviceFilePath) Đẩy định kỳ các nội dung trong thư mục sang thiết bị.
abstract boolean	pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) Biến thể của pushFile(File, String) có thể xem xét đánh giá nhu cầu của trình cung cấp nội dung (không bắt buộc).
abstract boolean	pushFile(File localFile, String deviceFilePath) Đẩy tệp vào thiết bị.
abstract boolean	pushFile(File localFile, String deviceFilePath, int userId) Đẩy tệp vào thiết bị.
abstract boolean	pushString(String contents, String deviceFilePath) Đẩy tệp được tạo từ một chuỗi đến thiết bị
abstract void	reboot() Khởi động lại thiết bị ở chế độ adb.
abstract void	reboot(String reason) Khởi động lại thiết bị ở chế độ adb bằng reason nhất định để duy trì khi khởi động lại.
abstract void	rebootIntoBootloader() Khởi động lại thiết bị ở chế độ trình tải khởi động.
abstract void	rebootIntoFastbootd() Khởi động lại thiết bị ở chế độ khởi động nhanh.
abstract void	rebootIntoRecovery() Khởi động lại thiết bị ở chế độ khôi phục adb.
abstract void	rebootIntoSideload(boolean autoReboot) Khởi động lại thiết bị ở chế độ tải không qua cửa hàng adb (lưu ý rằng đây là chế độ đặc biệt đang trong quá trình khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ cài đặt không qua cửa hàng ứng dụng
abstract void	rebootIntoSideload() Khởi động lại thiết bị ở chế độ tải không qua cửa hàng adb (lưu ý rằng đây là chế độ đặc biệt đang trong quá trình khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ cài đặt không qua cửa hàng ứng dụng
abstract void	rebootUntilOnline() Một giải pháp thay thế cho reboot() chỉ chặn cho đến khi thiết bị kết nối mạng, tức là hiển thị với adb.
abstract void	rebootUntilOnline(String reason) Một giải pháp thay thế cho reboot() chỉ chặn cho đến khi thiết bị kết nối mạng, tức là hiển thị với adb.
abstract void	rebootUserspace() Chỉ khởi động lại một phần trong không gian người dùng của thiết bị.
abstract void	rebootUserspaceUntilOnline() Một phương thức thay thế cho rebootUserspace() ()} chỉ chặn cho đến khi thiết bị xuất hiện trực tuyến, tức là hiển thị với adb.
abstract void	remountSystemReadOnly() Đặt phân vùng hệ thống trên thiết bị ở chế độ chỉ có thể đọc.
abstract void	remountSystemWritable() Đặt phân vùng hệ thống trên thiết bị ở chế độ có thể ghi.
abstract void	remountVendorReadOnly() Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ có thể đọc.
abstract void	remountVendorWritable() Tạo phân vùng nhà cung cấp trên thiết bị có thể ghi.
abstract boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Phương thức thuận tiện để biểu diễn ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) với một hoặc nhiều trình nghe được truyền dưới dạng tham số.
abstract boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners) Chạy kiểm thử đo lường và cung cấp dịch vụ khôi phục thiết bị.
abstract boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners) Giống như ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) nhưng chạy kiểm thử cho người dùng cụ thể.
abstract boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) Giống như ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) nhưng chạy kiểm thử cho một người dùng cụ thể.
abstract void	setDate(Date date) Đặt ngày trên thiết bị Lưu ý: việc đặt ngày trên thiết bị yêu cầu thư mục gốc
abstract void	setOptions(TestDeviceOptions options) Đặt TestDeviceOptions cho thiết bị
abstract boolean	setProperty(String propKey, String propValue) Đặt giá trị thuộc tính đã cho trên thiết bị.
abstract void	setRecovery(IDeviceRecovery recovery) Đặt IDeviceRecovery để sử dụng cho thiết bị này.
abstract void	setRecoveryMode(ITestDevice.RecoveryMode mode) Đặt chế độ khôi phục hiện tại để sử dụng cho thiết bị.
abstract void	setUseFastbootErase(boolean useFastbootErase) Đặt xem bạn nên sử dụng định dạng xoá khởi động nhanh hay định dạng khởi động nhanh để xoá sạch một phân vùng trên thiết bị.
abstract void	startLogcat() Bắt đầu ghi lại đầu ra logcat từ thiết bị ở chế độ nền.
abstract void	stopEmulatorOutput() Đóng và xoá dữ liệu đầu ra của trình mô phỏng.
abstract void	stopLogcat() Dừng ghi lại đầu ra logcat từ thiết bị và loại bỏ dữ liệu logcat hiện đã lưu.
abstract String	switchToAdbTcp() Chuyển thiết bị sang chế độ adb-over-tcp.
abstract boolean	switchToAdbUsb() Chuyển thiết bị sang adb qua chế độ USB.
abstract boolean	syncFiles(File localFileDir, String deviceFilePath) Đồng bộ hoá dần nội dung của thư mục tệp cục bộ với thiết bị.
abstract boolean	unlockDevice() Mở khoá thiết bị nếu thiết bị đang ở trạng thái đã mã hoá.
abstract void	unmountDebugfs() Ngắt kết nối debugfs.
abstract boolean	waitForBootComplete(long timeOut) Chặn cho đến khi cờ hoàn tất khởi động của thiết bị được đặt.
abstract boolean	waitForDeviceAvailable() Chờ thiết bị phản hồi và sẵn sàng để kiểm thử.
abstract boolean	waitForDeviceAvailable(long waitTime) Chờ thiết bị phản hồi và sẵn sàng để kiểm thử.
abstract boolean	waitForDeviceAvailableInRecoverPath(long waitTime) Chờ thiết bị phản hồi và sẵn sàng mà không xem xét đường dẫn khôi phục.
abstract void	waitForDeviceBootloader() Chặn cho đến khi thiết bị hiển thị thông qua tính năng khởi động nhanh.
abstract boolean	waitForDeviceInRecovery(long waitTime) Các quy tắc chặn để thiết bị ở trạng thái "khôi phục adb" (lưu ý rằng điều này khác với IDeviceRecovery).
abstract boolean	waitForDeviceInSideload(long waitTime) Các quy tắc chặn để thiết bị ở trạng thái "adb sideload" (Tải không qua cửa hàng ứng dụng)
abstract boolean	waitForDeviceNotAvailable(long waitTime) Các quy tắc chặn thiết bị không hoạt động, tức là bị thiếu trong adb
abstract void	waitForDeviceOnline() Chặn cho đến khi thiết bị hiển thị qua adb.
abstract void	waitForDeviceOnline(long waitTime) Chặn cho đến khi thiết bị hiển thị qua adb.
abstract boolean	waitForDeviceShell(long waitTime) Chờ thiết bị phản hồi với lệnh adb shell cơ bản.

Hằng số

KHÔNG XÁC ĐỊNH_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Giá trị mặc định khi không thể phát hiện cấp độ API

Giá trị hằng số: -1 (0xffffffff)

Phương thức công khai

checkApilevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Kiểm tra xem một tính năng hiện có được hỗ trợ ở mức tối thiểu được hỗ trợ hay không. Phương thức này tính đến các tính năng chưa phát hành trước khi tăng cấp độ API.

Tham số
strictMinLevel	int: Cấp độ nghiêm ngặt tối thiểu có thể hỗ trợ tính năng này.

Giá trị trả về
boolean	Đúng nếu cấp độ này được hỗ trợ. Nếu không thì là False.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

xoáLogcat

public abstract void clearLogcat ()

Xoá mọi dữ liệu logcat đã tích luỹ.

Điều này hữu ích cho những trường hợp bạn muốn đảm bảo rằng ITestDevice#getLogcat() chỉ trả về dữ liệu nhật ký được tạo sau một thời điểm nhất định (chẳng hạn như sau khi cài đặt ROM cho một bản dựng thiết bị mới, v.v.).

xoá tệp

public abstract void deleteFile (String deviceFilePath)

Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị.

Tham số
deviceFilePath	String: Đường dẫn tuyệt đối của tệp trên thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

xoá tệp

public abstract void deleteFile (String deviceFilePath, 
                int userId)

Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị.

Tham số
deviceFilePath	String: Đường dẫn tuyệt đối của tệp trên thiết bị.
userId	int: Mã nhận dạng người dùng cần xoá

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

thiết bị đã khởi động lại mềm

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm hay không bằng cách so sánh system_server hiện tại với ProcessInfo system_server trước đó. Dùng getProcessByName(String) để hưởng ProcessInfo.

Tham số
prevSystemServerProcess	ProcessInfo: quá trình system_server trước đó ProcessInfo.

Giá trị trả về
boolean	true nếu thiết bị khởi động lại mềm

Gửi
RuntimeException	nếu thiết bị có lý do khởi động bất thường
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

thiết bịSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm kể từ thời gian UTC kể từ thời gian bắt đầu của hệ thống từ thiết bị và ERROR(/TimeUnit) của thiết bị hay không. Khởi động lại mềm đề cập đến việc system_server được khởi động lại bên ngoài một quá trình khởi động cứng thiết bị (ví dụ: yêu cầu khởi động lại). Bạn có thể lấy thiết bị hiện tại utcEpochTime trong Milliseccond bằng phương thức getDeviceDate().

Tham số
utcEpochTime	long: thời gian của thiết bị tính bằng giây kể từ thời gian bắt đầu của hệ thống.
timeUnit	TimeUnit: đơn vị thời gian TimeUnit của utcEpochTime đã cho.

Giá trị trả về
boolean	true nếu thiết bị khởi động lại mềm

Gửi
RuntimeException	nếu thiết bị có lý do khởi động bất thường
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

vô hiệu hoáAdbRoot

public abstract boolean disableAdbRoot ()

Tắt adb gốc.

Việc tắt adb gốc có thể khiến thiết bị ngắt kết nối khỏi adb. Phương thức này sẽ chặn cho đến khi có thiết bị.

Giá trị trả về
boolean	true nếu thành công.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

không có tệpExist

public abstract boolean doesFileExist (String deviceFilePath)

Phương thức trợ giúp để xác định xem có tệp trên thiết bị hay không.

Tham số
deviceFilePath	String: đường dẫn tuyệt đối của tệp trên thiết bị cần kiểm tra

Giá trị trả về
boolean	true nếu tệp tồn tại, nếu không thì false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

enableAdbRoot

public abstract boolean enableAdbRoot ()

Bật thư mục gốc adb. Nếu chế độ cài đặt "enable-root" là "false", thì hệ thống sẽ ghi lại một thông báo và trả về mà không cần bật thư mục gốc.

Việc bật adb gốc có thể khiến thiết bị ngắt kết nối khỏi adb. Phương thức này sẽ chặn cho đến khi có thiết bị.

Giá trị trả về
boolean	true nếu thành công.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiAdbCommand

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

Phương thức trợ giúp sẽ thực thi một lệnh adb dưới dạng một lệnh hệ thống với thời gian chờ được chỉ định.

Nếu có thể, bạn nên sử dụng executeShellCommand(String), vì phương thức đó giúp cải thiện hiệu suất và khả năng phát hiện lỗi.

Tham số
timeout	long: thời gian tính bằng mili giây trước khi thiết bị được coi là không phản hồi, 0L nếu không có thời gian chờ
commandArgs	String: lệnh adb và các đối số để chạy

Giá trị trả về
String	stdout từ lệnh. null nếu không thực thi được lệnh.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

Phương thức trợ giúp thực thi một lệnh adb dưới dạng một lệnh hệ thống.

Nếu có thể, bạn nên sử dụng executeShellCommand(String), vì phương thức đó giúp cải thiện hiệu suất và khả năng phát hiện lỗi.

Tham số
commandArgs	String: lệnh adb và các đối số để chạy

Giá trị trả về
String	stdout từ lệnh. null nếu không thực thi được lệnh.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiAdbCommand

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

Phương thức trợ giúp sẽ thực thi một lệnh adb dưới dạng một lệnh hệ thống với thời gian chờ được chỉ định.

Nếu có thể, bạn nên sử dụng executeShellCommand(String), vì phương thức đó giúp cải thiện hiệu suất và khả năng phát hiện lỗi.

Tham số
timeout	long: thời gian tính bằng mili giây trước khi thiết bị được coi là không phản hồi, 0L nếu không có thời gian chờ
envMap	: môi trường để đặt cho lệnh
commandArgs	String: lệnh adb và các đối số để chạy

Giá trị trả về
String	stdout từ lệnh. null nếu không thực thi được lệnh.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thi FastbootCommand

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

Phương thức trợ giúp thực thi lệnh khởi động nhanh dưới dạng lệnh hệ thống.

Dự kiến sẽ được sử dụng khi thiết bị đang ở chế độ khởi động nhanh.

Tham số
timeout	long: thời gian tính bằng mili giây trước khi lệnh hết hạn
commandArgs	String: lệnh khởi động nhanh và các đối số cần chạy

Giá trị trả về
CommandResult	CommandResult chứa kết quả của lệnh

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thi FastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Phương thức trợ giúp sẽ thực thi một lệnh khởi động nhanh dưới dạng một lệnh hệ thống với thời gian chờ mặc định là 2 phút.

Dự kiến sẽ được sử dụng khi thiết bị đang ở chế độ khởi động nhanh.

Tham số
commandArgs	String: lệnh khởi động nhanh và các đối số cần chạy

Giá trị trả về
CommandResult	CommandResult chứa kết quả của lệnh

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Phương thức trợ giúp giúp thực thi một lệnh khởi động nhanh chạy trong thời gian dài dưới dạng lệnh hệ thống.

Giống hệt với executeFastbootCommand(String), ngoại trừ việc sử dụng thời gian chờ dài hơn.

Tham số
commandArgs	String: lệnh khởi động nhanh và các đối số cần chạy

Giá trị trả về
CommandResult	CommandResult chứa kết quả của lệnh

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiLongFastbootCommand

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

Phương thức trợ giúp giúp thực thi một lệnh khởi động nhanh chạy trong thời gian dài dưới dạng một lệnh hệ thống với các biến môi trường hệ thống.

Giống hệt với executeFastbootCommand(String), ngoại trừ việc sử dụng thời gian chờ dài hơn.

Tham số
envVarMap	: các biến môi trường hệ thống mà lệnh khởi động nhanh chạy cùng
commandArgs	String: lệnh khởi động nhanh và các đối số cần chạy

Giá trị trả về
CommandResult	CommandResult chứa kết quả của lệnh

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiShellCommand

public abstract String executeShellCommand (String command)

Phương thức trợ giúp sẽ thực thi một lệnh shell adb và trả về kết quả dưới dạng String.

Tham số
command	String: lệnh adb shell để chạy

Giá trị trả về
String	kết quả đầu ra shell

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiShellCommand

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

Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.

Tham số
command	String: lệnh adb shell để chạy
receiver	IShellOutputReceiver: IShellOutputReceiver để trực tiếp điều hướng đầu ra shell đến.
maxTimeToOutputShellResponse	long: khoảng thời gian tối đa mà lệnh được phép không đưa ra bất kỳ phản hồi nào; đơn vị như được chỉ định trong timeUnit
timeUnit	TimeUnit: đơn vị của maxTimeToOutputShellResponse
retryAttempts	int: số lần tối đa để thử lại lệnh nếu lệnh đó không thành công do ngoại lệ. DeviceNotAdaptiveException sẽ được gửi nếu retryAttempts được thực hiện mà không thành công.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Xem thêm:

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

Thực thiShellCommand

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

Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.

Tham số
command	String: lệnh adb shell để chạy
receiver	IShellOutputReceiver: IShellOutputReceiver để trực tiếp điều hướng đầu ra shell đến.
maxTimeoutForCommand	long: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit
maxTimeToOutputShellResponse	long: khoảng thời gian tối đa mà lệnh được phép không đưa ra bất kỳ phản hồi nào; đơn vị như được chỉ định trong timeUnit
timeUnit	TimeUnit: đơn vị của maxTimeToOutputShellResponse
retryAttempts	int: số lần tối đa để thử lại lệnh nếu lệnh đó không thành công do ngoại lệ. DeviceNotRequestedException sẽ được gửi nếu retryAttempts được thực hiện mà không thành công.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Xem thêm:

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

Thực thiShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Thực thi lệnh adb shell đã cho, thử lại nhiều lần nếu lệnh không thành công.

Dạng executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) đơn giản hơn với các giá trị mặc định.

Tham số
command	String: lệnh adb shell để chạy
receiver	IShellOutputReceiver: IShellOutputReceiver để trực tiếp điều hướng đầu ra shell đến.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Phương thức trợ giúp sẽ thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách cùng với đầu ra trạng thái của lệnh là stdout và stderr.

Tham số
command	String: Lệnh cần chạy.

Giá trị trả về
CommandResult	Kết quả bằng CommandResult.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Phương thức trợ giúp thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách với đầu ra trạng thái của lệnh và stderr. stdout được chuyển hướng đến luồng được chỉ định.

Tham số
command	String: Lệnh cần chạy.
pipeToOutput	OutputStream: ERROR(/OutputStream), trong đó đầu ra std sẽ được chuyển hướng hoặc rỗng.

Giá trị trả về
CommandResult	Kết quả bằng CommandResult.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

Phương thức trợ giúp sẽ thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách cùng với đầu ra trạng thái của lệnh là stdout và stderr.

Tham số
command	String: Lệnh cần chạy.
pipeAsInput	File: Một ERROR(/File) sẽ được chuyển thành đầu vào cho lệnh hoặc giá trị rỗng.

Giá trị trả về
CommandResult	Kết quả bằng CommandResult.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Thực thiShellV2Command

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

Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.

Tham số
command	String: lệnh adb shell để chạy
maxTimeoutForCommand	long: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit
timeUnit	TimeUnit: đơn vị của maxTimeToOutputShellResponse
retryAttempts	int: số lần tối đa để thử lại lệnh nếu lệnh đó không thành công do ngoại lệ. DeviceNotRequestedException sẽ được gửi nếu retryAttempts được thực hiện mà không thành công.

Giá trị trả về
CommandResult

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Xem thêm:

• executeShellV2Command(String)
• TimeUtil

Thực thiShellV2Command

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

Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.

Tham số
command	String: lệnh adb shell để chạy
maxTimeoutForCommand	long: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit
timeUnit	TimeUnit: đơn vị của maxTimeToOutputShellResponse

Giá trị trả về
CommandResult

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Xem thêm:

• executeShellV2Command(String)
• TimeUtil

Thực thiShellV2Command

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

Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.

Tham số
command	String: lệnh adb shell để chạy
pipeAsInput	File: Một ERROR(/File) sẽ được chuyển thành đầu vào cho lệnh hoặc giá trị rỗng.
pipeToOutput	OutputStream: ERROR(/OutputStream), trong đó đầu ra std sẽ được chuyển hướng hoặc rỗng.
maxTimeoutForCommand	long: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit
timeUnit	TimeUnit: đơn vị của maxTimeToOutputShellResponse
retryAttempts	int: số lần tối đa để thử lại lệnh nếu lệnh đó không thành công do ngoại lệ. DeviceNotRequestedException sẽ được gửi nếu retryAttempts được thực hiện mà không thành công.

Giá trị trả về
CommandResult

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Xem thêm:

• executeShellV2Command(String)
• TimeUtil

Thực thiShellV2Command

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

Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.

Tham số
command	String: lệnh adb shell để chạy
pipeAsInput	File: Một ERROR(/File) sẽ được chuyển thành đầu vào cho lệnh hoặc giá trị rỗng.
pipeToOutput	OutputStream: ERROR(/OutputStream), trong đó đầu ra std sẽ được chuyển hướng hoặc rỗng.
pipeToError	OutputStream: ERROR(/OutputStream) nơi lỗi std sẽ được chuyển hướng hoặc rỗng.
maxTimeoutForCommand	long: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit
timeUnit	TimeUnit: đơn vị của maxTimeToOutputShellResponse
retryAttempts	int: số lần tối đa để thử lại lệnh nếu lệnh đó không thành công do ngoại lệ. DeviceNotRequestedException sẽ được gửi nếu retryAttempts được thực hiện mà không thành công.

Giá trị trả về
CommandResult

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Xem thêm:

• executeShellV2Command(String)
• TimeUtil

khởi động nhanhWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Phương thức trợ giúp giúp xoá sạch một phân vùng cho thiết bị.

Nếu getUseFastbootErase() là true, thì tính năng xoá khởi động nhanh sẽ được dùng để xoá sạch phân vùng. Sau đó, thiết bị phải tạo một hệ thống tệp vào lần khởi động tiếp theo của thiết bị. Nếu không, định dạng khởi động nhanh sẽ được dùng để tạo hệ thống tệp mới trên thiết bị.

Dự kiến sẽ được sử dụng khi thiết bị đang ở chế độ khởi động nhanh.

Tham số
partition	String: phân vùng cần xoá

Giá trị trả về
CommandResult	CommandResult chứa kết quả của lệnh

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

lấy cấp độ API

public abstract int getApiLevel ()

Lấy cấp độ API của thiết bị. Giá trị mặc định là UNKNOWN_API_LEVEL.

Giá trị trả về
int	một số nguyên cho biết Cấp độ API của thiết bị

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

nhận phiên bản băng tần cơ sở

public abstract String getBasebandVersion ()

Phương thức thuận tiện để mua phiên bản băng tần cơ sở (vô tuyến) của thiết bị này. Việc nhận phiên bản đài phát thanh là tuỳ theo thiết bị nên có thể không trả về thông tin chính xác cho tất cả thiết bị. Phương thức này dựa vào đặc quyền của gsm.version.base Band để trả về thông tin phiên bản chính xác. Điều này không chính xác đối với một số thiết bị CDMA và phiên bản được trả về ở đây có thể không khớp với phiên bản được báo cáo qua tính năng khởi động nhanh và có thể không trả về phiên bản cho vô tuyến CDMA. Tóm lại, phương thức này chỉ báo cáo phiên bản chính xác nếu thuộc tính gsm.version.base Band giống với phiên bản do fastboot getvar version-baseband trả về.

Giá trị trả về
String	phiên bản băng tần cơ sở String hoặc null nếu không xác định được (thiết bị không có đài hoặc chuỗi phiên bản không đọc được)

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể khôi phục được.

getBattery

public abstract Integer getBattery ()

Trả về mức pin hiện tại của thiết bị hoặc trả về giá trị rỗng nếu không có mức pin.

Giá trị trả về
Integer

Thuộc tính getBoolean

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Trả về giá trị boolean của thuộc tính đã cho.

Tham số
name	String: tên thuộc tính
defaultValue	boolean: giá trị mặc định trả về nếu thuộc tính trống hoặc không tồn tại.

Giá trị trả về
boolean	true nếu tài sản có giá trị "1", "y", "yes", "on" hoặc "true", false nếu tài sản đó có giá trị "0", "n", "no", "off", "false" hoặc defaultValue.

Gửi
DeviceNotAvailableException

getNhật ký khởi động

public abstract  getBootHistory ()

Phương thức trợ giúp thu thập bản đồ nhật ký khởi động, kèm theo thời gian khởi động và lý do khởi động.

Giá trị trả về
	Bản đồ thời gian khởi động (thời gian UTC tính bằng giây kể từ Kỷ nguyên) và lý do khởi động

Gửi
DeviceNotAvailableException

nhận nhật ký khởi động từ

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Phương thức trợ giúp thu thập bản đồ nhật ký khởi động cùng với thời gian khởi động và lý do khởi động kể từ thời gian cụ thể kể từ thời gian bắt đầu của hệ thống từ thiết bị và đơn vị thời gian đã chỉ định. Bạn có thể lấy thiết bị hiện tại utcEpochTime tính bằng Mili giây bằng phương thức getDeviceDate().

Tham số
utcEpochTime	long: thời gian thiết bị kể từ Epoch.
timeUnit	TimeUnit: đơn vị thời gian TimeUnit.

Giá trị trả về
	Bản đồ thời gian khởi động (thời gian UTC tính bằng giây kể từ Kỷ nguyên) và lý do khởi động

Gửi
DeviceNotAvailableException

nhận phiên bản trình tải khởi động

public abstract String getBootloaderVersion ()

Phương thức thuận tiện để tải phiên bản trình tải khởi động của thiết bị này.

Sẽ tìm cách truy xuất phiên bản trình tải khởi động từ trạng thái hiện tại của thiết bị. (tức là nếu thiết bị đang ở chế độ khởi động nhanh, thì thiết bị sẽ cố gắng truy xuất phiên bản qua chế độ khởi động nhanh)

Giá trị trả về
String	phiên bản trình tải khởi động String hoặc null nếu không tìm thấy phiên bản này

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

getBuildAlias

public abstract String getBuildAlias ()

Truy xuất bí danh của bản dựng mà thiết bị hiện đang chạy.

Bí danh bản dựng thường là một chuỗi dễ đọc hơn mã bản dựng (thường là một số cho bản dựng Nexus). Ví dụ: bản phát hành Android 4.2 chính thức có bí danh bản dựng là JDQ39 và mã bản dựng 573038

Giá trị trả về
String	bí danh bản dựng hoặc quay lại mã bản dựng nếu không truy xuất được mã bản dựng đó

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

tạo hương vị

public abstract String getBuildFlavor ()

Truy xuất phiên bản bản dựng cho thiết bị.

Giá trị trả về
String	phiên bản bản dựng hoặc giá trị rỗng nếu không thể truy xuất được phiên bản đó

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Truy xuất bản dựng mà thiết bị đang chạy.

Giá trị trả về
String	mã bản dựng hoặc IBuildInfo#UNKNOWN_BUILD_ID nếu không truy xuất được

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildKýKeys

public abstract String getBuildSigningKeys ()

Trả về loại khoá dùng để ký hình ảnh thiết bị

Thông thường, các thiết bị Android có thể được ký bằng các khoá kiểm thử (như trong AOSP) hoặc khoá phát hành (do từng nhà sản xuất thiết bị kiểm soát)

Giá trị trả về
String	Khoá ký nếu tìm thấy, nếu không thì khoá sẽ rỗng.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBộ nhớ đệm thiết bị mô tả

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Trả về một DeviceDescriptor đã lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không sẽ trả về DeviceDescriptor hiện tại.

Giá trị trả về
DeviceDescriptor

getBộ nhớ đệm thiết bị mô tả

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Trả về một DeviceDescriptor đã lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không sẽ trả về DeviceDescriptor hiện tại.

Tham số
shortDescriptor	boolean: Có giới hạn phần mô tả ở dạng thông tin tối thiểu hay không

Giá trị trả về
DeviceDescriptor

lấy trẻ em

public abstract String[] getChildren (String deviceFilePath)

Phương pháp thay thế cho việc sử dụng IFileEntry mà đôi khi không hoạt động do quyền.

Tham số
deviceFilePath	String: là đường dẫn trên thiết bị để thực hiện tìm kiếm

Giá trị trả về
String[]	Mảng chuỗi chứa tất cả tệp trong một đường dẫn trên thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Trả về kết nối liên kết với thiết bị.

Giá trị trả về
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Lấy lớp thiết bị.

Giá trị trả về
String	lớp thiết bị String.

nhận ngày thiết bị

public abstract long getDeviceDate ()

Trả về ngày của thiết bị tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

Giá trị trả về
long	ngày của thiết bị ở định dạng thời gian bắt đầu của hệ thống.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Trả về một DeviceDescriptor từ thông tin thiết bị để nhận thông tin về thiết bị đó mà không truyền đối tượng thiết bị thực.

Giá trị trả về
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Trả về một DeviceDescriptor từ thông tin thiết bị để nhận thông tin về thiết bị đó mà không truyền đối tượng thiết bị thực.

Tham số
shortDescriptor	boolean: Có giới hạn phần mô tả ở dạng thông tin tối thiểu hay không

Giá trị trả về
DeviceDescriptor

nhận Trạng thái thiết bị

public abstract TestDeviceState getDeviceState ()

Xem trạng thái của thiết bị.

Giá trị trả về
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Giúp bạn tìm chênh lệch thời gian giữa thiết bị và một ERROR(/Date) cụ thể. Sử dụng Epoch time nội bộ.

Tham số
date	Date

Giá trị trả về
long	mức chênh lệch tính theo mili giây

Gửi
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Nhận luồng stdout và stderr của trình mô phỏng

Giá trị trả về
InputStreamSource	đầu ra của trình mô phỏng

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Phương pháp trợ giúp để xác định lượng dung lượng trống trên bộ nhớ ngoài của thiết bị.

Giá trị trả về
long	lượng dung lượng trống tính bằng KB

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

loại chiến dịch khởi động nhanh

public abstract String getFastbootProductType ()

Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ khởi động nhanh.

Bạn chỉ nên sử dụng phương thức này nếu thiết bị đang ở chế độ khởi động nhanh. Trong trường hợp này, biến thể này an toàn hơn một chút so với phương thức getProductType() chung, vì ITestDevice sẽ biết cách khôi phục thiết bị vào chế độ khởi động nhanh nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.

Giá trị trả về
String	tên loại sản phẩm String hoặc null nếu không xác định được

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

phương thức getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ khởi động nhanh.

Bạn chỉ nên sử dụng phương thức này nếu thiết bị đang ở chế độ khởi động nhanh. Trong trường hợp này, biến thể này an toàn hơn một chút so với phương thức getProductType() chung, vì ITestDevice sẽ biết cách khôi phục thiết bị vào chế độ khởi động nhanh nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.

Giá trị trả về
String	tên loại sản phẩm String hoặc null nếu không xác định được

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Trả về số sê-ri của chế độ khởi động nhanh.

Giá trị trả về
String

phương thức khởi động nhanh

public abstract String getFastbootVariable (String variableName)

Truy xuất giá trị biến khởi động nhanh đã cho từ thiết bị.

Tham số
variableName	String: tên biến

Giá trị trả về
String	giá trị thuộc tính hoặc null nếu không tồn tại

Gửi
	Trường hợp ngoại lệ không được hỗ trợ
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Truy xuất tham chiếu đến tệp từ xa trên thiết bị.

Tham số
path	String: đường dẫn tệp cần truy xuất. Có thể là một đường dẫn hoặc đường dẫn tuyệt đối tương ứng với "/". (tức là cả cú pháp "/system" và "system" đều được hỗ trợ)

Giá trị trả về
IFileEntry	IFileEntry hoặc null nếu không tìm thấy tệp tại path đã cho

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Trả về tham chiếu đến IDevice ddmlib liên kết.

DDMS có thể phân bổ một IDevice mới mỗi khi thiết bị ngắt kết nối và kết nối lại với adb. Do đó, phương thức gọi không được giữ lại tham chiếu đến IDevice, vì tham chiếu đó có thể đã lỗi thời.

Giá trị trả về
IDevice	IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Trả về giá trị số nguyên của thuộc tính đã cho từ thiết bị.

Tham số
name	String: tên thuộc tính
defaultValue	long: giá trị mặc định trả về nếu thuộc tính trống hoặc không tồn tại.

Giá trị trả về
long	giá trị thuộc tính hoặc defaultValue nếu thuộc tính trống, không tồn tại hoặc không có giá trị số nguyên.

Gửi
DeviceNotAvailableException

getLastSuggestedRestartTimeMillis cho lượt khởi động lại

public abstract long getLastExpectedRebootTimeMillis ()

Trả về lần gần đây nhất Trade tác API kích hoạt quá trình khởi động lại tính bằng mili giây kể từ khi EPOCH được System.currentTimeMillis() trả về.

Giá trị trả về
long

getLaunchApilevel

public abstract int getLaunchApiLevel ()

Lấy Cấp độ API đầu tiên của thiết bị. Giá trị mặc định là UNKNOWN_API_LEVEL.

Giá trị trả về
int	một số nguyên cho biết Cấp độ API khởi chạy đầu tiên của thiết bị

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

lấy Logcat

public abstract InputStreamSource getLogcat ()

Lấy một luồng tổng quan nhanh của dữ liệu logcat.

Hoạt động ở hai chế độ:

Nếu logcat đang được ghi ở chế độ nền, thì hệ thống sẽ trả về tối đa TestDeviceOptions.getMaxLogcatDataSize() byte nội dung hiện tại của bản ghi logcat ở chế độ nền

Nếu không, hàm sẽ trả về một tệp kết xuất tĩnh của dữ liệu logcat nếu thiết bị hiện đang phản hồi

Giá trị trả về
InputStreamSource

lấy Logcat

public abstract InputStreamSource getLogcat (int maxBytes)

Lấy luồng ảnh chụp nhanh của maxBytes dữ liệu logcat đã thu thập gần đây nhất.

Hữu ích cho các trường hợp bạn muốn thường xuyên chụp ảnh chụp nhanh dữ liệu logcat đã chụp mà không phải chịu hình phạt dung lượng ổ đĩa lớn có thể nhận được toàn bộ ảnh chụp nhanh getLogcat().

Tham số
maxBytes	int: lượng dữ liệu tối đa cần trả về. Phải là dung lượng vừa với bộ nhớ

Giá trị trả về
InputStreamSource

tải LogcatDump

public abstract InputStreamSource getLogcatDump ()

Tải tệp kết xuất logcat hiện tại cho thiết bị. Không giống như getLogcat(), phương thức này sẽ luôn trả về một tệp kết xuất tĩnh của logcat.

Nhược điểm là sẽ không có nội dung nào được trả về nếu không kết nối được với thiết bị.

Giá trị trả về
InputStreamSource	InputStreamSource dữ liệu logcat. Một luồng trống sẽ được trả về nếu không thu thập được dữ liệu logcat.

Nhận Logcat từ

public abstract InputStreamSource getLogcatSince (long date)

Lấy một luồng tổng quan nhanh về dữ liệu logcat đã ghi bắt đầu từ ngày đã cung cấp. Thời gian trên thiết bị sẽ được sử dụng getDeviceDate().

Tham số
date	long: tính bằng mili giây kể từ định dạng thời gian bắt đầu của thời điểm bắt đầu bản tổng quan nhanh cho đến hiện tại. (có thể lấy bằng cách sử dụng 'ngày +%s')

Giá trị trả về
InputStreamSource

getMountPoint

public abstract String getMountPoint (String mountName)

Trả về một điểm gắn.

Truy vấn trực tiếp thiết bị nếu không có thông tin đã lưu vào bộ nhớ đệm trong IDevice.

VIỆC CẦN LÀM: di chuyển hành vi này sang IDevice#getMountPoint(String)

Tham số
mountName	String: tên của điểm gắn

Giá trị trả về
String	điểm gắn hoặc null

Xem thêm:

• IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Trả về một MountPointInfo tương ứng với đường dẫn điểm gắn được chỉ định, hoặc null nếu đường dẫn đó không có giá trị nào được gắn hoặc không xuất hiện trong /proc/Mua sắm dưới dạng một điểm gắn.

Tham số
mountpoint	String

Giá trị trả về
ITestDevice.MountPointInfo	ERROR(/List) trong số MountPointInfo chứa thông tin trong "/proc/videos"

Gửi
DeviceNotAvailableException

Xem thêm:

• getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

Trả về phiên bản đã phân tích cú pháp của thông tin trong /proc/sticks trên thiết bị

Giá trị trả về
	ERROR(/List) trong số MountPointInfo chứa thông tin trong "/proc/videos"

Gửi
DeviceNotAvailableException

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

Phương pháp trợ giúp để xác định lượng dung lượng trống trên phân vùng thiết bị.

Tham số
partition	String

Giá trị trả về
long	lượng dung lượng trống tính bằng KB

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

Phương thức trợ giúp sẽ chạy lệnh "pidof" và "stat" đồng thời trả về đối tượng ProcessInfo có PID và thời gian bắt đầu xử lý của quy trình cụ thể.

Tham số
processName	String: Chuỗi tên thủ tục.

Giá trị trả về
ProcessInfo	ProcessInfo của processName nhất định

Gửi
DeviceNotAvailableException

getProcessPid

public abstract String getProcessPid (String process)

Trả về pid của dịch vụ hoặc giá trị rỗng nếu xảy ra lỗi.

Tham số
process	String: Chuỗi tên thủ tục.

Giá trị trả về
String

Gửi
DeviceNotAvailableException

getProductType

public abstract String getProductType ()

Phương thức thuận tiện để mua loại sản phẩm của thiết bị này.

Phương thức này sẽ hoạt động nếu thiết bị đang ở chế độ adb hoặc chế độ khởi động nhanh.

Giá trị trả về
String	tên loại sản phẩm String. Sẽ không có giá trị rỗng

Gửi
DeviceNotAvailableException	nếu mất kết nối với thiết bị và không thể khôi phục hoặc nếu không thể xác định loại sản phẩm

getProductVariant

public abstract String getProductVariant ()

Phương thức thuận tiện để mua biến thể sản phẩm của thiết bị này.

Phương thức này sẽ hoạt động nếu thiết bị đang ở chế độ adb hoặc chế độ khởi động nhanh.

Giá trị trả về
String	tên biến thể sản phẩm String hoặc null nếu không thể xác định được

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

nhận thuộc tính

public abstract String getProperty (String name)

Truy xuất giá trị thuộc tính đã cho từ thiết bị.

Tham số
name	String: tên thuộc tính

Giá trị trả về
String	giá trị thuộc tính hoặc null nếu không tồn tại

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

lấy lại Chế độ khôi phục

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

Tải chế độ khôi phục hiện tại được dùng cho thiết bị.

Giá trị trả về
ITestDevice.RecoveryMode	chế độ khôi phục hiện tại được dùng cho thiết bị.

getSerialNumber

public abstract String getSerialNumber ()

Phương thức thuận tiện để lấy số sê-ri của thiết bị này.

Giá trị trả về
String	số sê-ri String

getTombstones

public abstract  getTombstones ()

Tìm nạp và trả về danh sách tombstone trên các thiết bị. Cần phải can thiệp vào hệ thống.

là phương pháp tối ưu nhất, vì vậy nếu không lấy được một tombstone vì bất kỳ lý do gì thì tombstone sẽ bị thiếu trong danh sách. Chỉ DeviceNotAvailableException sẽ chấm dứt phương thức này sớm.

Giá trị trả về
	Danh sách các tệp tombstone, trống nếu không có tombstone.

Gửi
DeviceNotAvailableException

Xem thêm:

• Tài liệu về Tombstones

getTotalMemory

public abstract long getTotalMemory ()

Trả về tổng kích thước bộ nhớ thực tính bằng byte hoặc -1 trong trường hợp có lỗi nội bộ

Giá trị trả về
long

getUseKhởi động nhanh

public abstract boolean getUseFastbootErase ()

Chọn sử dụng định dạng xoá khởi động nhanh hay định dạng khởi động nhanh để xoá sạch một phân vùng trên thiết bị.

Giá trị trả về
boolean	true nếu tính năng xoá khởi động nhanh sẽ được sử dụng hoặc false nếu định dạng khởi động nhanh đang được sử dụng.

Xem thêm:

• fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

Giá trị trả về
boolean	true nếu thiết bị hiện có gốc adb, nếu không thì false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

isAdbTcp

public abstract boolean isAdbTcp ()

Giá trị trả về
boolean	true nếu thiết bị được kết nối với adb-over-tcp, nếu không thì false.

isAppEnumeration được hỗ trợ

public abstract boolean isAppEnumerationSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ tính năng liệt kê ứng dụng hay không

Giá trị trả về
boolean	True nếu liệt kê ứng dụng được hỗ trợ, false nếu không hỗ trợ

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Hàm isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ bỏ qua khối sdk mục tiêu thấp khi cài đặt ứng dụng hay không

Giá trị trả về
boolean	True nếu bỏ qua khối sdk mục tiêu thấp được hỗ trợ, nếu không thì là false

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

Kiểm tra xem Debugfs đã được gắn kết hay chưa.

Giá trị trả về
boolean	true nếu debugfs được liên kết

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Đã mã hoá thiết bị

public abstract boolean isDeviceEncrypted ()

Trả về nếu thiết bị được mã hoá.

Giá trị trả về
boolean	true nếu thiết bị được mã hoá.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

Trả về True nếu đường dẫn trên thiết bị là một thư mục, nếu không thì trả về false.

Tham số
deviceFilePath	String

Giá trị trả về
boolean

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Hỗ trợ Mã hoá

public abstract boolean isEncryptionSupported ()

Trả về nếu thiết bị hỗ trợ tính năng mã hoá.

Giá trị trả về
boolean	true nếu thiết bị hỗ trợ mã hoá.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

có thể thực thi

public abstract boolean isExecutable (String fullPath)

Trả về True nếu đường dẫn tệp trên thiết bị là tệp thực thi, nếu không thì trả về false.

Tham số
fullPath	String

Giá trị trả về
boolean

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Không có giao diện người dùng

public abstract boolean isHeadless ()

Trả về true nếu thiết bị không có giao diện người dùng (không có màn hình), trả về false nếu không có màn hình.

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isRuntimePermission được hỗ trợ

public abstract boolean isRuntimePermissionSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ cấp quyền khi bắt đầu chạy hay không

Giá trị trả về
boolean	True nếu quyền khi bắt đầu chạy được hỗ trợ, nếu không thì là false.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isStateKhởi động hoặc Khởi động nhanh

public abstract boolean isStateBootloaderOrFastbootd ()

Trả về giá trị true nếu thiết bị đang ở TestDeviceState#FASTBOOT hoặc TestDeviceState.FASTBOOTD.

Giá trị trả về
boolean

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Thu thập và ghi nhật ký lỗi ANR trên thiết bị.

Tham số
logger	ITestLogger: ITestLogger để ghi nhật ký các lỗi ANR.

Giá trị trả về
boolean	True nếu quá trình ghi nhật ký thành công, nếu không thì sẽ trả về false.

Gửi
DeviceNotAvailableException

đăng nhập trên thiết bị

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

Ghi lại thông điệp trong logcat của thiết bị. Đây là một lệnh gọi an toàn và sẽ không gửi ngay cả khi quá trình ghi nhật ký không thành công.

Tham số
tag	String: Thẻ mà chúng ta dùng để ghi nhật ký thông điệp của mình trong logcat.
level	Log.LogLevel: Cấp gỡ lỗi của thông báo trong logcat.
format	String: Định dạng thông báo.
args	Object: đối số sẽ được thay thế thông qua String.format().

Debugfs

public abstract void mountDebugfs ()

Gắn gỡ lỗi.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

không chặn khởi động lại

public abstract void nonBlockingReboot ()

Đưa ra lệnh để khởi động lại thiết bị và quay lại khi lệnh hoàn tất và khi thiết bị không còn hiển thị với adb.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Thiết lập postBoot

public abstract void postBootSetup ()

Thực hiện hướng dẫn định cấu hình thiết bị để kiểm thử sau mỗi lần khởi động.

Sẽ được gọi sau khi thiết bị khởi động xong/có sẵn

Trong các trường hợp thông thường, bạn không cần gọi phương thức này một cách rõ ràng, vì các quá trình triển khai sẽ tự động thực hiện các bước này khi khởi động lại.

Vị trí có thể cần gọi là khi thiết bị khởi động lại do các sự kiện khác (ví dụ: khi lệnh cập nhật khởi động nhanh đã hoàn tất)

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

PostInvocationTearDown

public void postInvocationTearDown ()

Phương thức này không còn được dùng nữa.
Thay vào đó, hãy sử dụng postInvocationTearDown(Throwable).

Các bước bổ sung để dọn dẹp bắt buộc theo thiết bị cụ thể sẽ được thực thi sau khi lệnh gọi hoàn tất.

PostInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

Các bước bổ sung để dọn dẹp bắt buộc theo thiết bị cụ thể sẽ được thực thi sau khi lệnh gọi hoàn tất.

Tham số
invocationException	Throwable: nếu có thì ngoại lệ cuối cùng do lỗi lệnh gọi phát sinh.

Thiết lập preInvocation

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

Các bước bổ sung để thiết lập bắt buộc theo thiết bị cụ thể sẽ được thực thi trên thiết bị trước quy trình gọi.

Tham số
info	IBuildInfo: IBuildInfo của thiết bị.
attributes	MultiMap: Các thuộc tính được lưu trữ trong ngữ cảnh lệnh gọi

Gửi
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
TargetSetupError

kéoDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Lấy nội dung thư mục từ thiết bị theo cách đệ quy.

Tham số
deviceFilePath	String: đường dẫn tệp tuyệt đối của nguồn từ xa
localDir	File: thư mục cục bộ để kéo tệp vào

Giá trị trả về
boolean	true nếu bạn kéo tệp thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

kéoDir

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

Lấy nội dung thư mục từ thiết bị theo cách đệ quy.

Tham số
deviceFilePath	String: đường dẫn tệp tuyệt đối của nguồn từ xa
localDir	File: thư mục cục bộ để kéo tệp vào
userId	int: mã nhận dạng người dùng cần lấy

Giá trị trả về
boolean	true nếu bạn kéo tệp thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

tệp kéo

public abstract File pullFile (String remoteFilePath, 
                int userId)

Truy xuất một tệp ra khỏi thiết bị, lưu trữ tệp đó trong ERROR(/File) cục bộ tạm thời và trả về File đó.

Tham số
remoteFilePath	String: đường dẫn tuyệt đối đến tệp trên thiết bị.
userId	int: Mã nhận dạng người dùng cần lấy

Giá trị trả về
File	ERROR(/File) chứa nội dung của tệp trên thiết bị hoặc null nếu không sao chép được vì bất kỳ lý do nào (bao gồm cả các sự cố về hệ thống tệp lưu trữ)

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

tệp kéo

public abstract File pullFile (String remoteFilePath)

Truy xuất một tệp ra khỏi thiết bị, lưu trữ tệp đó trong ERROR(/File) cục bộ tạm thời và trả về File đó.

Tham số
remoteFilePath	String: đường dẫn tuyệt đối đến tệp trên thiết bị.

Giá trị trả về
File	ERROR(/File) chứa nội dung của tệp trên thiết bị hoặc null nếu không sao chép được vì bất kỳ lý do nào (bao gồm cả các sự cố về hệ thống tệp lưu trữ)

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

tệp kéo

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Truy xuất tệp ra khỏi thiết bị.

Tham số
remoteFilePath	String: đường dẫn tuyệt đối đến tệp trên thiết bị.
localFile	File: tệp cục bộ để lưu trữ nội dung. Nếu giá trị không trống, nội dung sẽ bị thay thế.

Giá trị trả về
boolean	true nếu tệp được truy xuất thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

tệp kéo

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

Truy xuất tệp ra khỏi thiết bị.

Tham số
remoteFilePath	String: đường dẫn tuyệt đối đến tệp trên thiết bị.
localFile	File: tệp cục bộ để lưu trữ nội dung. Nếu giá trị không trống, nội dung sẽ bị thay thế.
userId	int: Mã nhận dạng người dùng cần lấy

Giá trị trả về
boolean	true nếu tệp được truy xuất thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

putFileContents

public abstract String pullFileContents (String remoteFilePath)

Truy xuất tệp ra khỏi thiết bị và trả về nội dung.

Tham số
remoteFilePath	String: đường dẫn tuyệt đối đến tệp trên thiết bị.

Giá trị trả về
String	String chứa nội dung của tệp trên thiết bị hoặc null nếu không sao chép được vì bất kỳ lý do nào (bao gồm cả các sự cố về hệ thống tệp lưu trữ)

Gửi
DeviceNotAvailableException

kéotệp từ bên ngoài

public abstract File pullFileFromExternal (String remoteFilePath)

Một phương thức tiện lợi để truy xuất một tệp từ bộ nhớ ngoài của thiết bị, lưu trữ tệp đó trong ERROR(/File) tạm thời cục bộ và trả về một tệp tham chiếu đến File đó.

Tham số
remoteFilePath	String: đường dẫn đến tệp trên thiết bị, so với điểm gắn bộ nhớ ngoài của thiết bị

Giá trị trả về
File	ERROR(/File) chứa nội dung của tệp trên thiết bị hoặc null nếu không sao chép được vì bất kỳ lý do nào (bao gồm cả các sự cố về hệ thống tệp lưu trữ)

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

pushDir

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

Đẩy định kỳ các nội dung trong thư mục sang thiết bị.

Tham số
localDir	File: thư mục cục bộ sẽ đẩy
deviceFilePath	String: đường dẫn tệp tuyệt đối của đích đến từ xa
userId	int: mã nhận dạng người dùng cần đẩy đến

Giá trị trả về
boolean	true nếu bạn đẩy tệp thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

pushDir

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

Đẩy định kỳ các nội dung trong thư mục sang thiết bị, đồng thời loại trừ một số thư mục đã được lọc.

Tham số
localDir	File: thư mục cục bộ sẽ đẩy
deviceFilePath	String: đường dẫn tệp tuyệt đối của đích đến từ xa
excludedDirectories	: Tập hợp tên của các thư mục bị loại trừ không được đẩy lên.

Giá trị trả về
boolean	true nếu bạn đẩy tệp thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Đẩy định kỳ các nội dung trong thư mục sang thiết bị.

Tham số
localDir	File: thư mục cục bộ sẽ đẩy
deviceFilePath	String: đường dẫn tệp tuyệt đối của đích đến từ xa

Giá trị trả về
boolean	true nếu bạn đẩy tệp thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

tệp đẩy

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

Biến thể của pushFile(File, String) có thể xem xét đánh giá nhu cầu của trình cung cấp nội dung (không bắt buộc).

Tham số
localFile	File: tệp cục bộ cần đẩy
deviceFilePath	String: đường dẫn tệp tuyệt đối cho đích đến từ xa
evaluateContentProviderNeeded	boolean: liệu để kiểm tra xem chúng tôi có cần trình cung cấp nội dung hay không

Giá trị trả về
boolean	true nếu bạn đẩy tệp thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

tệp đẩy

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

Đẩy tệp vào thiết bị. Theo mặc định, việc sử dụng trình cung cấp nội dung.

Tham số
localFile	File: tệp cục bộ cần đẩy
deviceFilePath	String: đường dẫn tệp tuyệt đối cho đích đến từ xa

Giá trị trả về
boolean	true nếu bạn đẩy tệp thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

tệp đẩy

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

Đẩy tệp vào thiết bị. Theo mặc định, việc sử dụng trình cung cấp nội dung.

Tham số
localFile	File: tệp cục bộ cần đẩy
deviceFilePath	String: đường dẫn tệp tuyệt đối cho đích đến từ xa
userId	int: userId để đẩy đến

Giá trị trả về
boolean	true nếu bạn đẩy tệp thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

chuỗi thông báo đẩy

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Đẩy tệp được tạo từ một chuỗi đến thiết bị

Tham số
contents	String: nội dung của tệp cần đẩy
deviceFilePath	String: đường dẫn tệp tuyệt đối cho đích đến từ xa

Giá trị trả về
boolean	true nếu chuỗi được đẩy thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

khởi động lại

public abstract void reboot ()

Khởi động lại thiết bị ở chế độ adb.

Các quy tắc chặn cho đến khi có thiết bị.

Gửi
DeviceNotAvailableException	nếu thiết bị không khả dụng sau khi khởi động lại

khởi động lại

public abstract void reboot (String reason)

Khởi động lại thiết bị ở chế độ adb bằng reason nhất định để duy trì khi khởi động lại.

Các quy tắc chặn cho đến khi có thiết bị.

Bạn có thể biết lý do khởi động lại lần gần đây nhất bằng cách truy vấn truy vấn truy vấn sys.boot.reason.

Tham số
reason	String: lý do khởi động lại hoặc null nếu bạn không chỉ định lý do.

Gửi
DeviceNotAvailableException	nếu thiết bị không khả dụng sau khi khởi động lại

khởi động lạiIntoBootloader

public abstract void rebootIntoBootloader ()

Khởi động lại thiết bị ở chế độ trình tải khởi động.

Chặn cho đến khi thiết bị ở chế độ trình tải khởi động.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

khởi động lạiIntoFastbootd

public abstract void rebootIntoFastbootd ()

Khởi động lại thiết bị ở chế độ khởi động nhanh.

Chặn cho đến khi thiết bị ở chế độ khởi động nhanh.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

khởi động lạiIntoRecovery

public abstract void rebootIntoRecovery ()

Khởi động lại thiết bị ở chế độ khôi phục adb.

Chặn cho đến khi thiết bị chuyển sang bước khôi phục

Gửi
DeviceNotAvailableException	nếu thiết bị không khả dụng sau khi khởi động lại

khởi động lạiIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Khởi động lại thiết bị ở chế độ tải không qua cửa hàng adb (lưu ý rằng đây là chế độ đặc biệt đang trong quá trình khôi phục)

Chặn cho đến khi thiết bị chuyển sang chế độ cài đặt không qua cửa hàng ứng dụng

Tham số
autoReboot	boolean: có tự động khởi động lại thiết bị sau khi cài đặt không qua cửa hàng ứng dụng hay không

Gửi
DeviceNotAvailableException	nếu thiết bị không tải không qua cửa hàng ứng dụng sau khi khởi động lại

khởi động lạiIntoSideload

public abstract void rebootIntoSideload ()

Khởi động lại thiết bị ở chế độ tải không qua cửa hàng adb (lưu ý rằng đây là chế độ đặc biệt đang trong quá trình khôi phục)

Chặn cho đến khi thiết bị chuyển sang chế độ cài đặt không qua cửa hàng ứng dụng

Gửi
DeviceNotAvailableException	nếu thiết bị không tải không qua cửa hàng ứng dụng sau khi khởi động lại

khởi động lại cho đến khi trực tuyến

public abstract void rebootUntilOnline ()

Một giải pháp thay thế cho reboot() chỉ chặn cho đến khi thiết bị kết nối mạng, tức là hiển thị với adb.

Gửi
DeviceNotAvailableException	nếu thiết bị không khả dụng sau khi khởi động lại

khởi động lại cho đến khi trực tuyến

public abstract void rebootUntilOnline (String reason)

Một giải pháp thay thế cho reboot() chỉ chặn cho đến khi thiết bị kết nối mạng, tức là hiển thị với adb.

Tham số
reason	String: lý do khởi động lại hoặc null nếu bạn không chỉ định lý do.

Gửi
DeviceNotAvailableException	nếu thiết bị không khả dụng sau khi khởi động lại

Xem thêm:

• reboot(String)

khởi động lạikhông gian người dùng

public abstract void rebootUserspace ()

Chỉ khởi động lại một phần trong không gian người dùng của thiết bị.

Các quy tắc chặn cho đến khi có thiết bị.

CẢNH BÁO. Quá trình khởi động lại không gian người dùng hiện đang trong quá trình phát triển. Bạn tự chịu rủi ro khi sử dụng quá trình này.

Gửi
DeviceNotAvailableException	nếu thiết bị không khả dụng sau khi khởi động lại

khởi động lại

public abstract void rebootUserspaceUntilOnline ()

Một phương thức thay thế cho rebootUserspace() ()} chỉ chặn cho đến khi thiết bị xuất hiện trực tuyến, tức là hiển thị với adb.

Gửi
DeviceNotAvailableException	nếu thiết bị không khả dụng sau khi khởi động lại

chỉ đọc lại hệ thống

public abstract void remountSystemReadOnly ()

Đặt phân vùng hệ thống trên thiết bị ở chế độ chỉ có thể đọc. Có thể khởi động lại thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

kết nối lạiHệ thống có thể ghi

public abstract void remountSystemWritable ()

Đặt phân vùng hệ thống trên thiết bị ở chế độ có thể ghi. Có thể khởi động lại thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

chỉ đọc lại nhà cung cấp

public abstract void remountVendorReadOnly ()

Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ có thể đọc. Có thể khởi động lại thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

gắn lại nhà cung cấp có thể ghi

public abstract void remountVendorWritable ()

Tạo phân vùng nhà cung cấp trên thiết bị có thể ghi. Có thể khởi động lại thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

chạyInstrumentationTests

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

Phương thức thuận tiện để biểu diễn ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) với một hoặc nhiều trình nghe được truyền dưới dạng tham số.

Tham số
runner	IRemoteAndroidTestRunner: IRemoteAndroidTestRunner chạy các bài kiểm thử
listeners	ITestLifeCycleReceiver: (các) trình nghe kết quả kiểm thử

Giá trị trả về
boolean	true nếu lệnh kiểm thử đã hoàn tất. false nếu không hoàn tất được nhưng khôi phục thành công

Gửi
DeviceNotAvailableException	nếu mất kết nối với thiết bị và không thể khôi phục, tức là không hoàn tất được lệnh kiểm tra và không khôi phục được.

chạyInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Chạy kiểm thử đo lường và cung cấp dịch vụ khôi phục thiết bị.

Nếu mất kết nối với thiết bị trước khi chạy kiểm thử hoàn tất và khôi phục thành công, tất cả trình nghe sẽ được thông báo về testRunFailed và thông báo "false" sẽ được trả về. Lệnh kiểm thử sẽ không được chạy lại. Người gọi sẽ có quyền thử lại nếu cần.

Nếu bị mất kết nối với thiết bị trước khi lần chạy kiểm thử hoàn tất và quá trình khôi phục không thành công, thì tất cả trình nghe sẽ được thông báo về testRunFailed và DeviceNotAvailableException.

Tham số
runner	IRemoteAndroidTestRunner: IRemoteAndroidTestRunner chạy các bài kiểm thử
listeners	: trình nghe kết quả kiểm thử

Giá trị trả về
boolean	true nếu lệnh kiểm thử đã hoàn tất. false nếu không hoàn tất được do ngoại lệ về việc giao tiếp với thiết bị nhưng đã khôi phục thành công

Gửi
DeviceNotAvailableException	nếu mất kết nối với thiết bị và không thể khôi phục, tức là không hoàn tất được lệnh kiểm tra và không khôi phục được.

runInstrumentationTestsAsUser

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

Giống như ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) nhưng chạy kiểm thử cho người dùng cụ thể.

Tham số
runner	IRemoteAndroidTestRunner
userId	int
listeners

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

runInstrumentationTestsAsUser

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

Giống như ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) nhưng chạy kiểm thử cho một người dùng cụ thể.

Tham số
runner	IRemoteAndroidTestRunner
userId	int
listeners	ITestLifeCycleReceiver

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

ngày đặt

public abstract void setDate (Date date)

Đặt ngày trên thiết bị

Lưu ý: việc đặt ngày trên thiết bị yêu cầu thư mục gốc

Tham số
date	Date: chỉ định một ngày cụ thể; sẽ sử dụng ngày lưu trữ nếu null

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setOptions

public abstract void setOptions (TestDeviceOptions options)

Đặt TestDeviceOptions cho thiết bị

Tham số
options	TestDeviceOptions

đặt thuộc tính

public abstract boolean setProperty (String propKey, 
                String propValue)

Đặt giá trị thuộc tính đã cho trên thiết bị. Yêu cầu gốc adb là true.

Tham số
propKey	String: Khoá được nhắm mục tiêu cần đặt.
propValue	String: Giá trị thuộc tính cần đặt.

Giá trị trả về
boolean	sẽ trả về True nếu lệnh setprop thành công, nếu không thì sẽ trả về False.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Đặt lại

public abstract void setRecovery (IDeviceRecovery recovery)

Đặt IDeviceRecovery để sử dụng cho thiết bị này. Bạn nên đặt giá trị này khi thiết bị được phân bổ lần đầu tiên.

Tham số
recovery	IDeviceRecovery: IDeviceRecovery

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Đặt chế độ khôi phục hiện tại để sử dụng cho thiết bị.

Dùng để kiểm soát phương thức khôi phục sẽ sử dụng khi gặp sự cố giao tiếp với thiết bị. Bạn chỉ nên sử dụng phương thức này một cách thận trọng khi cần (ví dụ: khi khung bị tắt, v.v.

Tham số
mode	ITestDevice.RecoveryMode: liệu có nên bật chế độ "chỉ khôi phục cho đến khi trực tuyến" hay không.

setUse FastbootXoá

public abstract void setUseFastbootErase (boolean useFastbootErase)

Đặt xem bạn nên sử dụng định dạng xoá khởi động nhanh hay định dạng khởi động nhanh để xoá sạch một phân vùng trên thiết bị.

Tham số
useFastbootErase	boolean: true nếu nên sử dụng tính năng xoá khởi động nhanh hoặc false nếu nên sử dụng định dạng khởi động nhanh.

Xem thêm:

• fastbootWipePartition(String)

bắt đầuLogcat

public abstract void startLogcat ()

Bắt đầu ghi lại đầu ra logcat từ thiết bị ở chế độ nền.

Sẽ không có hiệu lực nếu đầu ra logcat đã được ghi lại. Sau đó, bạn có thể truy xuất dữ liệu qua getLogcat.

Khi không sử dụng thiết bị nữa, bạn phải gọi stopLogcat().

startLogcat() và stopLogcat() thường không cần được gọi khi ở trong ngữ cảnh lệnh gọi TF, vì khung TF sẽ bắt đầu và dừng logcat.

dừngTrình mô phỏngOutput

public abstract void stopEmulatorOutput ()

Đóng và xoá dữ liệu đầu ra của trình mô phỏng.

dừngLogcat

public abstract void stopLogcat ()

Dừng ghi lại đầu ra logcat từ thiết bị và loại bỏ dữ liệu logcat hiện đã lưu.

Sẽ không có ảnh hưởng nếu đầu ra logcat không được ghi lại.

SwitchToAdbTcp

public abstract String switchToAdbTcp ()

Chuyển thiết bị sang chế độ adb-over-tcp.

Giá trị trả về
String	số sê-ri tcp hoặc null nếu không thể chuyển đổi thiết bị

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

SwitchToAdbUsb

public abstract boolean switchToAdbUsb ()

Chuyển thiết bị sang adb qua chế độ USB.

Giá trị trả về
boolean	true nếu quá trình chuyển đổi thành công, nếu không thì false.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

SyncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Đồng bộ hoá dần nội dung của thư mục tệp cục bộ với thiết bị.

Quyết định những tệp cần đẩy bằng cách so sánh dấu thời gian của các tệp trên máy với các tệp tương ứng từ xa. Chỉ các tệp "mới hơn" hoặc không tồn tại mới được đẩy tới thiết bị. Do đó, mức hao tổn sẽ tương đối nhỏ nếu thiết lập tệp trên thiết bị đã được cập nhật.

Các tệp ẩn (có tên bắt đầu bằng ".") sẽ bị bỏ qua.

Ví dụ về cách sử dụng: syncFiles("/tmp/files", "/sdcard") sẽ tạo thư mục /sdcard/files nếu chưa có và đẩy định kỳ nội dung /tmp/files vào /sdcard/files.

Tham số
localFileDir	File: thư mục tệp cục bộ chứa các tệp cần đẩy đệ quy.
deviceFilePath	String: gốc đường dẫn tệp tuyệt đối của đích đến từ xa. Tất cả các thư mục trong đường dẫn tệp đều phải đọc được, tức là đẩy tới /data/local/tmp khi adb không phải là thư mục gốc sẽ không thành công

Giá trị trả về
boolean	true nếu các tệp được đồng bộ hoá thành công. false.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

mở khoá thiết bị

public abstract boolean unlockDevice ()

Mở khoá thiết bị nếu thiết bị đang ở trạng thái đã mã hoá.

Phương thức này có thể khởi động lại khung nhưng sẽ không gọi postBootSetup(). Do đó, thiết bị có thể chưa sẵn sàng để được kiểm thử khi phương thức này trả về.

Giá trị trả về
boolean	true nếu thiết bị thành công hoặc nếu thiết bị chưa được mã hoá.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException	nếu thiết bị không hỗ trợ mã hoá.

gỡ lỗi gắn kết

public abstract void unmountDebugfs ()

Ngắt kết nối debugfs.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Chờ đợiKhởi động hoàn tất

public abstract boolean waitForBootComplete (long timeOut)

Chặn cho đến khi cờ hoàn tất khởi động của thiết bị được đặt.

Tham số
timeOut	long: thời gian tính bằng mili giây để chờ đặt cờ

Giá trị trả về
boolean	true nếu cờ hoàn tất khởi động của thiết bị được đặt trong thời gian chờ

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Chờ thiết bị có sẵn

public abstract boolean waitForDeviceAvailable ()

Chờ thiết bị phản hồi và sẵn sàng để kiểm thử. Sử dụng thời gian chờ mặc định.

Giá trị trả về
boolean	"True" nếu có thiết bị, False nếu tính năng khôi phục bị tắt và không hoạt động.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

Chờ thiết bị có sẵn

public abstract boolean waitForDeviceAvailable (long waitTime)

Chờ thiết bị phản hồi và sẵn sàng để kiểm thử.

Tham số
waitTime	long: thời gian tính bằng mili giây

Giá trị trả về
boolean	"True" nếu có thiết bị, False nếu tính năng khôi phục bị tắt và không hoạt động.

Gửi
DeviceNotAvailableException	nếu thiết bị vẫn không phản hồi sau khi hết thời gian chờ.

Chờ đợi thiết bị có sẵnInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Chờ thiết bị phản hồi và sẵn sàng mà không xem xét đường dẫn khôi phục.

Tham số
waitTime	long

Giá trị trả về
boolean	"True" nếu có thiết bị, False nếu không có thiết bị.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

bộ lọc khởi động thiết bị

public abstract void waitForDeviceBootloader ()

Chặn cho đến khi thiết bị hiển thị thông qua tính năng khởi động nhanh. Sử dụng thời gian chờ mặc định.

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

WaitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Các quy tắc chặn để thiết bị ở trạng thái "khôi phục adb" (lưu ý rằng điều này khác với IDeviceRecovery).

Tham số
waitTime	long: thời gian tính bằng mili giây

Giá trị trả về
boolean	true nếu thiết bị khởi động vào quá trình khôi phục trước khi hết thời gian khôi phục. Nếu không thì false

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Các quy tắc chặn để thiết bị ở trạng thái "adb sideload" (Tải không qua cửa hàng ứng dụng)

Tham số
waitTime	long: thời gian tính bằng mili giây

Giá trị trả về
boolean	true nếu thiết bị khởi động ở chế độ cài đặt không qua cửa hàng ứng dụng trước khi hết thời gian. Nếu không thì false

Chờ thiết bịKhông có sẵn

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Các quy tắc chặn thiết bị không hoạt động, tức là bị thiếu trong adb

Tham số
waitTime	long: thời gian tính bằng mili giây

Giá trị trả về
boolean	true nếu không dùng được thiết bị trước khi hết thời gian. Nếu không thì false

ChờChoThiết bịTrực tuyến

public abstract void waitForDeviceOnline ()

Chặn cho đến khi thiết bị hiển thị qua adb. Sử dụng thời gian chờ mặc định

Lưu ý rằng thiết bị có thể không nhất thiết phản hồi với các lệnh sau khi hoàn tất. Thay vào đó, hãy sử dụng waitForDeviceAvailable().

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

ChờChoThiết bịTrực tuyến

public abstract void waitForDeviceOnline (long waitTime)

Chặn cho đến khi thiết bị hiển thị qua adb.

Lưu ý rằng thiết bị có thể không nhất thiết phản hồi với các lệnh sau khi hoàn tất. Thay vào đó, hãy sử dụng waitForDeviceAvailable().

Tham số
waitTime	long: thời gian tính bằng mili giây

Gửi
DeviceNotAvailableException	nếu bị mất kết nối với thiết bị và không thể khôi phục.

WaitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Chờ thiết bị phản hồi với lệnh adb shell cơ bản.

Tham số
waitTime	long: thời gian tính bằng mili giây

Giá trị trả về
boolean	true nếu thiết bị phản hồi trước khi waitTime trôi qua.