REST Resource: testEnvironmentCatalog

Resource: TestEnvironmentCatalog

Deskripsi lingkungan pengujian.

Representasi 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.
}
Kolom
Kolom union environment_catalog. Hanya output. environment_catalog hanya ada berupa salah satu diantara berikut:
androidDeviceCatalog

object (AndroidDeviceCatalog)

Perangkat Android yang didukung.

iosDeviceCatalog

object (IosDeviceCatalog)

Perangkat iOS yang didukung.

networkConfigurationCatalog

object (NetworkConfigurationCatalog)

Konfigurasi jaringan yang didukung.

softwareCatalog

object (ProvidedSoftwareCatalog)

Lingkungan pengujian software yang disediakan oleh TestExecutionService.

deviceIpBlockCatalog

object (DeviceIpBlockCatalog)

Blok IP yang digunakan oleh perangkat di lingkungan pengujian.

AndroidDeviceCatalog

Perangkat Android yang saat ini didukung.

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

object (AndroidModel)

Kumpulan model perangkat Android yang didukung.

versions[]

object (AndroidVersion)

Kumpulan versi OS Android yang didukung.

runtimeConfiguration

object (AndroidRuntimeConfiguration)

Kumpulan konfigurasi waktu proses yang didukung.

AndroidModel

Deskripsi uji perangkat Android dapat dijalankan.

Representasi 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
}
Kolom
id

string

ID buram unik untuk model ini. Gunakan ini untuk mengaktifkan TestExecutionService.

name

string

Nama pemasaran yang dapat dibaca manusia untuk model perangkat ini. Contoh: "Nexus 5", "Galaxy S5".

manufacturer

string

Pabrikan perangkat ini.

brand

string

Perusahaan yang memberi merek perangkat ini. Contoh: "Google", "Samsung".

codename

string

Nama desain industri. Ini sesuai dengan android.os.Build.DEVICE.

form

enum (DeviceForm)

Apakah perangkat ini berbentuk virtual atau fisik.

formFactor

enum (DeviceFormFactor)

Apakah perangkat ini berupa ponsel, tablet, perangkat wearable, dll.

perVersionInfo[]

object (PerAndroidVersionInfo)

Informasi khusus versi dari model Android.

screenX

integer

Ukuran layar dalam dimensi horizontal (X) yang diukur dalam piksel.

screenY

integer

Ukuran layar dalam dimensi vertikal (Y) yang diukur dalam piksel.

screenDensity

integer

Kerapatan layar dalam DPI. Ini berkaitan dengan ro.sf.lcd_density

lowFpsVideoRecording

boolean

Benar jika dan hanya jika pengujian dengan model ini direkam dengan merangkai sejumlah screenshot. Lihat use_low_spec_video_recording pada konfigurasi perangkat.

supportedVersionIds[]

string

Kumpulan versi Android yang didukung perangkat ini.

supportedAbis[]

string

Daftar ABI yang didukung untuk perangkat ini. Ini sesuai dengan android.os.Build.SUPPORTED_ABIS (untuk level API 21 dan yang lebih tinggi) atau android.os.Build.CPU_ABI/CPU_ABI2. ABI yang lebih diutamakan adalah elemen pertama dalam daftar.

Secara opsional, elemen diawali dengan "versionId:" (dengan versionId adalah ID AndroidVersion), yang menunjukkan ABI yang hanya didukung pada versi tertentu.

tags[]

string

Tag untuk dimensi ini. Contoh: "default", "preview", "deprecated".

thumbnailUrl

string

URL gambar thumbnail (foto) perangkat.

DeviceForm

Apakah perangkat berbentuk fisik atau virtual.

Enum
DEVICE_FORM_UNSPECIFIED Jangan gunakan. Untuk penetapan versi proto saja.
VIRTUAL Perangkat virtual Android menggunakan virtualisasi native Compute Engine. Khusus Firebase Test Lab.
PHYSICAL Hardware yang sebenarnya.
EMULATOR Perangkat virtual Android menggunakan emulator dalam virtualisasi bertingkat. Setara dengan Android Studio.

DeviceFormFactor

Faktor bentuk perangkat.

