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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

enum (InvalidMatrixDetails)

เอาต์พุตเท่านั้น อธิบายสาเหตุที่ระบบถือว่าเมทริกซ์ไม่ถูกต้อง มีประโยชน์สำหรับเมทริกซ์ที่อยู่ในสถานะไม่ถูกต้องเท่านั้น

integer

จำนวนครั้งที่ TestExecution ควรทำอีกครั้งหากกรอบการทดสอบอย่างน้อย 1 กรณีล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จำนวนการฉายซ้ำสูงสุดที่อนุญาตคือ 10 รอบ

ค่าเริ่มต้นคือ 0 ซึ่งหมายความว่าไม่มีการเรียกใช้ซ้ำ

enum (OutcomeSummary)

เอาต์พุตเท่านั้น ผลลัพธ์โดยรวมของการทดสอบ ระบบจะตั้งค่าเมื่อสถานะเมทริกซ์ทดสอบเป็น FINISHED เท่านั้น

boolean

หากเป็น "จริง" ระบบจะพยายามเรียกใช้การดำเนินการ/ชาร์ดแต่ละรายการในเมทริกซ์เป็นไม่เกิน 1 ครั้งเท่านั้น ทั้งนี้ ความพยายามทดสอบที่ไม่น่าเชื่อถือจะไม่ได้รับผลกระทบ

โดยปกติแล้วจะพยายามอย่างน้อย 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 นาที

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" เช่น "3.5s"

boolean

ปิดการบันทึกวิดีโอ อาจลดเวลาในการตอบสนองของการทดสอบ

boolean

ปิดการบันทึกเมตริกประสิทธิภาพ อาจลดเวลาในการตอบสนองของการทดสอบ

object (TestSetup)

ทดสอบข้อกำหนดในการตั้งค่าสำหรับ Android เช่น ไฟล์ที่จะติดตั้ง สคริปต์ Bootstrap

object (IosTestSetup)

ข้อกำหนดในการตั้งค่าการทดสอบสำหรับ iOS

object (AndroidInstrumentationTest)

การทดสอบการใช้เครื่องมือ Android

object (AndroidRoboTest)

การทดสอบ Android Robo

object (AndroidTestLoop)

แอปพลิเคชัน Android ที่มี Test Loop

object (IosXcTest)

iOS XCTest ผ่านไฟล์ .xctestrun

object (IosTestLoop)

แอปพลิเคชัน iOS ที่มี Test Loop

{
  "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 ชื่อเส้นทางถูกจำกัดไว้เฉพาะอักขระ a-z A-Z 0-9 _ - + และ /

หมายเหตุ: เส้นทาง /sdcard และ /data จะพร้อมใช้งานและถือเป็นการแทนเส้นทางโดยนัย ตัวอย่างเช่น ถ้า /sdcard บนอุปกรณ์ใดอุปกรณ์หนึ่งไม่ได้จับคู่กับที่จัดเก็บข้อมูลภายนอก ระบบจะแทนที่ /sdcard ด้วยคำนำหน้าเส้นทางที่จัดเก็บข้อมูลภายนอกสำหรับอุปกรณ์นั้น

object (Apk)

APK ที่จะติดตั้งนอกเหนือจาก APK ที่จะทดสอบโดยตรง ปัจจุบันจำกัดที่ 100 คน

object (Account)

อุปกรณ์จะเข้าสู่ระบบบัญชีนี้ตลอดระยะเวลาการทดสอบ

string

โปรไฟล์การจราจรของข้อมูลในเครือข่ายที่ใช้สำหรับทำการทดสอบ ค้นหาโปรไฟล์เครือข่ายที่พร้อมใช้งานได้โดยใช้ประเภทสภาพแวดล้อม NETWORK_CONFIGURATION เมื่อเรียกใช้ TestEnvironmentDiscoveryService.GetTestEnvironmentCatalog

object (EnvironmentVariable)

ตัวแปรสภาพแวดล้อมที่จะตั้งค่าสำหรับการทดสอบ (ใช้ได้เฉพาะสำหรับการทดสอบการวัดคุม)

object (SystraceSetup)

การกำหนดค่า Systrace สำหรับการเรียกใช้ เลิกใช้งานแล้ว: Systrace ใช้ Python 2 ซึ่งหยุดให้บริการไปเมื่อวันที่ 01-01-2020 Cloud Testing API ไม่รองรับ Systrace อีกต่อไป และจะไม่ส่งไฟล์ 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)

