Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

GCSBucketUtil

public class GCSBucketUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.GCSBucketUtil

Gerenciador de arquivos para fazer download e upload de arquivos do Google Cloud Storage (GCS).

Essa classe NÃO deve ser usada no escopo de um teste (ou seja, IRemoteTest). Essa política foi descontinuada. Use GCSFileDownloader.

Resumo

Classes aninhadas
`class`	`GCSBucketUtil.GCSFileMetadata` Wrapper simples para informações de arquivo no GCS.

Construtores públicos
`GCSBucketUtil(String bucketName)`

Métodos públicos
`CommandResult`	`copy(String source, String dest)` Copie um arquivo ou diretório para ou do bucket.
`int`	`getAttempts()`
`String`	`getBotoConfig()`
`String`	`getBotoPath()`
`String`	`getBucketName()`
`boolean`	`getNoClobber()`
`boolean`	`getParallel()`
`boolean`	`getRecursive()`
`long`	`getRetryInterval()`
`long`	`getTimeout()`
`boolean`	`isFile(String path)` Verifica se um arquivo do GCS é um arquivo ou não (uma pasta).
`List<String>`	`ls(Path bucketPath)` Listar arquivos em um caminho do GCS.
`CommandResult`	`makeBucket(String projectId)` Crie o bucket do GCS.
`String`	`md5Hash(File localFile)` Calcule o hash md5 do arquivo local.
`CommandResult`	`pull(Path bucketPath)` Baixe um arquivo ou diretório de um bucket do GCS para o diretório atual.
`CommandResult`	`pull(Path bucketPath, File localFile)` Baixe um arquivo ou diretório de um bucket do GCS.
`String`	`pullContents(Path bucketPath)` Faça o download de um arquivo de um bucket do GCS e extraia o conteúdo dele.
`CommandResult`	`push(File localFile)` Faça upload de um arquivo ou diretório local para um bucket do GCS.
`CommandResult`	`push(File localFile, Path bucketPath)` Faça upload de um arquivo ou diretório local para um bucket do GCS com um caminho específico.
`CommandResult`	`pushString(String contents, Path bucketPath)` Fazer upload de uma string para um bucket do GCS.
`CommandResult`	`remove(String pattern, boolean force)` Remova um arquivo ou diretório do bucket.
`CommandResult`	`remove(Path path, boolean force)` Remova um arquivo ou diretório do bucket.
`CommandResult`	`remove(Path path)` Remova um arquivo ou diretório do bucket.
`CommandResult`	`remove(String pattern)` Remova um arquivo ou diretório do bucket.
`CommandResult`	`removeBucket()` Remover o bucket do GCS
`void`	`setAttempts(int attempts)`
`void`	`setBotoConfig(String botoConfig)`
`void`	`setBotoPath(String botoPath)`
`void`	`setBucketName(String bucketName)`
`void`	`setNoClobber(boolean noClobber)`
`void`	`setParallel(boolean parallel)`
`void`	`setRecursive(boolean recursive)`
`void`	`setRetryInterval(long retryInterval)`
`void`	`setTimeout(long timeout, TimeUnit unit)`
`void`	`setTimeoutMs(long timeout)`
`GCSBucketUtil.GCSFileMetadata`	`stat(Path bucketPath)` Recebe o estado do arquivo para o caminho do GCS.

Métodos protegidos
`IRunUtil`	`getRunUtil()`

Construtores públicos

GCSBucketUtil

public GCSBucketUtil (String bucketName)

Parâmetros
`bucketName`	`String`

Métodos públicos

copiar

public CommandResult copy (String source, 
                String dest)

Copie um arquivo ou diretório para ou do bucket.

Parâmetros
`source`	`String`: arquivo ou padrão de origem
`dest`	`String`: arquivo ou padrão de destino

Retorna
`CommandResult`	`CommandResult` resultado da operação.

Gera
`IOException`

