REST Resource: 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)
  },
  "deviceIpBlockCatalog": {
    object (DeviceIpBlockCatalog)
  }
  // End of list of possible types for union field environment_catalog.
}
زمینه های
اتحادیه میدان environment_catalog . فقط خروجی environment_catalog فقط می تواند یکی از موارد زیر باشد:
androidDeviceCatalog

object ( AndroidDeviceCatalog )

دستگاه های اندرویدی پشتیبانی شده

iosDeviceCatalog

object ( IosDeviceCatalog )

دستگاه های iOS پشتیبانی شده

networkConfigurationCatalog

object ( NetworkConfigurationCatalog )

پشتیبانی از تنظیمات شبکه

softwareCatalog

object ( ProvidedSoftwareCatalog )

محیط تست نرم افزار ارائه شده توسط TestExecutionService.

deviceIpBlockCatalog

object ( DeviceIpBlockCatalog )

بلوک های IP که توسط دستگاه ها در محیط آزمایش استفاده می شود.

AndroidDeviceCatalog

دستگاه های اندرویدی که در حال حاضر پشتیبانی می شوند.

نمایندگی JSON
{
  "models": [
    {
      object (AndroidModel)
    }
  ],
  "versions": [
    {
      object (AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object (AndroidRuntimeConfiguration)
  }
}
زمینه های
models[]

object ( AndroidModel )

مجموعه ای از مدل های دستگاه اندرویدی پشتیبانی شده.

versions[]

object ( AndroidVersion )

مجموعه ای از نسخه های سیستم عامل اندروید پشتیبانی شده.

runtimeConfiguration

object ( AndroidRuntimeConfiguration )

مجموعه ای از تنظیمات زمان اجرا پشتیبانی شده.

اندروید مدل

ممکن است شرحی از آزمایش‌های دستگاه Android روی آن اجرا شود.

نمایندگی 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
}
زمینه های
id

string

شناسه مات منحصر به فرد برای این مدل. از این برای فراخوانی TestExecutionService استفاده کنید.

name

string

نام بازاریابی قابل خواندن برای انسان برای این مدل دستگاه. مثال‌ها: «Nexus 5»، «Galaxy S5».

manufacturer

string

سازنده این دستگاه.

brand

string

شرکتی که این دستگاه با آن نام تجاری دارد. به عنوان مثال: "گوگل"، "سامسونگ".

codename

string

نام طرح صنعتی این مربوط به android.os.Build.DEVICE است.

form

enum ( DeviceForm )

این دستگاه چه مجازی باشد چه فیزیکی.

formFactor

enum ( DeviceFormFactor )

این دستگاه تلفن، تبلت، پوشیدنی و غیره باشد.

perVersionInfo[]

object ( PerAndroidVersionInfo )

اطلاعات مربوط به نسخه یک مدل اندروید.

screenX

integer

اندازه صفحه نمایش در بعد افقی (X) با پیکسل اندازه گیری می شود.

screenY

integer

اندازه صفحه نمایش در بعد عمودی (Y) با پیکسل اندازه گیری می شود.

screenDensity

integer

تراکم صفحه نمایش بر حسب DPI این مربوط به ro.sf.lcd_density است

lowFpsVideoRecording

boolean

درست است اگر و فقط در صورتی که آزمایش‌های این مدل با دوختن اسکرین‌شات‌ها به هم ثبت شوند. use_low_spec_video_recording را در پیکربندی دستگاه ببینید.

supportedVersionIds[]

string

مجموعه ای از نسخه های اندرویدی که این دستگاه پشتیبانی می کند.

supportedAbis[]

string

لیست ABI های پشتیبانی شده برای این دستگاه. این مربوط به android.os.Build.SUPPORTED_ABIS (برای سطح API 21 و بالاتر) یا android.os.Build.CPU_ABI/CPU_ABI2 است. ترجیح داده شده ترین ABI اولین عنصر در لیست است.

پیشوند عناصر به صورت اختیاری با "versionId:" (که در آن versionId شناسه یک AndroidVersion است)، نشان دهنده یک ABI است که فقط در یک نسخه خاص پشتیبانی می شود.

tags[]

string

برچسب ها برای این بعد مثال: "پیش فرض"، "پیش نمایش"، "منسوخ شده".

thumbnailUrl

string

URL یک تصویر کوچک (عکس) دستگاه.

DeviceForm

خواه دستگاه فیزیکی باشد یا مجازی.

Enums
DEVICE_FORM_UNSPECIFIED استفاده نکن. فقط برای نسخه اولیه.
VIRTUAL دستگاه مجازی اندروید با استفاده از مجازی سازی بومی Compute Engine. فقط آزمایشگاه تست Firebase.
PHYSICAL سخت افزار واقعی
EMULATOR دستگاه مجازی اندروید با استفاده از شبیه ساز در مجازی سازی تودرتو. معادل اندروید استودیو

DeviceFormFactor

ضریب فرم یک دستگاه

Enums
DEVICE_FORM_FACTOR_UNSPECIFIED استفاده نکن. فقط برای نسخه اولیه.
PHONE این دستگاه به شکل گوشی است.
TABLET این دستگاه به شکل تبلت است.
WEARABLE این دستگاه به شکل ساعت یا پوشیدنی دیگر است.

PerAndroidVersionInfo

اطلاعات مربوط به نسخه یک مدل اندروید.

نمایندگی JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
زمینه های
versionId

string

یک نسخه اندروید.

deviceCapacity

enum ( DeviceCapacity )

تعداد دستگاه های آنلاین برای نسخه اندروید.

ظرفیت دستگاه

ظرفیت بر اساس تعداد دستگاه های آنلاین در آزمایشگاه.

مهم: ظرفیت دستگاه مستقیماً طول صف را در یک لحظه از زمان منعکس نمی کند. ترافیک فعلی یا وضعیت دستگاه ها را در نظر نمی گیرد.

برای دستگاه های فیزیکی، این تعداد میانگین دستگاه های آنلاین در 30 روز گذشته است.

Enums
DEVICE_CAPACITY_UNSPECIFIED مقدار ظرفیت دستگاه ناشناخته یا تنظیم نشده است.
DEVICE_CAPACITY_HIGH

دستگاه هایی که ظرفیت بالایی دارند (آزمایشگاه تعداد زیادی از این دستگاه ها را دارد).

این دستگاه ها عموماً برای اجرای تعداد زیادی تست همزمان (مثلاً بیش از 100 تست) پیشنهاد می شوند.

لطفاً توجه داشته باشید که دستگاه‌های با ظرفیت بالا به دلیل عوامل متعددی زمان انتظار کوتاه را تضمین نمی‌کنند: 1. ترافیک (چقدر از آنها در هر لحظه استفاده می‌شود) 2. دستگاه‌های با ظرفیت بالا برای استفاده‌های خاصی در اولویت هستند که ممکن است باعث کندتر شدن تست‌های کاربر شود. نسبت به انتخاب انواع دیگر دستگاه های مشابه.

DEVICE_CAPACITY_MEDIUM

دستگاه هایی که ظرفیت متوسطی دارند (آزمایشگاه تعداد مناسبی از این دستگاه ها را دارد، البته نه به اندازه دستگاه های با ظرفیت بالا).

این دستگاه ها برای آزمایش های کمتر (مثلاً کمتر از 100 آزمایش) و فقط برای تعداد خرده های کم (مثلاً کمتر از 10 قطعه) مناسب هستند.

DEVICE_CAPACITY_LOW

دستگاه هایی که ظرفیت پایینی دارند (آزمایشگاه تعداد کمی از این دستگاه ها را دارد).

اگر کاربران نیاز به آزمایش بر روی این مدل و نسخه دستگاه خاص داشته باشند، ممکن است از این دستگاه‌ها استفاده شود. لطفاً توجه داشته باشید که به دلیل ظرفیت کم، ممکن است اتمام آزمایش‌ها بسیار بیشتر طول بکشد، به خصوص اگر تعداد زیادی آزمایش به طور همزمان فراخوانی شوند. این دستگاه ها برای تست شاردینگ مناسب نیستند.

DEVICE_CAPACITY_NONE

دستگاه هایی که به طور کامل در آزمایشگاه گم شده اند.

این دستگاه ها به طور موقت یا دائم در دسترس نیستند و نباید درخواست شوند. اگر دستگاه نیز به‌عنوان منسوخ علامت‌گذاری شود، این وضعیت به احتمال زیاد دائمی است.

نسخه اندروید

نسخه ای از سیستم عامل اندروید.

نمایندگی JSON
{
  "id": string,
  "versionString": string,
  "apiLevel": integer,
  "codeName": string,
  "releaseDate": {
    object (Date)
  },
  "distribution": {
    object (Distribution)
  },
  "tags": [
    string
  ]
}
زمینه های
id

string

یک شناسه غیر شفاف برای این نسخه اندروید. از این شناسه برای فراخوانی TestExecutionService استفاده کنید.

versionString

string

رشته ای که این نسخه از سیستم عامل اندروید را نشان می دهد. مثال: "4.3"، "4.4".

apiLevel

integer

سطح API برای این نسخه اندروید. مثال: 18، 19.

codeName

string

نام کد این نسخه اندروید. مثال: "JellyBean"، "KitKat".

releaseDate

object ( Date )

تاریخی که این نسخه اندروید در بازار عرضه شد.

distribution

object ( Distribution )

سهم بازار این نسخه

tags[]

string

برچسب ها برای این بعد مثال: "پیش فرض"، "پیش نمایش"، "منسوخ شده".

تاریخ

نمایانگر یک تاریخ تقویم کامل یا جزئی، مانند روز تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده است یا ناچیز است. تاریخ مربوط به تقویم میلادی است. این می تواند نشان دهنده یکی از موارد زیر باشد:

  • تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
  • یک ماه و روز، با یک سال صفر (مثلاً یک سالگرد).
  • یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
  • یک سال و یک ماه، با روز صفر (مثلاً تاریخ انقضای کارت اعتباری).

انواع مرتبط:

نمایندگی JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
زمینه های
year

integer

سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد.

month

integer

ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود.

day

integer

روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.

توزیع

داده‌های مربوط به تعداد نسبی دستگاه‌هایی که یک پیکربندی معین از پلتفرم Android را اجرا می‌کنند.

نمایندگی JSON
{
  "measurementTime": string,
  "marketShare": number
}
زمینه های
measurementTime

string ( Timestamp format)

فقط خروجی زمانی که این توزیع اندازه گیری شد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "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 )

مجموعه جهت گیری های موجود

محلی

تعیین مکان/منطقه برای زبان.

نمایندگی JSON
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
زمینه های
id

string

شناسه این منطقه مثال: "en_US".

name

string

نامی انسان پسند برای این زبان/محل. مثال: "انگلیسی".

region

string

یک رشته انسان دوست که منطقه را برای این منطقه نشان می دهد. مثال: "ایالات متحده". برای هر محلی وجود ندارد.

tags[]

string

برچسب ها برای این بعد مثال: "پیش فرض".

گرایش

جهت صفحه نمایش دستگاه

نمایندگی JSON
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
زمینه های
id

string

شناسه این جهت. مثال: "پرتره".

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
  ],
  "screenX": integer,
  "screenY": integer,
  "screenDensity": integer,
  "formFactor": enum (DeviceFormFactor),
  "perVersionInfo": [
    {
      object (PerIosVersionInfo)
    }
  ]
}
زمینه های
id

