A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

ContentProviderHandler

public class ContentProviderHandler
extends Object

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

Handler che astrae le interazioni con i fornitori di contenuti e consente di utilizzare il fornitore di contenuti lato dispositivo per operazioni diverse.

Tutta l'implementazione in questa classe deve tenere conto dell'utente attualmente in esecuzione sul dispositivo.

Riepilogo

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

Costruttori pubblici
`ContentProviderHandler(ITestDevice device)` Costruttore.
`ContentProviderHandler(ITestDevice device, Integer userId)`

Metodi pubblici
`boolean`	`contentProviderNotFound()` Restituisce True se una delle operazioni non è riuscita perché il fornitore di contenuti non è stato trovato.
`static String`	`createEscapedContentUri(String deviceFilePath)` Restituisce la stringa URI completa per il percorso del dispositivo specificato, con caratteri di escape e codificati per evitare caratteri non URL.
`boolean`	`deleteFile(String deviceFilePath)` Callback del provider di contenuti che elimina un file nella posizione dell'URI.
`boolean`	`doesFileExist(String deviceFilePath)` Determina se il file o la directory non vuota esiste sul dispositivo.
`Integer`	`getUserId()` Restituisce l'attributo userId con cui è stata inizializzata questa istanza.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Estrai in modo ricorsivo i contenuti della directory dal dispositivo utilizzando il fornitore di contenuti.
`boolean`	`pullFile(String deviceFilePath, File localFile)` Callback del fornitore di contenuti che estrae un file dalla posizione dell'URI in un file locale.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Callback del fornitore di contenuti che spinge una directory alla posizione dell'URI.
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` Callback del provider di contenuti che invia un file alla posizione dell'URI.
`boolean`	`setUp()` Assicurati che l'apk helper del fornitore di contenuti sia installato e pronto per essere utilizzato.
`void`	`tearDown()` Pulisci il dispositivo dall'helper del fornitore di contenuti.

Campi

COLONNE

public static final String[] COLUMNS

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

DIRECTORY_COLONNA

public static final String COLUMN_DIRECTORY

COLUMN_METADATA

public static final String COLUMN_METADATA

MIME_TYPE_COLONNA

public static final String COLUMN_MIME_TYPE

NOME_COLONNA

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

Costruttori pubblici

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

Costruttore.

Parametri
`device`	`ITestDevice`

Lanci
`DeviceNotAvailableException`

ContentProviderHandler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

Parametri
`device`	`ITestDevice`
`userId`	`Integer`

Metodi pubblici

contentProviderNotFound

public boolean contentProviderNotFound ()

Restituisce True se una delle operazioni non è riuscita perché il fornitore di contenuti non è stato trovato. Può essere eliminato eseguendo di nuovo setUp().

Ritorni
`boolean`

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

Restituisce la stringa URI completa per il percorso del dispositivo specificato, con caratteri di escape e codificati per evitare caratteri non URL.

Parametri
`deviceFilePath`	`String`

Ritorni
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

Callback del provider di contenuti che elimina un file nella posizione dell'URI. Il file verrà eliminato dai contenuti del dispositivo.

Parametri
`deviceFilePath`	`String`: il percorso sul dispositivo del file da eliminare.

Ritorni
`boolean`	Vero se l'operazione è riuscita, falso in caso contrario

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Determina se il file o la directory non vuota esiste sul dispositivo.

Parametri
`deviceFilePath`	`String`: il percorso file assoluto sul dispositivo da verificare.

Ritorni
`boolean`	Vero se il file/la directory esiste, falso in caso contrario. Se la directory è vuota, restituisce anche False.

Lanci
`DeviceNotAvailableException`

getUserId

public Integer getUserId ()

Restituisce l'attributo userId con cui è stata inizializzata questa istanza.

Ritorni
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Estrai in modo ricorsivo i contenuti della directory dal dispositivo utilizzando il fornitore di contenuti.

Parametri
`deviceFilePath`	`String`: il percorso file assoluto dell'origine remota
`localDir`	`File`: la directory locale in cui importare i file

Ritorni
`boolean`	`true` se il file è stato estratto correttamente. `false` in caso contrario.

Lanci
`DeviceNotAvailableException`	Se la connessione con il dispositivo viene persa e non può essere recuperata.

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

Callback del fornitore di contenuti che estrae un file dalla posizione dell'URI in un file locale.

Parametri
`deviceFilePath`	`String`: il percorso sul dispositivo da cui estrarre il file.
`localFile`	`File`: il `ERROR(/File)` in cui memorizzare i contenuti. Se non è vuoto, i contenuti verranno sostituiti.

Ritorni
`boolean`	Vero se l'operazione è riuscita, falso in caso contrario

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushDir

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

Callback del fornitore di contenuti che invia una directory alla posizione dell'URI.

Parametri
`localFileDir`	`File`: la directory da inviare tramite push
`deviceFilePath`	`String`: la posizione sul dispositivo
`excludedDirectories`	: directory non incluse nel push.

Ritorni
`boolean`	Vero se l'operazione è riuscita

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

Callback del provider di contenuti che invia un file alla posizione dell'URI.

Parametri
`fileToPush`	`File`: il `ERROR(/File)` da inviare al dispositivo.
`deviceFilePath`	`String`: il percorso sul dispositivo in cui inviare il file.

Ritorni
`boolean`	Vero se l'operazione è riuscita, falso in caso contrario

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

setUp

public boolean setUp ()

Assicurati che l'apk helper del fornitore di contenuti sia installato e pronto per essere utilizzato.

Ritorni
`boolean`	Vero se è pronto per essere utilizzato, falso in caso contrario.

Lanci
`DeviceNotAvailableException`

tearDown

public void tearDown ()

Pulisci il dispositivo dall'helper del fornitore di contenuti.

Lanci
`DeviceNotAvailableException`