Enum
DEVICE_FORM_FACTOR_UNSPECIFIED Jangan gunakan. Untuk penetapan versi proto saja.
PHONE Perangkat ini berbentuk ponsel.
TABLET Perangkat ini berbentuk tablet.
WEARABLE Perangkat ini berbentuk jam tangan atau perangkat wearable lainnya.

InfoVersiPerAndroid

Informasi khusus versi dari model Android.

Representasi JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity),
  "interactiveDeviceAvailabilityEstimate": string,
  "directAccessVersionInfo": {
    object (DirectAccessVersionInfo)
  }
}
Kolom
versionId

string

Sebuah versi Android.

deviceCapacity

enum (DeviceCapacity)

Jumlah perangkat online untuk versi Android.

interactiveDeviceAvailabilityEstimate

string (Duration format)

Hanya output. Perkiraan waktu tunggu untuk satu sesi perangkat interaktif menggunakan Akses Langsung.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

directAccessVersionInfo

object (DirectAccessVersionInfo)

Hanya output. Mengidentifikasi klien yang didukung untuk DirectAccess bagi versi Android ini.

KapasitasPerangkat

Kapasitas berdasarkan jumlah perangkat online di lab.

Penting: kapasitas perangkat tidak secara langsung mencerminkan panjang antrean pada saat tertentu. Laporan ini tidak memperhitungkan traffic saat ini atau status perangkat.

Untuk perangkat fisik, jumlahnya adalah rata-rata perangkat online dalam 30 hari terakhir.

Enum
DEVICE_CAPACITY_UNSPECIFIED Nilai kapasitas perangkat tidak diketahui atau tidak ditetapkan.
DEVICE_CAPACITY_HIGH

Perangkat yang berkapasitas tinggi (Lab memiliki banyak perangkat ini).

Perangkat ini umumnya disarankan untuk menjalankan sejumlah besar pengujian secara bersamaan (mis. lebih dari 100 pengujian).

Perlu diperhatikan bahwa perangkat berkapasitas tinggi tidak menjamin waktu tunggu yang singkat karena beberapa faktor: 1. Traffic (seberapa banyak traffic tersebut digunakan pada momen tertentu) 2. Perangkat berkapasitas tinggi diprioritaskan untuk penggunaan tertentu, yang dapat menyebabkan pengujian pengguna lebih lambat daripada memilih jenis perangkat serupa lainnya.

DEVICE_CAPACITY_MEDIUM

Perangkat yang berkapasitas sedang (Lab ini memiliki jumlah perangkat yang cukup banyak, meskipun tidak sebanyak perangkat berkapasitas tinggi).

Perangkat ini cocok untuk pengujian yang lebih sedikit (misalnya, kurang dari 100 pengujian) dan hanya untuk jumlah shard rendah (misalnya, kurang dari 10 shard).

DEVICE_CAPACITY_LOW

Perangkat yang kapasitasnya rendah (Lab memiliki sedikit sekali perangkat ini).

Perangkat ini dapat digunakan jika pengguna perlu melakukan pengujian pada model dan versi perangkat khusus ini. Perlu diketahui bahwa karena kapasitas yang rendah, pengujian mungkin memerlukan waktu lebih lama untuk diselesaikan, terutama jika sejumlah besar pengujian dipanggil sekaligus. Perangkat ini tidak cocok untuk sharding pengujian.

DEVICE_CAPACITY_NONE

Perangkat yang benar-benar hilang dari lab.

Perangkat ini tidak tersedia untuk sementara atau permanen dan tidak akan diminta. Jika perangkat juga ditandai sebagai tidak digunakan lagi, status ini kemungkinan besar bersifat permanen.

{i>DirectAccessVersionInfo<i}

Menunjukkan apakah Akses Langsung didukung, dan oleh versi klien yang mana.

DirectAccessService saat ini tersedia sebagai pratinjau untuk developer tertentu. Anda dapat mendaftar sekarang atas nama Anda dan tim Anda di https://developer.android.com/studio/preview/android-device-streaming

Representasi JSON
{
  "directAccessSupported": boolean,
  "minimumAndroidStudioVersion": string
}
Kolom
directAccessSupported

boolean

Apakah akses langsung didukung. Klien diharapkan memfilter daftar perangkat hanya untuk model dan versi Android yang mendukung Akses Langsung jika itu adalah intent pengguna.

