Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

ContentProviderHandler

public class ContentProviderHandler
extends Object

java.lang.Object
↳	com.android.tradefed.device.contentprovider.ContentProviderHandler

Trình xử lý trừu tượng các hoạt động tương tác của trình cung cấp nội dung và cho phép sử dụng trình cung cấp nội dung phía thiết bị cho nhiều thao tác.

Mọi hoạt động triển khai trong lớp này đều phải lưu ý đến người dùng hiện đang chạy trên thiết bị.

Tóm tắt

Hằng số
`String`	`COLUMN_ABSOLUTE_PATH`
`String`	`COLUMN_DIRECTORY`
`String`	`COLUMN_METADATA`
`String`	`COLUMN_MIME_TYPE`
`String`	`COLUMN_NAME`
`String`	`CONTENT_PROVIDER_URI`
`String`	`NO_RESULTS_STRING`
`String`	`PACKAGE_NAME`
`String`	`QUERY_INFO_VALUE`

Trường
`public static final String[]`	`COLUMNS`

Hàm khởi tạo công khai
`ContentProviderHandler(ITestDevice device)` Hàm khởi tạo.
`ContentProviderHandler(ITestDevice device, Integer userId)`

Phương thức công khai
`boolean`	`contentProviderNotFound()` Trả về True nếu một trong các thao tác không thành công do không tìm thấy Trình cung cấp nội dung.
`static String`	`createEscapedContentUri(String deviceFilePath)` Trả về chuỗi URI đầy đủ cho đường dẫn thiết bị đã cho, được thoát và mã hoá để tránh các ký tự không phải URL.
`boolean`	`deleteFile(String deviceFilePath)` Lệnh gọi lại của trình cung cấp nội dung sẽ xoá một tệp tại vị trí URI.
`boolean`	`doesFileExist(String deviceFilePath)` Xác định xem tệp hoặc thư mục không trống có tồn tại trên thiết bị hay không.
`IRunUtil`	`getRunUtil()`
`Integer`	`getUserId()` Trả về userId mà phiên bản này được khởi tạo.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Truy xuất đệ quy nội dung thư mục từ thiết bị bằng trình cung cấp nội dung.
`boolean`	`pullFile(String deviceFilePath, File localFile)` Lệnh gọi lại của trình cung cấp nội dung kéo một tệp từ vị trí URI vào một tệp cục bộ.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Lệnh gọi lại của trình cung cấp nội dung sẽ đẩy một thư mục đến vị trí URI.
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` Lệnh gọi lại của trình cung cấp nội dung đẩy một tệp đến vị trí URI.
`void`	`setRunUtil(IRunUtil runUtil)`
`boolean`	`setUp()` Đảm bảo bạn đã cài đặt và sẵn sàng sử dụng apk trợ lý của trình cung cấp nội dung.
`void`	`tearDown()` Xoá thiết bị khỏi trình trợ giúp nhà cung cấp nội dung.

Hằng số

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

Giá trị không đổi: "absolute_path"

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

Giá trị không đổi: "is_directory"

COLUMN_METADATA

public static final String COLUMN_METADATA

Giá trị không đổi: "metadata"

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

Giá trị không đổi: "mime_type"

COLUMN_NAME

public static final String COLUMN_NAME

Giá trị không đổi: "name"

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

Giá trị không đổi: "content://android.tradefed.contentprovider"

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

Giá trị không đổi: "Không tìm thấy kết quả nào."

PACKAGE_NAME

public static final String PACKAGE_NAME

Giá trị không đổi: "android.tradefed.contentprovider"

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

Giá trị không đổi: "INFO"

Trường

HÀM COLUMNS

public static final String[] COLUMNS

Hàm khởi tạo công khai

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

Hàm khởi tạo.

Tham số
`device`	`ITestDevice`

Gửi
`DeviceNotAvailableException`

ContentProviderHandler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

Tham số
`device`	`ITestDevice`
`userId`	`Integer`

Phương thức công khai

contentProviderNotFound

public boolean contentProviderNotFound ()

Trả về True nếu một trong các thao tác không thành công do không tìm thấy Trình cung cấp nội dung. Có thể xoá bằng cách chạy lại setUp() thành công.

Giá trị trả về
`boolean`

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

Trả về chuỗi URI đầy đủ cho đường dẫn thiết bị đã cho, được thoát và mã hoá để tránh các ký tự không phải URL.

Tham số
`deviceFilePath`	`String`

Giá trị trả về
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

Lệnh gọi lại của trình cung cấp nội dung sẽ xoá một tệp tại vị trí URI. Tệp sẽ bị xoá khỏi nội dung trên thiết bị.

Tham số
`deviceFilePath`	`String`: Đường dẫn trên thiết bị của tệp cần xoá.

Giá trị trả về
`boolean`	True nếu thành công, False nếu không

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

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Xác định xem tệp hoặc thư mục không trống có tồn tại trên thiết bị hay không.

Tham số
`deviceFilePath`	`String`: Đường dẫn tuyệt đối đến tệp trên thiết bị để kiểm tra sự tồn tại.

Giá trị trả về
`boolean`	True nếu tệp/thư mục tồn tại, False nếu không. Nếu thư mục trống, hàm này cũng sẽ trả về False.

Gửi
`DeviceNotAvailableException`

getRunUtil

public IRunUtil getRunUtil ()

Giá trị trả về
`IRunUtil`

getUserId

public Integer getUserId ()

Trả về userId mà phiên bản này được khởi tạo.

Giá trị trả về
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Truy xuất đệ quy nội dung thư mục từ thiết bị bằng trình cung cấp nội dung.

Tham số
`deviceFilePath`	`String`: đường dẫn tuyệt đối đến tệp 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 tệp được kéo thành công. Nếu không thì là `false`.

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

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

Lệnh gọi lại của trình cung cấp nội dung kéo một tệp từ vị trí URI vào một tệp cục bộ.

Tham số
`deviceFilePath`	`String`: Đường dẫn trên thiết bị nơi bạn muốn kéo tệp.
`localFile`	`File`: `ERROR(/File)` để lưu trữ nội dung. Nếu không trống, nội dung sẽ được thay thế.

Giá trị trả về
`boolean`	True nếu thành công, False nếu không

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

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

Lệnh gọi lại của trình cung cấp nội dung sẽ đẩy một thư mục đến vị trí URI.

Tham số
`localFileDir`	`File`: Thư mục cần đẩy
`deviceFilePath`	`String`: Vị trí trên thiết bị
`excludedDirectories`	: Các thư mục không có trong lệnh đẩy.

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

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

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

Lệnh gọi lại của trình cung cấp nội dung đẩy một tệp đến vị trí URI.

Tham số
`fileToPush`	`File`: `ERROR(/File)` sẽ được chuyển đến thiết bị.
`deviceFilePath`	`String`: Đường dẫn trên thiết bị để đẩy tệp.

Giá trị trả về
`boolean`	True nếu thành công, False nếu không

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

setRunUtil

public void setRunUtil (IRunUtil runUtil)

Tham số
`runUtil`	`IRunUtil`

setUp

public boolean setUp ()

Đảm bảo bạn đã cài đặt và sẵn sàng sử dụng apk trợ lý của trình cung cấp nội dung.

Giá trị trả về
`boolean`	True nếu đã sẵn sàng sử dụng, False nếu chưa.

Gửi
`DeviceNotAvailableException`

tearDown

public void tearDown ()

Xoá thiết bị khỏi trình trợ giúp nhà cung cấp nội dung.

Gửi
`DeviceNotAvailableException`