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 )

الإخراج فقط. يصف سبب اعتبار المصفوفة غير صالحة. مفيد فقط للمصفوفات في الحالة غير الصالحة.

integer

عدد المرات التي يجب إعادة محاولة تنفيذ الاختبار فيها في حالة فشل حالة اختبار واحدة أو أكثر لأي سبب من الأسباب. الحد الأقصى لعدد عمليات إعادة التشغيل المسموح بها هو 10.

الافتراضي هو 0، مما يعني عدم إعادة التشغيل.

enum ( OutcomeSummary )

الإخراج فقط. النتيجة الإجمالية للاختبار. يتم التعيين فقط عند انتهاء حالة مصفوفة الاختبار.

boolean

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

عادةً، يتم إجراء محاولتين أو أكثر في حالة اكتشاف مشكلة محتملة في البنية الأساسية.

هذه الميزة مخصصة لأحمال العمل الحساسة لزمن الاستجابة. قد يكون حدوث حالات فشل التنفيذ أكبر بكثير بالنسبة للمصفوفات سريعة الفشل ويكون الدعم محدودًا أكثر بسبب هذا التوقع.

{
  "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 )

اختبار متطلبات الإعداد لنظام التشغيل Android، مثل الملفات المطلوب تثبيتها والبرامج النصية التمهيدية.

object ( IosTestSetup )

اختبار متطلبات الإعداد لنظام التشغيل iOS.

object ( AndroidInstrumentationTest )

اختبار أجهزة أندرويد.

object ( AndroidRoboTest )

اختبار الروبوت الروبوت.

object ( AndroidTestLoop )

تطبيق Android مع حلقة اختبار.

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 AZ 0-9 _ - . + و /

ملاحظة: سيتم توفير المسارات /sdcard و/data ومعاملتها كبدائل مسار ضمنية. على سبيل المثال، إذا لم يتم تعيين /sdcard الموجود على جهاز معين إلى وحدة تخزين خارجية، فسيقوم النظام باستبداله ببادئة مسار التخزين الخارجي لذلك الجهاز.

object ( Apk )

ملفات APK التي سيتم تثبيتها بالإضافة إلى تلك التي يتم اختبارها مباشرة. الحد الأقصى حاليا هو 100.

object ( Account )

سيتم تسجيل دخول الجهاز على هذا الحساب طوال مدة الاختبار.

string

ملف تعريف حركة مرور الشبكة المستخدم لإجراء الاختبار. يمكن الاستعلام عن ملفات تعريف الشبكة المتوفرة باستخدام نوع البيئة NETWORK_CONFIGURATION عند استدعاء TestEnvironmentDiscoveryService.GetTestEnvironmentCatalog.

object ( EnvironmentVariable )

متغيرات البيئة التي سيتم تعيينها للاختبار (تنطبق فقط على اختبارات الأجهزة).

object ( SystraceSetup )

تكوين Systrace للتشغيل. مهجور: استخدم Systrace Python 2 الذي تم إيقافه في 2020-01-01. لم يعد 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 Binary 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 الموجود على جهاز معين إلى وحدة تخزين خارجية، فسيقوم النظام باستبداله ببادئة مسار التخزين الخارجي لذلك الجهاز ونسخ الملف هناك.

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

{
  "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

ملف تعريف حركة مرور الشبكة المستخدم لإجراء الاختبار. يمكن الاستعلام عن ملفات تعريف الشبكة المتوفرة باستخدام نوع البيئة NETWORK_CONFIGURATION عند استدعاء TestEnvironmentDiscoveryService.GetTestEnvironmentCatalog.

object ( FileReference )

تطبيقات iOS المراد تثبيتها بالإضافة إلى تلك التي يتم اختبارها مباشرة.

object ( IosDeviceFile )

قائمة الملفات المطلوب دفعها إلى الجهاز قبل بدء الاختبار.

object ( IosDeviceFile )

قائمة الدلائل الموجودة على الجهاز للتحميل إلى Cloud Storage في نهاية الاختبار.

يجب أن تكون الأدلة إما في دليل مشترك (مثل /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_name"
• "اسم الحزمة فئة.class_name#method_name"

إذا كان فارغا، سيتم تشغيل كافة الأهداف في الوحدة.

enum ( OrchestratorOption )

خيار ما إذا كان سيتم تشغيل كل اختبار ضمن استدعاء الأجهزة الخاص به باستخدام Android Test Orchestrator أم لا. ** Orchestrator متوافق فقط مع الإصدار 1.1 من AndroidJUnitRunner أو أعلى! ** يقدم المنسق المزايا التالية:

• لا توجد دولة مشتركة
• الأعطال معزولة
• يتم تحديد نطاق السجلات لكل اختبار

راجع https://developer.android.com/training/testing/junit-runner.html#using-android-test-orchestrator لمزيد من المعلومات حول 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 )

اختبار Shards بناءً على سجلات توقيت حالة الاختبار السابقة.

{
  "numShards": integer
}

integer

مطلوب. إجمالي عدد القطع المراد إنشاؤها. ويجب أن يكون هذا دائمًا رقمًا موجبًا لا يزيد عن العدد الإجمالي لحالات الاختبار. عند تحديد جهاز فعلي واحد أو أكثر، يجب أن يكون عدد الأجزاء <= 50. عند تحديد جهاز ظاهري واحد أو أكثر من أجهزة ARM، يجب أن يكون العدد <= 200. عند تحديد أجهزة ظاهرية x86 فقط، يجب أن يكون العدد <= 500 .

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

object ( TestTargetsForShard )

مطلوب. مجموعة من الحزم و/أو الفئات و/أو طرق الاختبار التي سيتم تشغيلها لكل جزء تم إنشاؤه يدويًا. يجب عليك تحديد جزء واحد على الأقل في حالة وجود هذا الحقل. عند تحديد جهاز فعلي واحد أو أكثر، يجب أن يكون عدد testTargetsForShard المتكرر <= 50. عند تحديد واحد أو أكثر من أجهزة ARM الافتراضية، يجب أن يكون <= 200. عند تحديد أجهزة افتراضية x86 فقط، يجب أن يكون <= 500.

{
  "testTargets": [
    string
  ]
}

string

مجموعة من الحزم والفئات و/أو طرق الاختبار التي سيتم تشغيلها لكل جزء. يجب تحديد الأهداف بتنسيق وسيطة AndroidJUnitRunner. على سبيل المثال، "حزمة com.my.packages" "فئة com.my.package.MyClass".

يجب أن يكون عدد testTargets أكبر من 0.

{
  "targetedShardDuration": string
}

string ( Duration format)

مقدار الوقت الذي يجب أن تستغرقه الاختبارات داخل القطعة.

الافتراضي: 300 ثانية (5 دقائق). الحد الأدنى المسموح به: 120 ثانية (دقيقتان).

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

• تم الوصول إلى الحد الأقصى للجزء ويتبقى المزيد من وقت الاختبار المحسوب لتخصيصه للأجزاء.
• من المقدر أن يكون أي اختبار فردي أطول من مدة الجزء المستهدف.

مدة المشاركة غير مضمونة لأن المشاركة الذكية تستخدم سجل حالة الاختبار والمدد الافتراضية التي قد لا تكون دقيقة. قواعد العثور على سجلات توقيت حالة الاختبار هي:

• إذا قامت الخدمة بمعالجة حالة اختبار في آخر 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 استكشافه. يجب أن يكون عمرك 2 على الأقل ليتمكن Robo من استكشاف التطبيق بعد النشاط الأول. الافتراضي هو 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

مطلوب. اسم مورد android لعنصر واجهة المستخدم المستهدف. على سبيل المثال، في Java: R.string.foo في ملف xml: @string/foo مطلوب الجزء "foo" فقط. الوثيقة المرجعية: https://developer.Android.com/guide/topics/resources/accessing-resources.html

string

النص الذي تم توجيه Robo لتعيينه. إذا تركت فارغة، فسيتم التعامل مع التوجيه على أنه نقرة على العنصر المطابق لاسم المورد.

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

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

مطلوب. معرفات مجموعة أجهزة Android التي سيتم استخدامها. استخدم TestEnvironmentDiscoveryService للحصول على الخيارات المدعومة.

string

مطلوب. معرفات مجموعة إصدار نظام التشغيل Android المراد استخدامه. استخدم TestEnvironmentDiscoveryService للحصول على الخيارات المدعومة.

string

مطلوب. مجموعة اللغات التي سيقوم جهاز الاختبار بتمكينها للاختبار. استخدم TestEnvironmentDiscoveryService للحصول على الخيارات المدعومة.

string

مطلوب. مجموعة التوجهات للاختبار بها. استخدم TestEnvironmentDiscoveryService للحصول على الخيارات المدعومة.

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

object ( AndroidDevice )

مطلوب. قائمة أجهزة أندرويد.

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

string

مطلوب. معرف جهاز Android الذي سيتم استخدامه. استخدم TestEnvironmentDiscoveryService للحصول على الخيارات المدعومة.

string

مطلوب. معرف إصدار نظام التشغيل Android الذي سيتم استخدامه. استخدم 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 )

الإخراج فقط. يشير إلى التقدم الحالي في تنفيذ الاختبار (على سبيل المثال، انتهى).

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 )

جهاز Android يجب استخدامه مع اختبار Android.

object ( IosDevice )

جهاز iOS يجب استخدامه مع اختبار iOS.

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

string

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

string

الإخراج فقط. معرف سجل نتائج الأداة.

string

الإخراج فقط. معرف تنفيذ نتائج الأداة.

string

الإخراج فقط. معرف خطوة نتائج الأداة.

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

string

الإخراج فقط. وصف تفصيلي يمكن قراءته بواسطة الإنسان لتقدم الاختبار. على سبيل المثال: "توفير جهاز"، "بدء الاختبار".

أثناء التنفيذ، قد يتم إلحاق بيانات جديدة بنهاية رسائل التقدم.

string

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

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

object ( GoogleCloudStorage )

مطلوب.

object ( ToolResultsHistory )

سجل نتائج الأداة الذي يحتوي على تنفيذ نتائج الأداة التي تتم كتابة النتائج إليها.

إذا لم يتم توفيرها، سيتم اختيار الخدمة القيمة المناسبة.

object ( ToolResultsExecution )

الإخراج فقط. تنفيذ نتائج الأداة التي تتم كتابة النتائج عليها.

string

الإخراج فقط. عنوان URL للنتائج في Firebase Web Console.

{
  "gcsPath": string
}

string

مطلوب. المسار إلى الدليل في GCS الذي سيحتوي في النهاية على نتائج هذا الاختبار. يجب أن يكون لدى المستخدم الطالب حق الوصول للكتابة على المجموعة الموجودة في المسار المتوفر.

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

string

مطلوب. المشروع السحابي الذي يمتلك سجل نتائج الأداة.

string

مطلوب. معرف سجل نتائج الأداة.

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

string

الإخراج فقط. المشروع السحابي الذي يمتلك الأداة يؤدي إلى التنفيذ.

string

الإخراج فقط. معرف سجل نتائج الأداة.

string

الإخراج فقط. معرف تنفيذ نتائج الأداة.