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.
}
Los campos
Campo de unión environment_catalog . Solo salida. environment_catalog solo puede ser uno de los siguientes:
androidDeviceCatalog

object ( AndroidDeviceCatalog )

Dispositivos Android compatibles.

iosDeviceCatalog

object ( IosDeviceCatalog )

Dispositivos iOS compatibles.

networkConfigurationCatalog

object ( NetworkConfigurationCatalog )

Configuraciones de red compatibles.

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.

AndroidDeviceCatálogo

Los dispositivos Android compatibles actualmente.

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

object ( AndroidModel )

El conjunto de modelos de dispositivos Android compatibles.

versions[]

object ( AndroidVersion )

El conjunto de versiones compatibles del sistema operativo Android.

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
}
Los campos
id

string

La identificación opaca única para este modelo. Use esto 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 con la que está marcado 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) medida 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 el nivel de API 21 y superior) o android.os.Build.CPU_ABI/CPU_ABI2. El ABI preferido es el primer elemento de la lista.

Los elementos tienen el prefijo opcional "versionId:" (donde versionId es la identificación de una AndroidVersion), lo que indica una ABI que solo se admite en una versión en particular.

tags[]

string

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

thumbnailUrl

string

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

DeviceForm

Si el dispositivo es físico o virtual.

Enumeraciones
DEVICE_FORM_UNSPECIFIED No utilice. Solo para protoversiones.
VIRTUAL Dispositivo virtual Android con virtualización nativa de Compute Engine. Solo para el laboratorio de pruebas de Firebase.
PHYSICAL Hardware real.
EMULATOR Dispositivo virtual Android usando 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 protoversiones.
PHONE Este dispositivo tiene la forma de un teléfono.
TABLET Este dispositivo tiene la forma de una tableta.
WEARABLE Este dispositivo tiene la forma de un reloj u otro dispositivo portátil.

PorAndroidVersionInfo

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

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

string

Una versión de Android.

deviceCapacity

enum ( DeviceCapacity )

El número 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 tiene 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 (qué tanto se usan 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 dispositivos de alta capacidad).

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

DEVICE_CAPACITY_LOW

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

Estos dispositivos se pueden usar si los usuarios necesitan realizar pruebas en este modelo y versión específicos del dispositivo. 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 la fragmentación de prueba.

DEVICE_CAPACITY_NONE

Dispositivos que faltan por completo en el laboratorio.

Estos dispositivos no están disponibles de manera temporal o permanente 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
  ]
}
Los campos
id

string

Una identificación opaca para esta versión de Android. Use 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 de calendario total o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar 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 un año cero (por ejemplo, un aniversario).
  • Un año por sí solo, 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
}
Los 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 un mes donde el día no es significativo.

Distribución

Datos sobre el número relativo de dispositivos que ejecutan una determinada configuración de la plataforma Android.

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

string ( Timestamp format)

Solo salida. El tiempo 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

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

Configuración de tiempo de ejecución de Android

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

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

object ( Locale )

El conjunto de locales 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
  ]
}
Los campos
id

string

El ID de esta configuración regional. Ejemplo: "en_US".

name

string

Un nombre descriptivo para este idioma/configuración regional. Ejemplo: "Inglés".

region

string

Una cadena amigable para los humanos que representa la región de esta configuración regional. Ejemplo: "Estados Unidos". No presente para 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
  ]
}
Los campos
id

string

El id para esta orientación. Ejemplo: "retrato".

name

string

Un nombre humano para esta orientación. Ejemplo: "retrato".

tags[]

string

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

IosDeviceCatálogo

Los dispositivos iOS compatibles actualmente.

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

object ( IosModel )

El conjunto de modelos de dispositivos iOS compatibles.

versions[]

object ( IosVersion )

El conjunto de versiones de software de iOS compatibles.

xcodeVersions[]

object ( XcodeVersion )

El conjunto de versiones compatibles de Xcode.

runtimeConfiguration

object ( IosRuntimeConfiguration )

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

IosModelo

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)
    }
  ]
}
Los campos
id

string

La identificación opaca única para este modelo. Use esto 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 de software principales 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) medida 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.

PerIosVersionInfo

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

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

string

Una versión de iOS.

deviceCapacity

enum ( DeviceCapacity )

El número de dispositivos en línea para una versión de iOS.

IosVersión

Una versión de iOS.

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

string

Una identificación opaca para esta versión de iOS. Use 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 de Xcode

Una versión de Xcode compatible con una versión de iOS.

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

string

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

tags[]

string

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

IosRuntimeConfigurationIosRuntimeConfiguration

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

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

object ( Locale )

El conjunto de locales disponibles.

orientations[]

object ( Orientation )

El conjunto de orientaciones disponibles.

NetworkConfigurationCatálogo

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

object ( NetworkConfiguration )

Configuración de la red

Representación JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
Los 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
}
Los campos
delay

string ( Duration format)

Retraso del paquete, debe ser >= 0.

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

packetLossRatio

number

Tasa 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
}
Los 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 usa 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 usa en el entorno. El paquete está disponible en https://maven.google.com/web/index.html#androidx.test:orchestrator .

DeviceIpBlockCatálogo

Lista de bloques de IP utilizados por Firebase Test Lab

Representación JSON
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
Los 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)
  }
}
Los 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.