REST Resource: testEnvironmentCatalog

Tài nguyên: TestEnvironmentCatalog

Nội dung mô tả về một môi trường kiểm thử.

Biểu diễn dưới dạng 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.
}
Trường
Trường kết hợp environment_catalog. Chỉ có đầu ra. environment_catalog chỉ có thể là một trong những trạng thái sau đây:
androidDeviceCatalog

object (AndroidDeviceCatalog)

Các thiết bị Android được hỗ trợ.

iosDeviceCatalog

object (IosDeviceCatalog)

Các thiết bị iOS được hỗ trợ.

networkConfigurationCatalog

object (NetworkConfigurationCatalog)

Các cấu hình mạng được hỗ trợ.

softwareCatalog

object (ProvidedSoftwareCatalog)

Môi trường kiểm thử phần mềm do TestExecutionService cung cấp.

deviceIpBlockCatalog

object (DeviceIpBlockCatalog)

Các khối IP mà các thiết bị sử dụng trong môi trường kiểm thử.

Danh mục thiết bị Android

Các thiết bị Android hiện được hỗ trợ.

Biểu diễn dưới dạng JSON
{
  "models": [
    {
      object (AndroidModel)
    }
  ],
  "versions": [
    {
      object (AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object (AndroidRuntimeConfiguration)
  }
}
Trường
models[]

object (AndroidModel)

Tập hợp các mẫu thiết bị Android được hỗ trợ.

versions[]

object (AndroidVersion)

Bộ phiên bản hệ điều hành Android được hỗ trợ.

runtimeConfiguration

object (AndroidRuntimeConfiguration)

Tập hợp các cấu hình thời gian chạy được hỗ trợ.

Mô hình Android

Nội dung mô tả về hoạt động kiểm thử thiết bị Android có thể chạy trên đó.

Biểu diễn dưới dạng 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
}
Trường
id

string

Mã nhận dạng mờ duy nhất cho mô hình này. Sử dụng phương thức này để gọi TestExecutionService.

name

string

Tên tiếp thị mà con người có thể đọc được cho mẫu thiết bị này. Ví dụ: "Nexus 5", "Galaxy S5".

manufacturer

string

Nhà sản xuất thiết bị này.

brand

string

Công ty có thương hiệu của thiết bị này. Ví dụ: "Google", "Samsung".

codename

string

Tên kiểu dáng công nghiệp. Tên này tương ứng với android.os.Build.DEVICE.

form

enum (DeviceForm)

Thiết bị này là thiết bị thực hay ảo.

formFactor

enum (DeviceFormFactor)

Cho dù thiết bị này là điện thoại, máy tính bảng, thiết bị đeo, v.v.

perVersionInfo[]

object (PerAndroidVersionInfo)

Thông tin về phiên bản cụ thể của một mẫu Android.

screenX

integer

Kích thước màn hình theo chiều ngang (X) được đo bằng pixel.

screenY

integer

Kích thước màn hình theo chiều dọc (Y) được đo bằng pixel.

screenDensity

integer

Mật độ màn hình tính bằng DPI. Giá trị này tương ứng với ro.sf.lcd_Density

lowFpsVideoRecording

boolean

Đúng khi và chỉ khi các thử nghiệm với kiểu máy này được ghi lại bằng cách ghép các ảnh chụp màn hình lại với nhau. Xem use_low_spec_video_recording trong cấu hình thiết bị.

supportedVersionIds[]

string

Bộ phiên bản Android mà thiết bị này hỗ trợ.

supportedAbis[]

string

Danh sách các ABI mà thiết bị này hỗ trợ. Thư viện này tương ứng với android.os.Build.supported_ABIS (đối với API cấp 21 trở lên) hoặc android.os.Build.CPU_ABI/CPU_ABI2. ABI được ưu tiên nhất là phần tử đầu tiên trong danh sách.

Các phần tử có tiền tố tùy chọn là "versionId:" (trong đó versionId là mã nhận dạng của AndroidVersion), cho biết ABI chỉ được hỗ trợ trên một phiên bản cụ thể.

tags[]

string

Các thẻ cho phương diện này. Ví dụ: "mặc định", "xem trước", "không dùng nữa".

thumbnailUrl

string

URL của hình thu nhỏ (ảnh) của thiết bị.

Dạng thiết bị

Liệu thiết bị là thiết bị thực hay ảo.

Enum
DEVICE_FORM_UNSPECIFIED Không được dùng. Chỉ dành cho việc tạo phiên bản proto.
VIRTUAL Thiết bị ảo Android dùng công nghệ ảo hoá gốc trong Compute Engine. Chỉ có trong Phòng thử nghiệm Firebase.
PHYSICAL Phần cứng thực tế.
EMULATOR Thiết bị ảo Android dùng trình mô phỏng trong tính năng ảo hoá lồng nhau. Tương đương với Android Studio.

Hệ số hình dạng của thiết bị

Kiểu dáng của một thiết bị.

Enum
DEVICE_FORM_FACTOR_UNSPECIFIED Không được dùng. Chỉ dành cho việc tạo phiên bản proto.
PHONE Thiết bị này có hình dạng của một chiếc điện thoại.
TABLET Thiết bị này có hình dạng một chiếc máy tính bảng.
WEARABLE Thiết bị này có hình dạng của một chiếc đồng hồ hoặc thiết bị đeo khác.

Thông tin phiên bản PerAndroid

Thông tin về phiên bản cụ thể của một mẫu Android.

Biểu diễn dưới dạng JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity),
  "interactiveDeviceAvailabilityEstimate": string,
  "directAccessVersionInfo": {
    object (DirectAccessVersionInfo)
  }
}
Trường
versionId

