REST Resource: projects.testMatrices

{
  "testMatrixId": string,
  "projectId": string,
  "clientInfo": {
    object (ClientInfo)
  },
  "testSpecification": {
    object (TestSpecification)
  },
  "environmentMatrix": {
    object (EnvironmentMatrix)
  },
  "testExecutions": [
    {
      object (TestExecution)
    }
  ],
  "resultStorage": {
    object (ResultStorage)
  },
  "state": enum (TestState),
  "timestamp": string,
  "invalidMatrixDetails": enum (InvalidMatrixDetails),
  "flakyTestAttempts": integer,
  "outcomeSummary": enum (OutcomeSummary),
  "failFast": boolean
}

string

فقط خروجی شناسه منحصر به فرد توسط سرویس تنظیم شده است.

string

پروژه ابری که مالک ماتریس آزمایشی است.

object ( ClientInfo )

اطلاعات در مورد مشتری که آزمون را فراخوانی کرده است.

object ( TestSpecification )

ضروری. نحوه اجرای آزمون

object ( EnvironmentMatrix )

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

object ( TestExecution )

فقط خروجی لیستی از اجرای آزمایشی که سرویس برای این ماتریس ایجاد می کند.

object ( ResultStorage )

ضروری. جایی که نتایج برای ماتریس نوشته می شود.

enum ( TestState )

فقط خروجی پیشرفت فعلی ماتریس تست را نشان می دهد.

string ( Timestamp format)

فقط خروجی زمانی که این ماتریس آزمون در ابتدا ایجاد شد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

enum ( InvalidMatrixDetails )

فقط خروجی توضیح می دهد که چرا ماتریس نامعتبر در نظر گرفته می شود. فقط برای ماتریس هایی در حالت INVALID مفید است.

integer

تعداد دفعاتی که یک TestExecution باید دوباره امتحان شود اگر یک یا چند مورد تست آن به هر دلیلی شکست بخورد. حداکثر تعداد تکرار مجاز 10 عدد است.

پیش‌فرض 0 است که به معنای عدم اجرای مجدد است.

enum ( OutcomeSummary )

فقط خروجی نتیجه کلی آزمون. فقط زمانی تنظیم کنید که وضعیت ماتریس آزمایشی FINISHED باشد.

boolean

اگر درست باشد، حداکثر تنها یک تلاش برای اجرای هر اجرا/شارد در ماتریس انجام خواهد شد. تلاش های تست پوسته پوسته تحت تاثیر قرار نمی گیرند.

به طور معمول، اگر یک مشکل زیرساختی بالقوه شناسایی شود، 2 یا بیشتر تلاش می شود.

این ویژگی برای بارهای کاری حساس به تأخیر است. بروز شکست در اجرا ممکن است برای ماتریس های سریع شکست به طور قابل توجهی بیشتر باشد و به دلیل این انتظار، پشتیبانی محدودتر است.

{
  "name": string,
  "clientInfoDetails": [
    {
      object (ClientInfoDetail)
    }
  ]
}

string

ضروری. نام مشتری، مانند gcloud.

object ( ClientInfoDetail )

لیست اطلاعات دقیق در مورد مشتری

{
  "key": string,
  "value": string
}

string

ضروری. کلید اطلاعات دقیق مشتری

string

ضروری. ارزش اطلاعات دقیق مشتری

{
  "testTimeout": string,
  "disableVideoRecording": boolean,
  "disablePerformanceMetrics": boolean,

  // Union field setup can be only one of the following:
  "testSetup": {
    object (TestSetup)
  },
  "iosTestSetup": {
    object (IosTestSetup)
  }
  // End of list of possible types for union field setup.

  // Union field test can be only one of the following:
  "androidInstrumentationTest": {
    object (AndroidInstrumentationTest)
  },
  "androidRoboTest": {
    object (AndroidRoboTest)
  },
  "androidTestLoop": {
    object (AndroidTestLoop)
  },
  "iosXcTest": {
    object (IosXcTest)
  },
  "iosTestLoop": {
    object (IosTestLoop)
  }
  // End of list of possible types for union field test.
}

string ( Duration format)

حداکثر زمانی که اجرای آزمایشی قبل از لغو خودکار مجاز است اجرا شود. مقدار پیش فرض 5 دقیقه است.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

boolean

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

boolean