ต้องระบุ ไฟล์ Opaque 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 บนอุปกรณ์ใดอุปกรณ์หนึ่งไม่ได้จับคู่กับที่จัดเก็บข้อมูลภายนอก ระบบจะแทนที่ /sdcard ด้วยคำนำหน้าเส้นทางที่จัดเก็บข้อมูลภายนอกสำหรับอุปกรณ์นั้น และคัดลอกไฟล์ลงในนั้น

ขอแนะนำให้ใช้ Environment API ในแอปและโค้ดทดสอบเพื่อเข้าถึงไฟล์ในอุปกรณ์แบบพกพา

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

object (FileReference)

เส้นทางไปยัง APK ที่จะติดตั้งในอุปกรณ์ก่อนเริ่มการทดสอบ

string

แพ็กเกจ Java สำหรับ APK ที่จะติดตั้ง ค่านี้กำหนดโดยการตรวจสอบไฟล์ Manifest ของแอปพลิเคชัน

{

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

บัญชีที่เข้าสู่ระบบ Google โดยอัตโนมัติ

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

string

คีย์สำหรับตัวแปรสภาพแวดล้อม

string

ค่าสำหรับตัวแปรสภาพแวดล้อม

{
  "durationSeconds": integer
}

integer

ระยะเวลา Systrace เป็นวินาที ควรอยู่ระหว่าง 1 ถึง 30 วินาที 0 จะปิดใช้ Systrace

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

แพ็กเกจ Java สำหรับแอปพลิเคชันที่อยู่ระหว่างการทดสอบ ค่าเริ่มต้นจะกำหนดโดยการตรวจสอบไฟล์ Manifest ของแอปพลิเคชัน

string

แพ็กเกจ Java สำหรับทดสอบที่จะดำเนินการ ค่าเริ่มต้นจะกำหนดโดยการตรวจสอบไฟล์ Manifest ของแอปพลิเคชัน

string

คลาส InstrumentationTestRunner ค่าเริ่มต้นจะกำหนดโดยการตรวจสอบไฟล์ Manifest ของแอปพลิเคชัน

string

เป้าหมายแต่ละรายการต้องเป็นแบบเต็มด้วยชื่อแพ็กเกจหรือชื่อคลาสในรูปแบบใดรูปแบบหนึ่งต่อไปนี้

• "ชื่อแพ็กเกจชื่อแพ็กเกจ"
• "class packageName.class_name"
• "class packageName.class_name#method_name"

หากเว้นว่างไว้ เป้าหมายทั้งหมดในโมดูลจะทำงาน

enum (OrchestratorOption)

ตัวเลือกว่าจะเรียกใช้การทดสอบแต่ละรายการภายในการเรียกใช้เครื่องมือของตนเองกับ Android Test Orchestrator หรือไม่ ** Orchestrator ใช้งานได้กับ AndroidJUnitRunner เวอร์ชัน 1.1 ขึ้นไปเท่านั้น ** Orchestrator มีประโยชน์ดังต่อไปนี้

• ไม่มีสถานะที่แชร์
• ข้อขัดข้องจะแยกเป็นบางส่วน
• ระบบจะกำหนดขอบเขตบันทึกต่อการทดสอบ

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Android Test Orchestrator ได้ที่ https://developer.android.com/training/testing/junit-runner.html#using-android-test-orchestrator

หากไม่ได้ตั้งค่า การทดสอบจะทํางานโดยไม่มี Orchestrator

object (ShardingOption)

ตัวเลือกในการเรียกใช้การทดสอบในชาร์ดหลายรายการพร้อมกัน

object (FileReference)

APK สำหรับแอปพลิเคชันที่อยู่ระหว่างการทดสอบ

object (AppBundle)

App Bundle ที่มี 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 ที่แสดงถึง App Bundle ที่อยู่ภายใต้การทดสอบ

{

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

กรณีการทดสอบชาร์ดลงในกลุ่มของแพ็กเกจ คลาส และ/หรือเมธอดที่ระบุ

object (SmartSharding)

การทดสอบชาร์ดตามบันทึกการจับเวลาของกรอบการทดสอบก่อนหน้า

{
  "numShards": integer
}

integer

ต้องระบุ จำนวนชาร์ดทั้งหมดที่จะสร้าง ซึ่งจะต้องเป็นจำนวนบวกที่ไม่เกินจำนวนกรอบการทดสอบทั้งหมดเสมอ เมื่อคุณเลือกอุปกรณ์จริงอย่างน้อย 1 เครื่อง จำนวนชาร์ดต้องน้อยกว่า 50 เมื่อเลือกอุปกรณ์เสมือน ARM อย่างน้อย 1 เครื่อง อุปกรณ์นั้นต้องมีค่า <= 200 เมื่อเลือกเฉพาะอุปกรณ์เสมือน x86 อุปกรณ์นั้นต้องมีค่า <= 500

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

object (TestTargetsForShard)

ต้องระบุ กลุ่มของแพ็กเกจ คลาส และ/หรือวิธีการทดสอบที่จะเรียกใช้สำหรับชาร์ดที่สร้างด้วยตนเองแต่ละรายการ คุณต้องระบุชาร์ดอย่างน้อย 1 รายการหากมีช่องนี้อยู่ เมื่อคุณเลือกอุปกรณ์จริงอย่างน้อย 1 เครื่อง จำนวน testTargetsForShard ซ้ำต้อง <= 50 เมื่อเลือกอุปกรณ์เสมือน ARM อย่างน้อย 1 เครื่อง อุปกรณ์นั้นต้องมีค่า <= 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 นาที)

ระบบจะตั้งค่าจำนวนชาร์ดแบบไดนามิกตามเวลาที่ขึ้นอยู่กับจำนวนชาร์ดสูงสุด (คำอธิบายอยู่ด้านล่าง) เพื่อรับประกันกรอบการทดสอบอย่างน้อย 1 รายการสำหรับชาร์ดแต่ละรายการ จำนวนชาร์ดจะไม่เกินจำนวนกรอบการทดสอบ ระยะเวลาของชาร์ดจะเกินกำหนดในกรณีต่อไปนี้

• ถึงขีดจำกัดของชาร์ดสูงสุดแล้ว และเหลือเวลาทดสอบที่คำนวณได้เพิ่มเติมเพื่อจัดสรรไปยังชาร์ด
• การทดสอบแต่ละครั้งมีการประมาณว่านานกว่าระยะเวลาของชาร์ดเป้าหมาย

ระบบไม่รับประกันระยะเวลาของชาร์ดเนื่องจาก Smart Shard ใช้ประวัติกรอบการทดสอบและระยะเวลาเริ่มต้นซึ่งอาจไม่ถูกต้อง กฎในการค้นหาระเบียนเวลาของกรอบการทดสอบมีดังนี้

• หากบริการได้ประมวลผลกรอบการทดสอบในช่วง 30 วันที่ผ่านมา ระบบจะใช้บันทึกของกรอบการทดสอบที่สำเร็จล่าสุด
• สำหรับกรอบการทดสอบใหม่ ระบบจะใช้ระยะเวลาเฉลี่ยของกรอบการทดสอบอื่นๆ ที่ทราบ
• หากไม่มีบันทึกการจับเวลาของกรอบการทดสอบก่อนหน้า ระยะเวลาเริ่มต้นของกรอบการทดสอบคือ 15 วินาที

เนื่องจากระยะเวลาชาร์ดจริงอาจเกินระยะเวลาของชาร์ดเป้าหมาย เราจึงขอแนะนำให้คุณตั้งค่าเป้าหมายอย่างน้อย 5 นาทีต่ำกว่าระยะหมดเวลาทดสอบสูงสุดที่อนุญาต (45 นาทีสำหรับอุปกรณ์จริง และ 60 นาทีสำหรับเสมือน) หรือคุณอาจใช้ค่าการหมดเวลาการทดสอบที่กำหนดเองที่ตั้งไว้ วิธีนี้จะหลีกเลี่ยงการยกเลิกชาร์ดก่อนที่การทดสอบทั้งหมดจะเสร็จสมบูรณ์

โปรดทราบว่าจำนวนชาร์ดสูงสุดมีขีดจำกัด เมื่อคุณเลือกอุปกรณ์จริงอย่างน้อย 1 เครื่อง จำนวนชาร์ดต้องน้อยกว่า 50 เมื่อเลือกอุปกรณ์เสมือน ARM อย่างน้อย 1 เครื่อง อุปกรณ์นั้นต้องมีค่า <= 200 เมื่อเลือกเฉพาะอุปกรณ์เสมือน x86 อุปกรณ์นั้นต้องมีค่า <= 500 เพื่อรับประกันกรอบการทดสอบอย่างน้อย 1 รายการต่อชาร์ด จำนวนชาร์ดจะไม่เกินจำนวนกรอบการทดสอบ ชาร์ดที่สร้างขึ้นแต่ละรายการจะนับรวมในโควต้าการทดสอบรายวัน

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "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

แพ็กเกจ Java สำหรับแอปพลิเคชันที่อยู่ระหว่างการทดสอบ ค่าเริ่มต้นจะกำหนดโดยการตรวจสอบไฟล์ Manifest ของแอปพลิเคชัน

string

กิจกรรมเริ่มต้นที่ควรใช้ในการเริ่มต้นแอป

integer

ความลึกสูงสุดของสแต็ก Traversal ที่ Robo สำรวจได้ อย่างน้อย 2 คนเพื่อให้ Robo สำรวจแอปได้เกินกว่ากิจกรรมแรก ค่าเริ่มต้นคือ 50

integer

จำนวนสูงสุดของขั้นตอนที่ Robo ทำได้ ไม่มีขีดจำกัดเริ่มต้น

object (RoboDirective)

ชุดคำสั่งที่ Robo ควรใช้ในระหว่างการรวบรวมข้อมูล ซึ่งจะช่วยให้ผู้ใช้ปรับแต่งการ Crawl ได้ เช่น ระบุชื่อผู้ใช้และรหัสผ่านของบัญชีทดสอบได้

enum (RoboMode)

โหมดที่ Robo ควรทำงาน ไคลเอ็นต์ส่วนใหญ่ควรอนุญาตให้เซิร์ฟเวอร์ป้อนข้อมูลในช่องนี้โดยอัตโนมัติ

object (FileReference)

ไฟล์ JSON ที่มีลำดับการดำเนินการ Robo ควรทำหน้าที่เป็นอารัมภบทสำหรับการรวบรวมข้อมูล

object (RoboStartingIntent)

Intent ที่ใช้เพื่อเปิดแอปสำหรับการรวบรวมข้อมูล หากไม่ได้ให้ไว้ ระบบจะเริ่มกิจกรรมหลักของ Launcher หากมีบางรายการ ระบบจะเปิดใช้งานเฉพาะรายการที่ระบุไว้เท่านั้น (ต้องระบุกิจกรรมของ Launcher หลักอย่างชัดเจน)

object (FileReference)

APK สำหรับแอปพลิเคชันที่อยู่ระหว่างการทดสอบ

object (AppBundle)

App Bundle ที่มี APK หลายรายการสำหรับแอปพลิเคชันที่อยู่ระหว่างการทดสอบ

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

string

ต้องระบุ ชื่อทรัพยากร Android ขององค์ประกอบ UI เป้าหมาย ตัวอย่างเช่น ใน Java: R.string.foo ใน xml: @string/foo ต้องใส่ส่วน "foo" เท่านั้น เอกสารอ้างอิง: https://developer.android.com/guide/topics/resources/accessing-resources.html

string

ข้อความที่ Robo ได้รับการตั้งค่า หากเว้นว่างไว้ ระบบจะถือว่าคำสั่งเป็นการคลิกองค์ประกอบที่ตรงกับ resourceName

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)