string

Phiên bản Android.

deviceCapacity

enum (DeviceCapacity)

Số thiết bị có kết nối mạng cho một phiên bản Android.

interactiveDeviceAvailabilityEstimate

string (Duration format)

Chỉ có đầu ra. Thời gian chờ ước tính cho một phiên thiết bị tương tác bằng tính năng Truy cập trực tiếp.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

directAccessVersionInfo

object (DirectAccessVersionInfo)

Chỉ có đầu ra. Xác định các ứng dụng được hỗ trợ cho DirectAccess đối với phiên bản Android này.

Dung lượng thiết bị

Dung lượng dựa trên số lượng thiết bị có kết nối mạng trong phòng thí nghiệm.

Lưu ý quan trọng: dung lượng của thiết bị không phản ánh trực tiếp độ dài của hàng đợi tại một thời điểm nào đó. Báo cáo này không tính đến lưu lượng truy cập hiện tại hoặc trạng thái của thiết bị.

Đối với thiết bị thực, số liệu này là giá trị trung bình của các thiết bị có kết nối mạng trong 30 ngày qua.

Enum
DEVICE_CAPACITY_UNSPECIFIED Giá trị dung lượng của thiết bị chưa xác định hoặc chưa đặt.
DEVICE_CAPACITY_HIGH

Các thiết bị có công suất lớn (Phòng thí nghiệm có một số lượng lớn các thiết bị này).

Những thiết bị này thường được đề xuất chạy nhiều kiểm thử đồng thời (ví dụ: hơn 100 kiểm thử).

Xin lưu ý rằng các thiết bị có dung lượng cao không đảm bảo thời gian chờ sẽ ngắn vì một số yếu tố: 1. Lưu lượng truy cập (mức sử dụng của người dùng tại một thời điểm bất kỳ) 2. Các thiết bị có dung lượng cao được ưu tiên cho một số mục đích sử dụng nhất định, điều này có thể khiến quá trình kiểm thử người dùng chậm hơn so với việc chọn các loại thiết bị tương tự khác.

DEVICE_CAPACITY_MEDIUM

Các thiết bị có công suất trung bình (một số lượng thiết bị trong phòng thí nghiệm này tương đối nhiều, mặc dù không nhiều như các thiết bị công suất cao).

Các thiết bị này phù hợp với ít lần chạy chương trình kiểm thử hơn (ví dụ: có ít hơn 100 chương trình kiểm thử) và chỉ phù hợp với số lượng phân đoạn thấp (ví dụ: dưới 10 phân đoạn).

DEVICE_CAPACITY_LOW

Các thiết bị có công suất thấp (Phòng thí nghiệm có một số ít thiết bị này).

