Recurso de REST: testEnvironmentCatalog

Recurso: TestEnvironmentCatalog

Es la descripción de un entorno de prueba.

Representación JSON

{

  // Union field environment_catalog can be only one of the following:
  "androidDeviceCatalog": {
    object(AndroidDeviceCatalog)
  },
  "iosDeviceCatalog": {
    object(IosDeviceCatalog)
  },
  "networkConfigurationCatalog": {
    object(NetworkConfigurationCatalog)
  },
  "softwareCatalog": {
    object(ProvidedSoftwareCatalog)
  }
  // End of list of possible types for union field environment_catalog.
}
Campos
El campo de unión environment_catalog es de solo salida. environment_catalog puede ser solamente una de las siguientes opciones:
androidDeviceCatalog

object(AndroidDeviceCatalog)

Son los dispositivos Android compatibles.

iosDeviceCatalog

object(IosDeviceCatalog)

Son los dispositivos iOS compatibles.

networkConfigurationCatalog

object(NetworkConfigurationCatalog)

Son las configuraciones de red compatibles.

softwareCatalog

object(ProvidedSoftwareCatalog)

Es el entorno de prueba del software que TestExecutionService proporciona.

AndroidDeviceCatalog

Son los dispositivos Android compatibles en la actualidad.

Representación JSON

