Panduan referensi skrip Robo

Dokumen ini memberikan informasi referensi tentang skrip Robo, termasuk struktur, kemampuan, penggunaan, perekaman, dan tindakan. Skrip Robo adalah pengujian yang mengotomatiskan tugas jaminan kualitas (QA) manual untuk aplikasi seluler, serta mengaktifkan strategi continuous integration (CI) dan pengujian pra-peluncuran. Skrip Robo adalah file JSON yang mendeskripsikan urutan antarmuka pengguna (UI) dan tindakan lainnya.

Anda dapat membuat skrip Robo dengan cara berikut:

• Gunakan fitur perekaman skrip Robo. (Khusus Android)

• Buat skrip Robo secara manual. (Android dan iOS+)

• Rekam skrip Robo, lalu edit secara manual. (Khusus Android)

Untuk mempelajari lebih lanjut penggunaan skrip Robo, lihat Menjalankan skrip Robo.

Pengantar

Skrip Robo disediakan untuk Uji Robo bersama input lain seperti Paket Aplikasi Android (APK) dari aplikasi yang sedang diuji.

Berikut adalah contoh skrip Robo yang membuat memproses login pengguna ke aplikasi, yang dipicu saat aplikasi yang sedang diuji diluncurkan:

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

Jika ada satu skrip Robo dalam file dan skrip tersebut memiliki kondisi pemicu app_under_test_shown default, seperti dalam contoh di atas, Anda dapat menentukan skrip Robo dalam file menggunakan format yang lebih sederhana - cukup sebagai urutan tindakannya:

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

Dukungan iOS+ untuk skrip Robo

Robo untuk iOS+ (Beta) memiliki dukungan terbatas untuk skrip Robo. Sintaksis skrip Robo untuk iOS+ identik dengan sintaksis Android, dan fitur iOS+ yang didukung berperilaku mirip dengan versi Android.

Tindakan berikut ini didukung di iOS+:

• Pernyataan
• Klik
• Klik lama
• Tindakan geser
• Abaikan semua elemen
• Tunggu
• Mengambil screenshot
• Menghentikan crawling

Atribut pengidentifikasi berikut dalam deskripsi elemen didukung di iOS+:

• Nama kelas
• Nama class ancestor
• Deskripsi konten (dan regex)
• Teks (dan regex)

Kondisi pemicu di deskripsi konteks berikut didukung di iOS+:

• Aplikasi yang sedang diuji ditampilkan
• Terdapat elemen
• Tindakan skrip Non-Robo dilakukan

Struktur

Skrip Robo memiliki beberapa atribut yang menjelaskan cara Robo menjalankannya. Sebagian besar atribut ini bersifat opsional dengan nilai default yang telah ditentukan:

Satu file berisi kumpulan satu atau beberapa skrip Robo.

Berikut adalah contoh file dengan dua skrip Robo yang tidak kondisional, masing-masing dengan satu tindakan yang dijalankan satu kali di awal crawling:

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

Deskripsi konteks

Deskripsi konteks menentukan konteks atau kondisi yang memicu skrip Robo menggunakan satu atau kombinasi beberapa atribut:

Berikut adalah contoh skrip Robo yang dipicu oleh widget UI dengan ID resource "my.app.package:id/page_header" yang ada di layar:

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

Berikut adalah contoh skrip Robo yang dipicu oleh "Privacy Policy" yang terdeteksi oleh Pengenalan Karakter Optik (OCR):

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

Berikut adalah contoh skrip Robo yang menunggu 5 detik setelah setiap tindakan yang tidak melibatkan skrip Robo:

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

Tindakan

Setiap tindakan dalam skrip Robo direpresentasikan sebagai paket dari satu atau beberapa pasangan nilai atribut, yang dijelaskan dalam tabel berikut:

Berikut adalah contoh skrip Robo dengan dua tindakan tanpa widget UI target, yang berarti bahwa tindakan ini tidak beroperasi pada widget UI tertentu:

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

Deskripsi elemen

Deskripsi elemen mengidentifikasi widget UI menggunakan satu atau beberapa atribut identifikasi berikut:

Sering kali atribut ini tidak ditentukan. Misalnya, tombol mungkin tidak memiliki deskripsi konten dan teks. Meskipun ada beberapa nilai atribut, nilai tersebut mungkin tidak unik pada layar aplikasi tertentu (termasuk resourceId).

