REST Resource: testEnvironmentCatalog

Zasób: TestEnvironmentCatalog

Opis środowiska testowego.

Reprezentacja 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.
}
Pola
Pole Unii environment_catalog . Tylko wyjście. environment_catalog może mieć tylko jedną z następujących wartości:
androidDeviceCatalog

object ( AndroidDeviceCatalog )

Obsługiwane urządzenia z Androidem.

iosDeviceCatalog

object ( IosDeviceCatalog )

Obsługiwane urządzenia iOS.

networkConfigurationCatalog

object ( NetworkConfigurationCatalog )

Obsługiwane konfiguracje sieciowe.

softwareCatalog

object ( ProvidedSoftwareCatalog )

Środowisko testowe oprogramowania dostarczane przez TestExecutionService.

deviceIpBlockCatalog

object ( DeviceIpBlockCatalog )

Bloki IP używane przez urządzenia w środowisku testowym.

Katalog urządzeń z Androidem

Aktualnie obsługiwane urządzenia z systemem Android.

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

object ( AndroidModel )

Zestaw obsługiwanych modeli urządzeń z systemem Android.

versions[]

object ( AndroidVersion )

Zestaw obsługiwanych wersji systemu operacyjnego Android.

runtimeConfiguration

object ( AndroidRuntimeConfiguration )

Zestaw obsługiwanych konfiguracji środowiska wykonawczego.

Model Androida

Można uruchomić opis testów urządzenia z systemem Android.

Reprezentacja 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
}
Pola
id

string

Unikalny, nieprzezroczysty identyfikator tego modelu. Użyj tego do wywołania usługi TestExecutionService.

name

string

Czytelna dla człowieka nazwa marketingowa tego modelu urządzenia. Przykłady: „Nexus 5”, „Galaxy S5”.

manufacturer

string

Producent tego urządzenia.

brand

string

Firma, której marką jest to urządzenie. Przykład: „Google”, „Samsung”.

codename

string

Nazwa wzoru przemysłowego. Odpowiada to android.os.Build.DEVICE.

form

enum ( DeviceForm )

Czy to urządzenie jest wirtualne czy fizyczne.

formFactor

enum ( DeviceFormFactor )

Czy to urządzenie jest telefonem, tabletem, urządzeniem do noszenia itp.

perVersionInfo[]

object ( PerAndroidVersionInfo )

Informacje dotyczące konkretnej wersji modelu Androida.

screenX

integer

Rozmiar ekranu w wymiarze poziomym (X) mierzony w pikselach.

screenY

integer

Rozmiar ekranu w wymiarze pionowym (Y) mierzony w pikselach.

screenDensity

integer

Gęstość ekranu w DPI. Odpowiada to ro.sf.lcd_density

lowFpsVideoRecording

boolean

Prawda wtedy i tylko wtedy, gdy testy z tym modelem są rejestrowane poprzez zszywanie zrzutów ekranu. Zobacz use_low_spec_video_recording w konfiguracji urządzenia.

supportedVersionIds[]

string

Zestaw wersji Androida obsługiwanych przez to urządzenie.

supportedAbis[]

string

Lista obsługiwanych interfejsów ABI dla tego urządzenia. Odpowiada to albo android.os.Build.SUPPORTED_ABIS (dla poziomu API 21 i wyższego) lub android.os.Build.CPU_ABI/CPU_ABI2. Najbardziej preferowanym ABI jest pierwszy element na liście.

Elementy są opcjonalnie poprzedzone prefiksem „versionId:” (gdzie VersionId to identyfikator wersji Androida), oznaczający interfejs ABI obsługiwany tylko w określonej wersji.

tags[]

string

Tagi dla tego wymiaru. Przykłady: „domyślny”, „podgląd”, „przestarzały”.

thumbnailUrl

string

Adres URL miniatury (zdjęcia) urządzenia.

Formularz urządzenia

Niezależnie od tego, czy urządzenie jest fizyczne, czy wirtualne.

Wyliczenia
DEVICE_FORM_UNSPECIFIED Nie używaj. Tylko dla wersji proto.
VIRTUAL Urządzenie wirtualne z Androidem korzystające z natywnej wirtualizacji Compute Engine. Tylko laboratorium testowe Firebase.
PHYSICAL Rzeczywisty sprzęt.
EMULATOR Urządzenie wirtualne z systemem Android korzystające z emulatora w zagnieżdżonej wirtualizacji. Odpowiednik Androida Studio.

