คู่มืออ้างอิงสคริปต์ Robo

เอกสารนี้มีข้อมูลอ้างอิงเกี่ยวกับสคริปต์ Robo ซึ่งรวมถึงโครงสร้าง ความสามารถ การใช้งาน การบันทึก และการดำเนินการ สคริปต์ Robo คือการทดสอบที่ทำงานด้านการรับประกันคุณภาพด้วยตนเอง (QA) สำหรับแอปบนอุปกรณ์เคลื่อนที่โดยอัตโนมัติ และเปิดใช้การผสานรวมอย่างต่อเนื่อง (CI) และกลยุทธ์การทดสอบก่อนการเปิดตัว โรบอสกริปต์คือไฟล์ JSON ที่อธิบายลำดับอินเทอร์เฟซผู้ใช้ (UI) และการดำเนินการอื่นๆ

คุณสามารถสร้างสคริปต์ Robo ด้วยวิธีต่อไปนี้

• ใช้ฟีเจอร์การบันทึกสคริปต์อัตโนมัติ (Android เท่านั้น)

• สร้างสคริปต์ Robo ด้วยตนเอง (Android และ iOS+)

• บันทึกสคริปต์ Robo แล้วแก้ไขด้วยตนเอง (Android เท่านั้น)

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้สคริปต์ Robo ได้ที่เรียกใช้สคริปต์ Robo

บทนำ

สคริปต์ Robo มีไว้สำหรับการทดสอบ Robo พร้อมกับอินพุตอื่นๆ เช่น Android Application Package (APK) ภายใต้การทดสอบแอปที่ต่ำกว่าการทดสอบ

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

[
  {
    "crawlStage": "crawl",
    "contextDescriptor": {
      "condition": "app_under_test_shown"
    },
    "actions": [
      {
        "eventType": "VIEW_TEXT_CHANGED",
        "replacementText": "user123",
        "elementDescriptors": [
          {
            "resourceId": "my.app.package:id/username"
          }
        ]
      },
      {
        "eventType": "VIEW_TEXT_CHANGED",
        "replacementText": "12345",
        "elementDescriptors": [
          {
            "resourceId": "my.app.package:id/password"
          }
        ]
      },
      {
        "eventType": "VIEW_CLICKED",
        "elementDescriptors": [
          {
            "resourceId": "my.app.package:id/login"
          }
        ]
      }
    ]
  }
]

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

[
  {
    "eventType": "VIEW_TEXT_CHANGED",
    "replacementText": "user123",
    "elementDescriptors": [
      {
        "resourceId": "my.app.package:id/username"
      }
    ]
  },
  {
    "eventType": "VIEW_TEXT_CHANGED",
    "replacementText": "12345",
    "elementDescriptors": [
      {
        "resourceId": "my.app.package:id/password"
      }
    ]
  },
  {
    "eventType": "VIEW_CLICKED",
    "elementDescriptors": [
      {
        "resourceId": "my.app.package:id/login"
      }
    ]
  }
]

การรองรับสคริปต์ Robo ใน iOS ขึ้นไป

Robo สำหรับ iOS ขึ้นไป (เบต้า) มีการรองรับแบบจํากัดสําหรับสคริปต์ Robo ไวยากรณ์สคริปต์ Robo สำหรับ iOS ขึ้นไปจะเหมือนกับไวยากรณ์ของ Android และฟีเจอร์ที่รองรับของ iOS ขึ้นไปจะทำงานคล้ายกับฟีเจอร์ของ Android

iOS ขึ้นไปรองรับการดำเนินการต่อไปนี้

• การยืนยัน
• คลิก
• คลิกค้าง
• การปัดหน้าจอ
• ละเว้นองค์ประกอบทั้งหมด
• รอ
• ถ่ายภาพหน้าจอ
• สิ้นสุดการ Crawl

แอตทริบิวต์การระบุต่อไปนี้ในข้อบ่งชี้องค์ประกอบได้รับการสนับสนุนใน iOS+

• ชื่อชั้นเรียน
• ชื่อคลาสบรรพบุรุษ
• คำอธิบายเนื้อหา (และนิพจน์ทั่วไป)
• ข้อความ (และนิพจน์ทั่วไป)

เงื่อนไขทริกเกอร์ในคําอธิบายบริบทที่รองรับใน iOS ขึ้นไปมีดังนี้

• แอปที่อยู่ระหว่างการทดสอบแสดงอยู่
• องค์ประกอบแสดงอยู่
• ดำเนินการสคริปต์ที่ไม่ใช่ Robo

โครงสร้าง

สคริปต์ Robo มีพร็อพเพอร์ตี้หลายรายการที่อธิบายวิธีการทำงานของ Robo แอตทริบิวต์ส่วนใหญ่เหล่านี้เป็นค่าที่ไม่บังคับโดยมีค่าเริ่มต้นที่กําหนดไว้ล่วงหน้า

ไฟล์หนึ่งจะมีคอลเล็กชันสคริปต์ Robo อย่างน้อย 1 รายการ

ต่อไปนี้คือตัวอย่างไฟล์ที่มีสคริปต์ Robo แบบไม่มีเงื่อนไข 2 รายการ โดยแต่ละรายการมีการดำเนินการเดียวที่ทำงานเพียงครั้งเดียวเมื่อเริ่มต้นการ Crawl

[
  {
    "id": 1000,
    "description": "My first Robo script",
    "actions": [
      {
        "eventType": "DISABLE_KEYBOARD"
      }
    ]
  },
  {
    "id": 1001,
    "description": "My second Robo script",
    "actions": [
      {
        "eventType": "PRESSED_BACK"
      }
    ]
  }
]

