Hướng dẫn tham khảo về tập lệnh Robo

Tài liệu này cung cấp thông tin tham khảo về tập lệnh Robo, bao gồm cả cấu trúc, chức năng, cách sử dụng, ghi lại và hành động. Tập lệnh Robo là các chương trình kiểm thử tự động hoá các tác vụ đảm bảo chất lượng (QA) thủ công cho ứng dụng di động, đồng thời cho phép tích hợp liên tục (CI) và các chiến lược kiểm thử trước khi phát hành. Tập lệnh Robo là một tệp JSON mô tả trình tự giao diện người dùng (UI) và các thao tác khác.

Bạn có thể tạo tập lệnh Robo theo các cách sau:

  • Sử dụng tính năng ghi tập lệnh Robo. (Chỉ dành cho Android)

  • Tạo tập lệnh Robo theo cách thủ công. (Android và iOS trở lên)

  • Ghi lại tập lệnh Robo rồi chỉnh sửa theo cách thủ công. (Chỉ dành cho Android)

Để tìm hiểu thêm về cách sử dụng tập lệnh Robo, hãy xem bài viết Chạy tập lệnh Robo.

Giới thiệu

Tập lệnh Robo được cung cấp cho kiểm thử Robo cùng với các dữ liệu đầu vào khác như Gói ứng dụng Android (APK) của ứng dụng đang được kiểm thử.

Sau đây là ví dụ về tập lệnh Robo giúp người dùng đăng nhập vào một ứng dụng. Tập lệnh này được kích hoạt khi ứng dụng đang được kiểm thử khởi chạy:

[
  {
    "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"
          }
        ]
      }
    ]
  }
]

Nếu có một tập lệnh Robo duy nhất trong một tệp và tập lệnh đó có điều kiện kích hoạt app_under_test_shown mặc định, như trong ví dụ trên, thì bạn có thể chỉ định tập lệnh Robo trong tệp bằng cách sử dụng định dạng đơn giản hơn – giống như một trình tự các hành động của tập lệnh:

[
  {
    "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"
      }
    ]
  }
]

Hỗ trợ iOS trở lên cho tập lệnh Robo

Robo dành cho iOS+ (Beta) hỗ trợ hạn chế cho các tập lệnh Robo. Cú pháp tập lệnh Robo cho iOS trở lên giống với cú pháp Android và các tính năng được hỗ trợ của iOS trở lên hoạt động tương tự như các tính năng tương ứng của Android.

Các thao tác sau được hỗ trợ trong iOS trở lên:

  • Câu nhận định
  • Nhấp chuột
  • Nhấp và giữ
  • Trượt
  • Bỏ qua tất cả phần tử
  • Đợi
  • Chụp ảnh màn hình
  • Chấm dứt quá trình thu thập dữ liệu

Các thuộc tính nhận dạng sau trong phần mô tả phần tử được hỗ trợ trong iOS trở lên:

  • Tên lớp
  • Tên lớp cấp trên
  • Nội dung mô tả (và biểu thức chính quy)
  • Văn bản (và biểu thức chính quy)

Các điều kiện kích hoạt trong chỉ số mô tả ngữ cảnh sau đây được hỗ trợ trong iOS trở lên:

  • Ứng dụng đang được kiểm thử
  • Phần tử hiện diện
  • Thực hiện hành động không phải của tập lệnh Robo

Cấu trúc

Tập lệnh Robo có một số thuộc tính mô tả cách Robo thực thi tập lệnh đó. Hầu hết các thuộc tính này là không bắt buộc và có giá trị mặc định được xác định trước:

Thuộc tính Nội dung mô tả
id Một số nguyên giúp theo dõi tập lệnh Robo này trong kết quả thu thập dữ liệu. Robo tích hợp sẵn các tập lệnh Robo với id riêng. Mặc dù cùng một id trong các tập lệnh Robo khác nhau không ảnh hưởng đến hành vi của các tập lệnh đó, nhưng việc phân biệt các hành động trong các tập lệnh Robo này trong kết quả thu thập dữ liệu có thể là một thách thức. Bạn nên chỉ định một id duy nhất là 1000 trở lên cho các tập lệnh Robo để tránh xung đột.
description Tương tự như id nhưng có tính mô tả hơn.
crawlStage Giai đoạn của một Robo thu thập dữ liệu áp dụng tập lệnh Robo này. Theo mặc định, đây là giai đoạn thu thập thông tin chính.
priority Mức độ ưu tiên của tập lệnh Robo này so với các tập lệnh Robo khác. Theo mặc định, tất cả tập lệnh Robo đều có mức độ ưu tiên là 1.
maxNumberOfRuns Chỉ định số lần trong quá trình thu thập thông tin, Robo có thể thực thi tập lệnh Robo này. Theo mặc định, Robo có thể thực thi một tập lệnh Robo một lần.
contextDescriptor Mô tả ngữ cảnh hoặc điều kiện kích hoạt tập lệnh Robo này. Nếu bị bỏ qua, điều kiện kích hoạt của tập lệnh Robo này sẽ được coi là luôn được đáp ứng; nói cách khác, tập lệnh Robo không có điều kiện.
actions Tất cả hành động của tập lệnh Robo này.

Một tệp chứa một tập hợp gồm một hoặc nhiều tập lệnh Robo.

Sau đây là ví dụ về một tệp có hai tập lệnh Robo không có điều kiện, mỗi tập lệnh có một thao tác được thực thi một lần ở đầu quá trình thu thập dữ liệu:

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

Phần mô tả ngữ cảnh

Chỉ số mô tả ngữ cảnh xác định ngữ cảnh hoặc điều kiện kích hoạt tập lệnh Robo bằng một hoặc một tổ hợp gồm nhiều thuộc tính:

Thuộc tính Nội dung mô tả
"condition": "always" Luôn kích hoạt tập lệnh Robo.
"condition": "element_present" Kiểm tra để đảm bảo rằng một tiện ích giao diện người dùng khớp với elementDescriptors hoặc văn bản do visionText chỉ định có trên màn hình.
"condition": "element_disabled" Kiểm tra để đảm bảo một tiện ích giao diện người dùng khớp với elementDescriptors xuất hiện trên màn hình và không thể tương tác.
"condition": "element_checked" Kiểm tra để đảm bảo một tiện ích giao diện người dùng khớp với elementDescriptors hiện diện trên màn hình và được đánh dấu.
"condition": "app_under_test_shown" Kiểm tra để đảm bảo ứng dụng đang được kiểm thử đang chạy trên nền trước.
"condition": "default_launcher_shown" Kiểm tra để đảm bảo màn hình chính của thiết bị hiển thị, tức là không có ứng dụng nào đang chạy ở nền trước.
"condition": "non_roboscript_action_performed" Kiểm tra để đảm bảo rằng nonRoboscriptActionCount hành động liên tiếp gần đây nhất do kiểm thử Robo thực hiện không phải là hành động tập lệnh Robo.
negateCondition Nếu được đặt thành true, sẽ phủ định condition. Ví dụ: bạn có thể sử dụng thuộc tính này để kiểm tra xem một tiện ích trên giao diện người dùng có xuất hiện trên màn hình hay không hoặc ứng dụng đang được kiểm thử có chạy ở nền trước hay không.
elementDescriptors Một hoặc nhiều phần mô tả phần tử xác định một tiện ích trên giao diện người dùng trên màn hình. Phương thức này được dùng kết hợp với các điều kiện element_present, element_disabled và element_checked. Loại trừ lẫn nhau với visionText. Để biết thêm thông tin, hãy xem phần Trình mô tả phần tử.
visionText Văn bản trên màn hình được phát hiện bằng API Nhận dạng ký tự quang học (OCR). visionText được sử dụng kết hợp với điều kiện element_present. Loại trừ lẫn nhau với elementDescriptors.
nonRoboscriptActionCount Số hành động liên tiếp không phải là tập lệnh Robo đã thực hiện trước đó. Thuộc tính này được sử dụng kết hợp với điều kiện non_roboscript_action_performed để kích hoạt tập lệnh Robo sau mỗi hành động Robo nonRoboscriptActionCount. Theo mặc định, giá trị này là 1.

Sau đây là ví dụ về tập lệnh Robo được kích hoạt bởi một tiện ích giao diện người dùng có mã nhận dạng tài nguyên "my.app.package:id/page_header" trên màn hình:

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

Sau đây là ví dụ về tập lệnh Robo được kích hoạt bằng "Privacy Policy" do công nghệ Nhận dạng ký tự quang học (OCR) phát hiện:

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

Sau đây là ví dụ về một tập lệnh Robo chờ 5 giây sau mỗi thao tác Robo không phải tập lệnh:

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

Hành động

Mỗi hành động trong tập lệnh Robo được biểu thị dưới dạng một gói gồm một hoặc nhiều cặp thuộc tính-giá trị, được mô tả trong bảng sau:

Thuộc tính Nội dung mô tả
eventType Chỉ định loại hành động, ví dụ: nhấp, chỉnh sửa văn bản, v.v. Bắt buộc đối với mọi hành động.
elementDescriptors Chỉ số mô tả xác định một tiện ích trên giao diện người dùng. Bắt buộc đối với tất cả các thao tác có tiện ích giao diện người dùng mục tiêu, chẳng hạn như nhấp vào một nút cụ thể.
optional Nếu được đặt thành true, thao tác này sẽ bị bỏ qua khi không thể thực hiện. Ví dụ: thao tác này sẽ bị bỏ qua khi không tìm thấy tiện ích giao diện người dùng mục tiêu trên màn hình mà không làm hỏng tập lệnh Robo chứa. Theo mặc định, giá trị này là false.
replacementText Văn bản cần nhập vào tiện ích giao diện người dùng mục tiêu. Bắt buộc đối với các thao tác chỉnh sửa văn bản.
swipeDirection Chỉ định hướng vuốt. Bắt buộc đối với thao tác vuốt.
delayTime Chỉ định thời gian chờ, tính bằng mili giây. Bắt buộc đối với các hành động chờ.
pointTapXCoordinate và pointTapYCoordinate Toạ độ X và Y theo pixel của điểm nhấn. Loại trừ lẫn nhau với pointTapXPercent và pointTapYPercent. Bắt buộc đối với các hành động nhấn vào điểm.
pointTapXPercent và pointTapYPercent Toạ độ X và Y theo tỷ lệ phần trăm của điểm nhấn. Loại trừ lẫn nhau với pointTapXCoordinate và pointTapYCoordinate. Bắt buộc đối với các hành động nhấn vào điểm.

Sau đây là ví dụ về tập lệnh Robo có hai thao tác không có tiện ích giao diện người dùng mục tiêu, tức là các thao tác này không hoạt động trên một tiện ích giao diện người dùng cụ thể:

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

Phần mô tả phần tử

Trình mô tả phần tử xác định một tiện ích trên giao diện người dùng bằng một hoặc nhiều thuộc tính nhận dạng sau:

Thuộc tính Nội dung mô tả
className –
ancestorClassName Tên lớp của thành phần mẹ trong hệ phân cấp giao diện người dùng của phần tử. Phần tử cấp trên là bất kỳ nút mẹ nào trong hệ phân cấp giao diện người dùng của phần tử, bao gồm cả chính phần tử đó.
resourceId –
resourceIdRegex Biểu thức chính quy Java để so khớp với resourceId.
contentDescription –
contentDescriptionRegex Biểu thức chính quy Java để so khớp với contentDescription.
text (xuất hiện trên màn hình) –
textRegex Biểu thức chính quy Java để so khớp với text.
groupViewChildPosition, recyclerViewChildPosition hoặc adapterViewChildPosition Biểu thị vị trí con của một tiện ích trên giao diện người dùng tuỳ thuộc vào loại tiện ích mẹ.