ضبط معیارهای عملکرد را غیرفعال می کند. ممکن است تاخیر تست را کاهش دهد.

object ( TestSetup )

تست الزامات راه اندازی برای اندروید به عنوان مثال فایل ها برای نصب، بوت استرپ اسکریپت ها.

object ( IosTestSetup )

تست تنظیمات مورد نیاز برای iOS.

object ( AndroidInstrumentationTest )

تست ابزار دقیق اندروید.

object ( AndroidRoboTest )

تست روبو اندروید.

object ( AndroidTestLoop )

یک برنامه اندروید با حلقه تست.

object ( IosXcTest )

یک iOS XCTest، از طریق یک فایل xctestrun.

object ( IosTestLoop )

یک برنامه iOS با حلقه تست.

{
  "filesToPush": [
    {
      object (DeviceFile)
    }
  ],
  "directoriesToPull": [
    string
  ],
  "additionalApks": [
    {
      object (Apk)
    }
  ],
  "account": {
    object (Account)
  },
  "networkProfile": string,
  "environmentVariables": [
    {
      object (EnvironmentVariable)
    }
  ],
  "systrace": {
    object (SystraceSetup)
  },
  "dontAutograntPermissions": boolean
}

object ( DeviceFile )

لیست فایل هایی که باید قبل از شروع آزمایش به دستگاه فشار دهید.

string

فهرست دایرکتوری‌های دستگاه برای آپلود در GCS در پایان آزمایش؛ آنها باید مسیرهای مطلق تحت /sdcard، /storage یا /data/local/tmp باشند. نام مسیرها به کاراکترهای AZ 0-9 _ - محدود شده است. + و /

توجه: مسیرهای /sdcard و /data در دسترس خواهند بود و به عنوان جایگزین مسیر ضمنی در نظر گرفته می شوند. به عنوان مثال، اگر /sdcard در یک دستگاه خاص به حافظه خارجی نگاشت نشود، سیستم آن را با پیشوند مسیر ذخیره سازی خارجی برای آن دستگاه جایگزین می کند.

object ( Apk )

APKهایی که باید نصب شوند علاوه بر آنهایی که مستقیماً آزمایش می شوند. در حال حاضر سقف 100 است.

object ( Account )

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

string

نمایه ترافیک شبکه مورد استفاده برای اجرای آزمایش. هنگام فراخوانی TestEnvironmentDiscoveryService.GetTestEnvironmentCatalog، می توان نمایه های شبکه موجود را با استفاده از نوع محیط NETWORK_CONFIGURATION جستجو کرد.

object ( EnvironmentVariable )

متغیرهای محیطی برای تنظیم برای آزمایش (فقط برای آزمایش‌های ابزار دقیق قابل استفاده است).

object ( SystraceSetup )

پیکربندی Systrace برای اجرا. منسوخ شده: Systrace از Python 2 استفاده کرد که در 01-01-2020 غروب شد. Systrace دیگر در Cloud Testing API پشتیبانی نمی‌شود و هیچ فایل Systrace در نتایج ارائه نخواهد شد.

boolean

آیا برای جلوگیری از اعطای همه مجوزهای زمان اجرا هنگام نصب برنامه

{

  // Union field device_file can be only one of the following:
  "obbFile": {
    object (ObbFile)
  },
  "regularFile": {
    object (RegularFile)
  }
  // End of list of possible types for union field device_file.
}

object ( ObbFile )

ارجاع به یک فایل باینری blob مات.

object ( RegularFile )

ارجاع به یک فایل معمولی

{
  "obbFileName": string,
  "obb": {
    object (FileReference)
  }
}

string

ضروری. نام فایل OBB که باید با فرمت مشخص شده توسط Android مطابقت داشته باشد، به عنوان مثال [main|patch].0300110.com.example.android.obb که در <shared-storage>/Android/obb/<package-name>/ نصب خواهد شد. روی دستگاه

object ( FileReference )

ضروری. فایل(های) مات باینری Blob (OBB) برای نصب روی دستگاه.

{

  // Union field file can be only one of the following:
  "gcsPath": string
  // End of list of possible types for union field file.
}

string

مسیری به یک فایل در Google Cloud Storage. به عنوان مثال: gs://build-app-1414623860166/app%40debug-unaligned.apk انتظار می رود این مسیرها دارای url کدگذاری شوند (درصد رمزگذاری)