Misalnya, membedakan antara item daftar biasanya hanya dapat dilakukan dengan menggunakan posisi turunan yang berbeda di dalam widget induknya. Artinya, hanya menggunakan satu deskripsi elemen untuk mengidentifikasi widget UI biasanya tidak cukup. Oleh karena itu, atribut elementDescriptors tindakan berisi urutan deskripsi elemen yang diurutkan sehingga yang pertama terkait dengan widget UI target, yang kedua sesuai dengan widget induk dari widget UI target, dan seterusnya. Widget UI target dari suatu tindakan akan cocok saat semua deskripsi elemennya cocok dengan sub-hierarki widget UI yang sesuai.

Berikut adalah contoh skrip Robo dengan perubahan teks dan tindakan klik, yang keduanya mengharuskan Anda mengidentifikasi widget UI target menggunakan deskripsi elemen yang disediakan:

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

Opsi eksekusi

Jika ingin, Anda dapat menambahkan awalan ke daftar tindakan dalam skrip Robo dengan objek JSON yang menentukan opsi eksekusi untuk skrip Robo tersebut. Header konfigurasi ini dimulai dengan kata kunci roboscript diikuti dengan representasi JSON dari opsi eksekusi yang diinginkan.

Skrip Robo mendukung opsi eksekusi berikut:

• executionMode - opsi eksekusi yang diterapkan saat skrip Robo berjalan:
  • strict - jika ditetapkan ke true, skrip Robo tidak akan menggunakan pencocokan sebagian, melewatkan tindakan saat ini, dan penangguhan. Artinya, skrip Robo dijalankan sebagai uji instrumentasi reguler dan akan segera gagal setelah tindakannya tidak dapat dilakukan. Secara default, nilainya adalah false.
  • dismiss_popups - jika ditetapkan ke true, Uji Robo akan menutup dialog yang tidak terduga saat menjalankan skrip Robo bahkan dalam mode strict. Opsi ini tidak berpengaruh jika tidak dalam mode strict. Secara default, nilainya adalah false.
  • notify - jika ditetapkan ke false, skrip Robo tidak akan menampilkan notifikasi di layar di awal dan akhir eksekusinya. Secara default, nilainya adalah true.
• postscript - opsi eksekusi yang diterapkan setelah skrip Robo selesai:
  • terminate - jika ditetapkan ke true, Uji Robo akan menghentikan crawling setelah skrip Robo selesai. Secara default, nilainya adalah false.

Berikut adalah contoh skrip Robo yang dijalankan dalam mode strict tanpa notifikasi di layar yang tidur selama tiga detik, setelah itu crawling berhenti:

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

Parameter template

Parameter template adalah placeholder dalam skrip Robo yang diganti dengan nilai sebenarnya saat Uji Robo memuat skrip Robo tersebut untuk dijalankan. Parameter template diawali dengan garis bawah ganda yang diikuti dengan tanda persen, dan diberi akhiran tanda persen yang diikuti dengan garis bawah ganda.

Skrip Robo mendukung parameter template berikut:

• __%APP_PACKAGE_NAME%__ - nama paket aplikasi yang sedang diuji.

Berikut adalah contoh skrip Robo yang menghentikan proses pengujian aplikasi:

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

Komentar

Skrip Robo dapat berisi baris komentar, yaitu baris yang diawali dengan # atau //.

Berikut adalah contoh skrip Robo dengan beberapa komentar:

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

Kemampuan

Secara default, hingga semua tindakan skrip Robo diselesaikan (atau setidaknya dicoba), skrip Robo akan tetap aktif. Uji Robo akan terus mencoba mencocokkan tindakan skrip Robo setiap kali memilih tindakan yang akan dilakukan. Skrip Robo menerapkan teknik berikut untuk meningkatkan keandalan:

Prioritas

Jika skrip Robo mencapai maxNumberOfRuns, skrip tersebut tidak dapat lagi dipicu dalam crawl tertentu. Jika lebih dari satu skrip Robo dapat dipicu oleh konteks saat ini, prioritas akan diberikan dengan memilih, dalam urutan berikut, skrip Robo yang:

1. Memiliki atribut contextDescriptor.
2. Memiliki priority tertinggi (secara default, semua skrip Robo memiliki priority eksekusi yang sama, yaitu 1).
3. Muncul paling awal dalam daftar skrip Robo, jika prioritas skrip Robo sama.

