REST Resource: testEnvironmentCatalog

Recurso: TestEnvironmentCatalog

Una 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)
  },
  "deviceIpBlockCatalog": {
    object (DeviceIpBlockCatalog)
  }
  // End of list of possible types for union field environment_catalog.
}
Campos
Campo de unión environment_catalog . Sólo salida. environment_catalog puede ser solo uno de los siguientes:
androidDeviceCatalog

object ( AndroidDeviceCatalog )

Dispositivos Android compatibles.

iosDeviceCatalog

object ( IosDeviceCatalog )

Dispositivos iOS compatibles.

networkConfigurationCatalog

object ( NetworkConfigurationCatalog )

Configuraciones de red admitidas.

softwareCatalog

object ( ProvidedSoftwareCatalog )

El entorno de prueba de software proporcionado por TestExecutionService.

deviceIpBlockCatalog

object ( DeviceIpBlockCatalog )

Los bloques de IP utilizados por los dispositivos en el entorno de prueba.

Catálogo de dispositivos Android

Los dispositivos Android actualmente compatibles.

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

object ( AndroidModel )

El conjunto de modelos de dispositivos Android compatibles.

versions[]

object ( AndroidVersion )

El conjunto de versiones del sistema operativo Android compatibles.

runtimeConfiguration

object ( AndroidRuntimeConfiguration )

El conjunto de configuraciones de tiempo de ejecución admitidas.

AndroidModelo

Se puede ejecutar una descripción de las pruebas de un dispositivo Android.

Representación JSON
{
  "id": string,
  "name": string,
  "manufacturer": string,
  "brand": string,
  "codename": string,
  "form": enum (DeviceForm),
  "formFactor": enum (DeviceFormFactor),
  "perVersionInfo": [
    {
      object (PerAndroidVersionInfo)
    }
  ],
  "screenX": integer,
  "screenY": integer,
  "screenDensity": integer,
  "lowFpsVideoRecording": boolean,
  "supportedVersionIds": [
    string
  ],
  "supportedAbis": [
    string
  ],
  "tags": [
    string
  ],
  "thumbnailUrl": string
}
Campos
id

string

La identificación opaca única para este modelo. Úselo para invocar TestExecutionService.

name

string

El nombre comercial legible por humanos para este modelo de dispositivo. Ejemplos: "Nexus 5", "Galaxy S5".

manufacturer

string

El fabricante de este dispositivo.

brand

string

La empresa a la que pertenece la marca de este dispositivo. Ejemplo: "Google", "Samsung".

codename

string

El nombre del diseño industrial. Esto corresponde a android.os.Build.DEVICE.

form

enum ( DeviceForm )

Si este dispositivo es virtual o físico.

formFactor

enum ( DeviceFormFactor )

Ya sea que este dispositivo sea un teléfono, una tableta, un dispositivo portátil, etc.

perVersionInfo[]

object ( PerAndroidVersionInfo )

Información específica de la versión de un modelo de Android.

screenX

integer

Tamaño de pantalla en la dimensión horizontal (X) medido en píxeles.

screenY

integer

Tamaño de pantalla en la dimensión vertical (Y) medido en píxeles.

screenDensity

integer

Densidad de pantalla en DPI. Esto corresponde a ro.sf.lcd_density

lowFpsVideoRecording

boolean

Verdadero si y solo si las pruebas con este modelo se registran uniendo capturas de pantalla. Consulte use_low_spec_video_recording en la configuración del dispositivo.

supportedVersionIds[]

string

El conjunto de versiones de Android que admite este dispositivo.

supportedAbis[]

string

La lista de ABI admitidas para este dispositivo. Esto corresponde a android.os.Build.SUPPORTED_ABIS (para nivel API 21 y superior) o android.os.Build.CPU_ABI/CPU_ABI2. El ABI más preferido es el primer elemento de la lista.

Opcionalmente, los elementos tienen el prefijo "versionId:" (donde versionId es el ID de una versión de Android), lo que indica una ABI que solo se admite en una versión particular.

tags[]

string

Etiquetas para esta dimensión. Ejemplos: "predeterminado", "vista previa", "obsoleto".

thumbnailUrl

string

URL de una imagen en miniatura (foto) del dispositivo.

Formulario de dispositivo

Si el dispositivo es físico o virtual.