ระยะหมดเวลาในหน่วยวินาทีสำหรับแต่ละ Intent

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" เช่น "3.5s"

object (LauncherActivityIntent)

Intent ที่เริ่มต้นกิจกรรมหลักของ Launcher

object (StartActivityIntent)

Intent ที่เริ่มกิจกรรมด้วยรายละเอียดที่เฉพาะเจาะจง

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

แพ็กเกจ Java สำหรับแอปพลิเคชันที่อยู่ระหว่างการทดสอบ ค่าเริ่มต้นจะกำหนดโดยการตรวจสอบไฟล์ Manifest ของแอปพลิเคชัน

integer

รายการสถานการณ์ที่ควรใช้ระหว่างการทดสอบ ค่าเริ่มต้นคือ Test Loop ทั้งหมด ซึ่งดึงมาจากไฟล์ Manifest ของแอปพลิเคชัน

string

รายการป้ายกำกับสถานการณ์ที่ควรใช้ระหว่างการทดสอบ ป้ายกำกับสถานการณ์ควรแมปกับป้ายกำกับที่กำหนดในไฟล์ Manifest ของแอปพลิเคชัน ตัวอย่างเช่น Player_experience และ com.google.test.loops.player_experience จะเพิ่มลูปทั้งหมดที่มีป้ายกำกับในไฟล์ Manifest ด้วยชื่อ com.google.test.loops.player_experience ในการเรียกใช้ นอกจากนี้ คุณยังระบุสถานการณ์ในช่องสถานการณ์ได้อีกด้วย

