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

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

Toda la implementación en esta clase debe tener en cuenta al usuario que se está ejecutando actualmente en el dispositivo.

Resumen

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

Campos
`public static final String[]`	`COLUMNS`

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

Métodos públicos
`boolean`	`contentProviderNotFound()` Devuelve True si una de las operaciones falló con el mensaje Content provider not found.
`static String`	`createEscapedContentUri(String deviceFilePath)` Devuelve la cadena de URI completa para la ruta de acceso del dispositivo determinada, con caracteres de escape y codificada para evitar caracteres que no sean de URL.
`boolean`	`deleteFile(String deviceFilePath)` Es una 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 existe en el dispositivo.
`IRunUtil`	`getRunUtil()`
`Integer`	`getUserId()` Devuelve el ID de usuario con el que se inicializó esta instancia.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extrae de forma recursiva el contenido del directorio del dispositivo con el proveedor de contenido.
`boolean`	`pullFile(String deviceFilePath, File localFile)` Es una 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 un directorio 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.
`void`	`setRunUtil(IRunUtil runUtil)`
`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.

Constantes

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

Valor de la constante: "absolute_path"

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

Valor de la constante: "is_directory"

COLUMN_METADATA

public static final String COLUMN_METADATA

Valor de la constante: "metadata"

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

Valor de la constante: "mime_type"

COLUMN_NAME

public static final String COLUMN_NAME

Valor de la constante: "name"

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

Valor de la constante: "content://android.tradefed.contentprovider"

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

Valor de la constante: "No se encontraron resultados".

PACKAGE_NAME

public static final String PACKAGE_NAME

Valor constante: "android.tradefed.contentprovider"

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

Valor de la constante: "INFO"

Campos

COLUMNS

public static final String[] COLUMNS

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

Devuelve True si una de las operaciones falló con el mensaje Content provider not found. Se puede borrar si se vuelve a ejecutar setUp() correctamente.

Muestra
`boolean`

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

Devuelve la cadena de URI completa para la ruta de acceso del dispositivo determinada, con caracteres de escape y codificada para evitar caracteres que no sean de URL.

Parámetros
`deviceFilePath`	`String`

Muestra
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

Es una 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 existe en el dispositivo.

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

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

Arroja
`DeviceNotAvailableException`

getRunUtil

public IRunUtil getRunUtil ()

Muestra
`IRunUtil`

getUserId

public Integer getUserId ()

Devuelve el ID de usuario con el que se inicializó esta instancia.

Muestra
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Extrae de forma recursiva 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 en el que se extraerán los archivos.

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

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

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

Es una 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 un directorio a la ubicación del URI.

Parámetros
`localFileDir`	`File`: El directorio para enviar
`deviceFilePath`	`String`: La ubicación en el dispositivo
`excludedDirectories`	: Son los directorios que no se incluyen en la transferencia.

Muestra
`boolean`	Es verdadero si se ejecuta 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 en la que se transferirá el archivo.

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

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

setRunUtil

public void setRunUtil (IRunUtil runUtil)

Parámetros
`runUtil`	`IRunUtil`

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 y falso en caso contrario.

Arroja
`DeviceNotAvailableException`

tearDown

public void tearDown ()

Limpia el dispositivo del asistente del proveedor de contenido.

Arroja
`DeviceNotAvailableException`