{
  "models": [
    {
      object(AndroidModel)
    }
  ],
  "versions": [
    {
      object(AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object(AndroidRuntimeConfiguration)
  }
}
Campos
models[]

object(AndroidModel)

Es el conjunto de modelos de dispositivos Android compatibles.

versions[]

object(AndroidVersion)

Es el conjunto de versiones del SO Android compatibles.

runtimeConfiguration

object(AndroidRuntimeConfiguration)

Es el conjunto de configuraciones de tiempo de ejecución compatibles.

AndroidModel

Es una descripción de un dispositivo Android en el que se pueden ejecutar pruebas.

Representación JSON

{
  "id": string,
  "name": string,
  "manufacturer": string,
  "brand": string,
  "codename": string,
  "form": enum(DeviceForm),
  "formFactor": enum(DeviceFormFactor),
  "screenX": number,
  "screenY": number,
  "screenDensity": number,
  "lowFpsVideoRecording": boolean,
  "supportedVersionIds": [
    string
  ],
  "supportedAbis": [
    string
  ],
  "tags": [
    string
  ]
}
Campos
id

string

Es el ID opaco único de este modelo. Puedes usarlo para invocar el recurso TestExecutionService.

name

string

Es el nombre comercial legible del modelo de este dispositivo. Ejemplos: “Nexus 5” o “Galaxy S5”.

manufacturer

string

Es el fabricante de este dispositivo.

brand

string

Es la empresa de la marca de este dispositivo. Ejemplos: “Google” o “Samsung”.

codename

string

Es el nombre del diseño industrial. Corresponde a android.os.Build.DEVICE.

form

enum(DeviceForm)

Indica si este dispositivo es virtual o físico.

formFactor

enum(DeviceFormFactor)

Indica si este dispositivo es un teléfono, una tablet, un dispositivo wearable, etcétera.

screenX

number

Es el tamaño de la pantalla en dimensión horizontal (X) medida en píxeles.

screenY

number

Es el tamaño de la pantalla en dimensión vertical (Y) medida en píxeles.

screenDensity

number

Es la densidad de la pantalla en DPI y corresponde a ro.sf.lcd_density

lowFpsVideoRecording

boolean

El valor es verdadero solo si se unieron las capturas de pantalla para registrar las pruebas en este modelo. Consulta use_low_spec_video_recording en la Configuración del dispositivo.

supportedVersionIds[]

string

Es el conjunto de versiones de Android compatibles con este dispositivo.

supportedAbis[]

string

Es la lista de ABI compatibles con este dispositivo. Corresponde a android.os.Build.SUPPORTED_ABIS (para las API de nivel 21 o superiores) o a android.os.Build.CPU_ABI/CPU_ABI2. La ABI preferida es el primer elemento en la lista.

Opcionalmente, los elementos tienen el prefijo “version_id:” (en el que version_id es el ID de una AndroidVersion), lo que indica que una ABI solo es compatible con una versión específica.

tags[]

string

Son las etiquetas de esta dimensión. Ejemplos: “predeterminado”, “vista previa” o “no disponible”.

DeviceForm

Indica si el dispositivo es físico o virtual.

Enumeraciones
DEVICE_FORM_UNSPECIFIED No se debe usar. Solo puedes hacerlo en el control de versiones proto.
VIRTUAL Es una pila de software que simula el dispositivo.
PHYSICAL Es el hardware real.

DeviceFormFactor

Enumeraciones
DEVICE_FORM_FACTOR_UNSPECIFIED No se debe usar. Solo puedes hacerlo en el control de versiones proto.
PHONE Este dispositivo tiene la forma de un teléfono.
TABLET Este dispositivo tiene la forma de una tablet.
WEARABLE Este dispositivo tiene la forma de un reloj o de un wearable.

AndroidVersion

Es la versión del SO Android.

Representación JSON

{
  "id": string,
  "versionString": string,
  "apiLevel": number,
  "codeName": string,
  "releaseDate": {
    object(Date)
  },
  "distribution": {
    object(Distribution)
  },
  "tags": [
    string
  ]
}
Campos
id

string

Es el ID opaco de esta versión de Android. Puedes usarlo para invocar el TestExecutionService.

versionString

string

Es una string que representa la versión del SO Android. Ejemplos: “4.3” o “4.4”.

apiLevel

number

Es el nivel de la API de esta versión de Android. Ejemplos: 18 o 19.

codeName

string

Es el nombre código de esta versión de Android. Ejemplos: “JellyBean” o “KitKat”.

releaseDate

object(Date)

Es la fecha en que se lanzó esta versión de Android al mercado.

distribution

object(Distribution)

Es la participación de mercado de esta versión.

tags[]

string

Son las etiquetas de esta dimensión. Ejemplos: “predeterminado”, “vista previa” o “no disponible”.

Date

Representa una fecha de calendario completa o parcial, como el cumpleaños. La hora del día y la zona horaria se especifican en otra parte o no son importantes. La fecha está relacionada con el calendario gregoriano proléptico. Este recurso puede describir lo siguiente:

  • Una fecha completa con valores para el año, mes y día que no sean cero
  • Un valor de mes y día con un año en cero, como un aniversario
  • Un año solo con valores de mes y día en cero
  • Un valor de año y mes con un día en cero, como la fecha de vencimiento de una tarjeta de crédito

Los tipos relacionados son google.type.TimeOfDay y google.protobuf.Timestamp.

Representación JSON

{
  "year": number,
  "month": number,
  "day": number
}
Campos
year

number

Año de la fecha. Debe encontrarse entre 1 y 9999, o 0 si se especifica una fecha sin año.

month

number

Mes del año. Debe encontrarse entre 1 y 12, o 0 si se especifica un año sin mes ni día.

day

number

Día del mes. Debe encontrarse entre 1 y 31 y ser válido para el mes y el año, o 0 si se especifica solo un año o un año y un mes en los que el día no es importante.

Distribution

Son datos sobre la cantidad relativa de dispositivos que se ejecuta en una configuración determinada de la plataforma de Android.

Representación JSON

{
  "measurementTime": string,
  "marketShare": number
}
Campos
measurementTime

string (Timestamp format)

Solo salida. La fecha y hora en que se midió esta distribución.

Una marca de tiempo en el formato RFC3339 UTC “Zulu”, con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

marketShare

number

Solo salida. Es la fracción estimada (de 0 a 1) del mercado total con esta configuración.

AndroidRuntimeConfiguration

Es la configuración de Android que se puede seleccionar cuando se ejecute una prueba.

Representación JSON

{
  "locales": [
    {
      object(Locale)
    }
  ],
  "orientations": [
    {
      object(Orientation)
    }
  ]
}
Campos
locales[]

object(Locale)

Es el conjunto de configuraciones regionales disponibles.

orientations[]

object(Orientation)

Es el conjunto de orientaciones disponibles.

Locale

Es una designación de ubicación/región de un idioma.

Representación JSON

{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
Campos
id

string

Es el ID de esta configuración regional. Ejemplo: “en_US”.

name

string

Un nombre sencillo para este idioma/configuración regional. Ejemplo: “inglés”.

region

string

Una string sencilla que describe la región de esta configuración regional. Ejemplo: “Estados Unidos”. Es posible que no esté presente en cada configuración regional.

tags[]

string

Son las etiquetas de esta dimensión. Ejemplo: “predeterminado”.

Orientation

Es la orientación de la pantalla del dispositivo.

Representación JSON

{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
Campos
id

string

Es el ID de esta orientación. Ejemplo: “vertical”.

name

string

Es un nombre sencillo para esta orientación. Ejemplo: “vertical”.

tags[]

string

Son las etiquetas de esta dimensión. Ejemplo: “predeterminado”.

IosDeviceCatalog

Son los dispositivos iOS que se admiten en la actualidad.

Representación JSON

{
  "models": [
    {
      object(IosModel)
    }
  ],
  "versions": [
    {
      object(IosVersion)
    }
  ],
  "xcodeVersions": [
    {
      object(XcodeVersion)
    }
  ],
  "runtimeConfiguration": {
    object(IosRuntimeConfiguration)
  }
}
Campos
models[]

object(IosModel)

Es el conjunto de modelos de dispositivos iOS compatibles.

versions[]

object(IosVersion)

Es el conjunto de versiones del software de iOS compatibles.

xcodeVersions[]

object(XcodeVersion)

Es el conjunto de versiones de Xcode compatibles.

runtimeConfiguration

object(IosRuntimeConfiguration)

Es el conjunto de configuraciones de tiempo de ejecución compatibles.

IosModel

Es una descripción de un dispositivo iOS en el que se pueden ejecutar pruebas.

Representación JSON

{
  "id": string,
  "name": string,
  "supportedVersionIds": [
    string
  ],
  "tags": [
    string
  ],
  "deviceCapabilities": [
    string
  ],
  "formFactor": enum(DeviceFormFactor)
}
Campos
id

string

Es el ID opaco único de este modelo. Puedes usarlo para invocar el recurso TestExecutionService.

name

string

Es el nombre legible del modelo de este dispositivo. Ejemplos: “iPhone 4s” o “iPad Mini 2”.

supportedVersionIds[]

string

Es el conjunto de las versiones de software principales de iOS compatibles con este dispositivo.

tags[]

string

Son las etiquetas de esta dimensión. Ejemplos: “predeterminado”, “vista previa” o “no disponible”.

deviceCapabilities[]

string

Son las funciones del dispositivo que se copiaron de https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

formFactor

enum(DeviceFormFactor)

Indica si este dispositivo es un teléfono, una tablet, un dispositivo wearable, etcétera.

IosVersion

Es una versión de iOS.

Representación JSON

{
  "id": string,
  "majorVersion": number,
  "minorVersion": number,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
Campos
id

string

Es el ID opaco de esta versión de iOS. Puedes usarlo para invocar el TestExecutionService.

majorVersion

number

Es un número entero que representa la versión principal de iOS. Ejemplos: “8” o “9”.

minorVersion

number

Es un número entero que representa la versión secundaria de iOS. Ejemplos: “1” o “2”.

tags[]

string

Son las etiquetas de esta dimensión. Ejemplos: “predeterminado”, “vista previa” o “no disponible”.

supportedXcodeVersionIds[]

string

Son las versiones de Xcode disponibles para esta versión.

XcodeVersion

Es una versión de Xcode que es compatible con una de iOS.

Representación JSON

{
  "version": string,
  "tags": [
    string
  ]
}
Campos
version

string

Es el ID de esta versión. Ejemplo: “9.2”.

tags[]

string

Son las etiquetas de esta versión de Xcode. Ejemplo: “predeterminado”.

IosRuntimeConfiguration

Es la configuración de iOS que se puede seleccionar cuando se ejecute una prueba.

Representación JSON

{
  "locales": [
    {
      object(Locale)
    }
  ],
  "orientations": [
    {
      object(Orientation)
    }
  ]
}
Campos
locales[]

object(Locale)

Es el conjunto de configuraciones regionales disponibles.

orientations[]

object(Orientation)

Es el conjunto de orientaciones disponibles.

NetworkConfigurationCatalog

Representación JSON

{
  "configurations": [
    {
      object(NetworkConfiguration)
    }
  ]
}
Campos
configurations[]

object(NetworkConfiguration)

NetworkConfiguration

Representación JSON

{
  "id": string,
  "upRule": {
    object(TrafficRule)
  },
  "downRule": {
    object(TrafficRule)
  }
}
Campos
id

string

Es el ID opaco único de esta configuración de tráfico de red.

upRule

object(TrafficRule)

Es la regla de emulación que se aplica al tráfico de carga.

downRule

object(TrafficRule)

Es la regla de emulación que se aplica al tráfico de descarga.

TrafficRule

Son los parámetros de emulación de red.

Representación JSON

{
  "delay": string,
  "packetLossRatio": number,
  "packetDuplicationRatio": number,
  "bandwidth": number,
  "burst": number
}
Campos
delay

string (Duration format)

Es la demora del paquete y debe ser >= 0.

Una duración en segundos con un máximo de 9 dígitos decimales, que termina con “s”. Ejemplo: "3.5s".

packetLossRatio

number

Es la proporción de pérdida del paquete (0.0 - 1.0).

packetDuplicationRatio

number

Es la proporción de duplicación del paquete (0.0 - 1.0).

bandwidth

number

Es el ancho de banda en kbits/s.

burst

number

Es el tamaño del pico de actividad en kbits.

ProvidedSoftwareCatalog

Es el entorno actual del software proporcionado en los dispositivos a prueba.

Representación JSON

{
  "orchestratorVersion": string
}
Campos
orchestratorVersion

string

Es una string que representa la versión actual de Android Test Orchestrator que TestExecutionService proporciona. Ejemplo: “1.0.2 versión Beta”.

Métodos

get

Permite obtener el catálogo de los entornos de prueba compatibles.

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.