A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

ContentProviderHandler

public class ContentProviderHandler
extends Object

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

Handler que abstrai as interações do provedor de conteúdo e permite usar o provedor de conteúdo do dispositivo para diferentes operações.

Todas as implementações nesta classe precisam considerar o usuário que está em execução no dispositivo.

Resumo

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`

Construtores públicos
`ContentProviderHandler(ITestDevice device)` Construtor.
`ContentProviderHandler(ITestDevice device, Integer userId)`

Métodos públicos
`boolean`	`contentProviderNotFound()` Retorna "True" se uma das operações falhar com o conteúdo do provedor não encontrado.
`static String`	`createEscapedContentUri(String deviceFilePath)` Retorna a string de URI completa para o caminho do dispositivo fornecido, codificada e com escape para evitar caracteres que não sejam de URL.
`boolean`	`deleteFile(String deviceFilePath)` Callback do provedor de conteúdo que exclui um arquivo no local do URI.
`boolean`	`doesFileExist(String deviceFilePath)` Determina se o arquivo ou diretório não vazio existe no dispositivo.
`Integer`	`getUserId()` Retorna o userId com que essa instância é inicializada.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extrair recursivamente o conteúdo do diretório do dispositivo usando o provedor de conteúdo.
`boolean`	`pullFile(String deviceFilePath, File localFile)` Callback do provedor de conteúdo que extrai um arquivo do local do URI para um arquivo local.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Callback do provedor de conteúdo que envia um diretório para o local do URI.
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` Callback do provedor de conteúdo que envia um arquivo para o local do URI.
`boolean`	`setUp()` Confira se o APK do auxiliar do provedor de conteúdo está instalado e pronto para uso.
`void`	`tearDown()` Limpe o dispositivo do auxiliar do provedor de conteúdo.

Campos

COLUNAS

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

Construtores públicos

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

Construtor.

Parâmetros
`device`	`ITestDevice`

Gera
`DeviceNotAvailableException`

ContentProviderHandler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

Parâmetros
`device`	`ITestDevice`
`userId`	`Integer`

Métodos públicos

contentProviderNotFound

public boolean contentProviderNotFound ()

Retorna "True" se uma das operações falhar com o conteúdo do provedor não encontrado. Pode ser limpo executando setUp() novamente.

Retorna
`boolean`

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

Retorna a string de URI completa para o caminho do dispositivo fornecido, codificada e com escape para evitar caracteres que não sejam de URL.

Parâmetros
`deviceFilePath`	`String`

Retorna
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

Callback do provedor de conteúdo que exclui um arquivo no local do URI. O arquivo será excluído do conteúdo do dispositivo.

Parâmetros
`deviceFilePath`	`String`: o caminho no dispositivo do arquivo a ser excluído.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, false.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Determina se o arquivo ou diretório não vazio existe no dispositivo.

Parâmetros
`deviceFilePath`	`String`: o caminho de arquivo absoluto no dispositivo para verificar a existência.

Retorna
`boolean`	Verdadeiro se o arquivo/diretório existir. Falso, caso contrário. Se o diretório estiver vazio, ele também retornará False.

Gera
`DeviceNotAvailableException`

getUserId

public Integer getUserId ()

Retorna o userId com que essa instância é inicializada.

Retorna
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Extrair recursivamente o conteúdo do diretório do dispositivo usando o provedor de conteúdo.

Parâmetros
`deviceFilePath`	`String`: o caminho de arquivo absoluto da origem remota
`localDir`	`File`: o diretório local para extrair arquivos

Retorna
`boolean`	`true` se o arquivo foi extraído. `false` se não forem.

Gera
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

Callback do provedor de conteúdo que extrai um arquivo do local do URI para um arquivo local.

Parâmetros
`deviceFilePath`	`String`: o caminho no dispositivo de onde o arquivo será extraído.
`localFile`	`File`: o `ERROR(/File)` em que o conteúdo será armazenado. Se não estiver vazio, o conteúdo será substituído.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, false.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushDir

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

Callback do provedor de conteúdo que envia um diretório para o local do URI.

Parâmetros
`localFileDir`	`File`: o diretório a ser enviado
`deviceFilePath`	`String`: o local no dispositivo
`excludedDirectories`	: diretórios não incluídos no push.

Retorna
`boolean`	Verdadeiro se for bem-sucedido

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

Callback do provedor de conteúdo que envia um arquivo para o local do URI.

Parâmetros
`fileToPush`	`File`: o `ERROR(/File)` a ser enviado ao dispositivo.
`deviceFilePath`	`String`: o caminho no dispositivo para enviar o arquivo.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, false.

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

setUp

public boolean setUp ()

Confira se o APK do auxiliar do provedor de conteúdo está instalado e pronto para uso.

Retorna
`boolean`	Verdadeiro se estiver pronto para uso. Caso contrário, é falso.

Gera
`DeviceNotAvailableException`

tearDown

public void tearDown ()

Limpe o dispositivo do auxiliar do provedor de conteúdo.

Gera
`DeviceNotAvailableException`