minimumAndroidStudioVersion

string

Hanya output. Menunjukkan kompatibilitas perangkat klien, ketika perangkat diketahui hanya berfungsi dengan solusi tertentu yang diimplementasikan pada klien Android Studio. Format yang diharapkan "major.minor.micro.patch", mis. "5921.22.2211.8881706".

AndroidVersion

Suatu versi dari OS Android.

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

string

ID buram untuk versi Android ini. Gunakan ID ini untuk mengaktifkan TestExecutionService.

versionString

string

String yang mewakili OS Android versi ini. Contoh: "4.3", "4.4".

apiLevel

integer

Level API untuk versi Android ini. Contoh: 18, 19.

codeName

string

Nama kode untuk versi Android ini. Contoh: "JellyBean", "KitKat".

releaseDate

object (Date)

Tanggal versi Android ini mulai tersedia di pasar.

distribution

object (Distribution)

Pangsa pasar untuk versi ini.

tags[]

string

Tag untuk dimensi ini. Contoh: "default", "preview", "deprecated".

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.

month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.

day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

Distribusi

Data tentang jumlah relatif perangkat yang menjalankan konfigurasi tertentu pada platform Android.

Representasi JSON
{
  "measurementTime": string,
  "marketShare": number
}
Kolom
measurementTime

string (Timestamp format)

Hanya output. Waktu distribusi ini diukur.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

marketShare

number

Hanya output. Estimasi pecahan (0-1) dari total pasar dengan konfigurasi ini.

AndroidRuntimeConfiguration

Konfigurasi Android yang dapat dipilih pada saat pengujian dijalankan.

Representasi JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Kolom
locales[]

object (Locale)

Kumpulan lokal yang tersedia.

orientations[]

object (Orientation)

Kumpulan orientasi yang tersedia.

Locale

Penamaan lokasi/daerah untuk bahasa.

Representasi JSON
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
Kolom
id

string

ID untuk lokal ini. Contoh: "en_US".

name

string

Nama yang mudah dibaca manusia untuk bahasa/lokal ini. Contoh: "English".

region

string

String yang mudah dibaca manusia yang menggambarkan daerah untuk lokal ini. Contoh: "United States". Tidak ada untuk setiap lokal.

tags[]

string

Tag untuk dimensi ini. Contoh: "default".

Orientation

Orientasi layar perangkat.

Representasi JSON
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
Kolom
id

string

ID untuk orientasi ini. Contoh: "portrait".

name

string

Nama yang mudah dibaca manusia untuk orientasi ini. Contoh: "portrait".

tags[]

string

Tag untuk dimensi ini. Contoh: "default".

IosDeviceCatalog

Perangkat iOS yang saat ini didukung.

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

object (IosModel)

Kumpulan model perangkat iOS yang didukung.

versions[]

object (IosVersion)

Kumpulan versi software iOS yang didukung.

xcodeVersions[]

object (XcodeVersion)

Kumpulan versi Xcode yang didukung.

runtimeConfiguration

object (IosRuntimeConfiguration)

Kumpulan konfigurasi waktu proses yang didukung.

IosModel

Deskripsi perangkat iOS yang dapat menjalankan pengujian.

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

string

ID buram unik untuk model ini. Gunakan ini untuk mengaktifkan TestExecutionService.

name

string

Nama yang dapat dibaca manusia untuk model perangkat ini. Contoh: "iPhone 4s", "iPad Mini 2".

supportedVersionIds[]

string

Kumpulan versi software utama iOS yang didukung perangkat ini.

tags[]

string

Tag untuk dimensi ini. Contoh: "default", "preview", "deprecated".

deviceCapabilities[]

string

Kemampuan perangkat. Disalin dari https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

screenX

integer

Ukuran layar dalam dimensi horizontal (X) yang diukur dalam piksel.

screenY

integer

Ukuran layar dalam dimensi vertikal (Y) yang diukur dalam piksel.

screenDensity

integer

Kepadatan layar dalam DPI.

formFactor

enum (DeviceFormFactor)

Apakah perangkat ini berupa ponsel, tablet, perangkat wearable, dll.