string

شناسه مات منحصر به فرد برای این مدل. از این برای فراخوانی 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

screenX

integer

اندازه صفحه نمایش در بعد افقی (X) با پیکسل اندازه گیری می شود.

screenY

integer

اندازه صفحه نمایش در بعد عمودی (Y) با پیکسل اندازه گیری می شود.

screenDensity

integer

تراکم صفحه نمایش بر حسب DPI

formFactor

enum ( DeviceFormFactor )

این دستگاه تلفن، تبلت، پوشیدنی و غیره باشد.

perVersionInfo[]

object ( PerIosVersionInfo )

اطلاعات مربوط به نسخه یک مدل iOS.

PerIosVersionInfo

اطلاعات مربوط به نسخه یک مدل iOS.

نمایندگی JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
زمینه های
versionId

string

یک نسخه iOS

deviceCapacity

enum ( DeviceCapacity )

تعداد دستگاه های آنلاین برای نسخه iOS.

IosVersion

یک نسخه iOS

نمایندگی JSON
{
  "id": string,
  "majorVersion": integer,
  "minorVersion": integer,
  "tags": [
    string
  ],
  "supportedXcodeVersionIds": [
    string
  ]
}
زمینه های
id

string

یک شناسه غیر شفاف برای این نسخه iOS. از این شناسه برای فراخوانی TestExecutionService استفاده کنید.