Enumeraciones
DEVICE_FORM_UNSPECIFIED No utilice. Solo para versiones proto.
VIRTUAL Dispositivo virtual Android que utiliza la virtualización nativa de Compute Engine. Solo laboratorio de pruebas de Firebase.
PHYSICAL Hardware real.
EMULATOR Dispositivo virtual Android que utiliza un emulador en virtualización anidada. Equivalente a Android Studio.

DispositivoFormFactor

El factor de forma de un dispositivo.

Enumeraciones
DEVICE_FORM_FACTOR_UNSPECIFIED No utilice. Solo para versiones proto.
PHONE Este dispositivo tiene forma de teléfono.
TABLET Este dispositivo tiene forma de tableta.
WEARABLE Este dispositivo tiene la forma de un reloj u otro dispositivo portátil.

Por información de versión de Android

Información específica de la versión de un modelo de Android.

Representación JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Campos
versionId

string

Una versión de Android.

deviceCapacity

enum ( DeviceCapacity )

La cantidad de dispositivos en línea para una versión de Android.

Capacidad del dispositivo

Capacidad basada en la cantidad de dispositivos en línea en el laboratorio.

Importante: la capacidad del dispositivo no refleja directamente la longitud de la cola en un momento dado. No tiene en cuenta el tráfico actual ni el estado de los dispositivos.

Para dispositivos físicos, el número es el promedio de dispositivos en línea en los últimos 30 días.

Enumeraciones
DEVICE_CAPACITY_UNSPECIFIED El valor de la capacidad del dispositivo es desconocido o no está configurado.
DEVICE_CAPACITY_HIGH

Dispositivos de alta capacidad (el laboratorio cuenta con una gran cantidad de estos dispositivos).

Estos dispositivos generalmente se recomiendan para ejecutar una gran cantidad de pruebas simultáneas (por ejemplo, más de 100 pruebas).

Tenga en cuenta que los dispositivos de alta capacidad no garantizan tiempos de espera cortos debido a varios factores: 1. Tráfico (cuánto se utilizan en un momento dado) 2. Los dispositivos de alta capacidad tienen prioridad para ciertos usos, lo que puede hacer que las pruebas de los usuarios sean más lentas que seleccionar otros tipos de dispositivos similares.

DEVICE_CAPACITY_MEDIUM

Dispositivos de capacidad media (el laboratorio tiene una cantidad decente de estos dispositivos, aunque no tantos como los de alta capacidad).

Estos dispositivos son adecuados para menos ejecuciones de pruebas (por ejemplo, menos de 100 pruebas) y sólo para recuentos bajos de fragmentos (por ejemplo, menos de 10 fragmentos).

DEVICE_CAPACITY_LOW

Dispositivos de baja capacidad (el laboratorio tiene una pequeña cantidad de estos dispositivos).

Estos dispositivos se pueden utilizar si los usuarios necesitan realizar pruebas en este modelo y versión de dispositivo específicos. Tenga en cuenta que debido a la baja capacidad, las pruebas pueden tardar mucho más en finalizar, especialmente si se invoca una gran cantidad de pruebas a la vez. Estos dispositivos no son adecuados para realizar pruebas de fragmentación.

DEVICE_CAPACITY_NONE

Dispositivos que faltan por completo en el laboratorio.

Estos dispositivos no están disponibles ni temporal ni permanentemente y no deben solicitarse. Si el dispositivo también está marcado como obsoleto, es muy probable que este estado sea permanente.

Versión de Android

Una versión del sistema operativo Android.

Representación JSON
{
  "id": string,
  "versionString": string,
  "apiLevel": integer,
  "codeName": string,
  "releaseDate": {
    object (Date)
  },
  "distribution": {
    object (Distribution)
  },
  "tags": [
    string
  ]
}
Campos
id

string

Una identificación opaca para esta versión de Android. Utilice esta identificación para invocar TestExecutionService.

versionString

string

Una cadena que representa esta versión del sistema operativo Android. Ejemplos: "4.3", "4.4".

apiLevel

integer

El nivel de API para esta versión de Android. Ejemplos: 18, 19.

codeName

string

El nombre en clave de esta versión de Android. Ejemplos: "JellyBean", "KitKat".

releaseDate

object ( Date )

La fecha en que esta versión de Android estuvo disponible en el mercado.

distribution

