A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

ContentProviderHandler

public class ContentProviderHandler
extends Object

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

Controlador que abstrae las interacciones del proveedor de contenido y permite usar el proveedor de contenido del dispositivo para diferentes operaciones.

Todas las implementaciones de esta clase deben tener en cuenta el usuario que se está ejecutando en el dispositivo.

Resumen

Campos
`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`

Constructores públicos
`ContentProviderHandler(ITestDevice device)` Constructor.
`ContentProviderHandler(ITestDevice device, Integer userId)`

Métodos públicos
`boolean`	`contentProviderNotFound()` Muestra verdadero si una de las operaciones falló con el mensaje No se encontró el proveedor de contenido.
`static String`	`createEscapedContentUri(String deviceFilePath)` Muestra la cadena de URI completa de la ruta de acceso del dispositivo especificada, con escape y codificación para evitar caracteres que no sean de URL.
`boolean`	`deleteFile(String deviceFilePath)` Llamada de devolución de llamada del proveedor de contenido que borra un archivo en la ubicación del URI.
`boolean`	`doesFileExist(String deviceFilePath)` Determina si el archivo o el directorio no vacío existen en el dispositivo.
`Integer`	`getUserId()` Muestra el userId con el que se inicializa esta instancia.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extrae recursivamente el contenido del directorio del dispositivo con el proveedor de contenido.
`boolean`	`pullFile(String deviceFilePath, File localFile)` Llamada de devolución de llamada del proveedor de contenido que extrae un archivo de la ubicación del URI a un archivo local.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Devolución de llamada del proveedor de contenido que envía una dir a la ubicación del URI.
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` Devolución de llamada del proveedor de contenido que envía un archivo a la ubicación del URI.
`boolean`	`setUp()` Asegúrate de que el apk del asistente del proveedor de contenido esté instalado y listo para usarse.
`void`	`tearDown()` Limpia el dispositivo del asistente del proveedor de contenido.

Campos

COLUMNAS

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

Constructores públicos

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

Constructor.

Parámetros
`device`	`ITestDevice`

Arroja
`DeviceNotAvailableException`

ContentProviderHandler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

Parámetros
`device`	`ITestDevice`
`userId`	`Integer`

Métodos públicos

contentProviderNotFound

public boolean contentProviderNotFound ()

Muestra verdadero si una de las operaciones falló con el mensaje No se encontró el proveedor de contenido. Para borrarlo, vuelve a ejecutar setUp() correctamente.

Muestra
`boolean`

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

Muestra la cadena de URI completa para la ruta de acceso del dispositivo especificada, con escape y codificación para evitar caracteres que no sean de URL.

Parámetros
`deviceFilePath`	`String`

Muestra
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

Llamada de devolución de llamada del proveedor de contenido que borra un archivo en la ubicación del URI. El archivo se borrará del contenido del dispositivo.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso en el dispositivo del archivo que se borrará.

Muestra
`boolean`	Es verdadero si se ejecuta correctamente; de lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Determina si el archivo o el directorio no vacío existen en el dispositivo.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo en el dispositivo para verificar si existe.

Muestra
`boolean`	Es verdadero si el archivo o directorio existe; de lo contrario, es falso. Si el directorio está vacío, también mostrará un valor falso.

Arroja
`DeviceNotAvailableException`

getUserId

public Integer getUserId ()

Muestra el userId con el que se inicializa esta instancia.

Muestra
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Extrae recursivamente el contenido del directorio del dispositivo con el proveedor de contenido.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo de la fuente remota.
`localDir`	`File`: Es el directorio local al que se extraen los archivos.

Muestra
`boolean`	`true` si el archivo se extrajo correctamente. `false` en caso contrario.

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

Llamada de devolución de llamada del proveedor de contenido que extrae un archivo de la ubicación del URI a un archivo local.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso en el dispositivo desde la que se extraerá el archivo.
`localFile`	`File`: Es el `ERROR(/File)` en el que se almacenará el contenido. Si no está vacío, se reemplazará el contenido.

Muestra
`boolean`	Es verdadero si se ejecuta correctamente; de lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushDir

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

Devolución de llamada del proveedor de contenido que envía una dir a la ubicación del URI.

Parámetros
`localFileDir`	`File`: Es el directorio que se enviará.
`deviceFilePath`	`String`: La ubicación en el dispositivo
`excludedDirectories`	: Directorios que no se incluyen en el envío.

Muestra
`boolean`	Es verdadero si se realiza correctamente.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

Devolución de llamada del proveedor de contenido que envía un archivo a la ubicación del URI.

Parámetros
`fileToPush`	`File`: Es el `ERROR(/File)` que se enviará al dispositivo.
`deviceFilePath`	`String`: Es la ruta de acceso en el dispositivo a la que se enviará el archivo.

Muestra
`boolean`	Es verdadero si se ejecuta correctamente; de lo contrario, es falso.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
	IllegalArgumentException
`DeviceNotAvailableException`

setUp

public boolean setUp ()

Asegúrate de que el apk del asistente del proveedor de contenido esté instalado y listo para usarse.

Muestra
`boolean`	Es verdadero si está listo para usarse; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

tearDown

public void tearDown ()

Limpia el dispositivo del asistente del proveedor de contenido.

Arroja
`DeviceNotAvailableException`