perVersionInfo[]

object (PerIosVersionInfo)

Informasi khusus versi dari model iOS.

InfoVersiPerIos

Informasi khusus versi dari model iOS.

Representasi JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Kolom
versionId

string

Suatu versi iOS.

deviceCapacity

enum (DeviceCapacity)

Jumlah perangkat online untuk versi iOS.

IosVersion

Suatu versi iOS.

Representasi JSON
{
  "id": string,
  "majorVersion": integer,
  "minorVersion": integer,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
Kolom
id

string

ID buram untuk versi iOS ini. Gunakan ID ini untuk mengaktifkan TestExecutionService.

majorVersion

integer

Bilangan bulat yang menunjukkan versi iOS utama. Contoh: "8", "9".

minorVersion

integer

Bilangan bulat yang menunjukkan versi iOS minor. Contoh: "1", "2".

tags[]

string

Tag untuk dimensi ini. Contoh: "default", "preview", "deprecated".

supportedXcodeVersionIds[]

string

Versi Xcode yang tersedia untuk versi ini.

XcodeVersion

Versi Xcode yang kompatibel dengan versi iOS.

Representasi JSON
{
  "version": string,
  "tags": [
    string
  ]
}
Kolom
version

string

ID untuk versi ini. Contoh: "9.2".

tags[]

string

Tag untuk versi Xcode ini. Contoh: "default".

IosRuntimeConfiguration

Konfigurasi iOS yang dapat dipilih pada saat pengujian dijalankan.

Representasi JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Kolom
locales[]

object (Locale)

Kumpulan lokal yang tersedia.

orientations[]

object (Orientation)

Kumpulan orientasi yang tersedia.

NetworkConfigurationCatalog

Representasi JSON
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
Kolom
configurations[]

object (NetworkConfiguration)

NetworkConfiguration

Representasi JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
Kolom
id

string

ID buram unik untuk konfigurasi traffic jaringan ini.

upRule

object (TrafficRule)

Aturan emulasi yang berlaku untuk traffic upload.

downRule

object (TrafficRule)

Aturan emulasi yang berlaku untuk traffic download.

TrafficRule

Parameter emulasi jaringan.

Representasi JSON
{
  "delay": string,
  "packetLossRatio": number,
  "packetDuplicationRatio": number,
  "bandwidth": number,
  "burst": number
}
Kolom
delay

string (Duration format)

Delay paket, harus >= 0.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

packetLossRatio

number

Rasio kehilangan paket (0.0 - 1.0).

packetDuplicationRatio

number

Rasio duplikasi paket (0.0 - 1.0).

bandwidth

number

Bandwidth dalam kbit/detik.

burst

number

Ukuran burst dalam kbit.

ProvidedSoftwareCatalog

Lingkungan software yang saat ini disediakan pada perangkat yang diuji.

Representasi JSON
{
  "orchestratorVersion": string,
  "androidxOrchestratorVersion": string
}
Kolom
orchestratorVersion
(deprecated)

string

Tidak digunakan lagi: Ke depannya, gunakan AndroidX Test Orchestrator.

String yang menunjukkan versi Android Test Orchestrator saat ini yang digunakan di lingkungan. Paket ini tersedia di https://maven.google.com/web/index.html#com.android.support.test:orchestrator.

androidxOrchestratorVersion

string

String yang menunjukkan versi AndroidX Test Orchestrator saat ini yang digunakan di lingkungan. Paket ini tersedia di https://maven.google.com/web/index.html#androidx.test:orchestrator.

PerangkatIpBlockCatalog

Daftar blok IP yang digunakan oleh Firebase Test Lab

Representasi JSON
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
Kolom
ipBlocks[]

object (DeviceIpBlock)

Blok IP perangkat yang digunakan oleh Firebase Test Lab

BlokIpPerangkat

Blok IP perangkat tunggal

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

string

Blok alamat IP dalam notasi CIDR misalnya: 34.68.194.64/29

form

enum (DeviceForm)

Apakah blok ini digunakan oleh perangkat fisik atau virtual

addedDate

object (Date)

Tanggal blok ini ditambahkan ke Firebase Test Lab

Metode

get

Mendapatkan katalog lingkungan pengujian yang didukung.