Thông thường, các thuộc tính này không được xác định, ví dụ: một nút có thể không có văn bản và nội dung mô tả. Ngay cả khi có một số giá trị thuộc tính, các giá trị đó có thể không phải là duy nhất trên một màn hình ứng dụng nhất định (bao gồm cả resourceId).

Ví dụ: thường thì bạn chỉ có thể phân biệt các mục trong danh sách bằng cách sử dụng các vị trí con khác nhau trong tiện ích mẹ. Điều này có nghĩa là việc chỉ sử dụng một chỉ số mô tả phần tử để xác định một tiện ích trên giao diện người dùng thường là không đủ. Do đó, thuộc tính elementDescriptors của một hành động chứa một trình tự mô tả phần tử được sắp xếp sao cho phần tử đầu tiên tương ứng với tiện ích giao diện người dùng mục tiêu, phần tử thứ hai tương ứng với tiện ích mẹ của tiện ích giao diện người dùng mục tiêu, v.v. Tiện ích giao diện người dùng mục tiêu của một hành động được so khớp khi tất cả các chỉ số mô tả phần tử của tiện ích đó khớp với hệ phân cấp phụ của tiện ích giao diện người dùng tương ứng.

Sau đây là ví dụ về tập lệnh Robo có thay đổi văn bản và thao tác nhấp, cả hai đều yêu cầu bạn xác định tiện ích giao diện người dùng mục tiêu bằng cách sử dụng phần mô tả phần tử được cung cấp:

[
  {
    "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"
      }
    ]
  }
]

Tuỳ chọn thực thi

Bạn có thể tuỳ ý đặt tiền tố cho danh sách thao tác trong tập lệnh Robo bằng một đối tượng JSON chỉ định các tuỳ chọn thực thi cho tập lệnh Robo đó. Tiêu đề cấu hình này bắt đầu bằng từ khoá roboscript, theo sau là một bản trình bày JSON về các tuỳ chọn thực thi mong muốn.

Tập lệnh Robo hỗ trợ các tuỳ chọn thực thi sau:

  • executionMode – các tuỳ chọn thực thi được áp dụng khi tập lệnh Robo đang chạy:
    • strict – nếu được đặt thành true, tập lệnh Robo sẽ không sử dụng tính năng so khớp một phần, bỏ qua hành động hiện tại và tạm ngưng. Tức là tập lệnh Robo được thực thi dưới dạng kiểm thử đo lường thông thường và không thành công ngay khi không thể thực hiện bất kỳ hành động nào của tập lệnh. Theo mặc định, giá trị này là false.
    • dismiss_popups – nếu được đặt thành true, quy trình kiểm thử Robo sẽ đóng mọi hộp thoại bất ngờ trong khi thực hiện tập lệnh Robo ngay cả ở chế độ strict. Tuỳ chọn này không có hiệu lực khi không ở chế độ strict. Theo mặc định, giá trị này là false.
    • notify – nếu bạn đặt thành false, tập lệnh Robo sẽ không hiển thị thông báo trên màn hình ở đầu và cuối quá trình thực thi. Theo mặc định, giá trị này là true.
  • postscript – các tuỳ chọn thực thi được áp dụng sau khi hoàn tất tập lệnh Robo:
    • terminate – nếu bạn đặt thành true, thì quy trình kiểm thử Robo sẽ ngừng thu thập dữ liệu sau khi tập lệnh Robo hoàn tất. Theo mặc định, giá trị này là false.

Sau đây là ví dụ về tập lệnh Robo được thực thi ở chế độ strict mà không có thông báo trên màn hình sẽ ngủ trong 3 giây, sau đó quá trình thu thập thông tin sẽ dừng:

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

Tham số mẫu

Thông số mẫu là phần giữ chỗ trong tập lệnh Robo được thay thế bằng giá trị thực tế khi kiểm thử Robo tải tập lệnh Robo đó để thực thi. Các tham số mẫu có tiền tố là dấu gạch dưới đôi, theo sau là dấu phần trăm và có hậu tố là dấu phần trăm, theo sau là dấu gạch dưới đôi.

Tập lệnh Robo hỗ trợ tham số mẫu sau:

  • __%APP_PACKAGE_NAME%__ – tên gói của ứng dụng đang được kiểm thử.

Sau đây là ví dụ về tập lệnh Robo dừng quy trình kiểm thử ứng dụng:

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

Nhận xét

Tập lệnh Robo có thể chứa các dòng nhận xét, là những dòng bắt đầu bằng # hoặc //.

Sau đây là ví dụ về một tập lệnh Robo có một vài chú thích:

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

Khả năng

Theo mặc định, cho đến khi tất cả các hành động của tập lệnh Robo hoàn tất (hoặc ít nhất là đã thử), tập lệnh Robo vẫn hoạt động. Kiểm thử Robo liên tục cố gắng so khớp một hành động trong tập lệnh Robo bất cứ khi nào chọn một hành động để thực hiện. Tập lệnh Robo sử dụng các kỹ thuật sau để tăng độ mạnh mẽ:

Kỹ thuật Nội dung mô tả
So khớp một phần Nếu không thể so khớp hoàn toàn thao tác tập lệnh Robo hiện tại, thì tiêu chí so khớp sẽ được nới lỏng và quá trình so khớp sẽ được thử lại. Tính năng so khớp một phần không xem xét chỉ số mô tả phần tử ngoài cùng trong khi so khớp tiện ích giao diện người dùng mục tiêu của một hành động trong tập lệnh Robo.

