REST Resource: projects.histories.executions.environments

Zasób: Środowisko

Środowisko reprezentuje zestaw przebiegów testowych (kroków) z wykonania nadrzędnego, które są skonfigurowane przy użyciu tego samego zestawu wymiarów (model, wersja, ustawienia regionalne i orientacja). Wiele takich uruchomień ma miejsce szczególnie ze względu na funkcje takie jak sharding (podzielenie zestawu testów w celu równoległego uruchomienia na urządzeniach) i powtórki (wielokrotne uruchamianie testu w celu sprawdzenia różnych wyników).

Reprezentacja JSON
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
Pola
projectId

string

Tylko wyjście. Identyfikator projektu.

historyId

string

Tylko wyjście. Identyfikator historii.

executionId

string

Tylko wyjście. Identyfikator wykonania.

environmentId

string

Tylko wyjście. Identyfikator środowiska.

dimensionValue

map (key: string, value: string)

Wartości wymiarów opisujące środowisko. Wartości wymiarów zawsze obejmują „Model”, „Wersję”, „Ustawienia regionalne” i „Orientacja”.

  • W odpowiedzi: zawsze ustawione
  • W żądaniu utworzenia: zawsze ustawione
  • W żądaniu aktualizacji: nigdy nie ustawione

Obiekt zawierający listę par "key": value . Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Krótka, czytelna dla człowieka nazwa wyświetlana w interfejsie użytkownika. Maksymalnie 100 znaków. Na przykład: Nexus 5, API 27.

creationTime

object ( Timestamp )

Tylko wyjście. Czas powstania Środowiska.

completionTime

object ( Timestamp )

Tylko wyjście. Czas, w którym stan środowiska został ustawiony na ukończony.

Wartość ta zostanie ustawiona automatycznie po zmianie stanu na COMPLETE.

shardSummaries[]

object ( ShardSummary )

Tylko wyjście. Podsumowania fragmentów.

Wyświetlony zostanie tylko jeden fragment, chyba że w usłudze TestExecutionService włączono funkcję fragmentowania.

environmentResult

object ( MergedResult )

Połączony wynik środowiska.

resultsStorage

object ( ResultsStorage )

Lokalizacja, w której przechowywane są pliki wyjściowe w zasobniku użytkownika.

Podsumowanie fragmentu

Podsumowanie wyników dla fragmentu w środowisku.

Reprezentacja JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Pola
runs[]

object ( StepSummary )

Podsumowania kroków należących do fragmentu.

Po włączeniu flaky_test_attempts w TestExecutionService może występować więcej niż jedno uruchomienie (krok). Przebiegi zostaną posortowane według numeru wieloetapowego.

shardResult

object ( MergedResult )

Połączony wynik fragmentu.

Podsumowanie kroku

Ten typ nie ma pól.

Lekkie podsumowanie kroku w ramach tego wykonania.

Połączony wynik

Połączony wynik testu dla środowiska.

Jeśli środowisko ma tylko jeden krok (bez powtórzeń i fragmentów), wówczas scalony wynik jest taki sam jak wynik kroku. Jeśli środowisko zawiera wiele fragmentów i/lub powtórzeń, wyniki fragmentów i powtórzeń należących do tego samego środowiska są łączone w jeden wynik środowiska.

Reprezentacja JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Pola
state

enum ( State )

Stan zasobu

outcome

object ( Outcome )

Wynik zasobu

testSuiteOverviews[]

object ( TestSuiteOverview )

Połączony i podsumowany wynik każdego zestawu testów, który został uruchomiony w ramach tego środowiska.

Łączenie: gdy przypadki testowe z pakietu są uruchamiane w różnych etapach (dzielenie na fragmenty), wyniki są ponownie sumowane w jednym przeglądzie. (np. jeśli fragment 1 ma 2 awarie, a fragment 2 ma 1 awarię, wówczas ogólna liczba niepowodzeń = 3).

Zestawienie: gdy przypadki testowe z tego samego zestawu są uruchamiane wielokrotnie (niestabilne), wyniki są łączone (np. jeśli przypadek testowy1.run1 zakończy się niepowodzeniem, przypadek testowy1.run2 zakończy się pomyślnie, a zarówno przypadek testowy2.run1, jak i przypadek testowy2.run2 nie powiodą się, wówczas pojawi się podsumowanie flakyCount = 1 i liczba niepowodzeń = 1).

Przechowywanie wyników

Przechowywanie wyników testów.

Reprezentacja JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Pola
resultsStoragePath

object ( FileReference )

Katalog główny wyników testów.

xunitXmlFile

object ( FileReference )

Ścieżka do pliku XML Xunit.

Metody

get

 Pobiera środowisko.

list

 Wyświetla listę środowisk dla danego wykonania.