majorVersion

integer

یک عدد صحیح که نشان دهنده نسخه اصلی iOS است. مثال: "8"، "9".

minorVersion

integer

یک عدد صحیح که نشان دهنده نسخه کوچک iOS است. مثال: "1"، "2".

tags[]

string

برچسب ها برای این بعد مثال: "پیش فرض"، "پیش نمایش"، "منسوخ شده".

supportedXcodeVersionIds[]

string

نسخه های Xcode موجود برای این نسخه.

XcodeVersion

یک نسخه Xcode که نسخه iOS با آن سازگار است.

نمایندگی JSON
{
  "version": string,
  "tags": [
    string
  ]
}
زمینه های
version

string

شناسه این نسخه مثال: "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 )

تنظیمات شبکه

نمایندگی JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
زمینه های
id

string

شناسه مات منحصر به فرد برای این پیکربندی ترافیک شبکه.

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

پهنای باند بر حسب کیلوبیت بر ثانیه

burst

number

اندازه انفجار به کیلوبیت

کاتالوگ نرم افزار ارائه شده

محیط نرم افزاری در حال حاضر در دستگاه های تحت آزمایش ارائه شده است.

نمایندگی JSON
{
  "orchestratorVersion": string,
  "androidxOrchestratorVersion": string
}
زمینه های
orchestratorVersion
(deprecated)