getAttempts

public int getAttempts ()

Retorna
`int`

getBotoConfig

public String getBotoConfig ()

Retorna
`String`

getBotoPath

public String getBotoPath ()

Retorna
`String`

getBucketName

public String getBucketName ()

Retorna
`String`

getNoClobber

public boolean getNoClobber ()

Retorna
`boolean`

getParallel

public boolean getParallel ()

Retorna
`boolean`

getRecursive

public boolean getRecursive ()

Retorna
`boolean`

getRetryInterval

public long getRetryInterval ()

Retorna
`long`

getTimeout

public long getTimeout ()

Retorna
`long`

isFile

public boolean isFile (String path)

Verifica se um arquivo do GCS é um arquivo ou não (uma pasta).

Se o nome do arquivo terminar com "/", ele será uma pasta. O comando "gsutil ls gs://filename" vai retornar "gs://filename" se for um arquivo. O comando "gsutil ls gs://nome da pasta" vai retornar os arquivos na pasta se houver arquivos nela. e gs://folder/ se não houver arquivos na pasta.

Parâmetros
`path`	`String`: o caminho relativo ao bucket.

Retorna
`boolean`	se é um arquivo ou não.

Gera
	java.io.IOException
`IOException`

ls

public List<String> ls (Path bucketPath)

Listar arquivos em um caminho do GCS.

Parâmetros
`bucketPath`	`Path`: o caminho do GCS

Retorna
`List<String>`	uma lista de `String`s que são arquivos no caminho do GCS

Gera
	java.io.IOException
`IOException`

makeBucket

public CommandResult makeBucket (String projectId)

Crie o bucket do GCS.

Parâmetros
`projectId`	`String`

Retorna
`CommandResult`	`CommandResult` resultado da operação.

Gera
	java.io.IOException
`IOException`

md5Hash

public String md5Hash (File localFile)

Calcule o hash md5 do arquivo local.

Parâmetros
`localFile`	`File`: um arquivo local

Retorna
`String`	o hash MD5 do arquivo local.

Gera
	java.io.IOException
`IOException`

pull

public CommandResult pull (Path bucketPath)

Baixe um arquivo ou diretório de um bucket do GCS para o diretório atual.

Parâmetros
`bucketPath`	`Path`: caminho do arquivo no bucket do GCS

Retorna
`CommandResult`	`CommandResult` resultado da operação.

Gera
`IOException`

pull

public CommandResult pull (Path bucketPath, 
                File localFile)

Baixe um arquivo ou diretório de um bucket do GCS.

Parâmetros
`bucketPath`	`Path`: caminho do arquivo no bucket do GCS
`localFile`	`File`: caminho de destino local

Retorna
`CommandResult`	`CommandResult` resultado da operação.

Gera
`IOException`

pullContents

public String pullContents (Path bucketPath)

Faça o download de um arquivo de um bucket do GCS e extraia o conteúdo dele.

Parâmetros
`bucketPath`	`Path`: caminho do arquivo no bucket do GCS

Retorna
`String`	Conteúdo da string do arquivo

Gera
`IOException`

push

public CommandResult push (File localFile)

Faça upload de um arquivo ou diretório local para um bucket do GCS.

Parâmetros
`localFile`	`File`: arquivo ou diretório local

Retorna
`CommandResult`	`CommandResult` resultado da operação.

Gera
`IOException`

push

public CommandResult push (File localFile, 
                Path bucketPath)

Faça upload de um arquivo ou diretório local para um bucket do GCS com um caminho específico.

Parâmetros
`localFile`	`File`: arquivo ou diretório local
`bucketPath`	`Path`: caminho do arquivo no bucket do GCS

Retorna
`CommandResult`	`CommandResult` resultado da operação.

Gera
`IOException`

pushString

public CommandResult pushString (String contents, 
                Path bucketPath)

Fazer upload de uma string para um bucket do GCS.

