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.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

AndroidCompatibility

public final class AndroidCompatibility
extends Object

java.lang.Object
↳	com.android.tradefed.result.resultdb.utils.AndroidCompatibility

Fornece métodos para facilitar o upload de campos específicos do Android para o ResultDB.

Essa classe é copiada da base de código do ResultDB para compatibilidade. Algumas funções são removidas devido à falta de dependências.

Resumo

Constantes
`int`	`MAX_TAG_KEY_BYTES` O tamanho máximo de uma chave de tag em bytes.
`String`	`PRIMARY_ERROR_CODE_TAG_KEY` A chave de tag usada para registrar um código de erro associado ao nome do erro associado ao erro principal (failure_reason.errors[0]).
`String`	`PRIMARY_ERROR_NAME_TAG_KEY` A chave de tag usada para registrar um identificador de erro (por exemplo, OUT_OF_QUOTA, MOBLY_TEST_CASE_ERROR, EXPECTED_TESTS_MISMATCH) associado ao erro principal (failure_reason.errors[0]).
`String`	`PRIMARY_ERROR_ORIGIN_TAG_KEY` A chave de tag usada para registrar o nome da classe Java totalmente qualificado que criou e gerou a exceção associada ao erro principal (failure_reason.errors[0]).
`String`	`PRIMARY_ERROR_TYPE_TAG_KEY` A chave de tag usada para registrar um tipo de erro para o erro principal (failure_reason.errors[0]).
`String`	`SKIP_BUG_TAG_KEY` A chave de tag usada para armazenar o ID do Buganizer do problema que fez com que os testes fossem ignorados.
`String`	`SKIP_TRIGGER_TAG_KEY` A chave de tag usada para armazenar a condição que fez com que o teste fosse ignorado.

Métodos públicos
`static String`	`makeValidTagKey(String key)` O MakeValidTagKey converte a chave de uma propriedade do AnTS em uma chave de tag ResultDB válida.
`static Struct`	`marshalTestResultProperties(TestResultProperties properties)` Faz o marshalling de um proto TestResultProperties (uma cópia de wireless.android.busytown.proto.TestResultProperties) para um google.protobuf.Struct para armazenamento no ResultDB.
`static StringPair`	`primaryErrorCodeTag(long code)` Retorna um StringPair que pode ser usado para registrar um código de erro associado ao erro principal (failure_reason.errors[0]).
`static StringPair`	`primaryErrorNameTag(String name)` Retorna um StringPair que pode ser usado para registrar um identificador de erro (por exemplo, OUT_OF_QUOTA, MOBLY_TEST_CASE_ERROR, EXPECTED_TESTS_MISMATCH) associado ao erro principal (failure_reason.errors[0]).
`static StringPair`	`primaryErrorOriginTag(String origin)` Retorna um StringPair que pode ser usado para registrar] o nome da classe Java totalmente qualificado que criou e gerou a exceção associada ao erro principal (failure_reason.errors[0]).
`static StringPair`	`skipBugTag(String bugId)` Retorna um StringPair que pode ser usado para registrar o ID do buganizer do problema que fez com que os testes fossem ignorados.
`static StringPair`	`skipTriggerTag(String trigger)` Retorna um StringPair que pode ser usado para registrar a condição que fez com que o teste fosse ignorado.

Constantes

MAX_TAG_KEY_BYTES

public static final int MAX_TAG_KEY_BYTES

O tamanho máximo de uma chave de tag em bytes.

Valor da constante: 64 (0x00000040)

PRIMARY_ERROR_CODE_TAG_KEY

public static final String PRIMARY_ERROR_CODE_TAG_KEY

A chave de tag usada para registrar um código de erro associado ao nome do erro associado ao erro principal (failure_reason.errors[0]).

Valor da constante: "primary_error_code"

PRIMARY_ERROR_NAME_TAG_KEY

public static final String PRIMARY_ERROR_NAME_TAG_KEY

