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)

أجهزة Android المتوافقة

iosDeviceCatalog

object (IosDeviceCatalog)

أجهزة iOS المتوافقة

networkConfigurationCatalog

object (NetworkConfigurationCatalog)

عمليات ضبط الشبكة المتوافقة.

softwareCatalog

object (ProvidedSoftwareCatalog)

بيئة اختبار البرامج التي توفرها TestExecutionService

deviceIpBlockCatalog

object (DeviceIpBlockCatalog)

عناوين IP المحظورة التي تستخدمها الأجهزة في بيئة الاختبار.

كتالوج جهاز Android

تشير هذه السمة إلى أجهزة Android المتوافقة حاليًا.

تمثيل JSON
{
  "models": [
    {
      object (AndroidModel)
    }
  ],
  "versions": [
    {
      object (AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object (AndroidRuntimeConfiguration)
  }
}
الحقول
models[]

object (AndroidModel)

مجموعة طُرز أجهزة Android المتوافقة.

versions[]

object (AndroidVersion)

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

runtimeConfiguration

object (AndroidRuntimeConfiguration)

مجموعة عمليات ضبط بيئة التشغيل المتوافقة.

طراز Android

يمكن إجراء اختبار على جهاز 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

الشركة التي تحمل العلامة التجارية لهذا الجهاز. مثال: "Google"، "Samsung".

codename

string

تمثّل هذه السمة اسم التصميم الصناعي. يتوافق هذا مع الملف android.os.Build.DEVICE.

form

enum (DeviceForm)

ما إذا كان هذا الجهاز افتراضيًا أو ماديًا

formFactor

enum (DeviceFormFactor)

ما إذا كان هذا الجهاز هاتفًا أو جهازًا لوحيًا أو جهازًا قابلاً للارتداء أو غير ذلك

perVersionInfo[]

object (PerAndroidVersionInfo)

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

screenX

integer

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

screenY

integer

حجم الشاشة في البُعد العمودي (Y) بالبكسل

screenDensity

integer

كثافة الشاشة بالنقاط لكل بوصة يتجاوب هذا مع ro.sf.lcd_density

lowFpsVideoRecording

boolean

صحيح إذا تم تسجيل الاختبارات باستخدام هذا النموذج من خلال دمج لقطات الشاشة معًا. يمكنك الاطّلاع على use_low_spec_video_recording في إعدادات الجهاز.

supportedVersionIds[]

string

مجموعة إصدارات Android المتوافقة مع هذا الجهاز

supportedAbis[]

string

قائمة واجهات ABI المتوافقة مع هذا الجهاز يتوافق هذا العمود مع android.os.Build.SUPPORTED_ABIS (للمستوى 21 لواجهة برمجة التطبيقات والمستويات الأعلى) أو android.os.Build.CPU_ABI/CPU_ABI2. إنّ واجهة التطبيق الثنائية (ABI) الأكثر تفضيلاً هي العنصر الأول في القائمة.

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

tags[]

string

علامات لهذه السمة. أمثلة: "تلقائي"، "معاينة"، "متوقف".

thumbnailUrl

string

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

نموذج الجهاز

ما إذا كان الجهاز ماديًا أو افتراضيًا

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

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

يعرض هذا المقياس شكل الجهاز.

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

معلومات PerAndroidVersionInfo

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

تمثيل JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity),
  "interactiveDeviceAvailabilityEstimate": string,
  "directAccessVersionInfo": {
    object (DirectAccessVersionInfo)
  }
}
الحقول
versionId

string

إصدار Android

deviceCapacity

enum (DeviceCapacity)

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

interactiveDeviceAvailabilityEstimate

string (Duration format)

النتائج فقط. وقت الانتظار المقدَّر لجلسة تفاعلية واحدة على الجهاز باستخدام الوصول المباشر.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

directAccessVersionInfo

object (DirectAccessVersionInfo)

النتائج فقط. تحدِّد هذه السياسة البرامج المتوافقة مع ميزة "الوصول المباشر" لإصدار Android هذا.

سعة الجهاز

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

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

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

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

الأجهزة العالية السعة (يحتوي المختبر على عدد كبير من هذه الأجهزة).

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