object ( Distribution )

Cuota de mercado para esta versión.

tags[]

string

Etiquetas para esta dimensión. Ejemplos: "predeterminado", "vista previa", "obsoleto".

Fecha

Representa una fecha del calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se indican en otra parte o son insignificantes. La fecha es relativa al Calendario Gregoriano. Esto puede representar uno de los siguientes:

  • Una fecha completa, con valores de año, mes y día distintos de cero.
  • Un mes y un día, con año cero (por ejemplo, un aniversario).
  • Un año en sí, con un mes cero y un día cero.
  • Un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser de 1 a 9999, o 0 para especificar una fecha sin año.

month

integer

Mes de un año. Debe ser de 1 a 12, o 0 para especificar un año sin mes ni día.

day

integer

Día de un mes. Debe ser del 1 al 31 y válido para el año y el mes, o 0 para especificar un año por sí solo o un año y mes donde el día no es significativo.

Distribución

Datos sobre la cantidad relativa de dispositivos que ejecutan una configuración determinada de la plataforma Android.

Representación JSON
{
  "measurementTime": string,
  "marketShare": number
}
Campos
measurementTime

string ( Timestamp format)

Sólo salida. El momento en que se midió esta distribución.

Una marca de tiempo en formato RFC3339 UTC "Zulu", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z" .

marketShare

number

Sólo salida. La fracción estimada (0-1) del mercado total con esta configuración.

AndroidRuntimeConfiguración

Configuración de Android que se puede seleccionar en el momento de ejecutar una prueba.

Representación JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Campos
locales[]

object ( Locale )

El conjunto de configuraciones regionales disponibles.

orientations[]

object ( Orientation )

El conjunto de orientaciones disponibles.

Lugar

Una designación de ubicación/región para el idioma.

Representación JSON
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
Campos
id

string

La identificación de esta configuración regional. Ejemplo: "en_US".

name

string

Un nombre amigable para los humanos para este idioma/localización. Ejemplo: "inglés".

region

string

Una cadena amigable para los humanos que representa la región de este lugar. Ejemplo: "Estados Unidos". No está presente en todos los lugares.

tags[]

string

Etiquetas para esta dimensión. Ejemplo: "predeterminado".

Orientación

Orientación de la pantalla del dispositivo.

Representación JSON
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
Campos
id

string

La identificación para esta orientación. Ejemplo: "retrato".

name

string

Un nombre amigable para los humanos para esta orientación. Ejemplo: "retrato".

tags[]

string

Etiquetas para esta dimensión. Ejemplo: "predeterminado".

Catálogo de dispositivos iOS

Los dispositivos iOS actualmente compatibles.

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

object ( IosModel )

El conjunto de modelos de dispositivos iOS compatibles.

versions[]

object ( IosVersion )

El conjunto de versiones de software iOS compatibles.

xcodeVersions[]

object ( XcodeVersion )

El conjunto de versiones de Xcode compatibles.

runtimeConfiguration

object ( IosRuntimeConfiguration )

El conjunto de configuraciones de tiempo de ejecución admitidas.

Modelo Ios

Se puede ejecutar una descripción de las pruebas de un dispositivo iOS.

Representación JSON
{
  "id": string,
  "name": string,
  "supportedVersionIds": [
    string
  ],
  "tags": [
    string
  ],
  "deviceCapabilities": [
    string
  ],
  "screenX": integer,
  "screenY": integer,
  "screenDensity": integer,
  "formFactor": enum (DeviceFormFactor),
  "perVersionInfo": [
    {
      object (PerIosVersionInfo)
    }
  ]
}
Campos
id

string

La identificación opaca única para este modelo. Úselo para invocar TestExecutionService.

name

string

El nombre legible por humanos para este modelo de dispositivo. Ejemplos: "iPhone 4s", "iPad Mini 2".

supportedVersionIds[]

string

El conjunto de versiones principales de software de iOS que admite este dispositivo.

tags[]

string

Etiquetas para esta dimensión. Ejemplos: "predeterminado", "vista previa", "obsoleto".

deviceCapabilities[]

string

Capacidades del dispositivo. Copiado de https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

screenX

integer

Tamaño de pantalla en la dimensión horizontal (X) medido en píxeles.

screenY

integer

Tamaño de pantalla en la dimensión vertical (Y) medido en píxeles.