{
  "content": {
    object (FileReference)
  },
  "devicePath": string
}

object ( FileReference )

ضروری. فایل منبع

string

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

${EXTERNAL_STORAGE}، /sdcard، یا /storage

${ANDROID_DATA}/local/tmp، یا /data/local/tmp

تعیین مسیر خارج از این درختان فهرست نامعتبر است.

مسیرهای /sdcard و /data در دسترس قرار می گیرند و به عنوان جایگزین مسیر ضمنی در نظر گرفته می شوند. به عنوان مثال، اگر /sdcard در یک دستگاه خاص به حافظه خارجی نگاشت، سیستم آن را با پیشوند مسیر ذخیره سازی خارجی برای آن دستگاه جایگزین می کند و فایل را در آنجا کپی می کند.

اکیداً توصیه می‌شود که از Environment API در برنامه و کد آزمایشی برای دسترسی به فایل‌های روی دستگاه به صورت قابل حمل استفاده کنید.

{
  "location": {
    object (FileReference)
  },
  "packageName": string
}

object ( FileReference )

مسیر یک APK که باید قبل از شروع آزمایش روی دستگاه نصب شود.

string

بسته جاوا برای APK که باید نصب شود. مقدار با بررسی مانیفست برنامه تعیین می شود.

{

  // Union field account_type can be only one of the following:
  "googleAuto": {
    object (GoogleAuto)
  }
  // End of list of possible types for union field account_type.
}

object ( GoogleAuto )

یک حساب ورود خودکار به گوگل.

{
  "key": string,
  "value": string
}

string

کلید برای متغیر محیطی

string

ارزش برای متغیر محیطی

{
  "durationSeconds": integer
}

integer

مدت زمان Systrace در ثانیه. باید بین 1 تا 30 ثانیه باشد. 0 سیستم را غیرفعال می کند.

{
  "networkProfile": string,
  "additionalIpas": [
    {
      object (FileReference)
    }
  ],
  "pushFiles": [
    {
      object (IosDeviceFile)
    }
  ],
  "pullDirectories": [
    {
      object (IosDeviceFile)
    }
  ]
}

string

نمایه ترافیک شبکه مورد استفاده برای اجرای آزمایش. هنگام فراخوانی TestEnvironmentDiscoveryService.GetTestEnvironmentCatalog، می توان نمایه های شبکه موجود را با استفاده از نوع محیط NETWORK_CONFIGURATION جستجو کرد.

object ( FileReference )

برنامه های iOS برای نصب علاوه بر آنهایی که مستقیماً آزمایش می شوند.

object ( IosDeviceFile )

لیست فایل هایی که باید قبل از شروع آزمایش به دستگاه فشار دهید.

object ( IosDeviceFile )

فهرست دایرکتوری‌های موجود در دستگاه برای آپلود در فضای ذخیره‌سازی ابری در پایان آزمایش.

دایرکتوری ها باید یا در یک دایرکتوری مشترک (مانند /private/var/mobile/Media) یا در یک دایرکتوری قابل دسترسی در داخل سیستم فایل برنامه (مانند /Documents) با تعیین شناسه بسته باشند.

{
  "content": {
    object (FileReference)
  },
  "bundleId": string,
  "devicePath": string
}

object ( FileReference )

فایل منبع

string

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

برنامه‌های iOS سیستم فایل مخصوص خود را سندباکس می‌کنند، بنابراین فایل‌های برنامه باید مشخص کنند که کدام برنامه روی دستگاه نصب شده است.

string

مکان فایل روی دستگاه، در داخل سیستم فایل سندباکس برنامه

{
  "testApk": {
    object (FileReference)
  },
  "appPackageId": string,
  "testPackageId": string,
  "testRunnerClass": string,
  "testTargets": [
    string
  ],
  "orchestratorOption": enum (OrchestratorOption),
  "shardingOption": {
    object (ShardingOption)
  },

  // Union field app_under_test can be only one of the following:
  "appApk": {
    object (FileReference)
  },
  "appBundle": {
    object (AppBundle)
  }
  // End of list of possible types for union field app_under_test.
}

object ( FileReference )

ضروری. APK حاوی کد آزمایشی است که باید اجرا شود.

string

بسته جاوا برای برنامه تحت آزمایش. مقدار پیش فرض با بررسی مانیفست برنامه تعیین می شود.