Người dùng có thể sử dụng các thiết bị này nếu cần kiểm thử trên mẫu thiết bị và phiên bản cụ thể này. Xin lưu ý rằng do dung lượng thấp nên các thử nghiệm có thể mất nhiều thời gian hơn để hoàn thành, đặc biệt nếu nhiều thử nghiệm được gọi cùng một lúc. Các thiết bị này không phù hợp để phân đoạn kiểm thử.

DEVICE_CAPACITY_NONE

Các thiết bị hoàn toàn không có trong phòng thí nghiệm.

Các thiết bị này tạm thời hoặc vĩnh viễn không khả dụng và không nên được yêu cầu. Nếu thiết bị cũng được đánh dấu là không dùng nữa, trạng thái này rất có thể là vĩnh viễn.

Thông tin DirectAccessVersion

Cho biết liệu tính năng Truy cập trực tiếp có được hỗ trợ hay không và phiên bản ứng dụng tương ứng.

DirectAccessService hiện có sẵn dưới dạng bản xem trước cho một số nhà phát triển. Bạn có thể đăng ký ngay hôm nay thay mặt cho bạn và nhóm của bạn tại https://developer.android.com/studio/preview/android-device-streaming

Biểu diễn dưới dạng JSON
{
  "directAccessSupported": boolean,
  "minimumAndroidStudioVersion": string
}
Trường
directAccessSupported

boolean

Liệu việc truy cập trực tiếp có được hỗ trợ hay không. Theo dự kiến, ứng dụng sẽ chỉ lọc danh sách thiết bị để chỉ hiển thị các mẫu và phiên bản Android có hỗ trợ Quyền truy cập trực tiếp khi đó là ý định của người dùng.

minimumAndroidStudioVersion

string

Chỉ có đầu ra. Cho biết khả năng tương thích giữa thiết bị khách và thiết bị, trong đó một thiết bị được xác định là chỉ hoạt động với một số giải pháp nhất định được triển khai trong ứng dụng Android Studio. Định dạng đúng là "major.minor.micro.patch", ví dụ: "5921.22.2211.8881706".

Phiên bản Android

Một phiên bản của hệ điều hành Android.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "versionString": string,
  "apiLevel": integer,
  "codeName": string,
  "releaseDate": {
    object (Date)
  },
  "distribution": {
    object (Distribution)
  },
  "tags": [
    string
  ]
}
Trường
id

string

Mã nhận dạng mờ cho phiên bản Android này. Sử dụng mã nhận dạng này để gọi TestExecutionService.

versionString

string

Một chuỗi đại diện cho phiên bản hệ điều hành Android này. Ví dụ: "4.3", "4.4".

apiLevel

integer

Cấp độ API của phiên bản Android này. Ví dụ: 18, 19.

codeName

string

Tên mã cho phiên bản Android này. Ví dụ: "JellyBean", "KitKat".

releaseDate

object (Date)

Ngày phiên bản Android này có mặt trên thị trường.

distribution

object (Distribution)

Thị phần dành cho phiên bản này.

tags[]

string

Các thẻ cho phương diện này. Ví dụ: "mặc định", "xem trước", "không dùng nữa".

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Lịch Gregory. Thông tin này có thể là một trong những trường hợp sau:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, thể hiện giá trị năm 0 (ví dụ: ngày kỷ niệm).
  • Một năm riêng biệt, tháng không tháng và ngày không tháng.
  • Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.

month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 để chỉ định một năm không có tháng và ngày.

day

integer

Ngày trong tháng. Phải có giá trị từ 1 đến 31 và có giá trị hợp lệ trong năm và tháng, hoặc bằng 0 để chỉ định một năm độc lập hoặc là một năm và tháng mà ngày không quan trọng.

Phân phối

Dữ liệu về số lượng thiết bị tương đối chạy một cấu hình nhất định của nền tảng Android.

Biểu diễn dưới dạng JSON
{
  "measurementTime": string,
  "marketShare": number
}
Trường
measurementTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian đo lường sự phân bổ này.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

marketShare

number

Chỉ có đầu ra. Tỷ lệ ước tính (0-1) của tổng thị trường có cấu hình này.

Cấu hình thời gian chạy Android

Cấu hình Android có thể được chọn tại thời điểm chạy kiểm thử.

Biểu diễn dưới dạng JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Trường
locales[]

object (Locale)

Nhóm ngôn ngữ có sẵn.

orientations[]

object (Orientation)