ข้อบ่งชี้บริบท

ตัวบ่งชี้บริบทจะกําหนดบริบทหรือเงื่อนไขที่ทริกเกอร์ Roboscript โดยใช้แอตทริบิวต์อย่างน้อย 1 รายการหรือหลายรายการร่วมกัน ดังนี้

ต่อไปนี้คือตัวอย่างสคริปต์ Robo ที่ทริกเกอร์โดยวิดเจ็ต UI ที่มีรหัสทรัพยากร "my.app.package:id/page_header" ปรากฏบนหน้าจอ

{
  "id": 1000,
  "contextDescriptor": {
    "condition": "element_present",
    "elementDescriptors": [
      {
        "resourceId": "my.app.package:id/page_header"
      }
    ]
  },
  "actions": [
    {
      "eventType": "VIEW_CLICKED",
      "elementDescriptors": [
        {
          "text": "Settings"
        }
      ]
    }
  ]
}

ต่อไปนี้คือตัวอย่างสคริปต์ Robo ที่ทริกเกอร์โดย "Privacy Policy" ที่ตรวจพบโดยการรู้จำอักขระด้วยภาพ (OCR)

{
  "id": 1000,
  "description": "Vision text Robo script",
  "contextDescriptor": {
    "condition": "element_present",
    "visionText": "Privacy Policy"
  },
  "actions": [
    {
      "eventType": "VIEW_CLICKED",
      "visionText": "Privacy Policy"
    }
  ]
}

ต่อไปนี้คือตัวอย่างสคริปต์ Robo ที่รอ 5 วินาทีหลังจากการดำเนินการ Robo ที่ไม่ใช้สคริปต์ทุกครั้ง

{
  "contextDescriptor": {
    "condition": "non_roboscript_action_performed"
  },
  "maxNumberOfRuns" : 1000,
  "actions" : [
    {
      "eventType" : "DELAYED_MESSAGE_POSTED",
      "delayTime" : 5000
    }]
}

การดำเนินการ

การดําเนินการแต่ละรายการในสคริปต์ Robo จะแสดงเป็นกลุ่มของคู่แอตทริบิวต์-ค่าอย่างน้อย 1 คู่ตามที่อธิบายไว้ในตารางต่อไปนี้

ต่อไปนี้คือตัวอย่างสคริปต์ Robo ที่มีการดำเนินการ 2 รายการโดยไม่มีวิดเจ็ต UI เป้าหมาย ซึ่งหมายความว่าการดำเนินการเหล่านี้จะไม่ทำงานกับวิดเจ็ต UI ที่เฉพาะเจาะจง

[
  {
    "eventType": "DELAYED_MESSAGE_POSTED",
    "delayTime": 3000
  },
  {
    "eventType": "PRESSED_BACK"
  }
]

ข้อบ่งชี้องค์ประกอบ

ตัวระบุองค์ประกอบจะระบุวิดเจ็ต UI โดยใช้แอตทริบิวต์ระบุอย่างน้อย 1 รายการต่อไปนี้

บ่อยครั้งที่แอตทริบิวต์เหล่านี้ไม่มีการกำหนด เช่น ปุ่มอาจไม่มีข้อความและคําอธิบายเนื้อหา แม้ว่าจะมีค่าแอตทริบิวต์บางค่า แต่ค่าเหล่านั้นอาจไม่ซ้ำกันในหน้าจอแอปหนึ่งๆ (รวมถึง resourceId)

ตัวอย่างเช่น โดยทั่วไปแล้ว ความแตกต่างระหว่างรายการของรายการหนึ่งๆ จะทำได้โดยใช้ตําแหน่งรายการย่อยที่แตกต่างกันภายในวิดเจ็ตหลักเท่านั้น ซึ่งหมายความว่าการใช้ตัวบ่งชี้องค์ประกอบเพียงรายการเดียวเพื่อระบุวิดเจ็ต UI มักจะไม่เพียงพอ ดังนั้น แอตทริบิวต์ elementDescriptors ของการดำเนินการจึงมีลําดับของคําอธิบายองค์ประกอบที่จัดเรียงไว้เพื่อให้รายการแรกสอดคล้องกับวิดเจ็ต UI เป้าหมาย รายการที่ 2 สอดคล้องกับวิดเจ็ตหลักของวิดเจ็ต UI เป้าหมาย และอื่นๆ ระบบจะจับคู่วิดเจ็ต UI เป้าหมายของการดำเนินการเมื่อตัวบ่งชี้องค์ประกอบทั้งหมดตรงกับลําดับชั้นย่อยของวิดเจ็ต UI ที่เกี่ยวข้อง

ต่อไปนี้คือตัวอย่างสคริปต์ Robo ที่มีการเปลี่ยนแปลงข้อความและการดําเนินการคลิก ซึ่งทั้ง 2 อย่างกำหนดให้คุณระบุวิดเจ็ต UI เป้าหมายโดยใช้ตัวระบุองค์ประกอบที่ระบุ