string

بسته جاوا برای آزمایش اجرا می شود. مقدار پیش فرض با بررسی مانیفست برنامه تعیین می شود.

string

کلاس InstrumentationTestRunner. مقدار پیش فرض با بررسی مانیفست برنامه تعیین می شود.

string

هر هدف باید به طور کامل با نام بسته یا نام کلاس، در یکی از این قالب‌ها واجد شرایط باشد:

• "نام بسته بسته"
• "class packageName.class_name"
• "class packageName.class_name#method_name"

اگر خالی باشد، تمام اهداف در ماژول اجرا خواهند شد.

enum ( OrchestratorOption )

این گزینه که آیا هر تست را با فراخوانی ابزار دقیق خود با Android Test Orchestrator اجرا کنید یا خیر. ** Orchestrator فقط با AndroidJUnitRunner نسخه 1.1 یا بالاتر سازگار است! ** ارکستراتور مزایای زیر را ارائه می دهد:

• حالت مشترک وجود ندارد
• تصادفات جدا شده اند
• سیاههها در هر آزمون محدوده می شوند

برای اطلاعات بیشتر درباره Android Test Orchestrator به https://developer.android.com/training/testing/junit-runner.html#using-android-test-orchestrator مراجعه کنید.

در صورت عدم تنظیم، آزمون بدون ارکستر اجرا می شود.

object ( ShardingOption )

گزینه ای برای اجرای آزمایش ها در چند قطعه به صورت موازی.

object ( FileReference )

APK برای برنامه تحت آزمایش.

object ( AppBundle )

بسته نرم افزاری چند apk برای برنامه تحت آزمایش.

{

  // Union field bundle can be only one of the following:
  "bundleLocation": {
    object (FileReference)
  }
  // End of list of possible types for union field bundle.
}

object ( FileReference )

فایل .aab که نشان دهنده بسته نرم افزاری تحت آزمایش است.

{

  // Union field option can be only one of the following:
  "uniformSharding": {
    object (UniformSharding)
  },
  "manualSharding": {
    object (ManualSharding)
  },
  "smartSharding": {
    object (SmartSharding)
  }
  // End of list of possible types for union field option.
}

object ( UniformSharding )

موارد آزمایشی یکنواخت خرده با توجه به تعداد کل خرده‌ها.

object ( ManualSharding )

Shards موارد را در گروه های مشخصی از بسته ها، کلاس ها و/یا متدها آزمایش می کند.

object ( SmartSharding )

تست شارد بر اساس سوابق زمان بندی مورد آزمایش قبلی.

{
  "numShards": integer
}

integer

ضروری. تعداد کل خرده‌هایی که باید ایجاد شوند. این همیشه باید یک عدد مثبت باشد که از تعداد کل موارد آزمایش بیشتر نباشد. هنگامی که یک یا چند دستگاه فیزیکی را انتخاب می کنید، تعداد خرده ها باید <= 50 باشد. وقتی یک یا چند دستگاه مجازی ARM را انتخاب می کنید، باید <= 200 باشد. هنگامی که فقط دستگاه های مجازی x86 را انتخاب می کنید، باید <= 500 باشد. .

{
  "testTargetsForShard": [
    {
      object (TestTargetsForShard)
    }
  ]
}

object ( TestTargetsForShard )

ضروری. گروهی از بسته‌ها، کلاس‌ها و/یا روش‌های آزمایشی که برای هر قطعه ایجاد شده به صورت دستی اجرا می‌شوند. در صورت وجود این فیلد، باید حداقل یک قطعه را مشخص کنید. هنگامی که یک یا چند دستگاه فیزیکی را انتخاب می کنید، تعداد تست های تکراریTargetsForShard باید <= 50 باشد. هنگامی که یک یا چند دستگاه مجازی ARM را انتخاب می کنید، باید <= 200 باشد. هنگامی که فقط دستگاه های مجازی x86 را انتخاب می کنید، باید <= باشد. 500.

{
  "testTargets": [
    string
  ]
}

string

گروهی از بسته‌ها، کلاس‌ها و/یا روش‌های آزمایشی که برای هر قطعه اجرا می‌شوند. اهداف باید در قالب آرگومان AndroidJUnitRunner مشخص شوند. به عنوان مثال، "package com.my.packages" "class com.my.package.MyClass".