,

Zasób: Środowisko

Środowisko reprezentuje zestaw przebiegów testowych (kroków) z wykonania nadrzędnego, które są skonfigurowane przy użyciu tego samego zestawu wymiarów (model, wersja, ustawienia regionalne i orientacja). Wiele takich uruchomień ma miejsce szczególnie ze względu na funkcje takie jak sharding (podzielenie zestawu testów w celu równoległego uruchomienia na urządzeniach) i powtórki (wielokrotne uruchamianie testu w celu sprawdzenia różnych wyników).

Reprezentacja JSON
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
Pola
projectId

string

Tylko wyjście. Identyfikator projektu.

historyId

string

Tylko wyjście. Identyfikator historii.

executionId

string

Tylko wyjście. Identyfikator wykonania.

environmentId

string

Tylko wyjście. Identyfikator środowiska.

dimensionValue

map (key: string, value: string)

Wartości wymiarów opisujące środowisko. Wartości wymiarów zawsze obejmują „Model”, „Wersję”, „Ustawienia regionalne” i „Orientacja”.

  • W odpowiedzi: zawsze ustawione
  • W żądaniu utworzenia: zawsze ustawione
  • W żądaniu aktualizacji: nigdy nie ustawione

Obiekt zawierający listę par "key": value . Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Krótka, czytelna dla człowieka nazwa wyświetlana w interfejsie użytkownika. Maksymalnie 100 znaków. Na przykład: Nexus 5, API 27.

creationTime

object ( Timestamp )

Tylko wyjście. Czas powstania Środowiska.

completionTime

object ( Timestamp )

Tylko wyjście. Czas, w którym stan środowiska został ustawiony na ukończony.

Wartość ta zostanie ustawiona automatycznie po zmianie stanu na COMPLETE.

shardSummaries[]

object ( ShardSummary )

Tylko wyjście. Podsumowania fragmentów.

Wyświetlony zostanie tylko jeden fragment, chyba że w usłudze TestExecutionService włączono funkcję fragmentowania.

environmentResult

object ( MergedResult )

Połączony wynik środowiska.

resultsStorage

object ( ResultsStorage )

Lokalizacja, w której przechowywane są pliki wyjściowe w zasobniku użytkownika.

Podsumowanie fragmentu

Podsumowanie wyników dla fragmentu w środowisku.

Reprezentacja JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Pola
runs[]

object ( StepSummary )

Podsumowania kroków należących do fragmentu.

Po włączeniu flaky_test_attempts w TestExecutionService może występować więcej niż jedno uruchomienie (krok). Przebiegi zostaną posortowane według numeru wieloetapowego.

shardResult

object ( MergedResult )

Połączony wynik fragmentu.

Podsumowanie kroku

Ten typ nie ma pól.

Lekkie podsumowanie kroku w ramach tego wykonania.

Połączony wynik

Połączony wynik testu dla środowiska.

Jeśli środowisko ma tylko jeden krok (bez powtórzeń i fragmentów), wówczas scalony wynik jest taki sam jak wynik kroku. Jeśli środowisko zawiera wiele fragmentów i/lub powtórzeń, wyniki fragmentów i powtórzeń należących do tego samego środowiska są łączone w jeden wynik środowiska.

Reprezentacja JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Pola
state

enum ( State )

Stan zasobu

outcome

object ( Outcome )

Wynik zasobu

testSuiteOverviews[]

object ( TestSuiteOverview )

Połączony i podsumowany wynik każdego zestawu testów, który został uruchomiony w ramach tego środowiska.

Łączenie: gdy przypadki testowe z pakietu są uruchamiane w różnych etapach (dzielenie na fragmenty), wyniki są ponownie sumowane w jednym przeglądzie. (np. jeśli fragment 1 ma 2 awarie, a fragment 2 ma 1 awarię, wówczas ogólna liczba niepowodzeń = 3).

Zestawienie: gdy przypadki testowe z tego samego zestawu są uruchamiane wielokrotnie (niestabilne), wyniki są łączone (np. jeśli przypadek testowy1.run1 zakończy się niepowodzeniem, przypadek testowy1.run2 zakończy się pomyślnie, a zarówno przypadek testowy2.run1, jak i przypadek testowy2.run2 nie powiodą się, wówczas pojawi się podsumowanie flakyCount = 1 i liczba niepowodzeń = 1).

Przechowywanie wyników

Przechowywanie wyników testów.

Reprezentacja JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Pola
resultsStoragePath

object ( FileReference )

Katalog główny wyników testów.

xunitXmlFile

object ( FileReference )

Ścieżka do pliku XML Xunit.

Metody

get

 Pobiera środowisko.

list

 Wyświetla listę środowisk dla danego wykonania.