object (FileReference)

APK สำหรับแอปพลิเคชันที่อยู่ระหว่างการทดสอบ

object (AppBundle)

App Bundle ที่มี APK หลายรายการสำหรับแอปพลิเคชันที่อยู่ระหว่างการทดสอบ

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

object (FileReference)

ต้องระบุ ไฟล์ .zip ที่มีไฟล์ .xctestrun และเนื้อหาของไดเรกทอรี DerivedData/Build/Products ระบบจะละเว้นไฟล์ .xctestrun ในไฟล์ ZIP นี้หากระบุช่อง xctestrun

object (FileReference)

ไฟล์ .xctestrun ที่จะลบล้างไฟล์ .xctestrun ในไฟล์ ZIP ของการทดสอบ เนื่องจากไฟล์ .xctestrun มีตัวแปรสภาพแวดล้อมพร้อมกับวิธีการทดสอบที่จะเรียกใช้และ/หรือละเว้น จึงอาจเป็นประโยชน์ต่อการชาร์ดดิ้งการทดสอบ ค่าเริ่มต้นจะดึงมาจากไฟล์ ZIP ของการทดสอบ

string

Xcode เวอร์ชันที่ควรใช้สำหรับการทดสอบ ใช้ TestEnvironmentDiscoveryService เพื่อรับตัวเลือกที่รองรับ ค่าเริ่มต้นเป็น Xcode เวอร์ชันล่าสุดที่ Firebase Test Lab รองรับ