تعداد testTarget باید بیشتر از 0 باشد.

{
  "targetedShardDuration": string
}

string ( Duration format)

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

پیش‌فرض: 300 ثانیه (5 دقیقه). حداقل زمان مجاز: 120 ثانیه (2 دقیقه).

تعداد خرده‌ها به صورت پویا بر اساس زمان، تا حداکثر محدودیت خرده‌ها (در زیر توضیح داده شده) تنظیم می‌شود. برای ضمانت حداقل یک مورد آزمایشی برای هر قطعه، تعداد خرده ها از تعداد موارد آزمایش تجاوز نخواهد کرد. در صورتی که:

• به حداکثر حد خرده ها رسیده است و زمان آزمایش محاسبه شده بیشتری برای تخصیص به خرده ها باقی مانده است.
• تخمین زده می شود که هر آزمایش فردی بیشتر از مدت زمان مورد نظر باشد.

مدت زمان شارد تضمینی نیست زیرا اشتراک‌گذاری هوشمند از تاریخچه موارد آزمایشی و مدت‌های پیش‌فرض استفاده می‌کند که ممکن است دقیق نباشد. قوانین برای یافتن سوابق زمان بندی مورد آزمون عبارتند از:

• اگر سرویس در 30 روز گذشته یک مورد آزمایشی را پردازش کرده باشد، از سابقه آخرین مورد آزمایشی موفق استفاده خواهد شد.
• برای موارد آزمایشی جدید، میانگین مدت سایر موارد آزمایش شناخته شده استفاده خواهد شد.
• اگر سوابق زمان‌بندی مورد آزمایش قبلی موجود نباشد، مدت زمان مورد آزمایشی پیش‌فرض 15 ثانیه است.

از آنجایی که مدت زمان واقعی قطعه ممکن است از مدت زمان خرده هدف‌گذاری شده بیشتر شود، توصیه می‌کنیم مقدار هدف را حداقل 5 دقیقه کمتر از حداکثر زمان مجاز آزمایش (45 دقیقه برای دستگاه‌های فیزیکی و 60 دقیقه برای مجازی) تنظیم کنید، یا از سفارشی استفاده کنید. مقدار وقفه آزمایشی که تنظیم کردید. این رویکرد از لغو کردن قطعه قبل از اتمام همه آزمایش ها جلوگیری می کند.

توجه داشته باشید که محدودیتی برای حداکثر تعداد خرده ها وجود دارد. هنگامی که یک یا چند دستگاه فیزیکی را انتخاب می کنید، تعداد خرده ها باید <= 50 باشد. وقتی یک یا چند دستگاه مجازی ARM را انتخاب می کنید، باید <= 200 باشد. هنگامی که فقط دستگاه های مجازی x86 را انتخاب می کنید، باید <= 500 باشد. برای ضمانت حداقل یک مورد تست برای هر قطعه، تعداد خرده ها از تعداد موارد آزمایش تجاوز نخواهد کرد. هر قطعه ایجاد شده برای سهمیه آزمون روزانه حساب می شود.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

{
  "appPackageId": string,
  "appInitialActivity": string,
  "maxDepth": integer,
  "maxSteps": integer,
  "roboDirectives": [
    {
      object (RoboDirective)
    }
  ],
  "roboMode": enum (RoboMode),
  "roboScript": {
    object (FileReference)
  },
  "startingIntents": [
    {
      object (RoboStartingIntent)
    }
  ],

  // Union field app_under_test can be only one of the following:
  "appApk": {
    object (FileReference)
  },
  "appBundle": {
    object (AppBundle)
  }
  // End of list of possible types for union field app_under_test.
}

string

بسته جاوا برای برنامه تحت آزمایش. مقدار پیش فرض با بررسی مانیفست برنامه تعیین می شود.

string

فعالیت اولیه ای که باید برای شروع برنامه استفاده شود.

integer

حداکثر عمق پشته پیمایشی که Robo می تواند کاوش کند. برای اینکه Robo برنامه را فراتر از اولین فعالیت کاوش کند، باید حداقل 2 نفر باشد. پیش فرض 50 است.

integer

حداکثر تعداد مراحلی که Robo می تواند اجرا کند. پیش فرض محدودیت ندارد.

object ( RoboDirective )