Nếu việc so khớp một phần thành công, thao tác tập lệnh Robo tương ứng sẽ được thực hiện như bình thường. Kỹ thuật này hỗ trợ các trường hợp mà cấu trúc ứng dụng thay đổi, chẳng hạn như giữa các phiên bản ứng dụng, khi các phần tử màn hình được sắp xếp lại.

Bỏ qua thao tác hiện tại Nếu không thể so khớp toàn bộ hoặc một phần hành động trong tập lệnh Robo hiện tại, thì Robo sẽ cố gắng so khớp hành động trong tập lệnh Robo tiếp theo. Nếu hành động tiếp theo khớp hoàn toàn hoặc một phần, thì quy trình kiểm thử Robo sẽ bỏ qua (và không bao giờ quay lại) hành động tập lệnh Robo hiện tại và thực hiện hành động tiếp theo.

Kỹ thuật này hỗ trợ các trường hợp hành vi của ứng dụng thay đổi giữa các phiên bản hoặc không ổn định, ví dụ: khi hộp thoại không liên tục có thể xuất hiện trên các màn hình khác nhau trong quá trình ghi lại so với phát lại tập lệnh Robo.

Tạm ngưng Nếu không thể so khớp toàn bộ hoặc một phần các hành động trong tập lệnh Robo hiện tại hoặc các hành động tiếp theo, thì tập lệnh Robo sẽ tạm thời bị tạm ngưng và kiểm thử Robo sẽ chọn một hành động để thực hiện bằng các chiến lược khác. Sau khi thao tác này hoàn tất, quy trình kiểm thử Robo sẽ tiếp tục thực thi tập lệnh Robo.

Miễn là không thể so khớp các hành động hiện tại hoặc hành động tiếp theo trong tập lệnh Robo, tập lệnh Robo sẽ vẫn bị tạm ngưng cho bất kỳ số hành động nào. Do đó, tập lệnh Robo không nhất thiết phải là phần mở đầu cho kiểm thử Robo và bạn có thể xen kẽ các hành động trong tập lệnh Robo với các hành động kiểm thử Robo tiêu chuẩn. Kỹ thuật này hỗ trợ các trường hợp khi hành vi của ứng dụng không ổn định hoặc khi các thay đổi giữa các phiên bản ứng dụng đủ lớn để kiểm thử Robo cần "lấp đầy khoảng trống" bằng các hành động tiêu chuẩn.

Mức độ ưu tiên

Nếu một tập lệnh Robo đạt đến maxNumberOfRuns, thì tập lệnh đó sẽ không thể được kích hoạt trong một lần thu thập dữ liệu nhất định. Nếu ngữ cảnh hiện tại có thể kích hoạt nhiều tập lệnh Robo, thì hệ thống sẽ ưu tiên bằng cách chọn tập lệnh Robo theo thứ tự sau:

  1. Có thuộc tính contextDescriptor.
  2. Có priority cao nhất (theo mặc định, tất cả tập lệnh Robo đều có cùng priority thực thi là 1).
  3. Xuất hiện sớm nhất trong danh sách tập lệnh Robo, nếu các tập lệnh Robo có cùng mức độ ưu tiên.

Sau đây là ví dụ về một tệp có 3 tập lệnh Robo thực hiện cùng một thao tác và được kích hoạt bởi cùng một điều kiện – ứng dụng đang được kiểm thử ở nền trước:

[
  {
    "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
      }
    ]
  }
]

Khi ứng dụng đang được kiểm thử ở nền trước, Robo sẽ kích hoạt các thao tác sau theo thứ tự:

  1. "Robo script 2" vì nó có mức độ ưu tiên cao nhất.
  2. "Robo script 1" vì tập lệnh này xuất hiện sớm hơn trong số các tập lệnh Robo còn lại có cùng mức độ ưu tiên.
  3. "Robo script 3" là tập lệnh Robo áp dụng gần đây nhất.

Lần chạy lặp lại

Theo mặc định, Robo kích hoạt một tập lệnh Robo nhiều nhất một lần trong quá trình thu thập dữ liệu. Bạn có thể điều chỉnh thông số này thông qua thuộc tính maxNumberOfRuns.

Sau đây là ví dụ về tập lệnh Robo đưa ứng dụng đang kiểm thử vào chế độ nền tối đa 10 lần:

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

Giai đoạn thu thập dữ liệu

Bạn có thể áp dụng tập lệnh Robo ở nhiều giai đoạn của một lần thu thập dữ liệu Robo nhất định:

Giai đoạn thu thập dữ liệu Nội dung mô tả
pre_crawl Trước khi Robo khởi chạy và bắt đầu thu thập thông tin về ứng dụng đang được kiểm thử.
post_crawl Sau khi Robo hoàn tất việc thu thập thông tin về ứng dụng đang được kiểm thử. Thời lượng của tập lệnh Robo post_crawl không được vượt quá 15 giây, nếu không quá trình thu thập thông tin có thể bị chấm dứt do hết thời gian chờ.
crawl Giai đoạn thu thập thông tin chính, khi Robo thu thập thông tin về ứng dụng đang được kiểm thử.
close_screen Khi Robo cố gắng quay lại (quay lại) từ một màn hình nhất định, khi tất cả các thao tác có thể thực hiện trên màn hình này được khám phá. Theo mặc định, Robo nhấn nút quay lại, điều này không mong muốn trong một số trường hợp.

Nếu thuộc tính crawlStage của tập lệnh Robo không được chỉ định, thì thuộc tính này sẽ được ngụ ý là crawl.

Sau đây là ví dụ về tập lệnh Robo xoá dữ liệu người dùng của ứng dụng đang được kiểm thử trước khi Robo bắt đầu thu thập dữ liệu đó:

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

Sau đây là ví dụ về tập lệnh Robo hướng dẫn Robo nhấp vào "Cancel" bất cứ khi nào nó cố gắng quay lại (quay lại) từ hộp thoại xác nhận:

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

