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 המשמשים מכשירים בסביבת הבדיקה.

AndroidDevice Catalog

מכשירי האנדרואיד הנתמכים כעת.

ייצוג JSON
{
  "models": [
    {
      object (AndroidModel)
    }
  ],
  "versions": [
    {
      object (AndroidVersion)
    }
  ],
  "runtimeConfiguration": {
    object (AndroidRuntimeConfiguration)
  }
}
שדות
models[]

object ( AndroidModel )

סט הדגמים הנתמכים של מכשירי אנדרואיד.

versions[]

object ( AndroidVersion )

סט גרסאות מערכת ההפעלה אנדרואיד הנתמכות.

runtimeConfiguration

object ( AndroidRuntimeConfiguration )

קבוצת תצורות זמן הריצה הנתמכות.

דגם אנדרואיד

ניתן להפעיל תיאור של בדיקות מכשיר אנדרואיד.

ייצוג 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

רשימת ABIs נתמכים עבור מכשיר זה. זה מתאים ל-android.os.Build.SUPPORTED_ABIS (עבור רמת API 21 ומעלה) או ל-android.os.Build.CPU_ABI/CPU_ABI2. ה-ABI המועדף ביותר הוא האלמנט הראשון ברשימה.

קידומת אופציונלית לרכיבים היא "versionId:" (כאשר versionId הוא המזהה של AndroidVersion), המציינים ABI שנתמך רק בגרסה מסוימת.

tags[]

string

תגים עבור מימד זה. דוגמאות: "ברירת מחדל", "תצוגה מקדימה", "הוצא משימוש".

thumbnailUrl

string

כתובת אתר של תמונה ממוזערת (תמונה) של המכשיר.

DeviceForm

בין אם המכשיר פיזי או וירטואלי.

תקצירים
DEVICE_FORM_UNSPECIFIED אל תשתמש. לגירסת פרוטו בלבד.
VIRTUAL מכשיר וירטואלי אנדרואיד באמצעות וירטואליזציה מקורית של Compute Engine. Firebase Test Lab בלבד.
PHYSICAL חומרה בפועל.
EMULATOR מכשיר וירטואלי אנדרואיד באמצעות אמולטור בווירטואליזציה מקוננת. מקביל לאנדרואיד סטודיו.

DeviceFormFactor

גורם הצורה של מכשיר.

תקצירים
DEVICE_FORM_FACTOR_UNSPECIFIED אל תשתמש. לגירסת פרוטו בלבד.
PHONE למכשיר הזה יש צורה של טלפון.
TABLET למכשיר זה יש צורה של טאבלט.
WEARABLE למכשיר זה יש צורה של שעון או פריט לביש אחר.

PerAndroidVersionInfo

מידע ספציפי לגרסה של דגם אנדרואיד.

ייצוג JSON
{
  "versionId": string,
  "deviceCapacity": enum (DeviceCapacity)
}
שדות
versionId

string

גרסת אנדרואיד.

deviceCapacity

enum ( DeviceCapacity )

מספר המכשירים המקוונים עבור גרסת אנדרואיד.

קיבולת מכשיר

קיבולת מבוססת על מספר המכשירים המקוונים במעבדה.

חשוב: קיבולת המכשיר אינה משקפת ישירות את אורך התור ברגע בזמן. זה לא לוקח בחשבון את התעבורה הנוכחית או את מצב המכשירים.

עבור מכשירים פיזיים, המספר הוא הממוצע של מכשירים מקוונים ב-30 הימים האחרונים.

תקצירים
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 כדי לציין שנה בפני עצמה או שנה וחודש שבהם היום אינו משמעותי.

הפצה

נתונים על המספר היחסי של מכשירים המריצים תצורה נתונה של פלטפורמת אנדרואיד.

ייצוג 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

תצורת אנדרואיד שניתן לבחור בזמן הפעלת בדיקה.

ייצוג JSON
{
  "locales": [
    {
      object (Locale)
    }
  ],
  "orientations": [
    {
      object (Orientation)
    }
  ]
}
שדות
locales[]

object ( Locale )

קבוצת המקומות הזמינים.

orientations[]

object ( Orientation )

קבוצת הכיוונים הזמינים.

מקום

ייעוד מיקום/אזור לשפה.

ייצוג JSON
{
  "id": string,
  "name": string,
  "region": string,
  "tags": [
    string
  ]
}
שדות
id

string

המזהה של המקום הזה. דוגמה: "he_US".

name

string

שם ידידותי לאדם לשפה/מקום זה. דוגמה: "אנגלית".

region

string

מחרוזת ידידותית לאדם המייצגת את האזור עבור המקום הזה. דוגמה: "ארצות הברית". לא קיים בכל אזור.

tags[]

string

תגים עבור מימד זה. דוגמה: "ברירת מחדל".

נטייה

כיוון המסך של המכשיר.

ייצוג JSON
{
  "id": string,
  "name": string,
  "tags": [
    string
  ]
}
שדות
id

string

המזהה של הכיוון הזה. דוגמה: "פורטרט".

name

string

שם ידידותי לאדם להתמצאות זו. דוגמה: "פורטרט".

tags[]

string

תגים עבור מימד זה. דוגמה: "ברירת מחדל".

IosDevice Catalog

מכשירי 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 )

קבוצת הכיוונים הזמינים.

NetworkConfiguration Catalog

ייצוג JSON
{
  "configurations": [
    {
      object (NetworkConfiguration)
    }
  ]
}
שדות
configurations[]

object ( NetworkConfiguration )

תצורת רשת

ייצוג JSON
{
  "id": string,
  "upRule": {
    object (TrafficRule)
  },
  "downRule": {
    object (TrafficRule)
  }
}
שדות
id

string

המזהה האטום הייחודי עבור תצורת תעבורת רשת זו.

upRule

object ( TrafficRule )

כלל האמולציה החל על תעבורת ההעלאה.

downRule

object ( TrafficRule )

כלל האמולציה החל על תעבורת ההורדות.

Traffic Rule

פרמטרים של אמולציית רשת.

ייצוג 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

רוחב פס ב-kbits/שנייה.

burst

number

גודל פרץ ב-kbits.

ProvidedSoftware Catalog

סביבת התוכנה המסופקת כעת במכשירים הנבדקים.

ייצוג 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 Test Lab

ייצוג 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 Test Lab

שיטות

get

מקבל את הקטלוג של סביבות בדיקה נתמכות.