مجموعه ای از دستورالعمل ها که Robo باید در طول خزیدن اعمال شود. این به کاربران اجازه می دهد تا خزیدن را سفارشی کنند. به عنوان مثال، نام کاربری و رمز عبور برای یک حساب آزمایشی می تواند ارائه شود.

enum ( RoboMode )

حالتی که Robo باید در آن اجرا شود. اکثر مشتریان باید به سرور اجازه دهند این فیلد را به صورت خودکار پر کند.

object ( FileReference )

یک فایل JSON با دنباله ای از اقدامات Robo باید به عنوان یک پیش درآمد برای خزیدن انجام دهد.

object ( RoboStartingIntent )

اهداف مورد استفاده برای راه اندازی برنامه برای خزیدن. اگر هیچ کدام ارائه نشد، فعالیت اصلی پرتاب کننده راه اندازی می شود. اگر برخی از آنها ارائه شود، تنها موارد ارائه شده راه اندازی می شوند (فعالیت اصلی پرتابگر باید به صراحت ارائه شود).

object ( FileReference )

APK برای برنامه تحت آزمایش.

object ( AppBundle )

بسته نرم افزاری چند apk برای برنامه تحت آزمایش.

{
  "resourceName": string,
  "inputText": string,
  "actionType": enum (RoboActionType)
}

string

ضروری. نام منبع اندروید عنصر UI هدف. به عنوان مثال، در جاوا: R.string.foo در xml: @string/foo فقط به قسمت "foo" نیاز است. سند مرجع: https://developer.android.com/guide/topics/resources/accessing-resources.html

string

متنی که روبو برای تنظیم آن هدایت می شود. اگر خالی بماند، دستورالعمل به عنوان یک کلیک روی عنصر منطبق با نام منبع تلقی می شود.

enum ( RoboActionType )

ضروری. نوع عملی که Robo باید روی عنصر مشخص شده انجام دهد.

{
  "timeout": string,

  // Union field starting_intent can be only one of the following:
  "launcherActivity": {
    object (LauncherActivityIntent)
  },
  "startActivity": {
    object (StartActivityIntent)
  }
  // End of list of possible types for union field starting_intent.
}

string ( Duration format)

وقفه در ثانیه برای هر هدف.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

object ( LauncherActivityIntent )

قصدی که فعالیت اصلی لانچر را شروع می کند.

object ( StartActivityIntent )

قصدی که فعالیتی را با جزئیات خاص شروع می کند.

{
  "action": string,
  "uri": string,
  "categories": [
    string
  ]
}

string

نام اقدام. برای START_ACTIVITY مورد نیاز است.

string

URI برای اقدام.

string

مقوله‌های هدف برای تنظیم روی قصد.

{
  "appPackageId": string,
  "scenarios": [
    integer
  ],
  "scenarioLabels": [
    string
  ],

  // Union field app_under_test can be only one of the following:
  "appApk": {
    object (FileReference)
  },
  "appBundle": {
    object (AppBundle)
  }
  // End of list of possible types for union field app_under_test.
}

string

بسته جاوا برای برنامه تحت آزمایش. پیش فرض با بررسی مانیفست برنامه مشخص می شود.

integer

لیست سناریوهایی که باید در طول آزمون اجرا شوند. پیش‌فرض همه حلقه‌های آزمایشی است که از مانیفست برنامه مشتق شده‌اند.

string

لیستی از برچسب های سناریو که باید در طول آزمایش اجرا شوند. برچسب های سناریو باید به برچسب های تعریف شده در مانیفست برنامه نگاشت شوند. برای مثال، player_experience و com.google.test.loops.player_experience همه حلقه‌های برچسب‌گذاری شده در مانیفست را با نام com.google.test.loops.player_experience به اجرا اضافه می‌کنند. سناریوها را می توان در قسمت سناریوها نیز مشخص کرد.

object ( FileReference )

APK برای برنامه تحت آزمایش.

object ( AppBundle )

بسته نرم افزاری چند apk برای برنامه تحت آزمایش.

{
  "testsZip": {
    object (FileReference)
  },
  "xctestrun": {
    object (FileReference)
  },
  "xcodeVersion": string,
  "appBundleId": string,
  "testSpecialEntitlements": boolean
}

object ( FileReference )

ضروری. zip. حاوی فایل xctestrun. و محتویات دایرکتوری DerivedData/Build/Products. اگر قسمت xctestrun مشخص شده باشد، فایل .xctestrun در این فایل فشرده نادیده گرفته می شود.

