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

Gestore che astrae le interazioni del content provider e consente di utilizzare il content provider lato dispositivo per diverse operazioni.

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

Riepilogo

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

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

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

Metodi pubblici
`boolean`	`contentProviderNotFound()` Restituisce True se una delle operazioni non è riuscita perché non è stato trovato il fornitore di contenuti.
`static String`	`createEscapedContentUri(String deviceFilePath)` Restituisce la stringa URI completa per il percorso del dispositivo specificato, con escape e codifica per evitare caratteri non URL.
`boolean`	`deleteFile(String deviceFilePath)` Callback del content provider che elimina un file nella posizione URI.
`boolean`	`doesFileExist(String deviceFilePath)` Determina se il file o la directory non vuota esiste sul dispositivo.
`IRunUtil`	`getRunUtil()`
`Integer`	`getUserId()` Restituisce l'ID utente con cui è 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 URI in un file locale.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Callback del fornitore di contenuti che invia una directory alla posizione dell'URI.
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` Callback del fornitore di contenuti che invia un file alla posizione dell'URI.
`void`	`setRunUtil(IRunUtil runUtil)`
`boolean`	`setUp()` Assicurati che l'APK dell'helper del fornitore di contenuti sia installato e pronto per l'uso.
`void`	`tearDown()` Pulisci il dispositivo dall'helper del fornitore di contenuti.

Costanti

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

Valore costante: "absolute_path"

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

Valore costante: "is_directory"

COLUMN_METADATA

public static final String COLUMN_METADATA

Constant Value: "metadata"

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

Constant Value: "mime_type"

COLUMN_NAME

public static final String COLUMN_NAME

Constant Value: "name"

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

Valore costante: "content://android.tradefed.contentprovider"

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

Valore costante: "Nessun risultato trovato."

PACKAGE_NAME

public static final String PACKAGE_NAME

Valore costante: "android.tradefed.contentprovider"

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

Constant Value: "INFO"

Campi

COLONNE

public static final String[] COLUMNS

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é non è stato trovato il fornitore di contenuti. Può essere cancellato 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 escape e codifica per evitare caratteri non URL.

Parametri
`deviceFilePath`	`String`

Ritorni
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

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

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

Ritorni
`boolean`	True se l'operazione è riuscita, False 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 assoluto del file sul dispositivo da verificare.

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

Lanci
`DeviceNotAvailableException`

getRunUtil

public IRunUtil getRunUtil ()

Ritorni
`IRunUtil`

getUserId

public Integer getUserId ()

Restituisce l'ID utente con cui è 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 inserire i file

Ritorni
`boolean`	`true` se il file è stato estratto correttamente. `false` altrimenti.

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 URI in un file locale.

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

Ritorni
`boolean`	True se l'operazione è riuscita, False 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
`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 fornitore 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 eseguire il push del file.

Ritorni
`boolean`	True se l'operazione è riuscita, False in caso contrario

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

setRunUtil

public void setRunUtil (IRunUtil runUtil)

Parametri
`runUtil`	`IRunUtil`

setUp

public boolean setUp ()

Assicurati che l'APK dell'helper del fornitore di contenuti sia installato e pronto per l'uso.

Ritorni
`boolean`	True se è pronto per essere utilizzato, False in caso contrario.

Lanci
`DeviceNotAvailableException`

tearDown

public void tearDown ()

Pulisci il dispositivo dall'helper del fornitore di contenuti.

Lanci
`DeviceNotAvailableException`