[
  {
    "eventType": "VIEW_TEXT_CHANGED",
    "replacementText": "John",
    "elementDescriptors": [
      {
        "className": "android.support.v7.widget.AppCompatEditText",
        "groupViewChildPosition": 0,
        "resourceId": "com.google.samples.apps.topeka:id/first_name"
      },
      {
        "className": "android.widget.FrameLayout",
        "groupViewChildPosition": 0
      },
      {
        "className": "android.support.design.widget.TextInputLayout",
        "groupViewChildPosition": 1
      }
    ]
  },
  {
    "eventType": "VIEW_CLICKED",
    "elementDescriptors": [
      {
        "className": "android.support.design.widget.FloatingActionButton",
        "groupViewChildPosition": 1,
        "resourceId": "com.google.samples.apps.topeka:id/done"
      },
      {
        "className": "android.widget.FrameLayout",
        "groupViewChildPosition": 1,
        "resourceId": "com.google.samples.apps.topeka:id/content"
      },
      {
        "className": "android.widget.FrameLayout",
        "groupViewChildPosition": 0,
        "resourceId": "com.google.samples.apps.topeka:id/sign_in_content"
      }
    ]
  }
]

ตัวเลือกการดําเนินการ

คุณอาจใส่ออบเจ็กต์ JSON ที่ระบุตัวเลือกการดำเนินการสำหรับสคริปต์ Robo นั้นไว้หน้ารายการการดำเนินการในสคริปต์ Robo ก็ได้ ส่วนหัวการกําหนดค่านี้ขึ้นต้นด้วยคีย์เวิร์ด roboscript ตามด้วยการแสดง JSON ของตัวเลือกการเรียกใช้ที่ต้องการ

สคริปต์ Robo รองรับตัวเลือกการดำเนินการต่อไปนี้

• executionMode - ตัวเลือกการดำเนินการที่ใช้เมื่อสคริปต์ Robo กำลังทำงาน
  • strict - หากตั้งค่าเป็น true สคริปต์ Robo จะไม่ใช้การจับคู่บางส่วน การข้ามการดำเนินการปัจจุบัน และการระงับ กล่าวคือ สคริปต์ Robo จะทำงานเป็นการทดสอบการใช้เครื่องมือตามปกติ และจะล้มเหลวทันทีที่ไม่สามารถดำเนินการใดๆ ได้ โดยค่าเริ่มต้นจะเป็น false
  • dismiss_popups - หากตั้งค่าเป็น true การทดสอบ Robo จะปิดกล่องโต้ตอบที่ไม่คาดคิดขณะเรียกใช้สคริปต์ Robo แม้ในโหมด strict ก็ตาม ตัวเลือกนี้จะไม่มีผลเมื่อไม่ได้อยู่ในโหมด strict โดยค่าเริ่มต้นจะเป็น false
  • notify - หากตั้งค่าเป็น false สคริปต์ Robo จะไม่แสดงการแจ้งเตือนบนหน้าจอเมื่อเริ่มต้นและสิ้นสุดการเรียกใช้ โดยค่าเริ่มต้นจะเป็น true
• postscript - ตัวเลือกการดําเนินการที่มีผลหลังจากสคริปต์ Robo เสร็จสมบูรณ์แล้ว
  • terminate - หากตั้งค่าเป็น true การทดสอบ Robo จะหยุดทำการ Crawl หลังจากสคริปต์ Robo ทำงานเสร็จ โดยค่าเริ่มต้นจะเป็น false

ต่อไปนี้คือตัวอย่างของสคริปต์ Robo ที่เรียกใช้ในโหมด strict โดยไม่มีการแจ้งเตือนบนหน้าจอที่เข้าสู่โหมดสลีปเป็นเวลา 3 วินาที จากนั้นการ Crawl จะหยุดลง

"roboscript": {
  "executionMode": {
    "strict": true,
    "notify": false
  },
  "postscript": {
    "terminate": true
  }
}
[
  {
    "eventType": "DELAYED_MESSAGE_POSTED",
    "delayTime": 3000
  }
]

พารามิเตอร์เทมเพลต

พารามิเตอร์เทมเพลตคือตัวยึดตําแหน่งในสคริปต์ Robo ที่ระบบจะแทนที่ด้วยค่าจริงเมื่อการทดสอบ Robo โหลดสคริปต์ Robo นั้นเพื่อดําเนินการ พารามิเตอร์เทมเพลตจะมีเครื่องหมายขีดล่าง 2 ตัวอยู่ข้างหน้า ตามด้วยเครื่องหมายเปอร์เซ็นต์ และจะมีเครื่องหมายเปอร์เซ็นต์อยู่ท้ายตามด้วยเครื่องหมายขีดล่าง 2 ตัว

สคริปต์ Robo รองรับพารามิเตอร์เทมเพลตต่อไปนี้

• __%APP_PACKAGE_NAME%__ - ชื่อแพ็กเกจของแอปที่ทดสอบ

ต่อไปนี้คือตัวอย่างของสคริปต์ Robo ที่หยุดกระบวนการแอปภายใต้การทดสอบ

[
  {
    "eventType": "ADB_SHELL_COMMAND",
    "command": "am force-stop __%APP_PACKAGE_NAME%__"
  }
]

ความคิดเห็น

สคริปต์ Robo อาจมีบรรทัดความคิดเห็น ซึ่งเป็นบรรทัดขึ้นต้นด้วย # หรือ //

ต่อไปนี้คือตัวอย่างสคริปต์ Robo ที่มีความคิดเห็น 2 รายการ

# Confirm a user account.
[
  {
    // Click the DONE button.
    "eventType": "VIEW_CLICKED",
    "elementDescriptors": [
      {
        "resourceId": "com.google.samples.apps.topeka:id/done"
      }
    ]
  }
]

ความสามารถ

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

ลำดับความสำคัญ