Thao tác có điều kiện

Tập lệnh Robo có thể chứa các hành động có điều kiện. Hành động có điều kiện có thêm 3 thuộc tính mô tả cách Robo thực hiện các hành động đó:

Thuộc tính Nội dung mô tả
priority Mức độ ưu tiên của hành động có điều kiện này so với các hành động có điều kiện khác trong tập lệnh Robo chứa hành động đó. Theo mặc định, tất cả các hành động có điều kiện đều có mức độ ưu tiên là 1.
maxNumberOfRuns Số lần có thể thực hiện hành động có điều kiện này trong một lần thực thi tập lệnh Robo chứa hành động đó. Theo mặc định, tất cả các hành động có điều kiện chỉ có thể được thực hiện tối đa một lần trong một lần thực thi tập lệnh Robo chứa các hành động đó.
contextDescriptor Ngữ cảnh/điều kiện kích hoạt hành động có điều kiện này. Tệp này có cùng cấu trúc và cung cấp các chức năng tương tự như contextDescriptor của tập lệnh Robo

Khi được kích hoạt, tập lệnh Robo sẽ thực hiện lần lượt các hành động không có điều kiện theo thứ tự xuất hiện. Nếu một tập lệnh Robo chứa các hành động có điều kiện, thì các hành động đó sẽ được xem xét mỗi khi chọn một hành động không có điều kiện để thực hiện. Nếu bất kỳ hành động có điều kiện nào được kích hoạt và chọn dựa trên mức độ ưu tiên và số lần chạy còn lại, thì tập lệnh Robo sẽ thực hiện hành động có điều kiện này. Nếu không, tập lệnh Robo sẽ thực hiện hành động không có điều kiện sau. Để hợp lệ, tập lệnh Robo phải chứa ít nhất một hành động không có điều kiện.

Sau đây là ví dụ về một tập lệnh Robo không có điều kiện với một thao tác có điều kiện đóng các hộp thoại bật lên nếu chúng xuất hiện tại bất kỳ thời điểm nào trong quá trình thực thi tập lệnh 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
    }
}

Bỏ qua hành động

Tập lệnh Robo có thể chứa hướng dẫn để Robo bỏ qua các tiện ích giao diện người dùng cụ thể hoặc tất cả tiện ích giao diện người dùng trên một màn hình cụ thể. Các hướng dẫn này được biểu thị là bỏ qua "hành động" bằng eventType ELEMENT_IGNORED và ALL_ELEMENTS_IGNORED tương ứng.

Bất cứ khi nào thuộc tính contextDescriptor của tập lệnh Robo chứa các thao tác bỏ qua khớp với một màn hình nhất định, Robo sẽ không tương tác với bất kỳ tiện ích giao diện người dùng nào được các thao tác bỏ qua nhắm đến (trừ khi một số thao tác tập lệnh Robo khác khiến Robo thực hiện một thao tác trên một trong các tiện ích giao diện người dùng bị bỏ qua).

Tập lệnh Robo có thể chứa các hành động bỏ qua, có điều kiện và không có điều kiện. Không giống như các thao tác tập lệnh Robo khác, thao tác bỏ qua được áp dụng miễn là contextDescriptor của tập lệnh Robo chứa khớp với màn hình trong quá trình thu thập dữ liệu Robo, bất kể giá trị của thuộc tính priority và maxNumberOfRuns.

Sau đây là ví dụ về một tệp có hai tập lệnh Robo. Tập lệnh Robo đầu tiên khiến Robo bỏ qua tất cả tiện ích giao diện người dùng trên màn hình chứa một tiện ích giao diện người dùng có mã nhận dạng tài nguyên "my.app.package:id/ignored_screen". Tập lệnh Robo thứ hai khiến Robo bỏ qua các tiện ích giao diện người dùng có mã nhận dạng tài nguyên khớp với biểu thức chính quy Java ".*:id/done" trên màn hình chứa một tiện ích giao diện người dùng có mã nhận dạng tài nguyên "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"
          }
        ]
      }
    ]
  }
]

Hỗ trợ RecyclerView và AdapterView

Các thành phần con của tiện ích RecyclerView và AdapterView được tải động và có thể hiển thị nhiều lần vuốt ra khỏi màn hình hiện tại. Vì kích thước màn hình và số lần vuốt cần thiết để chuyển đến thành phần con này khác nhau tuỳ theo kiểu dáng thiết bị, nên bạn nên dựa vào vị trí dữ liệu của thành phần con (là vị trí tuyệt đối) để có kết quả chính xác hơn. Đây là một phương pháp ít hiệu quả hơn khi dựa vào số lần vuốt cần thiết để đưa thành phần con này lên màn hình, sau đó sử dụng vị trí màn hình của thành phần con đó.

Do đó, tập lệnh Robo sẽ ghi lại các vị trí dữ liệu tuyệt đối của các thành phần con RecyclerView là mục tiêu của các hành động trong tập lệnh Robo dưới dạng recyclerViewChildPosition. Tập lệnh Robo cũng ghi lại vị trí dữ liệu tuyệt đối của các thành phần con AdapterView là mục tiêu của các thao tác tập lệnh Robo dưới dạng adapterViewChildPosition.

Các thao tác trên RecyclerView và AdapterView con được thực hiện theo các bước sau:

  1. Kiểm thử Robo đảm bảo rằng thành phần con tương ứng được hiển thị trên màn hình thông qua thao tác định vị trên RecyclerView hoặc AdapterView chứa thành phần con đó.

  2. Kiểm thử Robo thực hiện thao tác đã ghi trực tiếp trên phần tử con, vì phần tử con này đã hiển thị trên màn hình.

Sau đây là ví dụ về thao tác nhấp trên một thành phần con 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
    }
  ]
}

Sau đây là ví dụ về thao tác nhấp trên một thành phần con 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
    }
  ]
}

