REST Resource: testEnvironmentCatalog

Risorsa: TestEnvironmentCatalog

Una descrizione di un ambiente di test.

Rappresentazione 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.
}
Campi
Campo unione environment_catalog . Solo uscita. environment_catalog può essere solo uno dei seguenti:
androidDeviceCatalog

object ( AndroidDeviceCatalog )

Dispositivi Android supportati.

iosDeviceCatalog

object ( IosDeviceCatalog )

Dispositivi iOS supportati.

networkConfigurationCatalog

object ( NetworkConfigurationCatalog )

Configurazioni di rete supportate.

softwareCatalog

object ( ProvidedSoftwareCatalog )

L'ambiente di test del software fornito da TestExecutionService.

deviceIpBlockCatalog

object ( DeviceIpBlockCatalog )

I blocchi IP utilizzati dai dispositivi nell'ambiente di test.

AndroidDeviceCatalog

I dispositivi Android attualmente supportati.

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

object ( AndroidModel )

L'insieme di modelli di dispositivi Android supportati.

versions[]

object ( AndroidVersion )

L'insieme delle versioni del sistema operativo Android supportate.

runtimeConfiguration

object ( AndroidRuntimeConfiguration )

L'insieme di configurazioni di runtime supportate.

Modello Android

È possibile eseguire una descrizione dei test del dispositivo Android.

Rappresentazione 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
}
Campi
id

string

L'ID opaco univoco per questo modello. Usalo per richiamare TestExecutionService.

name

string

Il nome commerciale leggibile per questo modello di dispositivo. Esempi: "Nexus 5", "Galaxy S5".

manufacturer

string

Il produttore di questo dispositivo.

brand

string

L'azienda con cui è marchiato questo dispositivo. Esempio: "Google", "Samsung".

codename

string

Il nome del design industriale. Corrisponde a android.os.Build.DEVICE.

form

enum ( DeviceForm )

Se questo dispositivo è virtuale o fisico.

formFactor

enum ( DeviceFormFactor )

Se questo dispositivo è un telefono, un tablet, un dispositivo indossabile, ecc.

perVersionInfo[]

object ( PerAndroidVersionInfo )

Informazioni specifiche sulla versione di un modello Android.

screenX

integer

Dimensioni dello schermo nella dimensione orizzontale (X) misurata in pixel.

screenY

integer

Dimensioni dello schermo nella dimensione verticale (Y) misurate in pixel.

screenDensity

integer

Densità dello schermo in DPI. Ciò corrisponde a ro.sf.lcd_density

lowFpsVideoRecording

boolean

Vero se e solo se i test con questo modello vengono registrati unendo insieme gli screenshot. Vedi use_low_spec_video_recording nella configurazione del dispositivo.

supportedVersionIds[]

string

L'insieme di versioni Android supportate da questo dispositivo.

supportedAbis[]

string

L'elenco degli ABI supportati per questo dispositivo. Corrisponde a android.os.Build.SUPPORTED_ABIS (per il livello API 21 e superiore) o android.os.Build.CPU_ABI/CPU_ABI2. L'ABI più preferito è il primo elemento dell'elenco.