หากสคริปต์ Robo ไปถึง maxNumberOfRuns แล้ว ระบบจะไม่ทริกเกอร์สคริปต์นั้นอีกในการ Crawl ครั้งนั้น หากบริบทปัจจุบันทริกเกอร์สคริปต์ Robo ได้มากกว่า 1 รายการ ระบบจะจัดลำดับความสำคัญของสคริปต์ Robo ตามลำดับดังต่อไปนี้

1. มีแอตทริบิวต์ contextDescriptor
2. มี priority สูงสุด (โดยค่าเริ่มต้น สคริปต์ Robo ทั้งหมดมีการดำเนินการ priority ของ 1 เหมือนกัน)
3. จะปรากฏรายการแรกสุดในรายการสคริปต์ Robo หากลำดับความสำคัญของสคริปต์ Robo เหมือนกัน

ต่อไปนี้คือตัวอย่างไฟล์ที่มีสคริปต์ Robo 3 รายการที่ทําการดําเนินการเดียวกันและทริกเกอร์โดยเงื่อนไขเดียวกัน ซึ่งก็คือแอปที่ทดสอบอยู่อยู่เบื้องหน้า

[
  {
    "id": 1000,
    "description": "Robo script 1",
    "contextDescriptor": {
      "condition": "app_under_test_shown"
    },
    "actions": [
      {
        "eventType": "DELAYED_MESSAGE_POSTED",
        "delayTime": 3000
      }
    ]
  },
  {
    "id": 1001,
    "description": "Robo script 2",
    "priority": "2",
    "contextDescriptor": {
      "condition": "app_under_test_shown"
    },
    "actions": [
      {
        "eventType": "DELAYED_MESSAGE_POSTED",
        "delayTime": 3000
      }
    ]
  },
  {
    "id": 1002,
    "description": "Robo script 3",
    "contextDescriptor": {
      "condition": "app_under_test_shown"
    },
    "actions": [
      {
        "eventType": "DELAYED_MESSAGE_POSTED",
        "delayTime": 3000
      }
    ]
  }
]

เมื่อแอปที่ทดสอบอยู่เบื้องหน้า Robo จะทริกเกอร์การดำเนินการต่อไปนี้ตามลำดับ

1. "Robo script 2" เนื่องจากมีลําดับความสําคัญสูงสุด
2. "Robo script 1" เนื่องจากปรากฏก่อนสคริปต์ Robo ที่เกี่ยวข้องที่เหลือซึ่งมีลําดับความสําคัญเดียวกัน
3. "Robo script 3" เป็นสคริปต์ Robo ที่เกี่ยวข้องล่าสุด

การเรียกใช้ซ้ำ

โดยค่าเริ่มต้น Robo จะเรียกใช้สคริปต์ Robo ไม่เกิน 1 ครั้งระหว่างการ Crawl ซึ่งสามารถปรับผ่านแอตทริบิวต์ maxNumberOfRuns

ต่อไปนี้คือตัวอย่างสคริปต์ Robo ที่นําแอปที่ทดสอบไปไว้เบื้องหลังสูงสุด 10 ครั้ง

{
  "id": 1000,
  "maxNumberOfRuns": 10,
  "contextDescriptor": {
    "condition": "app_under_test_shown"
  },
  "actions": [
    {
      "eventType": "GO_HOME"
    }
  ]
}

ระยะการ Crawl

สคริปต์ Robo ใช้ได้ในขั้นตอนต่างๆ ของการ Crawl ของ Robo

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

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

{
  "id": 1000,
  "crawlStage": "pre_crawl",
  "actions": [
    {
      "eventType": "ADB_SHELL_COMMAND",
      "command": "pm clear __%APP_PACKAGE_NAME%__"
    }
  ]
}

ต่อไปนี้คือตัวอย่างสคริปต์ Robo ที่สั่งให้ Robo คลิก "Cancel" ทุกครั้งที่พยายามกลับ (ย้อนกลับ) จากกล่องโต้ตอบการยืนยัน

{
  "id": 1000,
  "crawlStage": "close_screen",
  "maxNumberOfRuns": 999,
  "contextDescriptor": {
    "condition": "element_present",
    "elementDescriptors": [
      {
        "resourceId": "my.app.package:id/confirmation_dialog"
      }
    ]
  },
  "actions": [
    {
      "eventType": "VIEW_CLICKED",
      "elementDescriptors": [
        {
          "text": "Cancel"
        }
      ]
    }
  ]
}

การทำงานตามเงื่อนไข

สคริปต์ Robo อาจมีการดำเนินการแบบมีเงื่อนไข การดำเนินการแบบมีเงื่อนไขมีแอตทริบิวต์เพิ่มเติม 3 รายการที่อธิบายวิธีที่ Robo ดำเนินการ

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

ต่อไปนี้คือตัวอย่างสคริปต์ Robo แบบไม่มีเงื่อนไขที่มีการดำเนินการแบบมีเงื่อนไขซึ่งจะปิดกล่องโต้ตอบแบบป๊อปอัปหากปรากฏขึ้นเมื่อใดก็ได้ระหว่างที่ดำเนินการสคริปต์ Robo