Ghi lại tập lệnh Robo trong Android Studio và chạy tập lệnh đó trong Test Lab

Bạn có thể tạo tập lệnh Robo trong Android Studio. Tập lệnh này sẽ được lưu dưới dạng tệp JSON. Sau đó, bạn có thể tải tệp JSON lên Firebase Test Lab bằng ứng dụng và chạy kiểm thử tương ứng.

Khi bạn chạy kiểm thử Robo bằng một tập lệnh đính kèm, trước tiên, kiểm thử Robo sẽ thực hiện các bước thông qua các hành động có trong tập lệnh trước rồi mới tiến hành kiểm thử ứng dụng như thường lệ.

Để tạo tệp JSON tập lệnh Robo trong Android Studio, hãy làm theo các bước trong phần Ghi lại tập lệnh Robo bằng Test Lab trong Android Studio.

Thao tác trong tập lệnh Robo

Thuộc tính không bắt buộc phổ biến sau đây áp dụng cho tất cả hành động:

  • description – giúp theo dõi quá trình thực thi hành động tập lệnh Robo này trong đầu ra kiểm thử Robo.

Câu nhận định

Nếu điều kiện được xác nhận là đúng, tập lệnh Robo sẽ tiếp tục thao tác tiếp theo, có thể là một xác nhận khác. Nếu không, quá trình thực thi tập lệnh Robo sẽ bị tạm dừng do không xác nhận được.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "ASSERTION" --
contextDescriptor Mô tả ngữ cảnh hoặc điều kiện được xác nhận. Tệp này có cùng cấu trúc và cung cấp các chức năng tương tự như contextDescriptor của tập lệnh Robo.

Sau đây là ví dụ về câu nhận định tập lệnh Robo kiểm tra để đảm bảo rằng ứng dụng đang được kiểm thử đang chạy ở nền trước:

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

Sau đây là ví dụ về câu nhận định tập lệnh Robo kiểm tra xem một tiện ích giao diện người dùng có mã nhận dạng tài nguyên "com.google.samples.apps.topeka:id/done" có xuất hiện trên màn hình hay không:

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

Sau đây là ví dụ về câu nhận định tập lệnh Robo kiểm tra xem "Settings" KHÔNG được phát hiện trên màn hình bằng OCR:

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

Nhấp chuột

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
eventType Chỉ định loại thao tác tập lệnh Robo.
"eventType": "VIEW_CLICKED" Nhấp vào phần tử mục tiêu của ứng dụng đang được kiểm thử.
"eventType": "SOFT_KEYBOARD_CLICK" Nhấp vào phần tử mục tiêu của bàn phím mềm.
"eventType": "SOFT_KEYBOARD_RANDOM_CLICK" Nhấp vào các phần tử ngẫu nhiên của bàn phím mềm tối đa là maxNumberOfRuns lần.
"eventType": "LIST_ITEM_CLICKED" Được trình ghi tập lệnh Robo trong Android Studio sử dụng để nhấp vào các mục trong danh sách.
elementDescriptors Xác định tiện ích giao diện người dùng đã nhấp bằng hệ phân cấp giao diện người dùng Android. Loại trừ lẫn nhau với visionText.
visionText Xác định phần tử được nhấp bằng công nghệ OCR. Loại trừ lẫn nhau với elementDescriptors.
matchIndex Chỉ định chỉ mục của lần xuất hiện phần tử mục tiêu được so khớp, khi phần tử mục tiêu được xác định bằng visionText. Nếu là 0, hành động tập lệnh Robo sẽ chọn phần tử được so khớp đầu tiên, nếu là 1, hành động tập lệnh Robo sẽ chọn phần tử được so khớp thứ hai, v.v. Thứ tự được xác định từ trái sang phải, từ trên xuống dưới. Giá trị mặc định là 0 (kết quả trùng khớp đầu tiên được chọn).
maxNumberOfRuns Chỉ định số lần nhấp vào một phần tử ngẫu nhiên của bàn phím mềm, khi eventType là SOFT_KEYBOARD_RANDOM_CLICK. Giá trị mặc định là 1.

Sau đây là ví dụ về một hành động trong tập lệnh Robo nhấp vào nút có mã nhận dạng tài nguyên "com.google.samples.apps.topeka:id/done":

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

Sau đây là ví dụ về một thao tác tập lệnh Robo nhấp vào lần xuất hiện thứ hai của từ "Search" được phát hiện trên màn hình bằng OCR:

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

Sau đây là ví dụ về một thao tác tập lệnh Robo nhấp vào một phần tử bàn phím mềm có nội dung mô tả "Emoji button":

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

Sau đây là ví dụ về một hành động tập lệnh Robo nhấp vào các thành phần bàn phím mềm ngẫu nhiên tối đa 5 lần:

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

Tắt bàn phím mềm

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "DISABLE_KEYBOARD" --

Sau đây là ví dụ về một thao tác tập lệnh Robo vô hiệu hoá bàn phím mềm:

{
  "eventType": "DISABLE_KEYBOARD"
}

Thực thi lệnh shell adb

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "ADB_SHELL_COMMAND" --
command Lệnh shell Cầu gỡ lỗi Android (adb) để thực thi.

Thuộc tính sau đây là không bắt buộc:

  • expectedOutputRegex – kết quả dự kiến của lệnh dưới dạng biểu thức chính quy Java. Nếu kết quả không khớp, thao tác tập lệnh Robo sẽ không thành công. Theo mặc định, đó là một chuỗi trống, nghĩa là đầu ra không được kiểm tra.

Sau đây là ví dụ về một hành động trong tập lệnh Robo giúp xoá dữ liệu người dùng của ứng dụng đang được kiểm thử:

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

Cấp quyền