A chave de tag usada para registrar um identificador de erro (por exemplo, OUT_OF_QUOTA, MOBLY_TEST_CASE_ERROR, EXPECTED_TESTS_MISMATCH) associado ao erro principal (failure_reason.errors[0]).

Valor da constante: "primary_error_name"

PRIMARY_ERROR_ORIGIN_TAG_KEY

public static final String PRIMARY_ERROR_ORIGIN_TAG_KEY

A chave de tag usada para registrar o nome da classe Java totalmente qualificado que criou e gerou a exceção associada ao erro principal (failure_reason.errors[0]).

Valor da constante: "primary_error_origin"

PRIMARY_ERROR_TYPE_TAG_KEY

public static final String PRIMARY_ERROR_TYPE_TAG_KEY

A chave de tag usada para registrar um tipo de erro para o erro principal (failure_reason.errors[0]).

Valor da constante: "primary_error_type"

SKIP_BUG_TAG_KEY

public static final String SKIP_BUG_TAG_KEY

A chave de tag usada para armazenar o ID do Buganizer do problema que fez com que os testes fossem ignorados.

Valor da constante: "skip_bug_id"

SKIP_TRIGGER_TAG_KEY

public static final String SKIP_TRIGGER_TAG_KEY

A chave de tag usada para armazenar a condição que fez com que o teste fosse ignorado.

Valor da constante: "skip_trigger"

Métodos públicos

makeValidTagKey

public static String makeValidTagKey (String key)

O MakeValidTagKey converte a chave de uma propriedade do AnTS em uma chave de tag ResultDB válida.

Isso é necessário porque as chaves de tag do ResultDB são limitadas à correspondência ^[a-z][a-z0-9_]*(/[a-z][a-z0-9_]*)*$.

Observação: o ResultDB aplica um limite de 64 bytes às chaves. Se as chaves forem maiores, talvez seja necessário fazer upload dos dados por outros meios para evitar a perda de informações. Consulte go/resultdb-uploader-guidance#ants-field-properties para ver as opções.

Parâmetros
`key`	`String`

Retorna
`String`

marshalTestResultProperties

public static Struct marshalTestResultProperties (TestResultProperties properties)

Faz o marshalling de um proto TestResultProperties (uma cópia de wireless.android.busytown.proto.TestResultProperties) para um google.protobuf.Struct para armazenamento no ResultDB.

Parâmetros
`properties`	`TestResultProperties`

Retorna
`Struct`

Gera
`InvalidProtocolBufferException`

primaryErrorCodeTag

public static StringPair primaryErrorCodeTag (long code)

Retorna um StringPair que pode ser usado para registrar um código de erro associado ao erro principal (failure_reason.errors[0]).

Parâmetros
`code`	`long`

Retorna
`StringPair`

primaryErrorNameTag

public static StringPair primaryErrorNameTag (String name)

Retorna um StringPair que pode ser usado para registrar um identificador de erro (por exemplo, OUT_OF_QUOTA, MOBLY_TEST_CASE_ERROR, EXPECTED_TESTS_MISMATCH) associado ao erro principal (failure_reason.errors[0]).

Parâmetros
`name`	`String`

Retorna
`StringPair`

primaryErrorOriginTag

public static StringPair primaryErrorOriginTag (String origin)

Retorna um StringPair que pode ser usado para registrar] o nome da classe Java totalmente qualificado que criou e gerou a exceção associada ao erro principal (failure_reason.errors[0]).

Parâmetros
`origin`	`String`

Retorna
`StringPair`

skipBugTag

public static StringPair skipBugTag (String bugId)

Retorna um StringPair que pode ser usado para registrar o ID do buganizer do problema que fez com que os testes fossem ignorados.

Parâmetros
`bugId`	`String`

Retorna
`StringPair`

skipTriggerTag

public static StringPair skipTriggerTag (String trigger)

Retorna um StringPair que pode ser usado para registrar a condição que fez com que o teste fosse ignorado.

Parâmetros
`trigger`	`String`

Retorna
`StringPair`