REST Resource: testEnvironmentCatalog

المصدر: TestEnvironmentCatalog

وصف لبيئة الاختبار.

تمثيل جيسون
{

  // 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

أجهزة Android المدعومة حاليًا.

تمثيل جيسون
{
  "models": [
    {
      object (AndroidModel)
    }
  ],
  "versions": [
    {
      object (AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object (AndroidRuntimeConfiguration)
  }
}
مجالات
models[]

object ( AndroidModel )

مجموعة موديلات أجهزة Android المدعومة.

versions[]

object ( AndroidVersion )

مجموعة إصدارات نظام التشغيل Android المدعومة.

runtimeConfiguration

object ( AndroidRuntimeConfiguration )

مجموعة تكوينات وقت التشغيل المدعومة.

AndroidModel

قد يتم تشغيل وصف لاختبارات جهاز Android.

تمثيل جيسون
{
  "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 )

معلومات خاصة بالإصدار لطراز Android.

screenX

integer

حجم الشاشة في البعد الأفقي (X) مقاسًا بالبكسل.

screenY

integer

حجم الشاشة في البعد الرأسي (Y) مقاسًا بالبكسل.

screenDensity

integer

كثافة الشاشة بـ DPI. وهذا يتوافق مع ro.sf.lcd_density

lowFpsVideoRecording

boolean

صحيح إذا وفقط إذا تم تسجيل الاختبارات باستخدام هذا النموذج من خلال تجميع لقطات الشاشة معًا. راجع 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 الأكثر تفضيلاً هو العنصر الأول في القائمة.

تكون العناصر مسبوقة بشكل اختياري بـ "versionId:" (حيث يكون versionId هو معرف AndroidVersion)، للإشارة إلى واجهة برمجة التطبيقات (ABI) المدعومة فقط في إصدار معين.

tags[]

string

العلامات لهذا البعد. أمثلة: "افتراضي"، "معاينة"، "مهمل".

thumbnailUrl

string

عنوان URL للصورة المصغرة (الصورة) للجهاز.

نموذج الجهاز

سواء كان الجهاز فعليًا أو افتراضيًا.

التعدادات
DEVICE_FORM_UNSPECIFIED لا تستخدم. للإصدارات الأولية فقط.
VIRTUAL جهاز Android الظاهري يستخدم المحاكاة الافتراضية الأصلية لـ Compute Engine. معمل اختبار Firebase فقط.
PHYSICAL الأجهزة الفعلية.
EMULATOR جهاز Android الظاهري يستخدم المحاكي في المحاكاة الافتراضية المتداخلة. يعادل أندرويد ستوديو.

DeviceFormFactor

عامل شكل الجهاز.

التعدادات
DEVICE_FORM_FACTOR_UNSPECIFIED لا تستخدم. للإصدارات الأولية فقط.
PHONE هذا الجهاز له شكل الهاتف.
TABLET هذا الجهاز له شكل الكمبيوتر اللوحي.
WEARABLE هذا الجهاز على شكل ساعة أو أي جهاز آخر يمكن ارتداؤه.

PerAndroidVersionInfo

معلومات خاصة بالإصدار لطراز Android.

تمثيل جيسون
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
مجالات
versionId

string

نسخة أندرويد.

deviceCapacity

enum ( DeviceCapacity )

عدد الأجهزة المتصلة بالإنترنت لإصدار Android.

سعة الجهاز

تعتمد السعة على عدد الأجهزة المتصلة بالإنترنت في المختبر.

هام: سعة الجهاز لا تعكس بشكل مباشر طول قائمة الانتظار في أي لحظة من الزمن. ولا يأخذ في الاعتبار حركة المرور الحالية أو حالة الأجهزة.

بالنسبة للأجهزة الفعلية، فإن العدد هو متوسط ​​الأجهزة المتصلة بالإنترنت في آخر 30 يومًا.

التعدادات
DEVICE_CAPACITY_UNSPECIFIED قيمة سعة الجهاز غير معروفة أو غير محددة.
DEVICE_CAPACITY_HIGH

الأجهزة ذات القدرة العالية (يوجد في المعمل عدد كبير من هذه الأجهزة).

يُقترح عمومًا استخدام هذه الأجهزة لإجراء عدد كبير من الاختبارات المتزامنة (على سبيل المثال، أكثر من 100 اختبار).

يرجى ملاحظة أن الأجهزة ذات السعة العالية لا تضمن فترات انتظار قصيرة بسبب عدة عوامل: 1. حركة المرور (مدى كثافة استخدامها في أي لحظة معينة) 2. يتم إعطاء الأولوية للأجهزة ذات السعة العالية لاستخدامات معينة، مما قد يتسبب في إبطاء اختبارات المستخدم بدلاً من اختيار أنواع الأجهزة المماثلة الأخرى.

DEVICE_CAPACITY_MEDIUM

الأجهزة ذات السعة المتوسطة (يتوفر في المعمل عدد لا بأس به من هذه الأجهزة، ولكن ليس بقدر الأجهزة ذات السعة العالية).

تعتبر هذه الأجهزة مناسبة لعمليات تشغيل اختبار أقل (على سبيل المثال، أقل من 100 اختبار) ولأعداد الأجزاء المنخفضة فقط (على سبيل المثال، أقل من 10 أجزاء).

DEVICE_CAPACITY_LOW

الأجهزة ذات القدرة المنخفضة (المختبر لديه عدد قليل من هذه الأجهزة).

يمكن استخدام هذه الأجهزة إذا كان المستخدمون بحاجة إلى الاختبار على طراز الجهاز وإصداره المحددين. يرجى ملاحظة أنه نظرًا لانخفاض السعة، قد تستغرق الاختبارات وقتًا أطول بكثير للانتهاء، خاصة إذا تم استدعاء عدد كبير من الاختبارات مرة واحدة. هذه الأجهزة غير مناسبة لتقسيم الاختبار.

DEVICE_CAPACITY_NONE

الأجهزة المفقودة تماما من المعمل.

هذه الأجهزة غير متاحة بشكل مؤقت أو دائم ويجب عدم طلبها. إذا تم وضع علامة على الجهاز أيضًا على أنه مهمل، فمن المحتمل جدًا أن تكون هذه الحالة دائمة.

نسخة أندرويد

نسخة من نظام التشغيل أندرويد.

تمثيل جيسون
{
  "id": string,
  "versionString": string,
  "apiLevel": integer,
  "codeName": string,
  "releaseDate": {
    object (Date)
  },
  "distribution": {
    object (Distribution)
  },
  "tags": [
    string
  ]
}
مجالات
id

string

معرف غير شفاف لإصدار Android هذا. استخدم هذا المعرف لاستدعاء TestExecutionService.

versionString

string

سلسلة تمثل هذا الإصدار من نظام التشغيل Android. أمثلة: "4.3"، "4.4".

apiLevel

integer

مستوى واجهة برمجة التطبيقات (API) لإصدار Android هذا. أمثلة: 18، 19.

codeName

string

الاسم الرمزي لإصدار Android هذا. أمثلة: "JellyBean"، "KitKat".

releaseDate

object ( Date )

التاريخ الذي أصبح فيه إصدار Android هذا متاحًا في السوق.

distribution

object ( Distribution )

حصة السوق لهذا الإصدار.

tags[]

string

العلامات لهذا البعد. أمثلة: "افتراضي"، "معاينة"، "مهمل".

تاريخ

يمثل تاريخ تقويم كامل أو جزئي، مثل عيد ميلاد. الوقت من اليوم والمنطقة الزمنية إما محددان في مكان آخر أو غير مهمين. التاريخ نسبة إلى التقويم الغريغوري. يمكن أن يمثل هذا واحدًا مما يلي:

  • تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
  • شهر ويوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية).
  • سنة مستقلة بشهر صفر ويوم صفر.
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

الأنواع ذات الصلة:

تمثيل جيسون
{
  "year": integer,
  "month": integer,
  "day": integer
}
مجالات
year

integer

سنة التاريخ. يجب أن يكون من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة.

month

integer

شهر من السنة. يجب أن يكون من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم.

day

integer

يوم من شهر. يجب أن يكون من 1 إلى 31 ويكون صالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر حيث لا يكون لليوم أهمية.

توزيع

بيانات حول العدد النسبي للأجهزة التي تعمل بتكوين معين لمنصة Android.

تمثيل جيسون
{
  "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 الذي يمكن تحديده في وقت تشغيل الاختبار.

تمثيل جيسون
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
مجالات
locales[]

object ( Locale )

مجموعة اللغات المتاحة.

orientations[]

object ( Orientation )

مجموعة التوجهات المتاحة

لغة

تعيين الموقع/المنطقة للغة.

تمثيل جيسون
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
مجالات
id

string

معرف هذه اللغة. مثال: "ar_US".

name

string

اسم صديق للإنسان لهذه اللغة/اللغة المحلية. مثال: "الإنجليزية".

region

string

سلسلة صديقة للإنسان تمثل المنطقة لهذه اللغة. مثال: "الولايات المتحدة". غير موجود لكل لغة.

tags[]

string

العلامات لهذا البعد. مثال: "الافتراضي".

توجيه

اتجاه شاشة الجهاز.

تمثيل جيسون
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
مجالات
id

string

معرف هذا التوجه على سبيل المثال: "صورة".

name

string

اسم صديق للإنسان لهذا التوجه. على سبيل المثال: "صورة".

tags[]

string

العلامات لهذا البعد. مثال: "الافتراضي".

IosDeviceCatalog

أجهزة iOS المدعومة حاليًا.

تمثيل جيسون
{
  "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.

تمثيل جيسون
{
  "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.

تمثيل جيسون
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
مجالات
versionId

string

نسخة iOS.

deviceCapacity

enum ( DeviceCapacity )

عدد الأجهزة المتصلة بالإنترنت لإصدار iOS.

IosVersion

نسخة iOS.

تمثيل جيسون
{
  "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.

تمثيل جيسون
{
  "version": string,
  "tags": [
    string
  ]
}
مجالات
version

string

معرف هذا الإصدار مثال: "9.2".

tags[]

string

العلامات الخاصة بإصدار Xcode هذا. مثال: "الافتراضي".

تكوين IosRuntime

تكوين iOS الذي يمكن تحديده في وقت تشغيل الاختبار.

تمثيل جيسون
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
مجالات
locales[]

object ( Locale )

مجموعة اللغات المتاحة.

orientations[]

object ( Orientation )

مجموعة التوجهات المتاحة

كتالوج تكوين الشبكة

تمثيل جيسون
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
مجالات
configurations[]

object ( NetworkConfiguration )

تكوين شبكة

تمثيل جيسون
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
مجالات
id

string

المعرف غير الشفاف الفريد لتكوين حركة مرور الشبكة.

upRule

object ( TrafficRule )

قاعدة المحاكاة المطبقة على حركة التحميل.

downRule

object ( TrafficRule )

تنطبق قاعدة المحاكاة على حركة التنزيل.

TrafficRule

معلمات مضاهاة الشبكة.

تمثيل جيسون
{
  "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

حجم الانفجار بالكيلوبت.

كتالوج البرامج المقدمة

بيئة البرامج المتوفرة حاليًا على الأجهزة قيد الاختبار.

تمثيل جيسون
{
  "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 Test Lab

تمثيل جيسون
{
  "ipBlocks": [
    {
      object (DeviceIpBlock)
    }
  ]
}
مجالات
ipBlocks[]

object ( DeviceIpBlock )

يحظر عنوان IP الخاص بالجهاز الذي يستخدمه Firebase Test Lab

DeviceIpBlock

كتلة IP لجهاز واحد

تمثيل جيسون
{
  "block": string,
  "form": enum (DeviceForm),
  "addedDate": {
    object (Date)
  }
}
مجالات
block

string

كتلة عنوان IP في تدوين CIDR، على سبيل المثال: 34.68.194.64/29

form

enum ( DeviceForm )

ما إذا كان يتم استخدام هذه الكتلة بواسطة الأجهزة المادية أو الافتراضية

addedDate

object ( Date )

تاريخ إضافة هذه الكتلة إلى Firebase Test Lab

طُرق

get

 يحصل على كتالوج بيئات الاختبار المدعومة.