{
  "id": 1000,
  "actions": [
    {
      "description": "Dismiss popup",
      "maxNumberOfRuns": 100,
      "contextDescriptor": {
        "condition": "default_launcher_shown",
        "negateCondition": true
      },
      "eventType": "GO_HOME"
    },
    {
      "description": "Screen off",
      "eventType": "ADB_SHELL_COMMAND",
      "command": "input keyevent 26"
    },
    {
      "description": "Wait for 10 seconds",
      "eventType": "DELAYED_MESSAGE_POSTED",
      "delayTime": 10000
    },
    {
      "description": "Screen on",
      "eventType": "ADB_SHELL_COMMAND",
      "command": "input keyevent 82"
    },
    {
      "description": "Wait for 10 seconds",
      "eventType": "DELAYED_MESSAGE_POSTED",
      "delayTime": 10000
    }
}

การละเว้นการดำเนินการ

สคริปต์ Robo อาจมีวิธีการให้ Robo ละเว้นวิดเจ็ต UI ที่เฉพาะเจาะจงหรือวิดเจ็ต UI ทั้งหมดในหน้าจอหนึ่งๆ คำสั่งเหล่านี้จะแสดงเป็น "การดําเนินการ" ที่ไม่สนใจซึ่งมี eventType ELEMENT_IGNORED และ ALL_ELEMENTS_IGNORED ตามลำดับ

เมื่อใดก็ตามที่แอตทริบิวต์ contextDescriptor ของสคริปต์ Robo ที่มีการดำเนินการที่ไม่สนใจตรงกับหน้าจอหนึ่งๆ Robo จะไม่โต้ตอบกับวิดเจ็ต UI ใดๆ ที่การดำเนินการที่ไม่สนใจกำหนดเป้าหมายไว้ (เว้นแต่การดำเนินการของสคริปต์ Robo อื่นจะทำให้ Robo ดำเนินการกับวิดเจ็ต UI ที่ละเลยรายการใดรายการหนึ่ง)

สคริปต์ Robo อาจมีทั้งการละเว้น การกระทำที่มีเงื่อนไข และการดำเนินการที่ไม่มีเงื่อนไขผสมกัน การละเว้นการดําเนินการจะทํางานได้ตราบใดที่ contextDescriptor ของสคริปต์ Robo ที่รวมอยู่นั้นตรงกับหน้าจอระหว่างการ Crawl ของ Robo โดยไม่คำนึงถึงค่าของแอตทริบิวต์ priority และ maxNumberOfRuns

ต่อไปนี้เป็นตัวอย่างไฟล์ที่มีสคริปต์ Robo 2 รายการ สคริปต์ Robo แรกทําให้ Robo ละเว้นวิดเจ็ต UI ทั้งหมดบนหน้าจอที่มีวิดเจ็ต UI ที่มีรหัสทรัพยากร "my.app.package:id/ignored_screen" สคริปต์ Robo รายการที่ 2 ทําให้ Robo ละเว้นวิดเจ็ต UI ที่มีรหัสทรัพยากรตรงกับนิพจน์ทั่วไปของ Java ".*:id/done" ในหน้าจอที่มีวิดเจ็ต UI ที่มีรหัสทรัพยากร "my.app.package:id/main_screen"

[
  {
    "id": 1000,
    "contextDescriptor": {
      "condition": "element_present",
      "elementDescriptors": [
        {
          "resourceId": "my.app.package:id/ignored_screen"
        }
      ]
    },
    "actions": [
      {
        "eventType": "ALL_ELEMENTS_IGNORED"
      }
    ]
  },
  {
    "id": 1001,
    "contextDescriptor": {
      "condition": "element_present",
      "elementDescriptors": [
        {
          "resourceId": "my.app.package:id/main_screen"
        }
      ]
    },
    "actions": [
      {
        "eventType": "ELEMENT_IGNORED",
        "elementDescriptors": [
          {
            "resourceIdRegex": ".*:id/done"
          }
        ]
      }
    ]
  }
]

การรองรับ RecyclerView และ AdapterView

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

ดังนั้นสคริปต์ Robo จะบันทึกตำแหน่งข้อมูลสัมบูรณ์ของหน่วยย่อย RecyclerView ที่เป็นเป้าหมายของการดำเนินการสคริปต์ Robo เป็น recyclerViewChildPosition สคริปต์ Robo จะบันทึกตําแหน่งสัมบูรณ์ของข้อมูลของรายการย่อย AdapterView ที่เป็นเป้าหมายของการดำเนินการของสคริปต์ Robo ไว้ด้วยเช่นกัน ดังนี้ adapterViewChildPosition

การดำเนินการกับรายการย่อย RecyclerView และ AdapterView จะดำเนินการในขั้นตอนต่อไปนี้

1. การทดสอบด้วย Robo ช่วยให้มั่นใจได้ว่ารายการย่อยที่เกี่ยวข้องจะแสดงบนหน้าจอผ่านการดำเนินการจัดตำแหน่งใน RecyclerView หรือ AdapterView ที่มี

2. การทดสอบ Robo จะดําเนินการบันทึกไว้กับองค์ประกอบย่อยโดยตรง เนื่องจากองค์ประกอบนั้นแสดงอยู่บนหน้าจออยู่แล้ว

ตัวอย่างการดำเนินการคลิกใน AdapterView ย่อย (android.widget.GridView) มีดังนี้

{
  "eventType": "VIEW_CLICKED",
  "elementDescriptors": [
    {
      "className": "com.google.samples.apps.topeka.widget.AvatarView",
      "adapterViewChildPosition": 5,
      "resourceId": "com.google.samples.apps.topeka:id/avatar",
      "contentDescription": "Avatar 6"
    },
    {
      "className": "android.widget.GridView",
      "groupViewChildPosition": 1,
      "resourceId": "com.google.samples.apps.topeka:id/avatars"
    },
    {
      "className": "android.widget.LinearLayout",
      "groupViewChildPosition": 1
    },
    {
      "className": "android.widget.LinearLayout",
      "groupViewChildPosition": 0
    }
  ]
}

ตัวอย่างการดําเนินการคลิกในรายการย่อย RecyclerView (android.support.v7.widget.RecyclerView) มีดังนี้

{
  "eventType": "VIEW_CLICKED",
  "elementDescriptors": [
    {
      "className": "android.support.v7.widget.AppCompatTextView",
      "groupViewChildPosition": 1,
      "resourceId": "com.google.samples.apps.topeka:id/category_title"
    },
    {
      "className": "android.widget.FrameLayout",
      "recyclerViewChildPosition": 8,
      "resourceId": "com.google.samples.apps.topeka:id/category_item"
    },
    {
      "className": "android.support.v7.widget.RecyclerView",
      "groupViewChildPosition": 1,
      "resourceId": "com.google.samples.apps.topeka:id/categories"
    },
    {
      "className": "android.widget.FrameLayout",
      "groupViewChildPosition": 1,
      "resourceId": "com.google.samples.apps.topeka:id/category_container"
    },
    {
      "className": "android.widget.LinearLayout",
      "groupViewChildPosition": 0
    }
  ]
}

บันทึกสคริปต์ Robo ใน Android Studio แล้วเรียกใช้ใน Test Lab

คุณสร้างสคริปต์ Robo ใน Android Studio ได้ ซึ่งจะบันทึกสคริปต์เป็นไฟล์ JSON จากนั้นอัปโหลดไฟล์ JSON ไปยัง Firebase Test Lab พร้อมกับแอปพลิเคชันและทำการทดสอบตามลำดับ

เมื่อคุณเรียกใช้การทดสอบ Robo ที่มีสคริปต์แนบมาด้วย การทดสอบ Robo จะดำเนินการตามสคริปต์ที่กำหนดไว้ล่วงหน้าก่อน จากนั้นก็จะสำรวจแอปตามปกติ

หากต้องการสร้างไฟล์ JSON ของสคริปต์ Robo ใน Android Studio ให้ทําตามขั้นตอนในหัวข้อบันทึกสคริปต์ Robo โดยใช้ Test Lab ใน Android Studio

การดำเนินการของสคริปต์ Robo

แอตทริบิวต์ที่ไม่บังคับทั่วไปต่อไปนี้มีผลกับการดำเนินการทั้งหมด

• description - ช่วยติดตามการดำเนินการของสคริปต์ Robo นี้ในเอาต์พุตการทดสอบ Robo

การยืนยัน

หากเงื่อนไขที่กล่าวอ้างเป็นจริง สคริปต์ Robo จะดําเนินการถัดไป ซึ่งอาจเป็นการกล่าวอ้างอื่น มิฉะนั้น การดำเนินการสคริปต์ Robo จะหยุดชะงักเนื่องจากการยืนยันไม่สำเร็จ

ตารางต่อไปนี้แสดงรายการแอตทริบิวต์ที่จำเป็น

ต่อไปนี้คือตัวอย่างของการยืนยันสคริปต์ Robo ที่ตรวจสอบว่าการทดสอบแอปอันเดอร์อยู่ในเบื้องหน้า

{
  "eventType": "ASSERTION",
  "contextDescriptor": {
    "condition": "app_under_test_shown"
  }
}

ต่อไปนี้คือตัวอย่างของการยืนยันสคริปต์ Robo ที่ตรวจสอบว่ามีวิดเจ็ต UI ที่มีรหัสทรัพยากร "com.google.samples.apps.topeka:id/done" ปรากฏอยู่บนหน้าจอ

{
  "eventType": "ASSERTION",
  "contextDescriptor": {
    "condition": "element_present",
    "elementDescriptors": [
      {
        "resourceId": "com.google.samples.apps.topeka:id/done"
      }
    ]
  }
}

ต่อไปนี้คือตัวอย่างการยืนยันสคริปต์ Robo ที่ตรวจสอบว่าระบบไม่ตรวจพบ "Settings" ในหน้าจอโดยใช้ OCR

{
  "eventType": "ASSERTION",
  "contextDescriptor": {
    "condition": "element_present",
    "negateCondition": true,
    "visionText": "Settings"
  }
}

คลิก

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้คือตัวอย่างการดําเนินการของสคริปต์ Robo ที่คลิกปุ่มที่มีรหัสทรัพยากร "com.google.samples.apps.topeka:id/done"

{
  "eventType": "VIEW_CLICKED",
  "elementDescriptors": [
    {
      "resourceId": "com.google.samples.apps.topeka:id/done"
    }
  ]
}

ต่อไปนี้คือตัวอย่างการดําเนินการของสคริปต์ Robo ที่คลิกที่ครั้งที่ 2 ของคํา "Search" ที่ตรวจพบบนหน้าจอโดยใช้ OCR

{
  "eventType": "VIEW_CLICKED",
  "visionText": "Search",
  "matchIndex": 1
}

ต่อไปนี้คือตัวอย่างการทำงานของสคริปต์ Robo ที่คลิกองค์ประกอบแป้นพิมพ์แบบซอฟต์ที่มีคำอธิบายเนื้อหา "Emoji button"

{
  "eventType": "SOFT_KEYBOARD_CLICK",
  "elementDescriptors": [
    {
      "contentDescription": "Emoji button"
    }
  ]
}

ต่อไปนี้คือตัวอย่างการทำงานของสคริปต์ Robo ที่คลิกองค์ประกอบของแป้นพิมพ์แบบนุ่มแบบสุ่มสูงสุด 5 ครั้ง

{
  "eventType": "SOFT_KEYBOARD_RANDOM_CLICK",
  "maxNumberOfRuns": 5
}

ปิดใช้แป้นพิมพ์เสมือน

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้เป็นตัวอย่างการดำเนินการสคริปต์ Robo ที่ปิดใช้แป้นพิมพ์บนหน้าจอ

{
  "eventType": "DISABLE_KEYBOARD"
}

เรียกใช้คำสั่ง adb shell

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

คุณระบุแอตทริบิวต์ต่อไปนี้หรือไม่ก็ได้

• expectedOutputRegex - เอาต์พุตที่คาดไว้ของคำสั่งที่เป็นนิพจน์ทั่วไปของ Java หากเอาต์พุตไม่ตรงกัน การดำเนินการสคริปต์ Robo จะดำเนินการไม่สำเร็จ โดยค่าเริ่มต้น จะเป็นสตริงว่าง ซึ่งหมายความว่าระบบจะไม่ตรวจสอบเอาต์พุต

ต่อไปนี้คือตัวอย่างการทำงานของสคริปต์ Robo ที่ล้างข้อมูลผู้ใช้ในช่วงทดสอบแอป

{
  "eventType": "ADB_SHELL_COMMAND",
  "command": "pm clear __%APP_PACKAGE_NAME%__"
}

ให้สิทธิ์

โปรแกรมบันทึกสคริปต์ Robo ใน Android Studio จะบันทึกการดำเนินการนี้เพื่อใช้งานร่วมกับ Espresso Test Recorder ได้ การทดสอบ Robo จะมอบสิทธิ์ทั้งหมดแก่แอปที่ทดสอบในช่วงเริ่มต้นของการ Crawl ทุกครั้ง ดังนั้นการดำเนินการนี้จะใช้งานไม่ได้ โปรดอย่าใช้การดำเนินการนี้ในสคริปต์ Robo

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ละเว้นองค์ประกอบทั้งหมดบนหน้าจอ

การดำเนินการนี้จะทำให้ Robo ละเว้นองค์ประกอบทั้งหมดบนหน้าจอที่เรียกใช้สคริปต์ Robo

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

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

{
  "eventType": "ALL_ELEMENTS_IGNORED"
}

ละเว้นองค์ประกอบ

การดำเนินการนี้จะทำให้ Robo ละเว้นองค์ประกอบ (หรือองค์ประกอบ) ที่ตรงกับ elementDescriptorsที่ระบุ

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

คุณจะระบุแอตทริบิวต์ต่อไปนี้หรือไม่ก็ได้

• ignoreChildren - หากตั้งค่าเป็น true ทาง Robo จะละเว้นวิดเจ็ต UI ที่ละเว้นทั้งหมดด้วย โดยค่าเริ่มต้นจะเป็น false

ต่อไปนี้คือตัวอย่างการทำงานของสคริปต์ Robo ที่ทำให้ Robo ละเว้นองค์ประกอบทั้งหมด ซึ่งคำอธิบายเนื้อหาขึ้นต้นด้วย "Avatar"

{
  "eventType": "ELEMENT_IGNORED",
  "elementDescriptors": [
    {
      "contentDescriptionRegex": "Avatar.*"
    }
  ]
}

ข้อความอินพุต

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้คือตัวอย่างการดำเนินการสคริปต์ Robo ที่ป้อน "John" ลงในวิดเจ็ต UI ที่มีรหัสทรัพยากร "com.google.samples.apps.topeka:id/first_name"

{
  "eventType": "VIEW_TEXT_CHANGED",
  "replacementText": "John",
  "elementDescriptors": [
    {
      "resourceId": "com.google.samples.apps.topeka:id/first_name"
    }
  ]
}

คลิกค้าง

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

คุณระบุแอตทริบิวต์ต่อไปนี้หรือไม่ก็ได้

• delayTime - ระบุระยะเวลาการกดค้างไว้เป็นมิลลิวินาที

ต่อไปนี้คือตัวอย่างการดําเนินการสคริปต์ Robo ที่คลิกวิดเจ็ต UI ที่มีคำอธิบายเนื้อหา "Avatar 8" เป็นเวลา 5 วินาที

{
  "eventType": "VIEW_LONG_CLICKED",
  "elementDescriptors": [
    {
      "contentDescription": "Avatar 8"
    }
  ],
  "delayTime": 5000
}

ทำท่าทางสัมผัสแบบจุดเดียว

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

คุณจะระบุแอตทริบิวต์ต่อไปนี้หรือไม่ก็ได้

• dragAndDrop - หากตั้งค่าเป็น true ท่าทางสัมผัสแบบจุดเดียวจะดำเนินการลากและวาง โดยค่าเริ่มต้นจะเป็น false

ต่อไปนี้เป็นตัวอย่างการดําเนินการด้วยท่าทางสัมผัสแบบจุดเดียวของสคริปต์ Robo ที่ปัดลง

{
  "eventType": "ONE_POINT_GESTURE",
  "coordinates": "(50%,25%)->(50%,75%)"
}

ทำท่าทางสัมผัสด้วย 2 นิ้ว

ตารางต่อไปนี้แสดงรายการแอตทริบิวต์ที่จำเป็น

ต่อไปนี้เป็นตัวอย่างการดำเนินการสคริปต์ Robo ที่ใช้ท่าทางสัมผัสด้วยการกางนิ้ว

{
  "eventType": "TWO_POINT_GESTURE",
  "coordinates": "(50%,50%)->(25%,50%),(50%,50%)->(75%,50%)"
}

ดำเนินการ IME

การดําเนินการนี้จะกดปุ่มการดําเนินการปัจจุบัน เช่น ถัดไป เสร็จสิ้น และค้นหา ในเครื่องมือแก้ไขวิธีการป้อนข้อมูล (IME) สําหรับวิดเจ็ต UI เป้าหมายที่ระบุ

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้คือตัวอย่างการดำเนินการสคริปต์ Robo ที่ดำเนินการ IME ในวิดเจ็ต UI ที่มีรหัสทรัพยากร "com.google.samples.apps.topeka:id/first_name"

{
  "eventType": "PRESSED_EDITOR_ACTION",
  "elementDescriptors": [
    {
      "resourceId": "com.google.samples.apps.topeka:id/first_name"
    }
  ]
}

กดย้อนกลับ

ตารางต่อไปนี้แสดงรายการแอตทริบิวต์ที่จำเป็น

ต่อไปนี้เป็นตัวอย่างการดำเนินการสคริปต์ Robo ที่กดกลับ

{
  "eventType": "PRESSED_BACK"
}

กด "หน้าแรก"

การดำเนินการนี้จะส่งเหตุการณ์ KEYCODE_HOME ไปยังอุปกรณ์

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้เป็นตัวอย่างการดำเนินการสคริปต์ Robo ที่กดปุ่ม Home

{
  "eventType": "GO_HOME"
}

เลื่อนองค์ประกอบเข้ามาในมุมมอง

การดําเนินการนี้ทําให้ Robo Test เลื่อนวิดเจ็ต UI ที่ตรงกับ elementDescriptors ที่ระบุไปข้างหน้าจนกว่าวิดเจ็ต UI ที่ตรงกับ elementDescriptors ที่ระบุจะปรากฏบนหน้าจอ หรือเลื่อนวิดเจ็ตที่เลื่อนอยู่ไม่ได้อีกต่อไป หรือเลื่อนครบ 50 ครั้งแล้วchildElementDescriptors

ตารางต่อไปนี้แสดงรายการแอตทริบิวต์ที่จำเป็น

ต่อไปนี้เป็นตัวอย่างการทำงานของสคริปต์ Robo ที่เลื่อนวิดเจ็ต UI ที่มีรหัสทรัพยากร "my.app.package:id/scrollable_card_container" จนกระทั่งวิดเจ็ต UI ที่มีข้อความ "Orange" ปรากฏบนหน้าจอ (หรือไม่สามารถเลื่อนได้อีก หรือถึงจำนวนการเลื่อนสูงสุด 50 ครั้งแล้ว)

{
  "eventType": "ELEMENT_SCROLL_INTO_VIEW",
  "elementDescriptors": [
    {
      "resourceId": "my.app.package:id/scrollable_card_container"
    }
  ],
  "childElementDescriptors": [
    {
      "text": "Orange"
    }
  ]
}

การปัดหน้าจอ

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้คือตัวอย่างการดำเนินการสคริปต์ Robo ที่ปัดวิดเจ็ต UI ขึ้นโดยมีรหัสทรัพยากร "my.app.package:id/custom_content"

{
  "eventType": "VIEW_SWIPED",
  "swipeDirection": "Up",
  "elementDescriptors": [
    {
      "resourceId": "my.app.package:id/custom_content"
    }
  ]
}

ถ่ายภาพหน้าจอ

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้เป็นตัวอย่างการดําเนินการของสคริปต์ Robo ที่ถ่ายภาพหน้าจอ

{
  "eventType": "TAKE_SCREENSHOT",
  "screenshotName": "my_screenshot"
}

แตะจุดบนหน้าจอ

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้เป็นตัวอย่างการดําเนินการของสคริปต์ Robo ที่แตะตรงกลางหน้าจอ

{
  "eventType": "POINT_TAP",
  "pointTapXPercent": 50,
  "pointTapYPercent": 50
}

แตะจุดภายในองค์ประกอบ

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้คือตัวอย่างการดําเนินการของ Roboscript ที่เลื่อนแถบเลื่อนของแถบเลื่อนไปทางขวา

{
  "eventType": "POINT_TAP_ELEMENT",
  "pointTapXPercent": 80,
  "pointTapYPercent": 50,
  "elementDescriptors": [
    {
      "resourceId": "my.app.package:id/my_seekbar"
    }
  ]
}

สิ้นสุดการรวบรวมข้อมูล

การดำเนินการนี้จะหยุดการทดสอบ Robo

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้เป็นตัวอย่างการดำเนินการของสคริปต์ Robo ที่หยุดการทดสอบ Robo

{
  "eventType": "TERMINATE_CRAWL"
}

รอ

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้เป็นตัวอย่างการดำเนินการสคริปต์ Robo ที่รอ 3 วินาที

{
  "eventType": "DELAYED_MESSAGE_POSTED",
  "delayTime": 3000
}

รอองค์ประกอบ

การดำเนินการนี้จะทำให้การทดสอบ Robo รอองค์ประกอบปรากฏบนหน้าจอไม่เกินระยะหมดเวลาที่ระบุ

ตารางต่อไปนี้แสดงแอตทริบิวต์ที่จําเป็น

ต่อไปนี้คือตัวอย่างการดำเนินการสคริปต์ Robo ที่รอสูงสุด 30 วินาทีเพื่อให้วิดเจ็ต UI ที่มีรหัสทรัพยากร "my.app.package:id/confirmation_button" ปรากฏบนหน้าจอ

{
  "eventType": "WAIT_FOR_ELEMENT",
  "delayTime": 30000,
  "elementDescriptors": [
    {
      "resourceId": "my.app.package:id/confirmation_button"
    }
  ]
}

ขั้นตอนถัดไป

• ดูวิธีเรียกใช้สคริปต์ Robo