Parâmetros
`contents`	`String`: conteúdo do arquivo, como uma string
`bucketPath`	`Path`: caminho do arquivo no bucket do GCS

Retorna
`CommandResult`	`CommandResult` resultado da operação.

Gera
`IOException`

remover

public CommandResult remove (String pattern, 
                boolean force)

Remova um arquivo ou diretório do bucket.

Parâmetros
`pattern`	`String`: arquivo, diretório ou padrão a ser removido.
`force`	`boolean`: se as falhas devem ser ignoradas e continuar silenciosamente (não vai gerar exceção).

Retorna
`CommandResult`

Gera
`IOException`

remover

public CommandResult remove (Path path, 
                boolean force)

Remova um arquivo ou diretório do bucket.

Parâmetros
`path`	`Path`: caminho a ser removido
`force`	`boolean`: se a ação vai falhar se o arquivo não existir.

Retorna
`CommandResult`

Gera
`IOException`

remover

public CommandResult remove (Path path)

Remova um arquivo ou diretório do bucket.

Parâmetros
`path`	`Path`: caminho a ser removido

Retorna
`CommandResult`

Gera
`IOException`

remover

public CommandResult remove (String pattern)

Remova um arquivo ou diretório do bucket.

Parâmetros
`pattern`	`String`: arquivo, diretório ou padrão a ser removido.

Retorna
`CommandResult`

Gera
`IOException`

removeBucket

public CommandResult removeBucket ()

Remover o bucket do GCS

Retorna
`CommandResult`

Gera
	java.io.IOException
`IOException`

setAttempts

public void setAttempts (int attempts)

Parâmetros
`attempts`	`int`

setBotoConfig

public void setBotoConfig (String botoConfig)

Parâmetros
`botoConfig`	`String`

setBotoPath

public void setBotoPath (String botoPath)

Parâmetros
`botoPath`	`String`

setBucketName

public void setBucketName (String bucketName)

Parâmetros
`bucketName`	`String`

setNoClobber

public void setNoClobber (boolean noClobber)

Parâmetros
`noClobber`	`boolean`

setParallel

public void setParallel (boolean parallel)

Parâmetros
`parallel`	`boolean`

setRecursive

public void setRecursive (boolean recursive)

Parâmetros
`recursive`	`boolean`

setRetryInterval

public void setRetryInterval (long retryInterval)

Parâmetros
`retryInterval`	`long`

setTimeout

public void setTimeout (long timeout, 
                TimeUnit unit)

Parâmetros
`timeout`	`long`
`unit`	`TimeUnit`

setTimeoutMs

public void setTimeoutMs (long timeout)

Parâmetros
`timeout`	`long`

stat

public GCSBucketUtil.GCSFileMetadata stat (Path bucketPath)

Recebe o estado do arquivo para o caminho do GCS.

Parâmetros
`bucketPath`	`Path`: o caminho do GCS

Retorna
`GCSBucketUtil.GCSFileMetadata`	`GCSFileMetadata` para o caminho do GCS

Gera
	java.io.IOException
`IOException`

Métodos protegidos

getRunUtil

protected IRunUtil getRunUtil ()

Retorna
`IRunUtil`

GCSBucketUtil

Resumo

Classes aninhadas

Construtores públicos

Métodos públicos

Métodos protegidos

Construtores públicos

GCSBucketUtil

Métodos públicos

copiar

getAttempts

getBotoConfig

getBotoPath

getBucketName

getNoClobber

getParallel

getRecursive

getRetryInterval

getTimeout

isFile

ls

makeBucket

md5Hash

pull

pull

pullContents

push

push

pushString

remover

remover

remover

remover

removeBucket

setAttempts

setBotoConfig

setBotoPath

setBucketName

setNoClobber

setParallel

setRecursive

setRetryInterval

setTimeout

setTimeoutMs

stat

Métodos protegidos

getRunUtil