REST Resource: testEnvironmentCatalog

Ressource: TestEnvironmentCatalog

Eine Beschreibung einer Testumgebung.

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld environment_catalog . Nur Ausgabe. environment_catalog kann nur einer der folgenden Werte sein:
androidDeviceCatalog

object ( AndroidDeviceCatalog )

Unterstützte Android-Geräte.

iosDeviceCatalog

object ( IosDeviceCatalog )

Unterstützte iOS-Geräte.

networkConfigurationCatalog

object ( NetworkConfigurationCatalog )

Unterstützte Netzwerkkonfigurationen.

softwareCatalog

object ( ProvidedSoftwareCatalog )

Die von TestExecutionService bereitgestellte Softwaretestumgebung.

deviceIpBlockCatalog

object ( DeviceIpBlockCatalog )

Die von Geräten in der Testumgebung verwendeten IP-Blöcke.

AndroidDeviceCatalog

Die derzeit unterstützten Android-Geräte.

JSON-Darstellung
{
  "models": [
    {
      object (AndroidModel)
    }
  ],
  "versions": [
    {
      object (AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object (AndroidRuntimeConfiguration)
  }
}
Felder
models[]

object ( AndroidModel )

Die Gruppe der unterstützten Android-Gerätemodelle.

versions[]

object ( AndroidVersion )

Der Satz unterstützter Android-Betriebssystemversionen.

runtimeConfiguration

object ( AndroidRuntimeConfiguration )

Der Satz unterstützter Laufzeitkonfigurationen.

AndroidModel

Eine Beschreibung eines Android-Geräts, auf dem Tests ausgeführt werden können.

JSON-Darstellung
{
  "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
}
Felder
id

string

Die eindeutige undurchsichtige ID für dieses Modell. Verwenden Sie dies zum Aufrufen des TestExecutionService.

name

string

Der für Menschen lesbare Marketingname für dieses Gerätemodell. Beispiele: „Nexus 5“, „Galaxy S5“.

manufacturer

string

Der Hersteller dieses Geräts.

brand

string

Das Unternehmen, mit dem dieses Gerät gekennzeichnet ist. Beispiel: „Google“, „Samsung“.

codename

string

Der Name des Industriedesigns. Dies entspricht android.os.Build.DEVICE.

form

enum ( DeviceForm )

Ob dieses Gerät virtuell oder physisch ist.

formFactor

enum ( DeviceFormFactor )

Ob es sich bei diesem Gerät um ein Telefon, Tablet, Wearable usw. handelt.

perVersionInfo[]

object ( PerAndroidVersionInfo )

Versionsspezifische Informationen eines Android-Modells.

screenX

integer

Bildschirmgröße in der horizontalen Dimension (X), gemessen in Pixel.

screenY

integer

Bildschirmgröße in der vertikalen Dimension (Y), gemessen in Pixel.

screenDensity

integer

Bildschirmdichte in DPI. Dies entspricht ro.sf.lcd_density

lowFpsVideoRecording

boolean

True genau dann, wenn Tests mit diesem Modell durch Zusammenfügen von Screenshots aufgezeichnet werden. Siehe use_low_spec_video_recording in der Gerätekonfiguration.

supportedVersionIds[]

string

Die von diesem Gerät unterstützten Android-Versionen.

supportedAbis[]

string

Die Liste der unterstützten ABIs für dieses Gerät. Dies entspricht entweder android.os.Build.SUPPORTED_ABIS (für API-Level 21 und höher) oder android.os.Build.CPU_ABI/CPU_ABI2. Der am meisten bevorzugte ABI ist das erste Element in der Liste.

Den Elementen wird optional „versionId:“ vorangestellt (wobei versionId die ID einer AndroidVersion ist), was eine ABI bezeichnet, die nur in einer bestimmten Version unterstützt wird.

tags[]

string

Tags für diese Dimension. Beispiele: „default“, „preview“, „deprecated“.

thumbnailUrl

string

URL eines Miniaturbilds (Foto) des Geräts.

DeviceForm

Ob das Gerät physisch oder virtuell ist.

Aufzählungen
DEVICE_FORM_UNSPECIFIED Verwende nicht. Nur für die Proto-Versionierung.
VIRTUAL Virtuelles Android-Gerät mit nativer Compute Engine-Virtualisierung. Nur Firebase-Testlabor.
PHYSICAL Tatsächliche Hardware.
EMULATOR Virtuelles Android-Gerät mit Emulator in verschachtelter Virtualisierung. Entspricht Android Studio.

DeviceFormFactor

Der Formfaktor eines Geräts.

Aufzählungen
DEVICE_FORM_FACTOR_UNSPECIFIED Verwende nicht. Nur für die Proto-Versionierung.
PHONE Dieses Gerät hat die Form eines Telefons.
TABLET Dieses Gerät hat die Form eines Tablets.
WEARABLE Dieses Gerät hat die Form einer Uhr oder eines anderen tragbaren Geräts.

PerAndroidVersionInfo

Eine versionspezifische Information eines Android-Modells.

JSON-Darstellung
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Felder
versionId

string

Eine Android-Version.

deviceCapacity

enum ( DeviceCapacity )

Die Anzahl der Online-Geräte für eine Android-Version.

Gerätekapazität

Kapazität basierend auf der Anzahl der Online-Geräte im Labor.

Wichtig: Die Gerätekapazität spiegelt nicht direkt die Länge der Warteschlange zu einem bestimmten Zeitpunkt wider. Der aktuelle Datenverkehr oder der Zustand der Geräte werden dabei nicht berücksichtigt.

Bei physischen Geräten ist die Anzahl der Durchschnitt der Online-Geräte in den letzten 30 Tagen.

Aufzählungen
DEVICE_CAPACITY_UNSPECIFIED Der Wert der Gerätekapazität ist unbekannt oder nicht festgelegt.
DEVICE_CAPACITY_HIGH

Geräte mit hoher Kapazität (Das Labor verfügt über eine große Anzahl dieser Geräte).

Diese Geräte werden im Allgemeinen für die Durchführung einer großen Anzahl gleichzeitiger Tests (z. B. mehr als 100 Tests) empfohlen.

Bitte beachten Sie, dass Geräte mit hoher Kapazität aufgrund mehrerer Faktoren keine kurzen Wartezeiten garantieren: 1. Verkehr (wie stark sie zu einem bestimmten Zeitpunkt genutzt werden) 2. Geräte mit hoher Kapazität werden für bestimmte Verwendungen priorisiert, was dazu führen kann, dass Benutzertests langsamer sind als die Auswahl anderer ähnlicher Gerätetypen.

DEVICE_CAPACITY_MEDIUM

Geräte mit mittlerer Kapazität (Das Labor verfügt über eine ordentliche Anzahl dieser Geräte, wenn auch nicht so viele wie Geräte mit hoher Kapazität).

Diese Geräte eignen sich für weniger Testläufe (z. B. weniger als 100 Tests) und nur für geringe Shard-Anzahlen (z. B. weniger als 10 Shards).

DEVICE_CAPACITY_LOW

Geräte mit geringer Kapazität (Das Labor verfügt über eine kleine Anzahl dieser Geräte).

Diese Geräte können verwendet werden, wenn Benutzer Tests mit diesem bestimmten Gerätemodell und dieser spezifischen Geräteversion durchführen müssen. Bitte beachten Sie, dass die Tests aufgrund der geringen Kapazität möglicherweise viel länger dauern, insbesondere wenn viele Tests gleichzeitig aufgerufen werden. Diese Geräte sind nicht für Test-Sharding geeignet.

DEVICE_CAPACITY_NONE

Geräte, die im Labor völlig fehlen.

Diese Geräte sind weder vorübergehend noch dauerhaft verfügbar und sollten nicht angefordert werden. Wenn das Gerät außerdem als veraltet markiert ist, ist dieser Zustand höchstwahrscheinlich dauerhaft.

AndroidVersion

Eine Version des Android-Betriebssystems.

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

string

Eine undurchsichtige ID für diese Android-Version. Verwenden Sie diese ID, um den TestExecutionService aufzurufen.

versionString

string

Eine Zeichenfolge, die diese Version des Android-Betriebssystems darstellt. Beispiele: „4.3“, „4.4“.

apiLevel

integer

Die API-Ebene für diese Android-Version. Beispiele: 18, 19.

codeName

string

Der Codename für diese Android-Version. Beispiele: „JellyBean“, „KitKat“.

releaseDate

object ( Date )

Das Datum, an dem diese Android-Version auf dem Markt verfügbar wurde.

distribution

object ( Distribution )

Marktanteil für diese Version.

tags[]

string

Tags für diese Dimension. Beispiele: „default“, „preview“, „deprecated“.

Datum

Stellt ein ganzes oder einen Teil des Kalenderdatums dar, beispielsweise einen Geburtstag. Uhrzeit und Zeitzone sind entweder an anderer Stelle angegeben oder ohne Bedeutung. Das Datum ist relativ zum Gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein vollständiges Datum mit Jahres-, Monats- und Tageswerten ungleich Null.
  • Ein Monat und ein Tag mit einem Nulljahr (zum Beispiel ein Jahrestag).
  • Ein Jahr für sich, mit einem Monat Null und einem Tag Null.
  • Ein Jahr und ein Monat mit einem Nulltag (zum Beispiel das Ablaufdatum einer Kreditkarte).

Verwandte Typen:

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben.

month

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben.

day

integer

Tag eines Monats. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und einen Monat anzugeben, bei dem der Tag keine Bedeutung hat.

Verteilung

Daten zur relativen Anzahl von Geräten, auf denen eine bestimmte Konfiguration der Android-Plattform ausgeführt wird.

JSON-Darstellung
{
  "measurementTime": string,
  "marketShare": number
}
Felder
measurementTime

string ( Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem diese Verteilung gemessen wurde.

Ein Zeitstempel im RFC3339 UTC „Zulu“-Format mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z" .

marketShare

number

Nur Ausgabe. Der geschätzte Anteil (0-1) des Gesamtmarktes mit dieser Konfiguration.

AndroidRuntimeConfiguration

Android-Konfiguration, die zum Zeitpunkt der Testausführung ausgewählt werden kann.

JSON-Darstellung
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Felder
locales[]

object ( Locale )

Die Menge der verfügbaren Gebietsschemas.

orientations[]

object ( Orientation )

Der Satz verfügbarer Ausrichtungen.

Gebietsschema

Eine Orts-/Regionsbezeichnung für die Sprache.

JSON-Darstellung
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
Felder
id

string

Die ID für dieses Gebietsschema. Beispiel: „en_US“.

name

string

Ein benutzerfreundlicher Name für diese Sprache/Gebietsschema. Beispiel: „Englisch“.

region

string

Eine benutzerfreundliche Zeichenfolge, die die Region für dieses Gebietsschema darstellt. Beispiel: „Vereinigte Staaten“. Nicht für jedes Gebietsschema vorhanden.

tags[]

string

Tags für diese Dimension. Beispiel: „Standard“.

Orientierung

Bildschirmausrichtung des Geräts.

JSON-Darstellung
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
Felder
id

string

Die ID für diese Ausrichtung. Beispiel: „Porträt“.

name

string

Ein menschenfreundlicher Name für diese Ausrichtung. Beispiel: „Porträt“.

tags[]

string

Tags für diese Dimension. Beispiel: „Standard“.

IosDeviceCatalog

Die aktuell unterstützten iOS-Geräte.

JSON-Darstellung
{
  "models": [
    {
      object (IosModel)
    }
  ],
  "versions": [
    {
      object (IosVersion)
    }
  ],
  "xcodeVersions": [
    {
      object (XcodeVersion)
    }
  ],
  "runtimeConfiguration": {
    object (IosRuntimeConfiguration)
  }
}
Felder
models[]

object ( IosModel )

Der Satz unterstützter iOS-Gerätemodelle.

versions[]

object ( IosVersion )

Der Satz unterstützter iOS-Softwareversionen.

xcodeVersions[]

object ( XcodeVersion )

Der Satz unterstützter Xcode-Versionen.

runtimeConfiguration

object ( IosRuntimeConfiguration )

Der Satz unterstützter Laufzeitkonfigurationen.

IosModel

Eine Beschreibung eines iOS-Geräts, auf dem Tests ausgeführt werden können.

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

string

Die eindeutige undurchsichtige ID für dieses Modell. Verwenden Sie dies zum Aufrufen des TestExecutionService.

name

string

Der für Menschen lesbare Name für dieses Gerätemodell. Beispiele: „iPhone 4s“, „iPad Mini 2“.

supportedVersionIds[]

string

Die wichtigsten iOS-Softwareversionen, die dieses Gerät unterstützt.

tags[]

string

Tags für diese Dimension. Beispiele: „default“, „preview“, „deprecated“.

deviceCapabilities[]

string

Gerätefunktionen. Kopiert von https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

screenX

integer

Bildschirmgröße in der horizontalen Dimension (X), gemessen in Pixel.

screenY

integer

Bildschirmgröße in der vertikalen Dimension (Y), gemessen in Pixel.

screenDensity

integer

Bildschirmdichte in DPI.

formFactor

enum ( DeviceFormFactor )

Ob es sich bei diesem Gerät um ein Telefon, Tablet, Wearable usw. handelt.

perVersionInfo[]

object ( PerIosVersionInfo )

Versionsspezifische Informationen eines iOS-Modells.

PerIosVersionInfo

Eine versionspezifische Information eines iOS-Modells.

JSON-Darstellung
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Felder
versionId

string

Eine iOS-Version.

deviceCapacity

enum ( DeviceCapacity )

Die Anzahl der Online-Geräte für eine iOS-Version.

IosVersion

Eine iOS-Version.

JSON-Darstellung
{
  "id": string,
  "majorVersion": integer,
  "minorVersion": integer,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
Felder
id

string

Eine undurchsichtige ID für diese iOS-Version. Verwenden Sie diese ID, um den TestExecutionService aufzurufen.

majorVersion

integer

Eine Ganzzahl, die die Hauptversion von iOS darstellt. Beispiele: „8“, „9“.

minorVersion

integer

Eine Ganzzahl, die die Nebenversion von iOS darstellt. Beispiele: „1“, „2“.

tags[]

string

Tags für diese Dimension. Beispiele: „default“, „preview“, „deprecated“.

supportedXcodeVersionIds[]

string

Die verfügbaren Xcode-Versionen für diese Version.

XcodeVersion

Eine Xcode-Version, mit der eine iOS-Version kompatibel ist.

JSON-Darstellung
{
  "version": string,
  "tags": [
    string
  ]
}
Felder
version

string

Die ID für diese Version. Beispiel: „9.2“.

tags[]

string

Tags für diese Xcode-Version. Beispiel: „Standard“.

IosRuntimeConfiguration

iOS-Konfiguration, die zum Zeitpunkt der Testausführung ausgewählt werden kann.

JSON-Darstellung
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Felder
locales[]

object ( Locale )

Die Menge der verfügbaren Gebietsschemas.

orientations[]

object ( Orientation )

Der Satz verfügbarer Ausrichtungen.

Netzwerkkonfigurationskatalog

JSON-Darstellung
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
Felder
configurations[]

object ( NetworkConfiguration )

Netzwerkkonfiguration

JSON-Darstellung
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
Felder
id

string

Die eindeutige undurchsichtige ID für diese Netzwerkverkehrskonfiguration.

upRule

object ( TrafficRule )

Die Emulationsregel, die für den Upload-Verkehr gilt.

downRule

object ( TrafficRule )

Die Emulationsregel, die für den Download-Verkehr gilt.

Verkehrsregel

Netzwerkemulationsparameter.

JSON-Darstellung
{
  "delay": string,
  "packetLossRatio": number,
  "packetDuplicationRatio": number,
  "bandwidth": number,
  "burst": number
}
Felder
delay

string ( Duration format)

Paketverzögerung, muss >= 0 sein.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, endend mit „ s “. Beispiel: "3.5s" .

packetLossRatio

number

Paketverlustverhältnis (0,0 - 1,0).

packetDuplicationRatio

number

Paketduplizierungsverhältnis (0,0 - 1,0).

bandwidth

number

Bandbreite in Kbit/Sekunde.

burst

number

Burst-Größe in kbits.

BereitgestelltSoftwareKatalog

Die aktuell bereitgestellte Softwareumgebung auf den zu testenden Geräten.

JSON-Darstellung
{
  "orchestratorVersion": string,
  "androidxOrchestratorVersion": string
}
Felder
orchestratorVersion
(deprecated)

string

Veraltet: Verwenden Sie künftig AndroidX Test Orchestrator.

Eine Zeichenfolge, die die aktuelle Version von Android Test Orchestrator darstellt, die in der Umgebung verwendet wird. Das Paket ist unter https://maven.google.com/web/index.html#com.android.support.test:orchestrator verfügbar.

androidxOrchestratorVersion

string

Eine Zeichenfolge, die die aktuelle Version von AndroidX Test Orchestrator darstellt, die in der Umgebung verwendet wird. Das Paket ist unter https://maven.google.com/web/index.html#androidx.test:orchestrator verfügbar.

DeviceIpBlockCatalog

Liste der vom Firebase Test Lab verwendeten IP-Blöcke

JSON-Darstellung
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
Felder
ipBlocks[]

object ( DeviceIpBlock )

Die vom Firebase Test Lab verwendeten Geräte-IP-Blöcke

DeviceIpBlock

Ein einzelner Geräte-IP-Block

JSON-Darstellung
{
  "block": string,
  "form": enum (DeviceForm),
  "addedDate": {
    object (Date)
  }
}
Felder
block

string

Ein IP-Adressblock in CIDR-Notation, z. B.: 34.68.194.64/29

form

enum ( DeviceForm )

Ob dieser Block von physischen oder virtuellen Geräten verwendet wird

addedDate

object ( Date )

Das Datum, an dem dieser Block zum Firebase Test Lab hinzugefügt wurde

Methoden

get

Ruft den Katalog der unterstützten Testumgebungen ab.