screenDensity

integer

Densidad de pantalla en DPI.

formFactor

enum ( DeviceFormFactor )

Ya sea que este dispositivo sea un teléfono, una tableta, un dispositivo portátil, etc.

perVersionInfo[]

object ( PerIosVersionInfo )

Información específica de la versión de un modelo de iOS.

Información sobre la versión de PerIos

Información específica de la versión de un modelo de iOS.

Representación JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Campos
versionId

string

Una versión para iOS.

deviceCapacity

enum ( DeviceCapacity )

La cantidad de dispositivos en línea para una versión de iOS.

Versión iOS

Una versión para iOS.

Representación JSON
{
  "id": string,
  "majorVersion": integer,
  "minorVersion": integer,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
Campos
id

string

Una identificación opaca para esta versión de iOS. Utilice esta identificación para invocar TestExecutionService.

majorVersion

integer

Un número entero que representa la versión principal de iOS. Ejemplos: "8", "9".

minorVersion

integer

Un número entero que representa la versión secundaria de iOS. Ejemplos: "1", "2".

tags[]

string

Etiquetas para esta dimensión. Ejemplos: "predeterminado", "vista previa", "obsoleto".

supportedXcodeVersionIds[]

string

Las versiones de Xcode disponibles para esta versión.

Versión Xcode

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

Representación JSON
{
  "version": string,
  "tags": [
    string
  ]
}
Campos
version

string

La identificación de esta versión. Ejemplo: "9.2".

tags[]

string

Etiquetas para esta versión de Xcode. Ejemplo: "predeterminado".

Configuración de IosRuntime

Configuración de iOS que se puede seleccionar en el momento de ejecutar una prueba.

Representación JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Campos
locales[]

object ( Locale )

El conjunto de configuraciones regionales disponibles.

orientations[]

object ( Orientation )

El conjunto de orientaciones disponibles.

Catálogo de configuración de red

Representación JSON
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
Campos
configurations[]

object ( NetworkConfiguration )

Configuración de la red

Representación JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
Campos
id

string

La identificación opaca única para esta configuración de tráfico de red.

upRule

object ( TrafficRule )

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

downRule

object ( TrafficRule )

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

Regla de tráfico

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)

Retraso del paquete, debe ser >= 0.

Una duración en segundos con hasta nueve dígitos fraccionarios, que termina en ' s '. Ejemplo: "3.5s" .

packetLossRatio

number

Relación de pérdida de paquetes (0,0 - 1,0).

packetDuplicationRatio

number

Tasa de duplicación de paquetes (0,0 - 1,0).

bandwidth

number

Ancho de banda en kbits/segundo.

burst

number

Tamaño de ráfaga en kbits.

Catálogo de software proporcionado

El entorno de software proporcionado actualmente en los dispositivos bajo prueba.

Representación JSON
{
  "orchestratorVersion": string,
  "androidxOrchestratorVersion": string
}
Campos
orchestratorVersion
(deprecated)

string

En desuso: use AndroidX Test Orchestrator en el futuro.

Una cadena que representa la versión actual de Android Test Orchestrator que se utiliza en el entorno. El paquete está disponible en https://maven.google.com/web/index.html#com.android.support.test:orchestrator .

androidxOrchestratorVersion

string

Una cadena que representa la versión actual de AndroidX Test Orchestrator que se utiliza en el entorno. El paquete está disponible en https://maven.google.com/web/index.html#androidx.test:orchestrator .

DispositivoIpBlockCatálogo

Lista de bloques de IP utilizados por Firebase Test Lab

Representación JSON
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
Campos
ipBlocks[]

object ( DeviceIpBlock )

Los bloques de IP del dispositivo utilizados por Firebase Test Lab

DispositivoIpBlock

Un bloque de IP de un solo dispositivo

Representación JSON
{
  "block": string,
  "form": enum (DeviceForm),
  "addedDate": {
    object (Date)
  }
}
Campos
block

string

Un bloque de dirección IP en notación CIDR, por ejemplo: 34.68.194.64/29

form

enum ( DeviceForm )

Si este bloque es utilizado por dispositivos físicos o virtuales

addedDate

object ( Date )

La fecha en que se agregó este bloque a Firebase Test Lab

Métodos

get

Obtiene el catálogo de entornos de prueba admitidos.