object ( FileReference )

یک فایل xctestrun. که فایل .xctestrun را در فایل فشرده تست ها لغو می کند. از آنجا که فایل .xctestrun حاوی متغیرهای محیطی به همراه روش‌های تست برای اجرا و/یا نادیده گرفتن است، این می‌تواند برای آزمایش‌های اشتراک‌گذاری مفید باشد. پیش فرض از zip تست گرفته شده است.

string

نسخه Xcode که باید برای آزمایش استفاده شود. از TestEnvironmentDiscoveryService برای دریافت گزینه های پشتیبانی شده استفاده کنید. به طور پیش فرض آخرین نسخه Xcode Firebase Test Lab را پشتیبانی می کند.

string

فقط خروجی شناسه بسته نرم افزاری در حال آزمایش.

boolean

گزینه ای برای آزمایش حقوق برنامه های ویژه. تنظیم این باعث می شود که برنامه دارای حقوق ویژه با یک شناسه برنامه صریح مجدداً امضا شود. در حال حاضر از تست مجوز aps-environment پشتیبانی می کند.

{
  "appIpa": {
    object (FileReference)
  },
  "scenarios": [
    integer
  ],
  "appBundleId": string
}

object ( FileReference )

ضروری. .ipa برنامه برای تست.

integer

لیست سناریوهایی که باید در طول آزمون اجرا شوند. در صورت نامشخص بودن، سناریوی واحد 0 را پیش‌فرض می‌کند.

string

فقط خروجی شناسه بسته نرم افزاری در حال آزمایش.

{

  // Union field environment_matrix can be only one of the following:
  "androidMatrix": {
    object (AndroidMatrix)
  },
  "androidDeviceList": {
    object (AndroidDeviceList)
  },
  "iosDeviceList": {
    object (IosDeviceList)
  }
  // End of list of possible types for union field environment_matrix.
}

object ( AndroidMatrix )

ماتریسی از دستگاه های اندرویدی

object ( AndroidDeviceList )

لیستی از دستگاه های اندروید؛ تست فقط بر روی دستگاه های مشخص شده اجرا می شود.

object ( IosDeviceList )

لیستی از دستگاه های iOS.

{
  "androidModelIds": [
    string
  ],
  "androidVersionIds": [
    string
  ],
  "locales": [
    string
  ],
  "orientations": [
    string
  ]
}

string

ضروری. شناسه های مجموعه دستگاه اندروید مورد استفاده قرار می گیرد. از TestEnvironmentDiscoveryService برای دریافت گزینه های پشتیبانی شده استفاده کنید.

string

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

string

ضروری. مجموعه ای از مناطقی که دستگاه تست برای آزمایش فعال می کند. از TestEnvironmentDiscoveryService برای دریافت گزینه های پشتیبانی شده استفاده کنید.

string

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

{
  "androidDevices": [
    {
      object (AndroidDevice)
    }
  ]
}

object ( AndroidDevice )

ضروری. لیستی از دستگاه های اندرویدی

{
  "androidModelId": string,
  "androidVersionId": string,
  "locale": string,
  "orientation": string
}

string

ضروری. شناسه دستگاه اندرویدی مورد استفاده. از TestEnvironmentDiscoveryService برای دریافت گزینه های پشتیبانی شده استفاده کنید.

string

ضروری. شناسه نسخه سیستم عامل اندروید مورد استفاده. از TestEnvironmentDiscoveryService برای دریافت گزینه های پشتیبانی شده استفاده کنید.

string

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

string

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

{
  "iosDevices": [
    {
      object (IosDevice)
    }
  ]
}

object ( IosDevice )

ضروری. لیستی از دستگاه های iOS.

{
  "iosModelId": string,
  "iosVersionId": string,
  "locale": string,
  "orientation": string
}

string

ضروری. شناسه دستگاه iOS مورد استفاده. از TestEnvironmentDiscoveryService برای دریافت گزینه های پشتیبانی شده استفاده کنید.

string

ضروری. شناسه نسخه اصلی نرم افزار iOS مورد استفاده قرار می گیرد. از TestEnvironmentDiscoveryService برای دریافت گزینه های پشتیبانی شده استفاده کنید.

string

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

string

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

