BuildInfo
public class BuildInfo
extends Object
implements IBuildInfo
java.lang.Object | |
↳ | com.android.tradefed.build.BuildInfo |
Implementação genérica de um IBuildInfo
que deve ser associado a um ITestDevice
.
Resumo
Construtores públicos | |
---|---|
BuildInfo () Cria um | |
BuildInfo (String buildId, String buildTargetName) Cria um |
Métodos públicos | |
---|---|
void | addAppPackageFile (File appPackageFile, String version) Adiciona o arquivo apk local e sua versão associada. |
void | addBuildAttribute (String attributeName, String attributeValue) Adicione um atributo de compilação. |
void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Adicionar atributos de compilação |
void | cleanUp () Limpe todos os arquivos de compilação temporários |
void | cleanUp ( doNotClean) cleanUp ( doNotClean) Versão de |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) Copie todo o |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) Operação inversa para |
getAppPackageFiles () Obtém uma cópia do conjunto de arquivos apk do aplicativo local e suas versões. | |
getBuildAttributes () Obtenha um conjunto de pares nome-valor de atributos adicionais que descrevem a compilação. | |
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. |
String | getBuildFlavor () Método opcional para retornar o tipo de build que está sendo testado. |
String | getBuildId () Retorna o identificador exclusivo da compilação em teste. |
String | getBuildTargetName () Retorna o nome completo da compilação que está sendo testada. |
String | getDeviceSerial () |
File | getFile (String name) Método auxiliar para recuperar um arquivo com o nome fornecido. |
File | getFile ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar um arquivo com uma |
getFiles () Retorna todos | |
getProperties () Retorna uma cópia das propriedades atualmente definidas no | |
getRemoteFiles () Obtenha os caminhos para os artefatos de construção cujo download está atrasado. | |
String | getTestTag () Retorne um nome exclusivo para os testes que estão sendo executados. |
String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar uma versão de arquivo com um |
String | getVersion (String name) Método auxiliar para recuperar uma versão de arquivo com o nome fornecido. |
VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar um |
final VersionedFile | getVersionedFile (String name) Método auxiliar para recuperar um |
getVersionedFileKeys () Retorna o conjunto de chaves disponíveis para consultar | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Método auxiliar para recuperar uma lista de |
int | hashCode () |
void | removeBuildAttribute (String attributeName) Remova um determinado attributeName do rastreamento. |
void | setBuildBranch (String branch) Defina a ramificação de compilação |
void | setBuildFlavor (String buildFlavor) Defina o tipo de construção. |
void | setBuildId (String buildId) Define o identificador exclusivo da compilação em teste. |
void | setDeviceSerial (String serial) Defina o serial |
void | setFile (String name, File file, String version) Armazena um arquivo com o nome fornecido nesta informação de construção. |
void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Armazena um arquivo dado um |
void | setProperties ( BuildInfoProperties... properties) Defina |
void | setTestTag (String testTag) Define o nome exclusivo para os testes que estão sendo executados. |
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. |
BuildInformation.BuildInfo | toProto () Serialize uma instância BuildInfo em um protobuf. |
String | toString ()
|
Métodos protegidos | |
---|---|
void | addAllBuildAttributes ( BuildInfo build) Método auxiliar para copiar atributos de build, branch e variação de outro build. |
void | addAllFiles ( BuildInfo build) Método auxiliar para copiar todos os arquivos da outra compilação. |
boolean | applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Permite aplicar algumas das |
MultiMap <String, String> | getAttributesMultiMap () |
getVersionedFileMap () | |
MultiMap <String, VersionedFile > | getVersionedFileMapFull () |
Construtores públicos
BuildInfo
public BuildInfo (String buildId, String buildTargetName)
Cria um BuildInfo
Parâmetros | |
---|---|
buildId | String : o id da compilação |
buildTargetName | String : o nome do destino de compilação |
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 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 void cleanUp ()
Limpe todos os arquivos de compilação temporários
limpar
public void cleanUp (doNotClean)
Versão de cleanUp()
onde alguns arquivos não são excluídos.
Parâmetros | |
---|---|
doNotClean |
copyAllFileFrom
public final void copyAllFileFrom (BuildInfo build)
Copie todo o VersionedFile
de uma determinada compilação para esta.
Parâmetros | |
---|---|
build | BuildInfo |
é igual a
public boolean equals (Object obj)
Parâmetros | |
---|---|
obj | Object |
devoluções | |
---|---|
boolean |
deProto
public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)
Operação inversa para toProto()
para obter a instância de volta.
Parâmetros | |
---|---|
protoBuild | BuildInformation.BuildInfo |
devoluções | |
---|---|
IBuildInfo |
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
publicgetBuildAttributes ()
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 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 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 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 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 construção)]devoluções | |
---|---|
String |
getDeviceSerial
public String getDeviceSerial ()
devoluções | |
---|---|
String |
getFile
public 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 |
obterPropriedades
publicgetProperties ()
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 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 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 final 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
public finalgetVersionedFiles (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 |
hashCode
public int hashCode ()
devoluções | |
---|---|
int |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
Remova um determinado attributeName do rastreamento.
Parâmetros | |
---|---|
attributeName | String : o atributo para interromper o rastreamento |
setBuildBranch
public void setBuildBranch (String branch)
Defina a ramificação de compilação
Parâmetros | |
---|---|
branch | String : o nome do ramo |
setBuildFlavor
public void setBuildFlavor (String buildFlavor)
Defina o tipo de construção.
setBuildId
public void setBuildId (String buildId)
Define o identificador exclusivo da compilação em teste. Nunca deve ser nulo.
Parâmetros | |
---|---|
buildId | String |
setDeviceSerial
public 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 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 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 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 |
para sequenciar
public String toString ()
devoluções | |
---|---|
String |
Métodos protegidos
addAllBuildAttributes
protected void addAllBuildAttributes (BuildInfo build)
Método auxiliar para copiar atributos de build, branch e variação de outro build.
Parâmetros | |
---|---|
build | BuildInfo |
addAllFiles
protected void addAllFiles (BuildInfo build)
Método auxiliar para copiar todos os arquivos da outra compilação.
Cria novos hardlinks para os arquivos para que cada compilação tenha um caminho de arquivo exclusivo para o arquivo.
Parâmetros | |
---|---|
build | BuildInfo |
lances | |
---|---|
| se uma exceção for lançada ao criar o hardlink. |
applyBuildProperties
protected boolean applyBuildProperties (VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)
Permite aplicar algumas das IBuildInfo.BuildInfoProperties
e possivelmente fazer um tratamento diferente.
Parâmetros | |
---|---|
origFileConsidered | VersionedFile : O atualmente examinado em VersionedFile . |
build | IBuildInfo : a compilação original sendo clonada |
receiver | IBuildInfo : a compilação que recebe as informações. |
devoluções | |
---|---|
boolean | Verdadeiro se aplicamos as propriedades e a manipulação adicional deve ser ignorada. Falso caso contrário. |
getAttributesMultiMap
protected MultiMap<String, String> getAttributesMultiMap ()
devoluções | |
---|---|
MultiMap <String, String> |
getVersionedFileMap
protectedgetVersionedFileMap ()
devoluções | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
devoluções | |
---|---|
MultiMap <String, VersionedFile > |