FormFactor urządzenia

Współczynnik kształtu urządzenia.

Wyliczenia
DEVICE_FORM_FACTOR_UNSPECIFIED Nie używaj. Tylko dla wersji proto.
PHONE To urządzenie ma kształt telefonu.
TABLET Urządzenie to ma kształt tabletu.
WEARABLE To urządzenie ma kształt zegarka lub innego urządzenia do noszenia.

Informacje o wersji Androida

Informacje dotyczące konkretnej wersji modelu Androida.

Reprezentacja JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Pola
versionId

string

Wersja na Androida.

deviceCapacity

enum ( DeviceCapacity )

Liczba urządzeń online dla wersji Androida.

Pojemność urządzenia

Wydajność na podstawie liczby urządzeń online w laboratorium.

Ważne: pojemność urządzenia nie odzwierciedla bezpośrednio długości kolejki w danym momencie. Nie uwzględnia aktualnego ruchu ani stanu urządzeń.

W przypadku urządzeń fizycznych liczba ta jest średnią liczbą urządzeń online w ciągu ostatnich 30 dni.

Wyliczenia
DEVICE_CAPACITY_UNSPECIFIED Wartość pojemności urządzenia jest nieznana lub nieustawiona.
DEVICE_CAPACITY_HIGH

Urządzenia o dużej pojemności (laboratorium posiada dużą liczbę takich urządzeń).

Urządzenia te są na ogół zalecane do przeprowadzania dużej liczby jednoczesnych testów (np. ponad 100 testów).

Należy pamiętać, że urządzenia o dużej pojemności nie gwarantują krótkiego czasu oczekiwania z kilku powodów: 1. Ruch (jak intensywnie są używane w danym momencie) 2. Urządzenia o dużej pojemności mają priorytet w przypadku niektórych zastosowań, co może spowodować wolniejsze testy użytkowników niż wybieranie innych podobnych typów urządzeń.

DEVICE_CAPACITY_MEDIUM

Urządzenia o średniej pojemności (laboratorium dysponuje przyzwoitą liczbą tych urządzeń, choć nie tak dużą, jak urządzenia o dużej pojemności).

Urządzenia te nadają się do mniejszej liczby przebiegów testowych (np. mniej niż 100 testów) i tylko w przypadku małej liczby fragmentów (np. mniej niż 10 fragmentów).

DEVICE_CAPACITY_LOW

Urządzenia o małej pojemności (laboratorium posiada niewielką liczbę takich urządzeń).

Urządzenia te mogą być używane, jeśli użytkownicy chcą przetestować ten konkretny model i wersję urządzenia. Należy pamiętać, że ze względu na małą pojemność zakończenie testów może potrwać znacznie dłużej, zwłaszcza jeśli jednocześnie zostanie wywołana duża liczba testów. Urządzenia te nie nadają się do testowego fragmentowania.

DEVICE_CAPACITY_NONE

Urządzenia, których zupełnie brakuje w laboratorium.

Urządzenia te są niedostępne tymczasowo lub na stałe i nie należy ich zamawiać. Jeśli urządzenie jest również oznaczone jako przestarzałe, stan ten najprawdopodobniej będzie trwały.

Wersja Androida

Wersja systemu operacyjnego Android.

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

string

Nieprzezroczysty identyfikator dla tej wersji Androida. Użyj tego identyfikatora, aby wywołać usługę TestExecutionService.

versionString

string

Ciąg reprezentujący tę wersję systemu operacyjnego Android. Przykłady: „4,3”, „4,4”.

apiLevel

integer

Poziom API dla tej wersji Androida. Przykłady: 18, 19.

codeName

string

Nazwa kodowa tej wersji Androida. Przykłady: „JellyBean”, „KitKat”.

releaseDate

object ( Date )

Data udostępnienia na rynku tej wersji Androida.

distribution

object ( Distribution )

Udział w rynku dla tej wersji.

tags[]

string

Tagi dla tego wymiaru. Przykłady: „domyślny”, „podgląd”, „przestarzały”.

Data

Reprezentuje całą lub częściową datę kalendarzową, taką jak urodziny. Pora dnia i strefa czasowa są albo określone gdzie indziej, albo są nieistotne. Data jest zależna od kalendarza gregoriańskiego. Może to oznaczać jedno z poniższych:

  • Pełna data z niezerowymi wartościami roku, miesiąca i dnia.
  • Miesiąc i dzień z rokiem zerowym (na przykład rocznica).
  • Rok sam w sobie, z zerowym miesiącem i zerowym dniem.
  • Rok i miesiąc z dniem zerowym (na przykład datą ważności karty kredytowej).