{
  "id": string,
  "matrixId": string,
  "projectId": string,
  "testSpecification": {
    object (TestSpecification)
  },
  "shard": {
    object (Shard)
  },
  "environment": {
    object (Environment)
  },
  "state": enum (TestState),
  "toolResultsStep": {
    object (ToolResultsStep)
  },
  "timestamp": string,
  "testDetails": {
    object (TestDetails)
  }
}

string

فقط خروجی شناسه منحصر به فرد توسط سرویس تنظیم شده است.

string

فقط خروجی شناسه حاوی TestMatrix.

string

فقط خروجی پروژه ابری که اجرای آزمایشی را در اختیار دارد.

object ( TestSpecification )

فقط خروجی نحوه اجرای آزمون

object ( Shard )

فقط خروجی جزئیات در مورد خرده.

object ( Environment )

فقط خروجی نحوه پیکربندی ماشین(های) میزبان

enum ( TestState )

فقط خروجی پیشرفت فعلی اجرای آزمایش را نشان می دهد (به عنوان مثال، FINISHED).

object ( ToolResultsStep )

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

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( TestDetails )

فقط خروجی جزئیات بیشتر در مورد آزمون در حال اجرا.

{
  "shardIndex": integer,
  "numShards": integer,
  "testTargetsForShard": {
    object (TestTargetsForShard)
  },
  "estimatedShardDuration": string
}

integer

فقط خروجی شاخص خرده در میان همه خرده ها.

integer

فقط خروجی تعداد کل خرده ها

object ( TestTargetsForShard )

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

string ( Duration format)

فقط خروجی مدت زمان تخمینی خرده بر اساس سوابق زمان‌بندی مورد آزمایش قبلی، در صورت وجود.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

{

  // Union field environment can be only one of the following:
  "androidDevice": {
    object (AndroidDevice)
  },
  "iosDevice": {
    object (IosDevice)
  }
  // End of list of possible types for union field environment.
}

object ( AndroidDevice )

دستگاه اندرویدی که باید با تست اندروید استفاده شود.

object ( IosDevice )

یک دستگاه iOS که باید با تست iOS استفاده شود.

{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "stepId": string
}

string

فقط خروجی پروژه ابری که مالک ابزار است مرحله نتایج.

string

فقط خروجی یک ابزار ID تاریخچه را نشان می دهد.

string

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

string

فقط خروجی یک ابزار ID مرحله را نتیجه می دهد.

{
  "progressMessages": [
    string
  ],
  "errorMessage": string
}

string

فقط خروجی توصیفات دقیق و قابل خواندن توسط انسان از پیشرفت آزمایش. به عنوان مثال: "تهیه یک دستگاه"، "آزمایش شروع".

در طول اجرا ممکن است داده های جدیدی به انتهای progressMessages اضافه شود.

string

فقط خروجی اگر TestState ERROR باشد، این رشته حاوی جزئیات قابل خواندن توسط انسان در مورد خطا خواهد بود.

{
  "googleCloudStorage": {
    object (GoogleCloudStorage)
  },
  "toolResultsHistory": {
    object (ToolResultsHistory)
  },
  "toolResultsExecution": {
    object (ToolResultsExecution)
  },
  "resultsUrl": string
}

object ( GoogleCloudStorage )

ضروری.

object ( ToolResultsHistory )

تاریخچه نتایج ابزار که شامل اجرای نتایج ابزار است که نتایج روی آن نوشته می شود.

در صورت عدم ارائه، سرویس مقدار مناسبی را انتخاب می کند.

object ( ToolResultsExecution )

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

string

فقط خروجی URL به نتایج در کنسول وب Firebase.

{
  "gcsPath": string
}

string

ضروری. مسیر یک دایرکتوری در GCS که در نهایت حاوی نتایج این تست خواهد بود. کاربر درخواست کننده باید دسترسی نوشتن در سطل در مسیر ارائه شده داشته باشد.

{
  "projectId": string,
  "historyId": string
}

string

ضروری. پروژه ابری که مالک ابزار تاریخچه نتایج است.

string

ضروری. یک ابزار ID تاریخچه را نشان می دهد.

{
  "projectId": string,
  "historyId": string,
  "executionId": string
}

string

فقط خروجی پروژه ابری که ابزار را در اختیار دارد اجرا می شود.

string

فقط خروجی یک ابزار ID تاریخچه را نشان می دهد.

string

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