REST Resource: testEnvironmentCatalog

Ressource : TestEnvironmentCatalog

Une description d'un environnement de test.

Représentation 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.
}
Des champs
Champ Union environment_catalog . Sortie uniquement. environment_catalog ne peut être que l'un des éléments suivants :
androidDeviceCatalog

object ( AndroidDeviceCatalog )

Appareils Android pris en charge.

iosDeviceCatalog

object ( IosDeviceCatalog )

Appareils iOS pris en charge.

networkConfigurationCatalog

object ( NetworkConfigurationCatalog )

Configurations réseau prises en charge.

softwareCatalog

object ( ProvidedSoftwareCatalog )

L'environnement de test logiciel fourni par TestExecutionService.

deviceIpBlockCatalog

object ( DeviceIpBlockCatalog )

Les blocs IP utilisés par les appareils dans l'environnement de test.

Catalogue d'appareils Android

Les appareils Android actuellement pris en charge.

Représentation JSON
{
  "models": [
    {
      object (AndroidModel)
    }
  ],
  "versions": [
    {
      object (AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object (AndroidRuntimeConfiguration)
  }
}
Des champs
models[]

object ( AndroidModel )

L'ensemble des modèles d'appareils Android pris en charge.

versions[]

object ( AndroidVersion )

L'ensemble des versions du système d'exploitation Android prises en charge.

runtimeConfiguration

object ( AndroidRuntimeConfiguration )

L’ensemble des configurations d’exécution prises en charge.

Modèle Android

Une description des tests d'un appareil Android peut être exécutée.

Représentation 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
}
Des champs
id

string

L'identifiant opaque unique pour ce modèle. Utilisez-le pour appeler TestExecutionService.

name

string

Le nom marketing lisible par l'homme de ce modèle d'appareil. Exemples : "Nexus 5", "Galaxy S5".

manufacturer

string

Le fabricant de cet appareil.

brand

string

La société dont cet appareil est marqué. Exemple : "Google", "Samsung".

codename

string

Le nom du dessin industriel. Cela correspond à android.os.Build.DEVICE.

form

enum ( DeviceForm )

Si cet appareil est virtuel ou physique.

formFactor

enum ( DeviceFormFactor )

Que cet appareil soit un téléphone, une tablette, un portable, etc.

perVersionInfo[]

object ( PerAndroidVersionInfo )

Informations spécifiques à la version d'un modèle Android.

screenX

integer

Taille de l'écran dans la dimension horizontale (X) mesurée en pixels.

screenY

integer

Taille de l'écran dans la dimension verticale (Y) mesurée en pixels.

screenDensity

integer

Densité d'écran en DPI. Cela correspond à ro.sf.lcd_density

lowFpsVideoRecording

boolean

Vrai si et seulement si les tests avec ce modèle sont enregistrés en assemblant des captures d'écran. Voir use_low_spec_video_recording dans la configuration de l'appareil.

supportedVersionIds[]

string

L'ensemble des versions d'Android prises en charge par cet appareil.

supportedAbis[]

string

La liste des ABI pris en charge pour cet appareil. Cela correspond soit à android.os.Build.SUPPORTED_ABIS (pour le niveau d'API 21 et supérieur) ou à android.os.Build.CPU_ABI/CPU_ABI2. L'ABI le plus préféré est le premier élément de la liste.

Les éléments sont éventuellement préfixés par « versionId : » (où versionId est l'identifiant d'une AndroidVersion), désignant un ABI pris en charge uniquement sur une version particulière.

tags[]

string

Balises pour cette dimension. Exemples : "par défaut", "aperçu", "obsolète".

thumbnailUrl

string

URL d'une image miniature (photo) de l'appareil.

AppareilForm

Que l'appareil soit physique ou virtuel.

Énumérations
DEVICE_FORM_UNSPECIFIED Ne pas utiliser. Pour le versionnage de proto uniquement.
VIRTUAL Appareil virtuel Android utilisant la virtualisation native Compute Engine. Laboratoire de test Firebase uniquement.
PHYSICAL Matériel réel.
EMULATOR Appareil virtuel Android utilisant un émulateur dans une virtualisation imbriquée. Équivalent à Android Studio.

FacteurFormeAppareil

Le facteur de forme d'un appareil.

Énumérations
DEVICE_FORM_FACTOR_UNSPECIFIED Ne pas utiliser. Pour le versionnage de proto uniquement.
PHONE Cet appareil a la forme d'un téléphone.
TABLET Cet appareil a la forme d’une tablette.
WEARABLE Cet appareil a la forme d’une montre ou d’un autre portable.

ParAndroidVersionInfo

Informations spécifiques à la version d'un modèle Android.

Représentation JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Des champs
versionId

string

Une version Android.

deviceCapacity

enum ( DeviceCapacity )

Le nombre d'appareils en ligne pour une version Android.

Capacité de l'appareil

Capacité basée sur le nombre d’appareils en ligne dans le laboratoire.

Important : la capacité de l'appareil ne reflète pas directement la longueur de la file d'attente à un moment donné. Il ne prend pas en compte le trafic actuel ni l'état des appareils.

Pour les appareils physiques, le nombre correspond à la moyenne des appareils en ligne au cours des 30 derniers jours.

Énumérations
DEVICE_CAPACITY_UNSPECIFIED La valeur de la capacité de l'appareil est inconnue ou non définie.
DEVICE_CAPACITY_HIGH

Appareils de grande capacité (le laboratoire possède un grand nombre de ces appareils).

Ces appareils sont généralement proposés pour réaliser un grand nombre de tests simultanés (par exemple plus de 100 tests).

Veuillez noter que les appareils haute capacité ne garantissent pas des temps d'attente courts en raison de plusieurs facteurs : 1. Trafic (nombre d'utilisations à un moment donné) 2. Les appareils haute capacité sont prioritaires pour certains usages, ce qui peut ralentir les tests utilisateurs. plutôt que de sélectionner d'autres types d'appareils similaires.

DEVICE_CAPACITY_MEDIUM

Appareils de capacité moyenne (le laboratoire possède un nombre décent de ces appareils, mais pas autant que les appareils de grande capacité).

Ces appareils conviennent à moins d'exécutions de tests (par exemple, moins de 100 tests) et uniquement à un faible nombre de partitions (par exemple, moins de 10 partitions).

DEVICE_CAPACITY_LOW

Appareils de faible capacité (le laboratoire possède un petit nombre de ces appareils).

Ces appareils peuvent être utilisés si les utilisateurs ont besoin de tester sur ce modèle et cette version d'appareil spécifiques. Veuillez noter qu'en raison de la faible capacité, les tests peuvent prendre beaucoup plus de temps, surtout si un grand nombre de tests sont invoqués en même temps. Ces appareils ne sont pas adaptés au partage de tests.

DEVICE_CAPACITY_NONE

Des appareils totalement absents du laboratoire.

Ces appareils sont indisponibles temporairement ou définitivement et ne doivent pas être demandés. Si l’appareil est également marqué comme obsolète, cet état est très probablement permanent.

Version Android

Une version du système d'exploitation Android.

Représentation JSON
{
  "id": string,
  "versionString": string,
  "apiLevel": integer,
  "codeName": string,
  "releaseDate": {
    object (Date)
  },
  "distribution": {
    object (Distribution)
  },
  "tags": [
    string
  ]
}
Des champs
id

string

Un identifiant opaque pour cette version Android. Utilisez cet identifiant pour appeler TestExecutionService.

versionString

string

Une chaîne représentant cette version du système d'exploitation Android. Exemples : "4.3", "4.4".

apiLevel

integer

Le niveau API pour cette version Android. Exemples : 18, 19.

codeName

string

Le nom de code de cette version d'Android. Exemples : "JellyBean", "KitKat".

releaseDate

object ( Date )

Date à laquelle cette version d'Android est devenue disponible sur le marché.

distribution

object ( Distribution )

Part de marché pour cette version.

tags[]

string

Balises pour cette dimension. Exemples : "par défaut", "aperçu", "obsolète".

Date

Représente une date du calendrier entière ou partielle, comme un anniversaire. L'heure et le fuseau horaire sont soit indiqués ailleurs, soit insignifiants. La date est relative au calendrier grégorien. Cela peut représenter l'un des éléments suivants :

  • Une date complète, avec des valeurs d'année, de mois et de jour non nulles.
  • Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • Une année à elle seule, avec un mois zéro et un jour zéro.
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés :

Représentation JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Des champs
year

integer

Année de la date. Doit être compris entre 1 et 9999, ou 0 pour spécifier une date sans année.

month

integer

Mois d'un an. Doit être compris entre 1 et 12, ou 0 pour spécifier une année sans mois ni jour.

day

integer

Jour d'un mois. Doit être compris entre 1 et 31 et valable pour l'année et le mois, ou 0 pour spécifier une année seule ou une année et un mois où le jour n'est pas significatif.

Distribution

Données sur le nombre relatif d'appareils exécutant une configuration donnée de la plateforme Android.

Représentation JSON
{
  "measurementTime": string,
  "marketShare": number
}
Des champs
measurementTime

string ( Timestamp format)

Sortie uniquement. Heure à laquelle cette distribution a été mesurée.

Un horodatage au format RFC3339 UTC "Zulu", avec une résolution en nanosecondes et jusqu'à neuf chiffres fractionnaires. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z" .

marketShare

number

Sortie uniquement. La fraction estimée (0-1) du marché total avec cette configuration.

AndroidRuntimeConfiguration

Configuration Android sélectionnable au moment de l'exécution d'un test.

Représentation JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Des champs
locales[]

object ( Locale )

L’ensemble des paramètres régionaux disponibles.

orientations[]

object ( Orientation )

L’ensemble des orientations disponibles.

Lieu

Une désignation d'emplacement/de région pour la langue.

Représentation JSON
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
Des champs
id

string

L'identifiant de ces paramètres régionaux. Exemple : "en_US".

name

string

Un nom convivial pour cette langue/locale. Exemple : "Anglais".

region

string

Une chaîne conviviale représentant la région pour ces paramètres régionaux. Exemple : "États-Unis". Non présent pour tous les paramètres régionaux.

tags[]

string

Balises pour cette dimension. Exemple : "par défaut".

Orientation

Orientation de l'écran de l'appareil.

Représentation JSON
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
Des champs
id

string

L’identifiant de cette orientation. Exemple : "portrait".

name

string

Un nom convivial pour cette orientation. Exemple : "portrait".

tags[]

string

Balises pour cette dimension. Exemple : "par défaut".

Catalogue de périphériques Ios

Les appareils iOS actuellement pris en charge.

Représentation JSON
{
  "models": [
    {
      object (IosModel)
    }
  ],
  "versions": [
    {
      object (IosVersion)
    }
  ],
  "xcodeVersions": [
    {
      object (XcodeVersion)
    }
  ],
  "runtimeConfiguration": {
    object (IosRuntimeConfiguration)
  }
}
Des champs
models[]

object ( IosModel )

L'ensemble des modèles d'appareils iOS pris en charge.

versions[]

object ( IosVersion )

L'ensemble des versions du logiciel iOS prises en charge.

xcodeVersions[]

object ( XcodeVersion )

L'ensemble des versions Xcode prises en charge.

runtimeConfiguration

object ( IosRuntimeConfiguration )

L’ensemble des configurations d’exécution prises en charge.

Modèle Ios

Une description des tests d'un appareil iOS peut être exécuté.

Représentation JSON
{
  "id": string,
  "name": string,
  "supportedVersionIds": [
    string
  ],
  "tags": [
    string
  ],
  "deviceCapabilities": [
    string
  ],
  "screenX": integer,
  "screenY": integer,
  "screenDensity": integer,
  "formFactor": enum (DeviceFormFactor),
  "perVersionInfo": [
    {
      object (PerIosVersionInfo)
    }
  ]
}
Des champs
id

string

L'identifiant opaque unique pour ce modèle. Utilisez-le pour appeler TestExecutionService.

name

string

Le nom lisible par l’homme de ce modèle d’appareil. Exemples : « iPhone 4s », « iPad Mini 2 ».

supportedVersionIds[]

string

L'ensemble des principales versions du logiciel iOS pris en charge par cet appareil.

tags[]

string

Balises pour cette dimension. Exemples : "par défaut", "aperçu", "obsolète".

deviceCapabilities[]

string

Capacités de l'appareil. Copié depuis https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

screenX

integer

Taille de l'écran dans la dimension horizontale (X) mesurée en pixels.

screenY

integer

Taille de l'écran dans la dimension verticale (Y) mesurée en pixels.

screenDensity

integer

Densité d'écran en DPI.

formFactor

enum ( DeviceFormFactor )

Que cet appareil soit un téléphone, une tablette, un portable, etc.

perVersionInfo[]

object ( PerIosVersionInfo )

Informations spécifiques à la version d'un modèle iOS.

PerIosVersionInfo

Informations spécifiques à la version d'un modèle iOS.

Représentation JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Des champs
versionId

string

Une version iOS.

deviceCapacity

enum ( DeviceCapacity )

Le nombre d'appareils en ligne pour une version iOS.

Version iOS

Une version iOS.

Représentation JSON
{
  "id": string,
  "majorVersion": integer,
  "minorVersion": integer,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
Des champs
id

string

Un identifiant opaque pour cette version iOS. Utilisez cet identifiant pour appeler TestExecutionService.

majorVersion

integer

Entier représentant la version majeure d’iOS. Exemples : "8", "9".

minorVersion

integer

Entier représentant la version mineure d’iOS. Exemples : "1", "2".

tags[]

string

Balises pour cette dimension. Exemples : "par défaut", "aperçu", "obsolète".

supportedXcodeVersionIds[]

string

Les versions Xcode disponibles pour cette version.

Version Xcode

Une version Xcode avec laquelle une version iOS est compatible.

Représentation JSON
{
  "version": string,
  "tags": [
    string
  ]
}
Des champs
version

string

L'identifiant de cette version. Exemple : "9.2".

tags[]

string

Balises pour cette version de Xcode. Exemple : "par défaut".

IosRuntimeConfiguration

Configuration iOS sélectionnable au moment de l'exécution d'un test.

Représentation JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Des champs
locales[]

object ( Locale )

L’ensemble des paramètres régionaux disponibles.

orientations[]

object ( Orientation )

L’ensemble des orientations disponibles.

Catalogue de configuration réseau

Représentation JSON
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
Des champs
configurations[]

object ( NetworkConfiguration )

Configuration du réseau

Représentation JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
Des champs
id

string

L’identifiant opaque unique pour cette configuration du trafic réseau.

upRule

object ( TrafficRule )

La règle d'émulation s'appliquant au trafic de téléchargement.

downRule

object ( TrafficRule )

La règle d'émulation s'appliquant au trafic de téléchargement.

Règle de trafic

Paramètres d'émulation de réseau.

Représentation JSON
{
  "delay": string,
  "packetLossRatio": number,
  "packetDuplicationRatio": number,
  "bandwidth": number,
  "burst": number
}
Des champs
delay

string ( Duration format)

Le délai de paquet doit être >= 0.

Une durée en secondes avec jusqu'à neuf chiffres fractionnaires, se terminant par « s ». Exemple : "3.5s" .

packetLossRatio

number

Taux de perte de paquets (0,0 - 1,0).

packetDuplicationRatio

number

Taux de duplication de paquets (0,0 - 1,0).

bandwidth

number

Bande passante en kbits/seconde.

burst

number

Taille de rafale en kbits.

Catalogue de logiciels fournis

L'environnement logiciel actuellement fourni sur les appareils testés.

Représentation JSON
{
  "orchestratorVersion": string,
  "androidxOrchestratorVersion": string
}
Des champs
orchestratorVersion
(deprecated)

string

Obsolète : utilisez désormais AndroidX Test Orchestrator.

Chaîne représentant la version actuelle d'Android Test Orchestrator utilisée dans l'environnement. Le package est disponible sur https://maven.google.com/web/index.html#com.android.support.test:orchestrator .

androidxOrchestratorVersion

string

Chaîne représentant la version actuelle d'AndroidX Test Orchestrator utilisée dans l'environnement. Le package est disponible sur https://maven.google.com/web/index.html#androidx.test:orchestrator .

DeviceIpBlockCatalogue

Liste des blocs IP utilisés par le Firebase Test Lab

Représentation JSON
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
Des champs
ipBlocks[]

object ( DeviceIpBlock )

Les blocs IP de l'appareil utilisés par Firebase Test Lab

DeviceIpBlock

Un seul bloc IP d’appareil

Représentation JSON
{
  "block": string,
  "form": enum (DeviceForm),
  "addedDate": {
    object (Date)
  }
}
Des champs
block

string

Un bloc d'adresse IP en notation CIDR par exemple : 34.68.194.64/29

form

enum ( DeviceForm )

Si ce bloc est utilisé par des appareils physiques ou virtuels

addedDate

object ( Date )

La date à laquelle ce bloc a été ajouté à Firebase Test Lab

Méthodes

get

Obtient le catalogue des environnements de test pris en charge.