Thao tác này được ghi lại bằng trình ghi tập lệnh Robo trong Android Studio để tương thích ngược với Trình ghi lại quá trình kiểm thử Espresso. Kiểm thử Robo cấp tất cả quyền cho ứng dụng đang được kiểm thử ở đầu mỗi lần thu thập thông tin. Do đó, thao tác này không có tác dụng. ĐỪNG sử dụng thao tác này trong tập lệnh Robo.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "PERMISSIONS_REQUEST" --

Bỏ qua tất cả các phần tử trên màn hình

Thao tác này khiến Robo bỏ qua tất cả các phần tử trên màn hình bất kỳ kích hoạt tập lệnh Robo chứa.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "ALL_ELEMENTS_IGNORED" --

Sau đây là ví dụ về một thao tác tập lệnh Robo khiến Robo bỏ qua tất cả các phần tử trên màn hình:

{
  "eventType": "ALL_ELEMENTS_IGNORED"
}

Bỏ qua phần tử

Thao tác này khiến Robo bỏ qua một phần tử (hoặc các phần tử) khớp với elementDescriptors đã chỉ định.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "ELEMENT_IGNORED" --
elementDescriptors Xác định(các) tiện ích giao diện người dùng bị bỏ qua bằng hệ phân cấp giao diện người dùng Android.

Thuộc tính sau đây là không bắt buộc:

  • ignoreChildren – nếu được đặt thành true, Robo cũng bỏ qua tất cả phần tử con của(các) tiện ích giao diện người dùng bị bỏ qua. Theo mặc định, giá trị này là false.

Sau đây là ví dụ về một hành động trong tập lệnh Robo khiến Robo bỏ qua tất cả các phần tử có nội dung mô tả bắt đầu bằng "Avatar":

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

Văn bản đầu vào

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
eventType Chỉ định loại thao tác tập lệnh Robo.
"eventType": "VIEW_TEXT_CHANGED" Nhập văn bản đã cho vào tiện ích giao diện người dùng mục tiêu.
"eventType": "ENTER_TEXT" nhập văn bản đã cho vào tiện ích giao diện người dùng mục tiêu, sau đó gửi sự kiện KEYCODE_ENTER đến tiện ích giao diện người dùng này.
elementDescriptors Xác định tiện ích giao diện người dùng mục tiêu bằng hệ phân cấp giao diện người dùng Android.
replacementText Văn bản cần nhập vào tiện ích giao diện người dùng mục tiêu.

Sau đây là ví dụ về một thao tác tập lệnh Robo nhập "John" vào một tiện ích giao diện người dùng có mã nhận dạng tài nguyên "com.google.samples.apps.topeka:id/first_name":

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

Nhấp và giữ

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "VIEW_LONG_CLICKED" --
elementDescriptors Xác định tiện ích giao diện người dùng mục tiêu bằng hệ phân cấp giao diện người dùng Android. Tương tác lẫn nhau với visionText.
visionText Xác định phần tử được nhấp và giữ bằng OCR. Loại trừ lẫn nhau với elementDescriptors.
matchIndex Chỉ định chỉ mục của lần xuất hiện phần tử mục tiêu được so khớp, khi phần tử mục tiêu được xác định bằng visionText. Nếu là 0, hành động tập lệnh Robo sẽ chọn phần tử được so khớp đầu tiên, nếu là 1, hành động tập lệnh Robo sẽ chọn phần tử được so khớp thứ hai, v.v. Thứ tự được xác định từ trái sang phải, từ trên xuống dưới. Giá trị mặc định là 0 (kết quả trùng khớp đầu tiên được chọn).

Thuộc tính sau đây là không bắt buộc:

  • delayTime – chỉ định thời lượng nhấn và giữ của một lượt nhấp và giữ, tính bằng mili giây.

Sau đây là ví dụ về một thao tác tập lệnh Robo thực hiện một lượt nhấp kéo dài 5 giây trên một tiện ích giao diện người dùng có nội dung mô tả "Avatar 8":

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

Thực hiện cử chỉ một điểm

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "ONE_POINT_GESTURE" --
coordinates Hai toạ độ cho một cử chỉ một điểm, được định dạng là "(x1,y1)->(x2,y2)" dưới dạng tỷ lệ phần trăm hoặc pixel.

Thuộc tính sau đây là không bắt buộc:

  • dragAndDrop – nếu được đặt thành true, cử chỉ một điểm sẽ thực hiện thao tác kéo và thả. Theo mặc định, giá trị này là false.

Sau đây là ví dụ về thao tác cử chỉ một điểm của tập lệnh Robo thực hiện thao tác vuốt xuống:

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

Thực hiện cử chỉ hai điểm

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "TWO_POINT_GESTURE" --
coordinates Bốn toạ độ cho một cử chỉ hai điểm, được định dạng là "(x1,y1)->(x2,y2),(x3,y3)->(x4,y4)" dưới dạng tỷ lệ phần trăm hoặc pixel.

Sau đây là ví dụ về một thao tác tập lệnh Robo thực hiện cử chỉ chụm vào:

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

Thực hiện thao tác IME

Thao tác này nhấn nút hành động hiện tại, ví dụ: tiếp theo, xong và tìm kiếm, trên Trình chỉnh sửa phương thức nhập (IME) cho tiện ích giao diện người dùng mục tiêu đã chỉ định.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "PRESSED_EDITOR_ACTION" --
elementDescriptors Xác định tiện ích giao diện người dùng mục tiêu bằng hệ phân cấp giao diện người dùng Android.

Sau đây là ví dụ về một thao tác tập lệnh Robo thực hiện thao tác IME trên một tiện ích giao diện người dùng có mã nhận dạng tài nguyên "com.google.samples.apps.topeka:id/first_name":

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