Berikut adalah contoh file dengan tiga skrip Robo yang melakukan tindakan yang sama dan dipicu oleh kondisi yang sama, yaitu aplikasi yang sedang diuji berada di latar depan:

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

Jika aplikasi yang sedang diuji berjalan di latar depan, Robo memicu hal berikut secara berurutan:

1. "Robo script 2" karena memiliki prioritas tertinggi.
2. "Robo script 1" karena skrip tersebut muncul lebih awal di antara skrip Robo berprioritas sama yang berlaku dan tersisa.
3. "Robo script 3" sebagai skrip Robo terakhir yang berlaku.

Operasi berulang

Secara default, Robo memicu skrip Robo paling banyak sekali selama crawling. Ini dapat disesuaikan melalui atribut maxNumberOfRuns.

Berikut adalah contoh skrip Robo yang membawa aplikasi yang sedang diuji ke latar belakang hingga 10 kali:

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

Tahap crawling

Skrip Robo berlaku pada berbagai tahap crawling Robo tertentu:

Jika atribut crawlStage dari suatu skrip Robo tidak ditentukan, atribut tersebut secara tersirat adalah crawl.

Berikut adalah contoh skrip Robo yang menghapus data pengguna aplikasi yang sedang diuji sebelum Robo mulai meng-crawl-nya:

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

Berikut adalah contoh skrip Robo yang menginstruksikan Robo untuk mengklik "Cancel" setiap kali mencoba untuk kembali (backtrack) dari dialog konfirmasi:

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

Tindakan kondisional

Skrip Robo dapat berisi tindakan kondisional. Tindakan kondisional memiliki tiga atribut tambahan yang menjelaskan cara Robo melakukan tindakan tersebut:

Saat dipicu, skrip Robo melakukan tindakan non-kondisional satu per satu sesuai urutan kemunculan. Jika skrip Robo berisi tindakan kondisional, skrip tersebut akan dipertimbangkan setiap kali sebelum memilih tindakan non-kondisional yang akan dilakukan. Jika tindakan kondisional dipicu dan dipilih berdasarkan prioritasnya dan jumlah operasi yang tersisa, skrip Robo akan melakukan tindakan kondisional ini. Jika tidak, skrip Robo akan melakukan tindakan non-kondisional berikut. Agar valid, skrip Robo harus berisi setidaknya satu tindakan non-kondisional.

Berikut adalah contoh skrip Robo yang tidak kondisional dengan tindakan kondisional yang menutup dialog pop-up jika muncul kapan saja selama eksekusi skrip 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
    }
}

Mengabaikan tindakan

Skrip Robo dapat berisi instruksi bagi Robo untuk mengabaikan widget UI tertentu atau semua widget UI di layar tertentu. Instruksi ini diwakili sebagai mengabaikan "tindakan" dengan eventType ELEMENT_IGNORED dan ALL_ELEMENTS_IGNORED secara bersamaan.

Setiap kali atribut contextDescriptor dari skrip Robo yang berisi tindakan mengabaikan cocok dengan layar tertentu, Robo tidak berinteraksi dengan widget UI apa pun yang ditargetkan melalui tindakan pengabaiannya (kecuali jika beberapa tindakan skrip Robo lainnya membuat Robo melakukan tindakan pada salah satu widget UI yang diabaikan).

Skrip Robo dapat berisi campuran tindakan mengabaikan, kondisional, dan non-kondisional. Tidak seperti tindakan skrip Robo lainnya, tindakan mengabaikan akan diterapkan asalkan contextDescriptor skrip Robo yang memuatnya cocok dengan layar selama crawling Robo, terlepas dari nilai atribut priority dan maxNumberOfRuns.

Berikut adalah contoh file dengan dua skrip Robo. Skrip Robo pertama membuat Robo mengabaikan semua widget UI di layar yang berisi widget UI dengan ID resource "my.app.package:id/ignored_screen". Skrip Robo kedua membuat Robo mengabaikan widget UI yang ID resource-nya cocok dengan ekspresi reguler Java ".*:id/done" di layar yang berisi widget UI dengan ID resource "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"
          }
        ]
      }
    ]
  }
]

Dukungan RecyclerView dan AdapterView

Turunan widget RecyclerView dan AdapterView dimuat secara dinamis dan mungkin ditampilkan dengan banyak tindakan menggeser dari layar saat ini. Ukuran layar dan jumlah tindakan geser yang diperlukan untuk membuka turunan ini berbeda untuk faktor bentuk perangkat yang berbeda. Oleh karena itu, mengandalkan posisi data turunan akan jauh lebih efektif dan bersifat mutlak. Mengandalkan jumlah tindakan geser yang diperlukan untuk menampilkan turunan ini ke layar, lalu menggunakan posisi layarnya, dianggap sebagai pendekatan yang kurang efektif.