Tập hợp các hướng có sẵn.

Ngôn ngữ

Chỉ định vị trí/khu vực cho ngôn ngữ.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
Trường
id

string

Mã cho ngôn ngữ này. Ví dụ: "vi_VN".

name

string

Tên thân thiện với con người cho ngôn ngữ/khu vực này. Ví dụ: "Tiếng Anh".

region

string

Chuỗi thân thiện với con người đại diện cho khu vực của ngôn ngữ này. Ví dụ: "Hoa Kỳ". Chỉ có ở một số ngôn ngữ.

tags[]

string

Các thẻ cho phương diện này. Ví dụ: "default".

Hướng

Hướng màn hình của thiết bị.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
Trường
id

string

Mã cho hướng này. Ví dụ: "dọc".

name

string

Tên thân thiện với con người cho hướng này. Ví dụ: "dọc".

tags[]

string

Các thẻ cho phương diện này. Ví dụ: "default".

Danh mục thiết bị trên iOS

Các thiết bị iOS hiện được hỗ trợ.

Biểu diễn dưới dạng JSON
{
  "models": [
    {
      object (IosModel)
    }
  ],
  "versions": [
    {
      object (IosVersion)
    }
  ],
  "xcodeVersions": [
    {
      object (XcodeVersion)
    }
  ],
  "runtimeConfiguration": {
    object (IosRuntimeConfiguration)
  }
}
Trường
models[]

object (IosModel)

Tập hợp các mẫu thiết bị iOS được hỗ trợ.

versions[]

object (IosVersion)

Bộ phiên bản phần mềm iOS được hỗ trợ.

xcodeVersions[]

object (XcodeVersion)

Tập hợp các phiên bản Xcode được hỗ trợ.

runtimeConfiguration

object (IosRuntimeConfiguration)

Tập hợp các cấu hình thời gian chạy được hỗ trợ.

Mô hình Ios

Có thể chạy mô tả về thử nghiệm thiết bị iOS.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "name": string,
  "supportedVersionIds": [
    string
  ],
  "tags": [
    string
  ],
  "deviceCapabilities": [
    string
  ],
  "screenX": integer,
  "screenY": integer,
  "screenDensity": integer,
  "formFactor": enum (DeviceFormFactor),
  "perVersionInfo": [
    {
      object (PerIosVersionInfo)
    }
  ]
}
Trường
id

string

Mã nhận dạng mờ duy nhất cho mô hình này. Sử dụng phương thức này để gọi TestExecutionService.

name

string

Tên mà con người có thể đọc được của mẫu thiết bị này. Ví dụ: "iPhone 4s", "iPad Mini 2".

supportedVersionIds[]

string

Bộ phiên bản phần mềm chính iOS mà thiết bị này hỗ trợ.

tags[]

string

Các thẻ cho phương diện này. Ví dụ: "mặc định", "xem trước", "không dùng nữa".

deviceCapabilities[]

string

Khả năng của thiết bị. Được sao chép từ https://developer.apple.com/library/library/documentation/DeviceInformation/Reference/iOSDeviceCompatibility/DeviceCompatibilityMatrix/DeviceCompatibilityMatrix.html

screenX

integer

Kích thước màn hình theo chiều ngang (X) được đo bằng pixel.

screenY

integer

Kích thước màn hình theo chiều dọc (Y) được đo bằng pixel.

screenDensity

integer

Mật độ màn hình tính bằng DPI.

formFactor

enum (DeviceFormFactor)

Cho dù thiết bị này là điện thoại, máy tính bảng, thiết bị đeo, v.v.

perVersionInfo[]

object (PerIosVersionInfo)

Thông tin về phiên bản cụ thể của mẫu iOS.

Thông tin PerIosVersion

Thông tin về phiên bản cụ thể của mẫu iOS.

Biểu diễn dưới dạng JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
Trường
versionId

string

Phiên bản iOS.

deviceCapacity

enum (DeviceCapacity)

Số thiết bị trực tuyến cho một phiên bản iOS.

Phiên bản iOS

Phiên bản iOS.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "majorVersion": integer,
  "minorVersion": integer,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
Trường
id

string

Mã nhận dạng mờ cho phiên bản iOS này. Sử dụng mã nhận dạng này để gọi TestExecutionService.

majorVersion

integer