Gli elementi sono facoltativamente preceduti da "versionId:" (dove versionId è l'ID di un AndroidVersion), che indica un ABI supportato solo su una particolare versione.

tags[]

string

Tag per questa dimensione. Esempi: "default", "anteprima", "deprecato".

thumbnailUrl

string

URL di un'immagine in miniatura (foto) del dispositivo.

DispositivoForm

Se il dispositivo è fisico o virtuale.

Enumerazioni
DEVICE_FORM_UNSPECIFIED Non usare. Solo per il controllo delle versioni del prototipo.
VIRTUAL Dispositivo virtuale Android che utilizza la virtualizzazione nativa di Compute Engine. Solo Firebase Test Lab.
PHYSICAL Hardware reale.
EMULATOR Dispositivo virtuale Android che utilizza l'emulatore nella virtualizzazione nidificata. Equivalente ad Android Studio.

DispositivoFormFactor

Il fattore di forma di un dispositivo.

Enumerazioni
DEVICE_FORM_FACTOR_UNSPECIFIED Non usare. Solo per il controllo delle versioni del prototipo.
PHONE Questo dispositivo ha la forma di un telefono.
TABLET Questo dispositivo ha la forma di un tablet.
WEARABLE Questo dispositivo ha la forma di un orologio o di un altro oggetto indossabile.

PerAndroidVersionInfo

Informazioni specifiche sulla versione di un modello Android.

Rappresentazione JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Campi
versionId

string

Una versione Android.

deviceCapacity

enum ( DeviceCapacity )

Il numero di dispositivi online per una versione Android.

Capacità dispositivo

Capacità basata sul numero di dispositivi online nel laboratorio.

Importante: la capacità del dispositivo non riflette direttamente la lunghezza della coda in un dato momento. Non tiene conto del traffico attuale o dello stato dei dispositivi.

Per i dispositivi fisici, il numero rappresenta la media dei dispositivi online negli ultimi 30 giorni.

Enumerazioni
DEVICE_CAPACITY_UNSPECIFIED Il valore della capacità del dispositivo è sconosciuto o non impostato.
DEVICE_CAPACITY_HIGH

Dispositivi ad alta capacità (il laboratorio dispone di un gran numero di questi dispositivi).

Questi dispositivi sono generalmente consigliati per eseguire un gran numero di test simultanei (es. più di 100 test).

Tieni presente che i dispositivi ad alta capacità non garantiscono tempi di attesa brevi a causa di diversi fattori: 1. Traffico (quanto intensamente vengono utilizzati in un dato momento) 2. Ai dispositivi ad alta capacità viene data priorità per determinati utilizzi, il che potrebbe rallentare i test utente piuttosto che selezionare altri tipi di dispositivi simili.

DEVICE_CAPACITY_MEDIUM

Dispositivi di capacità media (il laboratorio dispone di un numero decente di questi dispositivi, anche se non tanti quanto i dispositivi ad alta capacità).

Questi dispositivi sono adatti per un numero inferiore di test (ad esempio, meno di 100 test) e solo per un numero basso di shard (ad esempio, meno di 10 shard).

DEVICE_CAPACITY_LOW

Dispositivi con capacità ridotta (il laboratorio dispone di un numero limitato di questi dispositivi).

Questi dispositivi possono essere utilizzati se gli utenti necessitano di eseguire test su questo modello e versione di dispositivo specifici. Tieni presente che, a causa della capacità ridotta, il completamento dei test potrebbe richiedere molto più tempo, soprattutto se vengono eseguiti numerosi test contemporaneamente. Questi dispositivi non sono adatti per lo sharding di prova.

DEVICE_CAPACITY_NONE

Dispositivi completamente scomparsi dal laboratorio.

Questi dispositivi non sono disponibili né temporaneamente né permanentemente e non devono essere richiesti. Se il dispositivo è contrassegnato anche come deprecato, è molto probabile che questo stato sia permanente.

Versione Android

Una versione del sistema operativo Android.

Rappresentazione JSON
{
  "id": string,
  "versionString": string,
  "apiLevel": integer,
  "codeName": string,
  "releaseDate": {
    object (Date)
  },
  "distribution": {
    object (Distribution)
  },
  "tags": [
    string
  ]
}
Campi
id

string

Un ID opaco per questa versione di Android. Utilizzare questo ID per richiamare TestExecutionService.

versionString

string

Una stringa che rappresenta questa versione del sistema operativo Android. Esempi: "4.3", "4.4".

apiLevel

integer

Il livello API per questa versione di Android. Esempi: 18, 19.

codeName

string

Il nome in codice per questa versione di Android. Esempi: "JellyBean", "KitKat".

releaseDate

object ( Date )

La data in cui questa versione di Android è diventata disponibile sul mercato.

distribution

object ( Distribution )

Quota di mercato per questa versione.

tags[]

string

Tag per questa dimensione. Esempi: "default", "anteprima", "deprecato".

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Questo può rappresentare uno dei seguenti:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno pari a zero (ad esempio, un anniversario).
  • Un anno a parte, con un mese zero e un giorno zero.
  • Un anno e un mese, con un giorno zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

Distribuzione

Dati sul numero relativo di dispositivi che eseguono una determinata configurazione della piattaforma Android.

Rappresentazione JSON
{
  "measurementTime": string,
  "marketShare": number
}
Campi
measurementTime

string ( Timestamp format)

Solo uscita. Il tempo in cui è stata misurata questa distribuzione.

Un timestamp in formato RFC3339 UTC "Zulu", con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z" .

marketShare

number

Solo uscita. La frazione stimata (0-1) del mercato totale con questa configurazione.

Configurazione AndroidRuntime

Configurazione Android selezionabile al momento dell'esecuzione del test.

Rappresentazione JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Campi
locales[]

object ( Locale )

L'insieme delle impostazioni internazionali disponibili.

orientations[]

object ( Orientation )

L'insieme degli orientamenti disponibili.

Locale

Una designazione di località/regione per la lingua.

Rappresentazione JSON
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
Campi
id

string

L'ID di questa locale. Esempio: "en_US".

name

string

Un nome comprensibile per questa lingua/impostazione internazionale. Esempio: "inglese".

region

string

Una stringa a misura d'uomo che rappresenta la regione per questa impostazione locale. Esempio: "Stati Uniti". Non presente per ogni locale.

tags[]

string

Tag per questa dimensione. Esempio: "predefinito".

Orientamento

Orientamento dello schermo del dispositivo.

Rappresentazione JSON
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
Campi
id

string

L'ID per questo orientamento. Esempio: "ritratto".

name

string

Un nome a misura d'uomo per questo orientamento. Esempio: "ritratto".

tags[]

string

Tag per questa dimensione. Esempio: "predefinito".

IosDeviceCatalog

I dispositivi iOS attualmente supportati.

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

object ( IosModel )

L'insieme di modelli di dispositivi iOS supportati.

versions[]

object ( IosVersion )

L'insieme delle versioni software iOS supportate.

xcodeVersions[]

object ( XcodeVersion )

L'insieme delle versioni Xcode supportate.

runtimeConfiguration

object ( IosRuntimeConfiguration )

L'insieme di configurazioni di runtime supportate.

IosModel

È possibile eseguire una descrizione dei test del dispositivo iOS.

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

string

L'ID opaco univoco per questo modello. Usalo per richiamare TestExecutionService.

name

string

Il nome leggibile per questo modello di dispositivo. Esempi: "iPhone 4s", "iPad Mini 2".

supportedVersionIds[]

string

L'insieme delle principali versioni software iOS supportate da questo dispositivo.

tags[]

string

Tag per questa dimensione. Esempi: "default", "anteprima", "deprecato".

deviceCapabilities[]

string

Funzionalità del dispositivo. Copiato da https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

screenX

integer

Dimensioni dello schermo nella dimensione orizzontale (X) misurata in pixel.

screenY

integer

Dimensioni dello schermo nella dimensione verticale (Y) misurate in pixel.

screenDensity

integer

Densità dello schermo in DPI.

formFactor

enum ( DeviceFormFactor )

Se questo dispositivo è un telefono, un tablet, un dispositivo indossabile, ecc.

perVersionInfo[]

object ( PerIosVersionInfo )

Informazioni specifiche sulla versione di un modello iOS.

PerIosVersionInfo

Informazioni specifiche sulla versione di un modello iOS.

Rappresentazione JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Campi
versionId

string

Una versione iOS.

deviceCapacity

enum ( DeviceCapacity )

Il numero di dispositivi online per una versione iOS.

Versione Ios

Una versione iOS.

Rappresentazione JSON
{
  "id": string,
  "majorVersion": integer,
  "minorVersion": integer,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
Campi
id

string

Un ID opaco per questa versione di iOS. Utilizzare questo ID per richiamare TestExecutionService.

majorVersion

integer

Un numero intero che rappresenta la versione principale di iOS. Esempi: "8", "9".

minorVersion

integer

Un numero intero che rappresenta la versione minore di iOS. Esempi: "1", "2".

tags[]

string

Tag per questa dimensione. Esempi: "default", "anteprima", "deprecato".

supportedXcodeVersionIds[]

string

Le versioni Xcode disponibili per questa versione.

XcodeVersione

Una versione Xcode con cui è compatibile una versione iOS.

Rappresentazione JSON
{
  "version": string,
  "tags": [
    string
  ]
}
Campi
version

string

L'ID di questa versione. Esempio: "9.2".

tags[]

string

Tag per questa versione di Xcode. Esempio: "predefinito".

IosRuntimeConfiguration

Configurazione iOS che può essere selezionata al momento dell'esecuzione di un test.

Rappresentazione JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Campi
locales[]

object ( Locale )

L'insieme delle impostazioni locali disponibili.

orientations[]

object ( Orientation )

L'insieme degli orientamenti disponibili.

Catalogo di configurazione di rete

Rappresentazione JSON
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
Campi
configurations[]

object ( NetworkConfiguration )

Configurazione di rete

Rappresentazione JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
Campi
id

string

L'ID opaco univoco per questa configurazione del traffico di rete.

upRule

object ( TrafficRule )

La regola di emulazione applicata al traffico di caricamento.

downRule

object ( TrafficRule )

La regola di emulazione applicata al traffico di download.

TrafficRule

Parametri di emulazione di rete.

Rappresentazione JSON
{
  "delay": string,
  "packetLossRatio": number,
  "packetDuplicationRatio": number,
  "bandwidth": number,
  "burst": number
}
Campi
delay

string ( Duration format)

Ritardo pacchetto, deve essere >= 0.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con ' s '. Esempio: "3.5s" .

packetLossRatio

number

Rapporto di perdita di pacchetti (0,0 - 1,0).

packetDuplicationRatio

number

Rapporto di duplicazione dei pacchetti (0,0 - 1,0).

bandwidth

number

Larghezza di banda in kbit/secondo.

burst

number

Dimensioni dello scoppio in kbit.

Catalogo software fornito

L'ambiente software attualmente fornito sui dispositivi in ​​prova.

Rappresentazione JSON
{
  "orchestratorVersion": string,
  "androidxOrchestratorVersion": string
}
Campi
orchestratorVersion
(deprecated)

string

Deprecato: utilizza AndroidX Test Orchestrator in futuro.

Una stringa che rappresenta la versione corrente di Android Test Orchestrator utilizzata nell'ambiente. Il pacchetto è disponibile all'indirizzo https://maven.google.com/web/index.html#com.android.support.test:orchestrator .

androidxOrchestratorVersion

string

Una stringa che rappresenta la versione corrente di AndroidX Test Orchestrator utilizzata nell'ambiente. Il pacchetto è disponibile all'indirizzo https://maven.google.com/web/index.html#androidx.test:orchestrator .

DeviceIpBlockCatalog

Elenco dei blocchi IP utilizzati dal Firebase Test Lab

Rappresentazione JSON
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
Campi
ipBlocks[]

object ( DeviceIpBlock )

I blocchi IP del dispositivo utilizzati da Firebase Test Lab

DispositivoIpBlock

Un singolo blocco IP del dispositivo

Rappresentazione JSON
{
  "block": string,
  "form": enum (DeviceForm),
  "addedDate": {
    object (Date)
  }
}
Campi
block

string

Un blocco di indirizzi IP nella notazione CIDR, ad esempio: 34.68.194.64/29

form

enum ( DeviceForm )

Se questo blocco viene utilizzato da dispositivi fisici o virtuali

addedDate

object ( Date )

La data in cui questo blocco è stato aggiunto a Firebase Test Lab

Metodi

get

Ottiene il catalogo degli ambienti di test supportati.