Oleh karena itu, skrip Robo menangkap posisi data mutlak turunan RecyclerView yang merupakan target tindakan skrip Robo sebagai recyclerViewChildPosition. Skrip Robo juga menangkap posisi data mutlak turunan AdapterView yang menjadi target tindakan skrip Robo sebagai adapterViewChildPosition.

Tindakan pada turunan RecyclerView dan AdapterView dilakukan dalam langkah-langkah berikut:

1. Uji Robo memastikan bahwa turunan yang sesuai ditampilkan di layar melalui tindakan pemosisian pada RecyclerView atau AdapterView yang memuatnya.

2. Uji Robo menjalankan tindakan yang direkam secara langsung pada elemen turunan, karena sudah ditampilkan di layar.

Berikut adalah contoh tindakan klik pada turunan 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
    }
  ]
}

Berikut adalah contoh tindakan klik pada turunan 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
    }
  ]
}

Merekam skrip Robo di Android Studio dan menjalankannya di Test Lab

Anda dapat membuat skrip Robo di Android Studio, yang menyimpan skrip sebagai file JSON. Kemudian, Anda dapat mengupload file JSON ke Firebase Test Lab dengan aplikasi tersebut dan menjalankan pengujian dengan semestinya.

Saat Anda menjalankan Uji Robo dengan lampiran skrip, Uji Robo akan menjalankan tindakan yang telah ditulis dalam skrip terlebih dahulu, kemudian menjelajahi aplikasi seperti biasa.

Untuk membuat file JSON skrip Robo di Android Studio, ikuti langkah-langkah dalam Merekam skrip Robo menggunakan Test Lab di Android Studio.

Tindakan skrip Robo

Atribut opsional umum berikut berlaku untuk semua tindakan:

• description - membantu melacak eksekusi tindakan skrip Robo ini dalam output Uji Robo.

Pernyataan

Jika kondisi yang dinyatakan benar, skrip Robo akan melanjutkan ke tindakan berikutnya, yang dapat berupa pernyataan lain. Jika tidak, eksekusi skrip Robo akan dihentikan karena pernyataan yang gagal.

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh pernyataan skrip Robo yang memeriksa apakah aplikasi yang sedang diuji berjalan di latar depan:

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

Berikut adalah contoh pernyataan skrip Robo yang memeriksa apakah widget UI dengan ID resource "com.google.samples.apps.topeka:id/done" ada di layar:

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

Berikut adalah contoh pernyataan skrip Robo yang memeriksa bahwa "Settings" TIDAK terdeteksi di layar menggunakan OCR:

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

Klik

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang mengklik tombol dengan ID resource "com.google.samples.apps.topeka:id/done":

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

Berikut adalah contoh tindakan skrip Robo yang mengklik kemunculan kedua kata "Search" yang terdeteksi di layar menggunakan OCR:

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

Berikut adalah contoh tindakan skrip Robo yang mengklik elemen keyboard virtual dengan deskripsi konten "Emoji button":

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

Berikut adalah contoh tindakan skrip Robo yang mengklik elemen keyboard virtual acak hingga lima kali:

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

Menonaktifkan keyboard virtual

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang menonaktifkan keyboard virtual:

{
  "eventType": "DISABLE_KEYBOARD"
}

Menjalankan perintah shell adb

Tabel berikut mencantumkan atribut yang diperlukan:

Atribut berikut bersifat opsional:

• expectedOutputRegex - output yang diharapkan dari perintah sebagai ekspresi reguler Java. Jika output-nya tidak cocok, tindakan skrip Robo akan gagal. Secara default, string ini kosong, yang berarti output tidak diperiksa.

Berikut adalah contoh tindakan skrip Robo yang menghapus data pengguna aplikasi yang sedang diuji:

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

Berikan izin

Tindakan ini direkam oleh perekam skrip Robo di Android Studio untuk kompatibilitas mundur dengan Espresso Test Recorder. Uji Robo memberikan semua izin ke aplikasi yang sedang diuji di awal setiap crawling, sehingga tindakan ini tidak beroperasi. JANGAN gunakan tindakan ini dalam skrip Robo.