Số nguyên đại diện cho phiên bản iOS chính. Ví dụ: "8", "9".

minorVersion

integer

Số nguyên đại diện cho phiên bản iOS nhỏ. Ví dụ: "1", "2".

tags[]

string

Các thẻ cho phương diện này. Ví dụ: "mặc định", "xem trước", "không dùng nữa".

supportedXcodeVersionIds[]

string

Các phiên bản Xcode hiện có cho phiên bản này.

Phiên bản Xcode

Một phiên bản Xcode tương thích với một phiên bản iOS.

Biểu diễn dưới dạng JSON
{
  "version": string,
  "tags": [
    string
  ]
}
Trường
version

string

Mã của phiên bản này. Ví dụ: "9.2".

tags[]

string

Thẻ cho phiên bản Xcode này. Ví dụ: "default".

Cấu hình IosRuntime

Cấu hình iOS có thể được chọn tại thời điểm chạy kiểm thử.

Biểu diễn dưới dạng JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
Trường
locales[]

object (Locale)

Nhóm ngôn ngữ có sẵn.

orientations[]

object (Orientation)

Tập hợp các hướng có sẵn.

Danh mục cấu hình mạng

Biểu diễn dưới dạng JSON
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
Trường
configurations[]

object (NetworkConfiguration)

Cấu hình mạng

Biểu diễn dưới dạng JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
Trường
id

string

Mã mờ duy nhất cho cấu hình lưu lượng truy cập mạng này.

upRule

object (TrafficRule)

Quy tắc mô phỏng áp dụng cho lưu lượng truy cập tải lên.

downRule

object (TrafficRule)

Quy tắc mô phỏng áp dụng cho lưu lượng truy cập tải xuống.

Quy tắc lưu lượng

Tham số mô phỏng mạng.

Biểu diễn dưới dạng JSON
{
  "delay": string,
  "packetLossRatio": number,
  "packetDuplicationRatio": number,
  "bandwidth": number,
  "burst": number
}
Trường
delay

string (Duration format)

Độ trễ của gói tin phải >= 0.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

packetLossRatio

number

Tỷ lệ mất gói tin (0,0 – 1,0).

packetDuplicationRatio

number

Tỷ lệ nhân bản gói tin (0,0 – 1,0).

bandwidth

number

Băng thông tính bằng kbit/giây.

burst

number

Kích thước loạt ảnh tính bằng kbit.

Danh mục phần mềm được cung cấp

Môi trường phần mềm hiện được cung cấp trên những thiết bị đang được kiểm thử.

Biểu diễn dưới dạng JSON
{
  "orchestratorVersion": string,
  "androidxOrchestratorVersion": string
}
Trường
orchestratorVersion
(deprecated)

string

Không dùng nữa: Sử dụng AndroidX Test Orchestrator từ nay về sau.

Một chuỗi đại diện cho phiên bản hiện tại của Android Test Orchestrator được dùng trong môi trường. Gói này có tại https://maven.google.com/web/index.html#com.android.support.test:orchestrator.

androidxOrchestratorVersion

string

Một chuỗi đại diện cho phiên bản hiện tại của AndroidX Test Orchestrator được dùng trong môi trường. Gói này có tại https://maven.google.com/web/index.html#androidx.test:orchestrator.

Danh mục DeviceIpBlockCatalog

Danh sách các khối IP mà Phòng thử nghiệm Firebase sử dụng

Biểu diễn dưới dạng JSON
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
Trường
ipBlocks[]

object (DeviceIpBlock)

Các khối IP thiết bị mà Phòng thử nghiệm Firebase sử dụng

DeviceIpBlock (Chặn thiết bị)

Một khối IP của thiết bị

Biểu diễn dưới dạng JSON
{
  "block": string,
  "form": enum (DeviceForm),
  "addedDate": {
    object (Date)
  }
}
Trường
block

string

Khối địa chỉ IP trong ký hiệu CIDR, ví dụ: 34.68.194.64/29

form

enum (DeviceForm)

Liệu thiết bị thực hay thiết bị ảo có sử dụng quy tắc chặn này không

addedDate

object (Date)

Ngày thêm khối này vào Phòng thử nghiệm Firebase

Phương thức

get

Lấy danh mục các môi trường kiểm thử được hỗ trợ.