string

منسوخ شده: از AndroidX Test Orchestrator در آینده استفاده کنید.

رشته ای نشان دهنده نسخه فعلی Android Test Orchestrator که در محیط استفاده می شود. این بسته در https://maven.google.com/web/index.html#com.android.support.test:orchestrator موجود است.

androidxOrchestratorVersion

string

رشته ای نشان دهنده نسخه فعلی AndroidX Test Orchestrator که در محیط استفاده می شود. این بسته در https://maven.google.com/web/index.html#androidx.test:orchestrator موجود است.

DeviceIpBlockCatalog

لیست بلوک های IP مورد استفاده توسط آزمایشگاه تست Firebase

نمایندگی JSON
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
زمینه های
ipBlocks[]

object ( DeviceIpBlock )

IP دستگاه مورد استفاده توسط Firebase Test Lab را مسدود می کند

DeviceIpBlock

یک بلوک IP واحد

نمایندگی JSON
{
  "block": string,
  "form": enum (DeviceForm),
  "addedDate": {
    object (Date)
  }
}
زمینه های
block

string

بلوک آدرس IP در نماد CIDR به عنوان مثال: 34.68.194.64/29

form

enum ( DeviceForm )

آیا این بلوک توسط دستگاه های فیزیکی یا مجازی استفاده می شود

addedDate

object ( Date )

تاریخی که این بلوک به آزمایشگاه آزمایشی Firebase اضافه شد

مواد و روش ها

get

کاتالوگ محیط های تست پشتیبانی شده را دریافت می کند.