Tabel berikut mencantumkan atribut yang diperlukan:

Mengabaikan semua elemen di layar

Tindakan ini akan membuat Robo mengabaikan semua elemen di layar mana pun yang memicu skrip Robo yang dimuatnya.

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang membuat Robo mengabaikan semua elemen di layar:

{
  "eventType": "ALL_ELEMENTS_IGNORED"
}

Mengabaikan suatu elemen

Tindakan ini akan membuat Robo mengabaikan suatu elemen (atau elemen-elemen) yang cocok dengan elementDescriptors yang ditentukan.

Tabel berikut mencantumkan atribut yang diperlukan:

Atribut berikut bersifat opsional:

• ignoreChildren - jika ditetapkan ke true, Robo juga akan mengabaikan semua turunan dari widget UI yang diabaikan. Secara default, nilainya adalah false.

Berikut adalah contoh tindakan skrip Robo yang membuat Robo mengabaikan semua elemen, yang deskripsi kontennya diawali dengan "Avatar":

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

Memasukkan teks

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang memasukkan "John" ke dalam widget UI dengan ID resource "com.google.samples.apps.topeka:id/first_name":

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

Klik lama

Tabel berikut mencantumkan atribut yang diperlukan:

Atribut berikut bersifat opsional:

• delayTime - menentukan durasi penekanan klik lama, dalam milidetik.

Berikut adalah contoh tindakan skrip Robo yang melakukan klik berdurasi lima detik pada widget UI dengan deskripsi konten "Avatar 8":

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

Melakukan gestur satu titik

Tabel berikut mencantumkan atribut yang diperlukan:

Atribut berikut bersifat opsional:

• dragAndDrop - jika ditetapkan ke true, gestur satu titik akan melakukan tindakan tarik lalu lepas. Secara default, nilainya adalah false.

Berikut adalah contoh tindakan gestur satu titik skrip Robo yang melakukan tindakan geser ke bawah:

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

Melakukan gestur dua titik

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang melakukan gestur cubit ke arah luar:

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

Melakukan tindakan IME

Tindakan ini menekan tombol tindakan saat ini, misalnya, selanjutnya, selesai, dan menelusuri, di Editor Metode Input (IME) untuk widget UI target yang ditentukan.

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang melakukan tindakan IME pada widget UI dengan ID resource "com.google.samples.apps.topeka:id/first_name":

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

Menekan kembali

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang melakukan tindakan tekan kembali:

{
  "eventType": "PRESSED_BACK"
}

Menekan beranda

Tindakan ini akan mengirim peristiwa KEYCODE_HOME ke perangkat.

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang menekan beranda:

{
  "eventType": "GO_HOME"
}

Men-scroll elemen agar muncul

Tindakan ini akan membuat Uji Robo men-scroll maju widget UI yang cocok dengan elementDescriptors yang ditentukan hingga widget UI yang cocok dengan childElementDescriptors yang ditentukan muncul di layar, atau widget yang di-scroll dapat tidak bisa lagi di-scroll, atau mencapai jumlah maksimum 50 scroll.

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang men-scroll widget UI dengan ID resource "my.app.package:id/scrollable_card_container" hingga widget UI dengan teks "Orange" muncul di layar (atau tidak ada scroll lagi yang bisa dilakukan, atau mencapai jumlah maksimum 50 scroll):

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

Tindakan geser

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang menggeser ke atas widget UI dengan ID resource "my.app.package:id/custom_content":

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

Mengambil screenshot

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang mengambil screenshot:

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

Mengetuk satu titik di layar

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang mengetuk di tengah layar:

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

Mengetuk titik dalam elemen

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang memindahkan penggeser pencari ke kanan:

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

Menghentikan crawling

Tindakan ini akan menghentikan Uji Robo.

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang menghentikan Uji Robo:

{
  "eventType": "TERMINATE_CRAWL"
}

Tunggu

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang menunggu selama tiga detik:

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

Menunggu elemen

Tindakan ini membuat Uji Robo menunggu elemen muncul di layar hingga waktu tunggu yang ditentukan.

Tabel berikut mencantumkan atribut yang diperlukan:

Berikut adalah contoh tindakan skrip Robo yang menunggu hingga 30 detik widget UI dengan ID resource "my.app.package:id/confirmation_button" muncul di layar:

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

Langkah berikutnya

• Pelajari cara menjalankan skrip Robo.