自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

ContentProviderHandler

public class ContentProviderHandler
extends Object

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

用于提取 content provider 互动并允许使用设备端 content provider 执行不同操作的 Handler。

此类中的所有实现都应注意设备上当前运行的用户。

摘要

字段
`public static final String[]`	`COLUMNS`
`public static final String`	`COLUMN_ABSOLUTE_PATH`
`public static final String`	`COLUMN_DIRECTORY`
`public static final String`	`COLUMN_METADATA`
`public static final String`	`COLUMN_MIME_TYPE`
`public static final String`	`COLUMN_NAME`
`public static final String`	`CONTENT_PROVIDER_URI`
`public static final String`	`NO_RESULTS_STRING`
`public static final String`	`PACKAGE_NAME`
`public static final String`	`QUERY_INFO_VALUE`

公共构造函数
`ContentProviderHandler(ITestDevice device)` 构造函数。
`ContentProviderHandler(ITestDevice device, Integer userId)`

公共方法
`boolean`	`contentProviderNotFound()` 如果其中某个操作因找不到内容提供程序而失败，则返回 True。
`static String`	`createEscapedContentUri(String deviceFilePath)` 返回给定设备路径的完整 URI 字符串，该字符串已转义和编码，以避免出现非网址字符。
`boolean`	`deleteFile(String deviceFilePath)` 用于删除 URI 位置的文件的内容提供程序回调。
`boolean`	`doesFileExist(String deviceFilePath)` 确定设备上是否存在文件或非空目录。
`Integer`	`getUserId()` 返回此实例的初始化 userId。
`boolean`	`pullDir(String deviceFilePath, File localDir)` 使用 content provider 递归地从设备中拉取目录内容。
`boolean`	`pullFile(String deviceFilePath, File localFile)` 用于将文件从 URI 位置拉取到本地文件的内容提供程序回调。
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` 用于将目录推送到 URI 位置的内容提供程序回调。
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` 用于将文件推送到 URI 位置的内容提供程序回调。
`boolean`	`setUp()` 确保 content provider helper apk 已安装并可供使用。
`void`	`tearDown()` 从 content provider 帮助程序中清理设备。

字段

列

public static final String[] COLUMNS

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

COLUMN_METADATA

public static final String COLUMN_METADATA

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

COLUMN_NAME

public static final String COLUMN_NAME

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

PACKAGE_NAME

public static final String PACKAGE_NAME

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

公共构造函数

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

构造函数。

参数
`device`	`ITestDevice`

抛出
`DeviceNotAvailableException`

ContentProviderHandler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

参数
`device`	`ITestDevice`
`userId`	`Integer`

公共方法

contentProviderNotFound

public boolean contentProviderNotFound ()

如果其中某个操作因找不到内容提供程序而失败，则返回 True。可以通过再次成功运行 setUp() 来清除。

返回
`boolean`

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

返回给定设备路径的完整 URI 字符串，该字符串已转义和编码，以避免出现非网址字符。

参数
`deviceFilePath`	`String`

返回
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

用于删除 URI 位置的文件的内容提供程序回调。文件将从设备内容中删除。

参数
`deviceFilePath`	`String`：要删除的文件在设备上的路径。

返回
`boolean`	如果成功则返回 true，否则返回 false

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

确定设备上是否存在文件或非空目录。

参数
`deviceFilePath`	`String`：设备上要检查是否存在的绝对文件路径。

返回
`boolean`	如果文件/目录存在，则返回 True；否则返回 False。如果目录为空，它也会返回 False。

抛出
`DeviceNotAvailableException`

getUserId

public Integer getUserId ()

返回此实例的初始化 userId。

返回
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

使用 content provider 递归地从设备中拉取目录内容。

参数
`deviceFilePath`	`String`：远程源的绝对文件路径
`localDir`	`File`：要将文件拉取到的本地目录

返回
`boolean`	如果文件成功拉取，则为 `true`；否则为 `false`。

抛出
`DeviceNotAvailableException`	如果与设备的连接断开且无法恢复。

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

用于将文件从 URI 位置拉取到本地文件的内容提供程序回调。

参数
`deviceFilePath`	`String`：设备上要从中拉取文件的路径。
`localFile`	`File`：用于存储内容的 `ERROR(/File)`。如果不为空，则会替换内容。

返回
`boolean`	如果成功则返回 true，否则返回 false

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushDir

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

用于将目录推送到 URI 位置的内容提供程序回调。

参数
`localFileDir`	`File`：要推送的目录
`deviceFilePath`	`String`：设备端位置信息
`excludedDirectories`	：推送操作中未包含的目录。

返回
`boolean`	如果成功，则为 true

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

用于将文件推送到 URI 位置的内容提供程序回调。

参数
`fileToPush`	`File`：要推送到设备的 `ERROR(/File)`。
`deviceFilePath`	`String`：设备上用于推送文件的路径。

返回
`boolean`	如果成功则返回 true，否则返回 false

抛出
	com.android.tradefed.device.DeviceNotAvailableException
	IllegalArgumentException
`DeviceNotAvailableException`

setUp

public boolean setUp ()

确保 content provider helper apk 已安装并可供使用。

返回
`boolean`	如果可以使用，则为 true；否则为 false。

抛出
`DeviceNotAvailableException`

tearDown

public void tearDown ()

从 content provider 帮助程序中清理设备。

抛出
`DeviceNotAvailableException`