REST 资源:testEnvironmentCatalog

资源:TestEnvironmentCatalog

有关测试环境的说明。

JSON 表示法

{

  // Union field environment_catalog can be only one of the following:
  "androidDeviceCatalog": {
    object(AndroidDeviceCatalog)
  },
  "iosDeviceCatalog": {
    object(IosDeviceCatalog)
  },
  "networkConfigurationCatalog": {
    object(NetworkConfigurationCatalog)
  },
  "softwareCatalog": {
    object(ProvidedSoftwareCatalog)
  }
  // End of list of possible types for union field environment_catalog.
}
字段
联合字段 environment_catalog。仅限输出。environment_catalog 只能是下列其中一项:
androidDeviceCatalog

object(AndroidDeviceCatalog)

受支持的 Android 设备。

iosDeviceCatalog

object(IosDeviceCatalog)

受支持的 iOS 设备。

networkConfigurationCatalog

object(NetworkConfigurationCatalog)

受支持的网络配置。

softwareCatalog

object(ProvidedSoftwareCatalog)

TestExecutionService 提供的软件测试环境。

AndroidDeviceCatalog

目前受支持的 Android 设备。

JSON 表示法

{
  "models": [
    {
      object(AndroidModel)
    }
  ],
  "versions": [
    {
      object(AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object(AndroidRuntimeConfiguration)
  }
}
字段
models[]

object(AndroidModel)

受支持的 Android 设备型号集。

versions[]

object(AndroidVersion)

受支持的 Android 操作系统版本集。

runtimeConfiguration

object(AndroidRuntimeConfiguration)

受支持的运行时配置集。

AndroidModel

有关可在其上运行测试的 Android 设备的说明。

JSON 表示法

{
  "id": string,
  "name": string,
  "manufacturer": string,
  "brand": string,
  "codename": string,
  "form": enum(DeviceForm),
  "formFactor": enum(DeviceFormFactor),
  "screenX": number,
  "screenY": number,
  "screenDensity": number,
  "lowFpsVideoRecording": boolean,
  "supportedVersionIds": [
    string
  ],
  "supportedAbis": [
    string
  ],
  "tags": [
    string
  ]
}
字段
id

string

此型号的唯一不透明 ID。使用此 ID 调用 TestExecutionService。

name

string

此设备型号的人类可读宣传名称。例如:“Nexus 5”、“Galaxy S5”。

manufacturer

string

此设备的制造商。

brand

string

该设备的品牌所属的公司。例如:“Google”、“Samsung”。

codename

string

工业设计的名称。此名称与 android.os.Build.DEVICE 相对应。

form

enum(DeviceForm)

此设备是虚拟设备还是真机设备。

formFactor

enum(DeviceFormFactor)

此设备是否为手机、平板电脑、可穿戴设备等。

screenX

number

水平 (X) 维度的屏幕尺寸(以像素为单位)。

screenY

number

垂直 (Y) 维度的屏幕尺寸(以像素为单位)。

screenDensity

number

DPI 中的屏幕密度。此密度与 ro.sf.lcd_density 相对应

lowFpsVideoRecording

boolean

当且仅当使用此型号的测试通过将屏幕截图拼接在一起来记录时,才会返回 true。请参阅设备配置中的 use_low_spec_video_recording。

supportedVersionIds[]

string

此设备支持的 Android 版本集。

supportedAbis[]

string

此设备支持的 ABI 列表。此列表与 android.os.Build.SUPPORTED_ABIS(适用于 API 级别 21 及更高级别)或 android.os.Build.CPU_ABI/CPU_ABI2 相对应。最偏好的 ABI 是列表中的第一个元素。

元素可带有前缀“version_id:”(其中 version_id 是 AndroidVersion 的 ID),表示仅在特定版本上受支持的 ABI。

tags[]

string

此维度的标记。例如:“默认”、“预览”、“已弃用”。

DeviceForm

设备是真机设备还是虚拟设备。

枚举
DEVICE_FORM_UNSPECIFIED 请勿使用。仅适用于 Proto 版本控制。
VIRTUAL 模拟设备的软件堆栈。
PHYSICAL 实际硬件。

DeviceFormFactor

枚举
DEVICE_FORM_FACTOR_UNSPECIFIED 请勿使用。仅适用于 Proto 版本控制。
PHONE 此设备具有手机的形状。
TABLET 此设备具有平板电脑的形状。
WEARABLE 此设备具有手表或其他可穿戴设备的形状。

AndroidVersion

Android 操作系统的版本。

JSON 表示法

{
  "id": string,
  "versionString": string,
  "apiLevel": number,
  "codeName": string,
  "releaseDate": {
    object(Date)
  },
  "distribution": {
    object(Distribution)
  },
  "tags": [
    string
  ]
}
字段
id

string

此 Android 版本的不透明 ID。使用此 ID 调用 TestExecutionService。

versionString

string

表示此版本的 Android 操作系统的字符串。例如:“4.3”、“4.4”。

apiLevel

number

此 Android 版本的 API 级别。例如:18、19。

codeName

string

此 Android 版本的代码名称。例如:“JellyBean”、“KitKat”。

releaseDate

object(Date)

此 Android 版本的上市日期。

distribution

object(Distribution)

此版本的市场份额。

tags[]

string

此维度的标记。例如:“默认”、“预览”、“已弃用”。

Date

表示整个或部分日历日期(例如生日)。一天中的时间和时区要么在别处指定,要么不重要。日期相对于预期的公历。它可以表示:

  • 包含非零年、月和日值的完整日期
  • 月和日值,年份值为零(例如周年纪念日)
  • 单独的年份,月和日的值为零
  • 年和月值,日的值为零(例如信用卡到期日期)

相关类型是 google.type.TimeOfDaygoogle.protobuf.Timestamp

JSON 表示法

{
  "year": number,
  "month": number,
  "day": number
}
字段
year

number

年份。必须是 1 到 9999,如果指定的日期不含年份,则为 0。

month

number

月份。必须是 1 到 12,如果指定年份而不指定月和日,则为 0。

day

number

日期。必须是 1 到 31 并且对年和月有效,如果仅指定年份或同时指定年份和月份(天不重要),则为 0。

Distribution

运行 Android 平台给定配置的设备的相对数量数据。

JSON 表示法

{
  "measurementTime": string,
  "marketShare": number
}
字段
measurementTime

string (Timestamp format)

仅限输出。衡量此分布的时间。

此时间戳采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,且精确到纳秒。例如:"2014-10-02T15:01:23.045123456Z"

marketShare

number

仅限输出。采用此配置的估算总市场份额 (0-1)。

AndroidRuntimeConfiguration

在运行测试时可以选择的 Android 配置。

JSON 表示法

{
  "locales": [
    {
      object(Locale)
    }
  ],
  "orientations": [
    {
      object(Orientation)
    }
  ]
}
字段
locales[]

object(Locale)

可用的语言区域集。

orientations[]

object(Orientation)

可用的屏幕方向集。

Locale

语言的位置/区域指定。

JSON 表示法

{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
字段
id

string

此语言区域的 ID。例如:“en-US”。

name

string

此语言/语言区域的易记名称。例如:“英语”。

region

string

一个人类可读的字符串,表示此语言区域对应的区域。例如:“美国”。不适用于所有语言区域。

tags[]

string

此维度的标记。例如:“默认”。

Orientation

设备的屏幕方向。

JSON 表示法

{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
字段
id

string

此屏幕方向的 ID。例如:“纵向”。

name

string

此屏幕方向的易记名称。例如:“纵向”。

tags[]

string

此维度的标记。例如:“默认”。

IosDeviceCatalog

目前受支持的 iOS 设备。

JSON 表示法

{
  "models": [
    {
      object(IosModel)
    }
  ],
  "versions": [
    {
      object(IosVersion)
    }
  ],
  "xcodeVersions": [
    {
      object(XcodeVersion)
    }
  ],
  "runtimeConfiguration": {
    object(IosRuntimeConfiguration)
  }
}
字段
models[]

object(IosModel)

受支持的 iOS 设备型号集。

versions[]

object(IosVersion)

受支持的 iOS 软件版本集。

xcodeVersions[]

object(XcodeVersion)

受支持的 Xcode 版本集。

runtimeConfiguration

object(IosRuntimeConfiguration)

受支持的运行时配置集。

IosModel

有关可在其上运行测试的 iOS 设备的说明。

JSON 表示法

{
  "id": string,
  "name": string,
  "supportedVersionIds": [
    string
  ],
  "tags": [
    string
  ],
  "deviceCapabilities": [
    string
  ],
  "formFactor": enum(DeviceFormFactor)
}
字段
id

string

此型号的唯一不透明 ID。使用此 ID 调用 TestExecutionService。

name

string

此设备型号的人类可读名称。例如:“iPhone 4s”、“iPad Mini 2”。

supportedVersionIds[]

string

此设备支持的 iOS 主要软件版本集。

tags[]

string

此维度的标记。例如:“默认”、“预览”、“已弃用”。

deviceCapabilities[]

string

设备功能。复制自 https://developer.apple.com/library/archive/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

formFactor

enum(DeviceFormFactor)

此设备是否为手机、平板电脑、可穿戴设备等。

IosVersion

iOS 版本。

JSON 表示法

{
  "id": string,
  "majorVersion": number,
  "minorVersion": number,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
字段
id

string

此 iOS 版本的不透明 ID。使用此 ID 调用 TestExecutionService。

majorVersion

number

表示主要 iOS 版本的整数。例如:“8”、“9”。

minorVersion

number

表示次要 iOS 版本的整数。例如:“1”、“2”。

tags[]

string

此维度的标记。例如:“默认”、“预览”、“已弃用”。

supportedXcodeVersionIds[]

string

此版本的可用 Xcode 版本。

XcodeVersion

与 iOS 版本兼容的 Xcode 版本。

JSON 表示法

{
  "version": string,
  "tags": [
    string
  ]
}
字段
version

string

此版本的 ID。例如:“9.2”。

tags[]

string

此 Xcode 版本的标记。例如:“默认”。

IosRuntimeConfiguration

在运行测试时可以选择的 iOS 配置。

JSON 表示法

{
  "locales": [
    {
      object(Locale)
    }
  ],
  "orientations": [
    {
      object(Orientation)
    }
  ]
}
字段
locales[]

object(Locale)

可用的语言区域集。

orientations[]

object(Orientation)

可用的屏幕方向集。

NetworkConfigurationCatalog

JSON 表示法

{
  "configurations": [
    {
      object(NetworkConfiguration)
    }
  ]
}
字段
configurations[]

object(NetworkConfiguration)

NetworkConfiguration

JSON 表示法

{
  "id": string,
  "upRule": {
    object(TrafficRule)
  },
  "downRule": {
    object(TrafficRule)
  }
}
字段
id

string

此网络流量配置的唯一不透明 ID。

upRule

object(TrafficRule)

适用于上传流量的模拟规则。

downRule

object(TrafficRule)

适用于下载流量的模拟规则。

TrafficRule

网络模拟参数。

JSON 表示法

{
  "delay": string,
  "packetLossRatio": number,
  "packetDuplicationRatio": number,
  "bandwidth": number,
  "burst": number
}
字段
delay

string (Duration format)

数据包延迟值,必须大于等于 0。

此时间以秒为单位,最多包含九个小数位,并以“s”结束。例如:"3.5s"

packetLossRatio

number

数据包丢失率 (0.0 - 1.0)。

packetDuplicationRatio

number

数据包重复率 (0.0 - 1.0)。

bandwidth

number

带宽,以每秒 kbit 数为单位。

burst

number

以 kbit 为单位的连拍照片大小。

ProvidedSoftwareCatalog

目前在测试设备上提供的软件环境。

JSON 表示法

{
  "orchestratorVersion": string
}
字段
orchestratorVersion

string

由 TestExecutionService 提供的表示当前 Android Test Orchestrator 版本的字符串。例如:“1.0.2 测试版”。

方法

get

获取受支持的测试环境目录。

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面