IBuildInfo
public interface IBuildInfo
com.android.tradefed.build.IBuildInfo |
Contém informações sobre a compilação em teste.
Resumo
Constantes | |
---|---|
String | REMOTE_FILE_PREFIX Prefixo usado no nome para indicar que o arquivo está configurado para download atrasado. |
String | REMOTE_FILE_VERSION O arquivo remoto não tem versão. |
String | UNKNOWN_BUILD_ID Valor padrão quando o ID de compilação é desconhecido. |
Métodos públicos | |
---|---|
default void | addAppPackageFile (File appPackageFile, String version) Adiciona o arquivo apk local e sua versão associada. |
abstract void | addBuildAttribute (String attributeName, String attributeValue) Adicione um atributo de compilação. |
default void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Adicionar atributos de compilação |
abstract void | cleanUp () Limpe todos os arquivos de compilação temporários |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) Versão de |
abstract IBuildInfo | clone () Clona o objeto |
default | getAppPackageFiles () Obtém uma cópia do conjunto de arquivos apk do aplicativo local e suas versões. |
abstract | getBuildAttributes () Obtenha um conjunto de pares nome-valor de atributos adicionais que descrevem a compilação. |
abstract String | getBuildBranch () Método opcional para retornar a ramificação de controle de origem da qual a compilação que está sendo testada foi produzida. |
abstract String | getBuildFlavor () Método opcional para retornar o tipo de build que está sendo testado. |
abstract String | getBuildId () Retorna o identificador exclusivo da compilação em teste. |
abstract String | getBuildTargetName () Retorna o nome completo da compilação que está sendo testada. |
abstract String | getDeviceSerial () |
abstract File | getFile (String name) Método auxiliar para recuperar um arquivo com o nome fornecido. |
default File | getFile ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar um arquivo com uma |
abstract | getFiles () Retorna todos |
abstract | getProperties () Retorna uma cópia das propriedades atualmente definidas no |
default | getRemoteFiles () Obtenha os caminhos para os artefatos de construção cujo download está atrasado. |
abstract String | getTestTag () Retorne um nome exclusivo para os testes que estão sendo executados. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar uma versão de arquivo com um |
abstract String | getVersion (String name) Método auxiliar para recuperar uma versão de arquivo com o nome fornecido. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar um |
default VersionedFile | getVersionedFile (String name) Método auxiliar para recuperar um |
default | getVersionedFileKeys () Retorna o conjunto de chaves disponíveis para consultar |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar uma lista de |
default void | removeBuildAttribute (String attributeName) Remova um determinado attributeName do rastreamento. |
abstract void | setBuildBranch (String branch) Defina a ramificação de compilação |
abstract void | setBuildFlavor (String buildFlavor) Defina o tipo de construção. |
abstract void | setBuildId (String buildId) Define o identificador exclusivo da compilação em teste. |
abstract void | setDeviceSerial (String serial) Defina o serial |
abstract void | setFile (String name, File file, String version) Armazena um arquivo com o nome fornecido nesta informação de construção. |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Armazena um arquivo dado um |
abstract void | setProperties ( BuildInfoProperties... properties) Defina |
abstract void | setTestTag (String testTag) Define o nome exclusivo para os testes que estão sendo executados. |
default File | stageRemoteFile (String fileName, File workingDir) Prepare um arquivo que faz parte de arquivos remotos no diretório raiz das informações de compilação. |
default BuildInformation.BuildInfo | toProto () Serialize uma instância BuildInfo em um protobuf. |
Constantes
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
Prefixo usado no nome para indicar que o arquivo está configurado para download atrasado.
Valor constante: "remote_file:"
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
O arquivo remoto não tem versão.
Valor constante: ""
UNKNOWN_BUILD_ID
public static final String UNKNOWN_BUILD_ID
Valor padrão quando o ID de compilação é desconhecido.
Valor constante: "-1"
Métodos públicos
addAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
Adiciona o arquivo apk local e sua versão associada. Observe que os apks serão retornados de getAppPackageFiles()
na ordem em que foram adicionados por esse método.
Parâmetros | |
---|---|
appPackageFile | File |
version | String |
addBuildAttribute
public abstract void addBuildAttribute (String attributeName, String attributeValue)
Adicione um atributo de compilação. Isso não permite substituir um attributeName existente.
Parâmetros | |
---|---|
attributeName | String : o nome do atributo exclusivo |
attributeValue | String : o valor do atributo |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
Adicionar atributos de compilação
Parâmetros | |
---|---|
buildAttributes |
limpar
public abstract void cleanUp ()
Limpe todos os arquivos de compilação temporários
limpar
public abstract void cleanUp (doNotDelete)
Versão de cleanUp()
onde alguns arquivos não são excluídos.
Parâmetros | |
---|---|
doNotDelete |
getAppPackageFiles
publicgetAppPackageFiles ()
Obtém uma cópia do conjunto de arquivos apk do aplicativo local e suas versões. A ordem retornada corresponde à ordem em que os apks foram adicionados ao IAppBuildInfo
.
devoluções | |
---|---|
getBuildAttributes
public abstractgetBuildAttributes ()
Obtenha um conjunto de pares nome-valor de atributos adicionais que descrevem a compilação.
devoluções | |
---|---|
um ERROR(/Map) de atributos de construção. Não será null , mas pode estar vazio. |
getBuildBranch
public abstract String getBuildBranch ()
Método opcional para retornar a ramificação de controle de origem da qual a compilação que está sendo testada foi produzida.
devoluções | |
---|---|
String | a ramificação de compilação ou null se não definido/não aplicável |
getBuildFlavor
public abstract String getBuildFlavor ()
Método opcional para retornar o tipo de build que está sendo testado.
Uma implementação comum para compilações da plataforma Android é retornar (build product)-(build os)-(build variant). isto é, generic-linux-userdebugdevoluções | |
---|---|
String | o tipo de compilação ou null se não definido/não aplicável |
getBuildId
public abstract String getBuildId ()
Retorna o identificador exclusivo da compilação em teste. Nunca deve ser nulo. O padrão é UNKNOWN_BUILD_ID
.
devoluções | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
Retorna o nome completo da compilação que está sendo testada.
Uma implementação comum é construir o nome do destino de construção a partir de uma combinação do tipo de construção e do nome da ramificação. [ou seja, (nome da ramificação)-(tipo de compilação)]devoluções | |
---|---|
String |
getDeviceSerial
public abstract String getDeviceSerial ()
devoluções | |
---|---|
String | o serial ITestDevice em que esta compilação foi executada. Retorna null se nenhum dispositivo estiver associado a esta compilação. |
getFile
public abstract File getFile (String name)
Método auxiliar para recuperar um arquivo com o nome fornecido.
devoluções | |
---|---|
File | o arquivo de imagem ou null se não for encontrado |
getFile
public File getFile (BuildInfoKey.BuildInfoFileKey key)
Método auxiliar para recuperar um arquivo com uma BuildInfoFileKey
fornecida.
Parâmetros | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : o BuildInfoFileKey solicitado. |
devoluções | |
---|---|
File | o arquivo de imagem ou null se não for encontrado |
getFiles
public abstractgetFiles ()
Retorna todos VersionedFile
s armazenados neste BuildInfo
.
devoluções | |
---|---|
obterPropriedades
public abstractgetProperties ()
Retorna uma cópia das propriedades atualmente definidas no IBuildInfo
.
devoluções | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
Obtenha os caminhos para os artefatos de construção cujo download está atrasado.
devoluções | |
---|---|
getTestTag
public abstract String getTestTag ()
Retorne um nome exclusivo para os testes que estão sendo executados.
devoluções | |
---|---|
String |
getVersion
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
Método auxiliar para recuperar uma versão de arquivo com um BuildInfoFileKey
fornecido.
Parâmetros | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : o BuildInfoFileKey solicitado. |
devoluções | |
---|---|
String | a versão da imagem ou null se não for encontrado |
getVersion
public abstract String getVersion (String name)
Método auxiliar para recuperar uma versão de arquivo com o nome fornecido.
devoluções | |
---|---|
String | a versão da imagem ou null se não for encontrado |
getVersionedFile
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
Método auxiliar para recuperar um VersionedFile
com um determinado BuildInfoFileKey
.
Parâmetros | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : o BuildInfoFileKey solicitado. |
devoluções | |
---|---|
VersionedFile | O arquivo com versão ou null se não for encontrado |
getVersionedFile
public VersionedFile getVersionedFile (String name)
Método auxiliar para recuperar um VersionedFile
com um determinado nome.
devoluções | |
---|---|
VersionedFile | O arquivo com versão ou null se não for encontrado |
getVersionedFileKeys
publicgetVersionedFileKeys ()
Retorna o conjunto de chaves disponíveis para consultar VersionedFile
via getFile(BuildInfoFileKey)
.
devoluções | |
---|---|
getVersionedFiles
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Método auxiliar para recuperar uma lista de VersionedFile
s associados a um determinado BuildInfoFileKey
. Se a tecla permite armazenar uma lista.
Parâmetros | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : o BuildInfoFileKey solicitado. |
devoluções | |
---|---|
O arquivo com versão ou null se não for encontrado |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
Remova um determinado attributeName do rastreamento.
Parâmetros | |
---|---|
attributeName | String : o atributo para interromper o rastreamento |
setBuildBranch
public abstract void setBuildBranch (String branch)
Defina a ramificação de compilação
Parâmetros | |
---|---|
branch | String : o nome do ramo |
setBuildFlavor
public abstract void setBuildFlavor (String buildFlavor)
Defina o tipo de construção.
setBuildId
public abstract void setBuildId (String buildId)
Define o identificador exclusivo da compilação em teste. Nunca deve ser nulo.
Parâmetros | |
---|---|
buildId | String |
setDeviceSerial
public abstract void setDeviceSerial (String serial)
Defina o serial ITestDevice
associado a esta compilação.
Parâmetros | |
---|---|
serial | String : o número de série do ITestDevice com o qual esta compilação foi executada. |
setArquivo
public abstract void setFile (String name, File file, String version)
Armazena um arquivo com o nome fornecido nesta informação de construção.
Parâmetros | |
---|---|
name | String : o nome exclusivo do arquivo |
file | File : o ERROR(/File) |
version | String : a versão do arquivo |
setArquivo
public void setFile (BuildInfoKey.BuildInfoFileKey key, File file, String version)
Armazena um arquivo dado um BuildInfoFileKey
nesta informação de compilação.
Parâmetros | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : o nome exclusivo do arquivo baseado em BuildInfoFileKey . |
file | File : o ERROR(/File) |
version | String : a versão do arquivo |
definirPropriedades
public abstract void setProperties (BuildInfoProperties... properties)
Defina BuildInfoProperties
para a instância IBuildInfo
. Substitua quaisquer propriedades existentes definidas anteriormente.
Parâmetros | |
---|---|
properties | BuildInfoProperties : a lista de propriedades a serem adicionadas. |
setTestTag
public abstract void setTestTag (String testTag)
Define o nome exclusivo para os testes que estão sendo executados.
Parâmetros | |
---|---|
testTag | String |
stageRemoteFile
public File stageRemoteFile (String fileName, File workingDir)
Prepare um arquivo que faz parte de arquivos remotos no diretório raiz das informações de compilação.
TODO(b/138416078): Remova esta interface e seu chamador quando os módulos requeridos por um teste puderem ser construídos adequadamente para o diretório do próprio módulo de teste.
Parâmetros | |
---|---|
fileName | String : Nome do arquivo a ser localizado nos arquivos remotos. |
workingDir | File : um objeto ERROR(/File) do diretório para preparar o arquivo. |
devoluções | |
---|---|
File | o objeto ERROR(/File) do arquivo preparado no local workingDir. |
toProto
public BuildInformation.BuildInfo toProto ()
Serialize uma instância BuildInfo em um protobuf.
devoluções | |
---|---|
BuildInformation.BuildInfo |