string

เอาต์พุตเท่านั้น รหัสชุดของแอปพลิเคชันที่อยู่ระหว่างทดสอบ

boolean

ตัวเลือกสำหรับทดสอบการให้สิทธิ์พิเศษของแอป การตั้งค่านี้จะลงนามแอปอีกครั้งที่มีสิทธิ์พิเศษด้วยตัวระบุแอปพลิเคชันที่ชัดเจน ปัจจุบันรองรับการให้สิทธิ์สภาพแวดล้อมแอปสำหรับการทดสอบ

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

เมทริกซ์ของอุปกรณ์ Android

object (AndroidDeviceList)

รายชื่ออุปกรณ์ Android การทดสอบจะทำงานเฉพาะในอุปกรณ์ที่ระบุ

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)

ต้องระบุ รายการอุปกรณ์ Android

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

เอาต์พุตเท่านั้น ระบุความคืบหน้าปัจจุบันของการดำเนินการทดสอบ (เช่น FINISHED)

object (ToolResultsStep)

เอาต์พุตเท่านั้น ตำแหน่งที่เขียนผลลัพธ์ของการดำเนินการนี้

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่การดำเนินการทดสอบนี้สร้างขึ้นเป็นครั้งแรก

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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)

เอาต์พุตเท่านั้น ระยะเวลาชาร์ดโดยประมาณที่อิงตามบันทึกเวลาของกรอบการทดสอบก่อนหน้า หากมี

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "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

เอาต์พุตเท่านั้น คำอธิบายรายละเอียดของความคืบหน้าของการทดสอบที่มนุษย์อ่านได้ เช่น "การจัดสรรอุปกรณ์" "การเริ่มต้นการทดสอบ"

ในระหว่างการดำเนินการ คุณสามารถมีข้อมูลใหม่ต่อท้าย 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

ต้องระบุ รหัสประวัติผลลัพธ์ของเครื่องมือ

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

string

เอาต์พุตเท่านั้น โปรเจ็กต์ระบบคลาวด์ที่เป็นเจ้าของการดำเนินการผลลัพธ์ของเครื่องมือ

string

เอาต์พุตเท่านั้น รหัสประวัติผลลัพธ์ของเครื่องมือ

string

เอาต์พุตเท่านั้น รหัสการดำเนินการผลลัพธ์ของเครื่องมือ