يُرجى العِلم أنّ الأجهزة ذات السعة الكبيرة لا تضمن أوقات انتظار قصيرة لعدّة عوامل: 1. الزيارات (مدى استخدامها في أي لحظة) 2- يتم منح الأولوية للأجهزة ذات السعة الكبيرة لاستخدامات معيّنة، ما قد يجعل اختبارات المستخدم أبطأ من اختيار أنواع أخرى مشابهة من الأجهزة.

DEVICE_CAPACITY_MEDIUM

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

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

DEVICE_CAPACITY_LOW

الأجهزة المنخفضة السعة (يحتوي المختبر على عدد صغير من هذه الأجهزة).

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

DEVICE_CAPACITY_NONE

الأجهزة غير الموجودة تمامًا في المختبر.

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

DirectAccessVersionInfo

تشير إلى ما إذا كان الوصول المباشر متوافقًا أم لا وإصدارات العميل التي يتم من خلالها.

تتوفّر خدمة DirectAccessService حاليًا كمعاينة لمجموعة محدَّدة من المطوّرين. يمكنك التسجيل اليوم نيابةً عنك وعن فريقك على الرابط https://developer.android.com/studio/preview/android-device-streaming.

تمثيل JSON
{
  "directAccessSupported": boolean,
  "minimumAndroidStudioVersion": string
}
الحقول
directAccessSupported

boolean

ما إذا كان الوصول المباشر متاحًا مطلقًا. من المتوقّع أن يفلتر العملاء قائمة الأجهزة لإظهار طُرز وإصدارات Android التي تتيح ميزة "الوصول المباشر" فقط، وذلك عندما يكون هذا هو ما يريده المستخدم.

minimumAndroidStudioVersion

string

النتائج فقط. يشير إلى التوافق مع جهاز العميل، حيث يُعرف عن أنّ الجهاز لا يعمل إلا مع حلول معيّنة منفَّذة في برنامج "استوديو Android". التنسيق المتوقّع "major.minor.micro.patch"، مثال: "5921.22.2211.8881706".

إصدار Android

إصدار من نظام التشغيل Android

تمثيل JSON
{
  "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

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

codeName

string

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

releaseDate

object (Date)

تاريخ توفُّر إصدار Android هذا في السوق

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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

marketShare

number

النتائج فقط. الكسر المقدّر (0-1) لإجمالي السوق باستخدام هذه الإعدادات

إعدادات AndroidRuntime

إعدادات 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

علامات لهذه السمة. مثال: "تلقائي".

كاتالوج جهاز IosDevice

أجهزة 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)

مجموعة عمليات ضبط بيئة التشغيل المتوافقة.

نموذج Ios

يمكن إجراء اختبار على جهاز 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/Documents/Device Information/Reference/iOSDeviceMatrix/Device تسجّلMatrix.html .

screenX

integer

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

screenY

integer

حجم الشاشة في البُعد العمودي (Y) بالبكسل

screenDensity

integer

كثافة الشاشة بالنقاط لكل بوصة

formFactor

enum (DeviceFormFactor)

ما إذا كان هذا الجهاز هاتفًا أو جهازًا لوحيًا أو جهازًا قابلاً للارتداء أو غير ذلك

perVersionInfo[]

object (PerIosVersionInfo)

معلومات خاصة بإصدار نموذج iOS

معلومات PerIosVersionInfo

تمثّل هذه السمة معلومات خاصة بإصدار معيّن من طراز iOS.

تمثيل JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
الحقول
versionId

string

إصدار iOS

deviceCapacity

enum (DeviceCapacity)

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

إصدار Ios

إصدار 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 هذا مثال: "تلقائي".

إعدادات وقت تشغيل Ios

إعدادات iOS التي يمكن اختيارها عند إجراء الاختبار.

تمثيل JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
الحقول
locales[]

object (Locale)

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

orientations[]

object (Orientation)

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

كتالوج إعداد الشبكة

تمثيل JSON
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
الحقول
configurations[]

object (NetworkConfiguration)

تهيئة الشبكة

تمثيل JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
الحقول
id

string

المعرّف الفريد المبهم لإعداد حركة مرور الشبكة هذه.

upRule

object (TrafficRule)

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

downRule

object (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

حظر عنوان IP للجهاز

حظر عنوان 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

الحصول على قائمة ببيئات الاختبار المتوافقة