Powiązane typy:

Reprezentacja JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi wynosić od 1 do 9999 lub 0, aby określić datę bez roku.

month

integer

Miesiąc roku. Musi wynosić od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia.

day

integer

Dzień miesiąca. Musi wynosić od 1 do 31 i obowiązywać dla roku i miesiąca, lub 0, aby określić sam rok lub rok i miesiąc, gdy dzień nie jest znaczący.

Dystrybucja

Dane o względnej liczbie urządzeń z daną konfiguracją platformy Android.

Reprezentacja JSON
{
  "measurementTime": string,
  "marketShare": number
}
Pola
measurementTime

string ( Timestamp format)

Tylko wyjście. Czas pomiaru tego rozkładu.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundową i maksymalnie dziewięcioma cyframi ułamkowymi. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z" .

marketShare

number

Tylko wyjście. Szacowany ułamek (0-1) całego rynku w tej konfiguracji.

Konfiguracja środowiska uruchomieniowego Androida

Konfiguracja Androida, którą można wybrać w momencie uruchomienia testu.

Reprezentacja JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Pola
locales[]

object ( Locale )

Zestaw dostępnych ustawień regionalnych.

orientations[]

object ( Orientation )

Zestaw dostępnych orientacji.

Widownia

Oznaczenie lokalizacji/regionu dla języka.

Reprezentacja JSON
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
Pola
id

string

Identyfikator tego ustawienia regionalnego. Przykład: „en_US”.

name

string

Przyjazna dla człowieka nazwa tego języka/lokalizacji. Przykład: „angielski”.

region

string

Przyjazny dla człowieka ciąg znaków reprezentujący region dla tej lokalizacji. Przykład: „Stany Zjednoczone”. Nie występuje w każdym regionie.

tags[]

string

Tagi dla tego wymiaru. Przykład: „domyślny”.

Orientacja

Orientacja ekranu urządzenia.

Reprezentacja JSON
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
Pola
id

string

Identyfikator tej orientacji. Przykład: „portret”.

name

string

Przyjazna człowiekowi nazwa tej orientacji. Przykład: „portret”.

tags[]

string

Tagi dla tego wymiaru. Przykład: „domyślny”.

Katalog urządzeń iOS

Aktualnie obsługiwane urządzenia iOS.

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

object ( IosModel )

Zestaw obsługiwanych modeli urządzeń iOS.

versions[]

object ( IosVersion )

Zestaw obsługiwanych wersji oprogramowania iOS.

xcodeVersions[]

object ( XcodeVersion )

Zestaw obsługiwanych wersji Xcode.

runtimeConfiguration

object ( IosRuntimeConfiguration )

Zestaw obsługiwanych konfiguracji środowiska wykonawczego.

Model iOS

Można na nim uruchomić opis testów urządzenia iOS.

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

string

Unikalny, nieprzezroczysty identyfikator tego modelu. Użyj tego do wywołania usługi TestExecutionService.

name

string

Czytelna dla człowieka nazwa tego modelu urządzenia. Przykłady: „iPhone 4s”, „iPad Mini 2”.

supportedVersionIds[]

string

Zestaw głównych wersji oprogramowania iOS obsługiwanych przez to urządzenie.

tags[]

string

Tagi dla tego wymiaru. Przykłady: „domyślny”, „podgląd”, „przestarzały”.

deviceCapabilities[]

string

Możliwości urządzenia. Skopiowano z https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

screenX

integer

Rozmiar ekranu w wymiarze poziomym (X) mierzony w pikselach.

screenY

integer

Rozmiar ekranu w wymiarze pionowym (Y) mierzony w pikselach.

screenDensity

integer

Gęstość ekranu w DPI.

formFactor

enum ( DeviceFormFactor )

Czy to urządzenie jest telefonem, tabletem, urządzeniem do noszenia itp.

perVersionInfo[]

object ( PerIosVersionInfo )

Informacje specyficzne dla wersji modelu iOS.

Informacje o wersji PerIos

Informacje specyficzne dla wersji modelu systemu iOS.

Reprezentacja JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Pola
versionId

string

Wersja na iOS.

deviceCapacity

enum ( DeviceCapacity )