Nhấn nút quay lại

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
eventType Chỉ định loại thao tác tập lệnh Robo.
"eventType": "PRESSED_BACK" Gửi sự kiện KEYCODE_BACK đến thiết bị.
"eventType": "PRESSED_BACK_EMULATOR_28" Được trình ghi tập lệnh Robo trong Android Studio sử dụng để nhấn nút quay lại trên trình mô phỏng API 28.

Sau đây là ví dụ về thao tác nhấn quay lại trong tập lệnh Robo:

{
  "eventType": "PRESSED_BACK"
}

Nhấn vào nút màn hình chính

Thao tác này sẽ gửi một sự kiện KEYCODE_HOME đến thiết bị.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "GO_HOME" --

Sau đây là ví dụ về một thao tác tập lệnh Robo nhấn vào màn hình chính:

{
  "eventType": "GO_HOME"
}

Cuộn một phần tử vào khung hiển thị

Thao tác này khiến Robo kiểm thử cuộn về phía trước tiện ích giao diện người dùng khớp với elementDescriptors đã chỉ định cho đến khi tiện ích giao diện người dùng khớp với childElementDescriptors đã chỉ định xuất hiện trên màn hình hoặc không thể cuộn tiện ích đã cuộn nữa hoặc đã đạt đến số lần cuộn tối đa là 50.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "ELEMENT_SCROLL_INTO_VIEW" --
elementDescriptors Xác định tiện ích giao diện người dùng cuộn bằng hệ phân cấp giao diện người dùng Android.
childElementDescriptors Xác định tiện ích giao diện người dùng cần cuộn đến bằng hệ phân cấp giao diện người dùng Android.

Sau đây là ví dụ về một thao tác tập lệnh Robo cuộn tiện ích giao diện người dùng bằng mã nhận dạng tài nguyên "my.app.package:id/scrollable_card_container" cho đến khi tiện ích giao diện người dùng có văn bản "Orange" xuất hiện trên màn hình (hoặc không thể cuộn thêm hoặc đã đạt đến số lần cuộn tối đa là 50):

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

Trượt

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "VIEW_SWIPED" --
swipeDirection Chỉ định hướng vuốt:
  • Left
  • Right
  • Up
  • Down
  • Forward – Down hoặc Right tuỳ thuộc vào khả năng cuộn theo chiều dọc hoặc chiều ngang của tiện ích giao diện người dùng mục tiêu.
  • Backward – Up hoặc Left tuỳ thuộc vào khả năng cuộn theo chiều dọc hoặc chiều ngang của tiện ích giao diện người dùng đích.
elementDescriptors Xác định tiện ích giao diện người dùng mục tiêu bằng hệ phân cấp giao diện người dùng Android.

Sau đây là ví dụ về một thao tác tập lệnh Robo vuốt lên một tiện ích giao diện người dùng có mã nhận dạng tài nguyên "my.app.package:id/custom_content":

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

Chụp ảnh màn hình

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "TAKE_SCREENSHOT" --
screenshotName Chỉ định tên tệp ảnh chụp màn hình.

Sau đây là ví dụ về một hành động trong tập lệnh Robo chụp ảnh màn hình:

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

Nhấn vào một điểm trên màn hình

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "POINT_TAP" --
pointTapXCoordinate Toạ độ X theo pixel của điểm nhấn. Loại trừ lẫn nhau với pointTapXPercent và pointTapYPercent.
pointTapYCoordinate Toạ độ Y theo pixel của điểm nhấn. Loại trừ lẫn nhau với pointTapXPercent và pointTapYPercent.
pointTapXPercent Toạ độ X theo tỷ lệ phần trăm của điểm nhấn. Loại trừ lẫn nhau với pointTapXCoordinate và pointTapYCoordinate.
pointTapYPercent Toạ độ Y theo tỷ lệ phần trăm của điểm nhấn. Loại trừ lẫn nhau với pointTapXCoordinate và pointTapYCoordinate.

Sau đây là ví dụ về thao tác trong tập lệnh Robo nhấn vào giữa màn hình:

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

Nhấn vào một điểm trong phần tử

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "POINT_TAP_ELEMENT" --
pointTapXPercent Toạ độ X theo tỷ lệ phần trăm trong phần tử mục tiêu.
pointTapYPercent Toạ độ Y theo tỷ lệ phần trăm trong phần tử mục tiêu.
elementDescriptors Xác định tiện ích giao diện người dùng mục tiêu bằng hệ phân cấp giao diện người dùng Android.

Sau đây là ví dụ về một thao tác tập lệnh Robo di chuyển thanh trượt của thanh tua sang phải:

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

Chấm dứt quá trình thu thập dữ liệu

Thao tác này sẽ dừng kiểm thử Robo.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "TERMINATE_CRAWL" --

Sau đây là ví dụ về một thao tác tập lệnh Robo dừng kiểm thử Robo:

{
  "eventType": "TERMINATE_CRAWL"
}

Đợi

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "DELAYED_MESSAGE_POSTED" --
delayTime Chỉ định thời gian chờ, tính bằng mili giây.

Sau đây là ví dụ về một hành động tập lệnh Robo chờ 3 giây:

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

Chờ một phần tử

Thao tác này khiến quy trình kiểm thử Robo chờ một phần tử xuất hiện trên màn hình trong khoảng thời gian chờ đã chỉ định.

Bảng sau đây liệt kê các thuộc tính bắt buộc:

Thuộc tính Nội dung mô tả
"eventType": "WAIT_FOR_ELEMENT" --
delayTime Chỉ định thời gian chờ, tính bằng mili giây.
elementDescriptors Xác định tiện ích giao diện người dùng đã chờ bằng hệ phân cấp giao diện người dùng Android.

Sau đây là ví dụ về một thao tác tập lệnh Robo chờ tối đa 30 giây để một tiện ích giao diện người dùng có mã nhận dạng tài nguyên "my.app.package:id/confirmation_button" xuất hiện trên màn hình:

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

Các bước tiếp theo