Liczba urządzeń online dla wersji iOS.

Wersja iOS

Wersja na iOS.

Reprezentacja JSON
{
  "id": string,
  "majorVersion": integer,
  "minorVersion": integer,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
Pola
id

string

Nieprzezroczysty identyfikator dla tej wersji iOS. Użyj tego identyfikatora, aby wywołać usługę TestExecutionService.

majorVersion

integer

Liczba całkowita reprezentująca główną wersję systemu iOS. Przykłady: „8”, „9”.

minorVersion

integer

Liczba całkowita reprezentująca pomocniczą wersję systemu iOS. Przykłady: „1”, „2”.

tags[]

string

Tagi dla tego wymiaru. Przykłady: „domyślny”, „podgląd”, „przestarzały”.

supportedXcodeVersionIds[]

string

Dostępne wersje Xcode dla tej wersji.

Wersja Xcode

Wersja Xcode, z którą jest kompatybilna wersja iOS.

Reprezentacja JSON
{
  "version": string,
  "tags": [
    string
  ]
}
Pola
version

string

Identyfikator tej wersji. Przykład: „9,2”.

tags[]

string

Tagi dla tej wersji Xcode. Przykład: „domyślny”.

Konfiguracja IosRuntime

Konfiguracja iOS, którą można wybrać w momencie uruchomienia testu.

Reprezentacja JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Pola
locales[]

object ( Locale )

Zestaw dostępnych ustawień regionalnych.

orientations[]

object ( Orientation )

Zestaw dostępnych orientacji.

Katalog konfiguracji sieci

Reprezentacja JSON
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
Pola
configurations[]

object ( NetworkConfiguration )

Konfiguracja sieci

Reprezentacja JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
Pola
id

string

Unikalny, nieprzezroczysty identyfikator tej konfiguracji ruchu sieciowego.

upRule

object ( TrafficRule )

Reguła emulacji stosowana do ruchu wysyłającego.

downRule

object ( TrafficRule )

Reguła emulacji stosowana do ruchu pobierania.

Reguła ruchu

Parametry emulacji sieci.

Reprezentacja JSON
{
  "delay": string,
  "packetLossRatio": number,
  "packetDuplicationRatio": number,
  "bandwidth": number,
  "burst": number
}
Pola
delay

string ( Duration format)

Opóźnienie pakietu musi wynosić >= 0.

Czas trwania w sekundach, zawierający maksymalnie dziewięć cyfr ułamkowych, kończący się na „ s ”. Przykład: "3.5s" .

packetLossRatio

number

Współczynnik utraty pakietów (0,0 - 1,0).

packetDuplicationRatio

number

Współczynnik duplikacji pakietów (0,0 - 1,0).

bandwidth

number

Przepustowość w kbitach/sekundę.

burst

number

Rozmiar serii w kbitach.

Dostarczony katalog oprogramowania

Aktualnie dostarczane środowisko oprogramowania na testowanych urządzeniach.

Reprezentacja JSON
{
  "orchestratorVersion": string,
  "androidxOrchestratorVersion": string
}
Pola
orchestratorVersion
(deprecated)

string

Przestarzałe: w przyszłości użyj narzędzia AndroidX Test Orchestrator.

Ciąg reprezentujący bieżącą wersję narzędzia Android Test Orchestrator używanego w środowisku. Pakiet jest dostępny pod adresem https://maven.google.com/web/index.html#com.android.support.test:orchestrator .

androidxOrchestratorVersion

string

Ciąg reprezentujący bieżącą wersję narzędzia AndroidX Test Orchestrator używanego w środowisku. Pakiet jest dostępny pod adresem https://maven.google.com/web/index.html#androidx.test:orchestrator .

Katalog urządzeńIpBlock

Lista bloków IP używanych przez laboratorium testowe Firebase

Reprezentacja JSON
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
Pola
ipBlocks[]

object ( DeviceIpBlock )

Bloki adresów IP urządzeń używane przez laboratorium testowe Firebase

UrządzenieIpBlock

Blok IP pojedynczego urządzenia

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

string

Blok adresu IP w notacji CIDR np.: 34.68.194.64/29

form

enum ( DeviceForm )

Czy ten blok jest używany przez urządzenia fizyczne czy wirtualne

addedDate

object ( Date )

Data dodania tego bloku do laboratorium testowego Firebase

Metody

get

Pobiera katalog obsługiwanych środowisk testowych.