راهنمای مرجع دستورگان‌های روبات

این سند اطلاعات مرجعی درباره Robo scripts ارائه می‌دهد، ازجمله ساختار، قابلیت‌ها، کاربرد، ضبط، و کنش‌ها. اسکریپت‌های Robo آزمایش‌هایی هستند که کارهای تضمین کیفیت (QA) دستی را برای برنامه‌های تلفن همراه خودکارسازی می‌کنند و استراتژی‌های آزمایش پیش‌راه‌اندازی و ادغام مداوم (CI) را فعال می‌کنند. اسکریپت Robo یک فایل JSON است که توالی میانای کاربر (UI) و کنش‌های دیگر را توصیف می‌کند.

می‌توانید به روش‌های زیر Robo script ایجاد کنید:

• از ویژگی ضبط Robo script استفاده کنید. (فقط Android)

• اسکریپت Robo را به‌صورت دستی ایجاد کنید. (Android و iOS+)

• اسکریپت Robo را ضبط کنید و سپس آن را به‌صورت دستی ویرایش کنید. (فقط Android)

برای کسب اطلاعات بیشتر درباره استفاده از Robo scripts، به اجرای Robo script مراجعه کنید.

مقدمه

دستورگان Robo درکنار ورودی‌های دیگر مانند «بسته برنامه Android» (APK) برنامه تحت آزمایش، برای آزمایش Robo ارائه می‌شود.

در زیر نمونه‌ای از Robo script آورده شده است که کاربر را به سیستم برنامه وارد می‌کند، که وقتی برنامه تحت آزمایش راه‌اندازی می‌شود، فعال می‌شود:

[
  {
    "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 script در فایل وجود داشته باشد و دارای شرط راه‌اندازی پیش‌فرض app_under_test_shown باشد، همان‌طور که در مثال بالا نشان داده شده است، می‌توانید Robo script را در فایل بااستفاده از قالب ساده‌تری مشخص کنید - درست مانند توالی کنش‌های آن:

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

پشتیبانی iOS+‎ از Robo scripts

Robo برای iOS+ (نسخه بتا) پشتیبانی محدودی برای Robo scripts دارد. نحو دستورگان Robo برای iOS+‎ با نحو Android یکسان است و ویژگی‌های پشتیبانی‌شده iOS+‎ رفتاری مشابه با همتایان Android خود دارند.

کنش‌های زیر در iOS+‎ پشتیبانی می‌شود:

• اثبات
• کلیک
• کلیک طولانی
• کشیدن
• نادیده گرفتن همه عنصر(ها)
• انتظار
• نماگرفت گرفتن
• پایان دادن به خزیدن

مشخصه‌های شناسایی زیر در توصیف‌کننده‌های عنصر در iOS+‎ پشتیبانی می‌شوند:

• نام کلاس
• نام کلاس نیا
• شرح محتوا (و عبارت باقاعده)
• نوشتار (و عبارت باقاعده)

شرایط راه‌انداز زیر در توصیف‌کننده‌های بافت در iOS+‎ پشتیبانی می‌شود:

• برنامه تحت آزمایش نشان داده می‌شود
• عنصر موجود است
• کنش اسکریپت غیرروباتیک انجام شد

ساختار

یک Robo script چندین ویژگی دارد که نحوه اجرای آن توسط Robo را توصیف می‌کند. اکثر این مشخصه‌ها اختیاری هستند و مقادیر پیش‌فرض ازپیش‌تعریف‌شده دارند:

یک فایل حاوی مجموعه‌ای از یک یا چند Robo script است.

در زیر نمونه‌ای از فایل با دو Robo script غیرمشروط آورده شده است که هرکدام یک کنش دارند که یک‌بار در شروع خزیدن اجرا می‌شود:

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

توصیف‌گر بافت

توصیف‌کننده بافت، بافت یا شرایطی را تعریف می‌کند که بااستفاده از یک یا ترکیبی از چند مشخصه، راه‌انداز Robo script است:

در زیر نمونه‌ای از دستور Robo آورده شده است که با وجود ابزارک میانای کاربری با شناسه منبع "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 script آورده شده است که با "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 ارائه شده است که پس‌از هر کنش Robo غیردستورگانی، ۵ ثانیه صبر می‌کند:

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

کنش‌ها

هر کنش در دستور Robo به‌صورت دسته‌ای از یک یا چند جفت مقدار-ویژگی نشان داده می‌شود که در جدول زیر شرح داده شده است:

در زیر نمونه‌ای از دستورگان Robo با دو کنش بدون ابزاره‌های هدف واسط کاربر آورده شده است، یعنی این کنش‌ها روی ابزاره واسط کاربر خاصی اجرا نمی‌شوند:

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

توصیف‌گرهای عنصر

توصیف‌کننده عنصر، ابزارک واسط کاربر را بااستفاده از یک یا چند مورد از مشخصه‌های شناسایی زیر شناسایی می‌کند:

اغلب این مشخصه‌ها تعریف‌نشده هستند، برای مثال، ممکن است دکمه‌ای نوشتار و شرح محتوا نداشته باشد. حتی اگر برخی‌از مقادیر مشخصه وجود داشته باشند، ممکن است در صفحه برنامه خاصی (ازجمله resourceId) منحصربه‌فرد نباشند.

برای مثال، تمایز بین موارد یک فهرست معمولاً فقط بااستفاده از موقعیت‌های فرزند متفاوت آن‌ها در ابزارک والد امکان‌پذیر است. این یعنی استفاده از فقط یک توصیف‌گر عنصر برای شناسایی ابزاره واسط کاربر معمولاً کافی نیست. بنابراین، مشخصه elementDescriptors کنش حاوی توالی توصیف‌کننده‌های عنصر است که به‌گونه‌ای مرتب شده‌اند که اولین توصیف‌کننده با ابزاره واسط کاربر هدف مطابقت دارد، دومین توصیف‌کننده با ابزاره والد ابزاره واسط کاربر هدف مطابقت دارد، و غیره. وقتی همه توصیف‌کننده‌های عنصر ابزاره واسط کاربر با زیرسلسله‌مراتب ابزاره واسط کاربر مربوطه مطابقت داشته باشد، ابزاره واسط کاربر هدف کنش مطابقت داده می‌شود.

در زیر نمونه‌ای از Robo script با کنش‌های تغییر نوشتار و کلیک آورده شده است که هر دو کنش مستلزم آن است که ابزاره واسط کاربر هدف را بااستفاده از توصیف‌کننده‌های عنصر ارائه‌شده شناسایی کنید:

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

گزینه‌های اجرا

می‌توانید به‌طور اختیاری فهرست کنش‌ها را در اسکریپت Robo با شیء JSON که گزینه‌های اجرا را برای آن اسکریپت Robo مشخص می‌کند پیشوند کنید. این سرصفحه پیکربندی با کلیدواژه roboscript شروع می‌شود و به‌دنبال آن نمایش JSON گزینه‌های اجرای موردنظر می‌آید.

اسکریپت‌های Robo از گزینه‌های اجرای زیر پشتیبانی می‌کنند:

• executionMode - گزینه‌های اجرا که هنگام اجرای Robo script اعمال می‌شود:
  • strict - اگر روی true تنظیم شده باشد، Robo script از تطابق جزئی، رد شدن از کنش فعلی، و تعلیق استفاده نمی‌کند. یعنی Robo script به‌عنوان یک آزمایش ابزار دقیق معمولی اجرا می‌شود و به‌محض اینکه هریک از کنش‌های آن قابل‌اجرا نباشد، ناموفق می‌شود. به‌طور پیش‌فرض، false است.
  • ‫dismiss_popups - اگر روی true تنظیم شده باشد، «آزمایش Robo» هرگونه گفتگوی غیرمنتظره را هنگام اجرای دستور Robo حتی در حالت strict رد می‌کند. این گزینه وقتی در حالت strict نباشید تأثیری ندارد. به‌طور پیش‌فرض، false است.
  • notify - اگر روی false تنظیم شود، Robo script اعلان‌های روی صفحه را در ابتدا و انتهای اجرایش نشان نمی‌دهد. به‌طور پیش‌فرض، true است.
• postscript - گزینه‌های اجرا که پس‌از تکمیل اسکریپت Robo اعمال می‌شوند:
  • terminate - اگر روی true تنظیم شود، آزمایش Robo پس‌از تکمیل شدن Robo script، خزیدن را متوقف می‌کند. به‌طور پیش‌فرض، false است.

در زیر نمونه‌ای از Robo script اجراشده در حالت strict بدون اعلان‌های روی صفحه آورده شده است که سه ثانیه منتظر می‌ماند و سپس خزیدن متوقف می‌شود:

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

پارامترهای الگو

پارامتر الگو جای‌بانی در Robo script است که وقتی آزمایش Robo آن Robo script را برای اجرا بار می‌کند، با مقدار واقعی جایگزین می‌شود. پارامترهای الگو با دو زیرخط و سپس علامت درصد شروع می‌شوند و با علامت درصد و سپس دو زیرخط پایان می‌یابند.

اسکریپت‌های Robo از پارامتر الگوی زیر پشتیبانی می‌کنند:

• __%APP_PACKAGE_NAME%__ - نام بسته برنامه تحت آزمایش.

در زیر نمونه‌ای از Robo script آورده شده است که فرایند برنامه تحت آزمایش را متوقف می‌کند:

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

نظرات

یک Robo script می‌تواند حاوی خطوط نظر باشد، که خطوطی هستند که با # یا // شروع می‌شوند.

در زیر نمونه‌ای از Robo script با چند نظر آورده شده است:

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

قابلیت‌ها

به‌طور پیش‌فرض، تا زمانی که همه کنش‌های Robo script تکمیل نشود (یا حداقل تلاش نشود)، Robo script فعال باقی می‌ماند. آزمایش Robo هرگاه کنشی را برای اجرا انتخاب می‌کند، تلاش می‌کند آن را با کنش اسکریپت Robo مطابقت دهد. اسکریپت Robo از تکنیک‌های زیر برای افزایش استحکام استفاده می‌کند:

اولویت‌ها

اگر Robo script به maxNumberOfRuns خود برسد، دیگر نمی‌تواند در یک خزیدن مشخص راه‌اندازی شود. اگر بیش‌از یک Robo script بتواند توسط زمینه فعلی راه‌اندازی شود، اولویت با انتخاب Robo script است که به‌ترتیب زیر:

1. دارای مشخصه contextDescriptor است.
2. بالاترین priority را داشته باشد (به‌طور پیش‌فرض، همه اسکریپت‌های Robo priority اجرای یکسان 1 دارند).
3. اگر اولویت‌های Robo script یکسان باشد، در ابتدای فهرست Robo script نشان داده می‌شود.

در زیر نمونه‌ای از فایل با سه Robo script آورده شده است که کنش یکسانی را انجام می‌دهند و با شرط یکسانی راه‌اندازی می‌شوند - برنامه تحت آزمایش در پیش‌زمینه است:

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

وقتی برنامه تحت آزمایش در پیش‌زمینه باشد، Robo موارد زیر را به‌ترتیب راه‌اندازی می‌کند:

1. "Robo script 2" چون بالاترین اولویت را دارد.
2. "Robo script 1" زیرا زودتر از سایر Robo scriptهای قابل‌اجرا با اولویت یکسان ظاهر می‌شود.
3. "Robo script 3" به‌عنوان آخرین Robo script قابل‌اجرا.

اجراهای تکراری

به‌طور پیش‌فرض، Robo درطول خزش حداکثر یک‌بار راه‌انداز Robo را فعال می‌کند. این مورد را می‌توان ازطریق مشخصه maxNumberOfRuns تنظیم کرد.

در زیر نمونه‌ای از دستور Robo ارائه شده است که برنامه تحت آزمایش را تا ۱۰ بار به پس‌زمینه می‌برد:

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

مرحله خزیدن

دستورات Robo در مراحل مختلف خزیدن Robo قابل‌اجرا هستند:

اگر مشخصه crawlStage از Robo script نامشخص باشد، به‌طور ضمنی crawl درنظر گرفته می‌شود.

در زیر نمونه‌ای از دستور Robo آورده شده است که داده‌های کاربر برنامه تحت آزمایش را پیش‌از شروع خزیدن Robo در آن پاک می‌کند:

{
  "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 script می‌تواند شامل کنش‌های شرطی باشد. کنش‌های شرطی سه مشخصه اضافی دارند که نحوه اجرای آن‌ها توسط Robo را توصیف می‌کند:

وقتی راه‌اندازی می‌شود، یک اسکریپت Robo کنش‌های غیرشرطی خود را یکی یکی به ترتیب ظاهر شدن انجام می‌دهد. اگر اسکریپت Robo حاوی کنش‌های شرطی باشد، هر بار قبل‌از انتخاب کنش غیرشرطی برای اجرا، این کنش‌ها درنظر گرفته می‌شوند. اگر کنش شرطی‌ای راه‌اندازی شود و براساس اولویت و تعداد اجراهای باقی‌مانده انتخاب شود، سپس Robo script این کنش شرطی را انجام می‌دهد. درغیراین‌صورت، Robo script کنش غیرشرطی زیر را انجام می‌دهد. برای معتبر بودن، Robo script باید حداقل یک کنش غیرشرطی داشته باشد.

در زیر نمونه‌ای از اسکریپت 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": "WAIT",
      "delayTime": 10000
    },
    {
      "description": "Screen on",
      "eventType": "ADB_SHELL_COMMAND",
      "command": "input keyevent 82"
    },
    {
      "description": "Wait for 10 seconds",
      "eventType": "WAIT",
      "delayTime": 10000
    }
}

نادیده گرفتن کنش‌ها

یک Robo script می‌تواند حاوی دستورالعمل‌هایی برای Robo باشد تا ابزاره‌های خاص واسط کاربر یا همه ابزاره‌های واسط کاربر را در صفحه‌ای خاص نادیده بگیرد. این دستورالعمل‌ها به‌صورت نادیده گرفتن «کنش‌ها» با eventType ELEMENT_IGNORED و ALL_ELEMENTS_IGNORED به‌ترتیب نشان داده می‌شوند.

هرگاه مشخصه contextDescriptor اسکریپت Robo حاوی کنش‌های نادیده گرفتن با صفحه‌نمایش داده‌شده‌ای مطابقت داشته باشد، Robo با هیچ‌یک از ابزاره‌های میانای کاربر که هدف کنش‌های نادیده گرفتن آن هستند تعامل برقرار نمی‌کند (مگر اینکه کنش اسکریپت Robo دیگری Robo را وادار کند کنشی را روی یکی از ابزاره‌های میانای کاربر نادیده‌گرفته‌شده انجام دهد).

یک دستور Robo می‌تواند ترکیبی از کنش‌های نادیده گرفتن، شرطی، و غیرشرطی باشد. برخلاف دیگر کنش‌های Robo script، کنش‌های نادیده گرفتن تا زمانی اعمال می‌شوند که contextDescriptor Robo script حاوی آن‌ها با صفحه‌ای درطول خزیدن Robo مطابقت داشته باشد، صرف‌نظر از مقادیر مشخصه‌های priority و maxNumberOfRuns.

در زیر نمونه‌ای از فایل با دو Robo script آورده شده است. اولین Robo script باعث می‌شود Robo همه ابزاره‌های واسط کاربر را در صفحه‌ای که حاوی ابزاره واسط کاربر با شناسه منبع "my.app.package:id/ignored_screen" است نادیده بگیرد. دستورگان Robo دوم باعث می‌شود Robo ابزاره‌های میانای کاربری را که شناسه‌های منبع آن‌ها با عبارت باقاعده Java ".*:id/done" در صفحه‌ای حاوی ابزاره میانای کاربری با شناسه منبع "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 script موقعیت‌های مطلق داده‌های فرزندان RecyclerView را که هدف کنش‌های Robo script هستند به‌صورت 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 script در Android Studio و اجرای آن در Test Lab

می‌توانید در Android Studio یک Robo script ایجاد کنید که اسکریپت را به‌عنوان یک فایل JSON ذخیره می‌کند. سپس می‌توانید فایل JSON را با برنامه در Firebase Test Lab بارگذاری کنید و آزمایش را براساس آن اجرا کنید.

وقتی آزمایش Robo را با متن پیوست‌شده اجرا می‌کنید، آزمایش Robo ابتدا کنش‌های ازپیش نوشته‌شده شما را گام‌به‌گام اجرا می‌کند و سپس برنامه را طبق معمول کاوش می‌کند.

برای ایجاد فایل JSON اسکریپت Robo در «استودیو Android»، مراحل موجود در ضبط اسکریپت Robo بااستفاده از Test Lab در «استودیو Android» را دنبال کنید.

کنش‌های Robo script

مشخصه اختیاری رایج زیر برای همه کنش‌ها اعمال می‌شود:

• description - به ردیابی اجرای این کنش Robo script در خروجی‌های آزمایش Robo کمک می‌کند.

اثبات

اگر شرط ادعاشده درست باشد، Robo script به کنش بعدی ادامه می‌دهد که می‌تواند ادعای دیگری باشد. درغیراین‌صورت، اجرای Robo script به‌دلیل عدم موفقیت در اثبات متوقف می‌شود.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از یک عبارت Robo script آورده شده است که بررسی می‌کند برنامه تحت آزمایش در پیش‌زمینه است:

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

در زیر نمونه‌ای از یک ادعای Robo script آورده شده است که بررسی می‌کند آیا یک ابزاره واسط کاربر با شناسه منبع "com.google.samples.apps.topeka:id/done" در صفحه وجود دارد یا نه:

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

در زیر نمونه‌ای از یک ادعای Robo script آورده شده است که بررسی می‌کند "Settings" بااستفاده از OCR در صفحه شناسایی نشده باشد:

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

کلیک

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script آورده شده است که روی دکمه‌ای با شناسه منبع "com.google.samples.apps.topeka:id/done" کلیک می‌کند:

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

در زیر نمونه‌ای از کنش Robo script آورده شده است که روی دومین مورد از کلمه "Search" که بااستفاده از OCR در صفحه شناسایی شده است کلیک می‌کند:

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

در زیر نمونه‌ای از کنش Robo script را می‌بینید که روی عنصر صفحه‌کلید نرم‌افزاری با شرح محتوای "Emoji button" کلیک می‌کند:

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

در زیر نمونه‌ای از کنش Robo script آورده شده است که به‌طور تصادفی روی عناصر صفحه‌کلید نرم‌افزاری تا پنج بار کلیک می‌کند:

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

غیرفعال کردن صفحه‌کلید نرم‌افزاری

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script را می‌بینید که صفحه‌کلید نرم‌افزاری را غیرفعال می‌کند:

{
  "eventType": "DISABLE_KEYBOARD"
}

اجرای فرمان پوسته adb

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

مشخصه زیر اختیاری است:

• expectedOutputRegex - خروجی موردانتظار فرمان به‌عنوان عبارت باقاعده Java. اگر خروجی مطابقت نداشته باشد، کنش Robo script ناموفق می‌شود. به‌طور پیش‌فرض، این رشته خالی است، یعنی برونداد بررسی نمی‌شود.

در زیر نمونه‌ای از کنش Robo script ارائه شده است که داده‌های کاربر برنامه تحت آزمایش را پاک می‌کند:

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

اعطای اجازه‌ها

این کنش توسط ضبط‌کننده Robo script در Android Studio برای سازگاری با نسخه قدیمی با Espresso Test Recorder ضبط می‌شود. آزمایش Robo در ابتدای هر خزیدن، همه اجازه‌ها را به برنامه تحت آزمایش اعطا می‌کند و بنابراین، این کنش بدون عملیات است. از این کنش در دستورات Robo استفاده نکنید.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

نادیده گرفتن همه عناصر روی صفحه

این کنش باعث می‌شود Robo همه عناصر موجود در هر صفحه‌ای را که راه‌انداز متن Robo حاوی آن است نادیده بگیرد.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script آورده شده است که باعث می‌شود Robo همه عناصر روی صفحه را نادیده بگیرد:

{
  "eventType": "ALL_ELEMENTS_IGNORED"
}

نادیده گرفتن عنصر

این کنش باعث می‌شود Robo عنصر (یا عناصری) را که با elementDescriptors مشخص‌شده مطابقت دارد نادیده بگیرد.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

مشخصه زیر اختیاری است:

• ignoreChildren - اگر روی true تنظیم شود، Robo همه فرزندان ابزاره(های) واسط کاربر نادیده‌گرفته‌شده را نیز نادیده می‌گیرد. به‌طور پیش‌فرض، false است.

در زیر نمونه‌ای از کنش Robo script آورده شده است که باعث می‌شود Robo همه عناصری را که شرح محتوای آن‌ها با "Avatar" شروع می‌شود نادیده بگیرد:

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

نوشتار ورودی

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script آورده شده است که "John" را در ابزارک میانای کاربری با شناسه منبع "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 script آورده شده است که کلیکی پنج ثانیه‌ای روی ابزاره واسط کاربر با شرح محتوای "Avatar 8" انجام می‌دهد:

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

انجام اشاره یک‌نقطه‌ای

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

مشخصه زیر اختیاری است:

• dragAndDrop - اگر روی true تنظیم شده باشد، اشاره یک‌نقطه‌ای کنش کشیدن و رها کردن را انجام می‌دهد. به‌طور پیش‌فرض، false است.

در زیر مثالی از کنش اشاره یک‌نقطه‌ای Robo script آورده شده است که تند کشیدن به پایین را انجام می‌دهد:

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

اشاره دو نقطه‌ای انجام دهید

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script که اشاره نزدیک کردن انگشتان را انجام می‌دهد آورده شده است:

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

انجام کنش IME

این کنش دکمه کنش فعلی را، برای مثال، بعدی، انجام شد، و جستجو، در «ویرایشگر روش ورودی» (IME) برای ابزاره واسط کاربر هدف مشخص‌شده فشار می‌دهد.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script آورده شده است که کنش IME را روی ابزاره واسط کاربر با شناسه منبع "com.google.samples.apps.topeka:id/first_name" انجام می‌دهد:

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

دکمه برگشتن را فشار دهید

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script را می‌بینید که دکمه برگشت را فشار می‌دهد:

{
  "eventType": "PRESSED_BACK"
}

فشار دادن دکمه صفحه اصلی

این کنش رویداد KEYCODE_HOME را به دستگاه ارسال می‌کند.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script آورده شده است که دکمه صفحه اصلی را فشار می‌دهد:

{
  "eventType": "GO_HOME"
}

پیمایش عنصر برای نمایش داده شدن

این کنش باعث می‌شود آزمایش Robo ابزاره واسط کاربری را که با elementDescriptors مشخص‌شده مطابقت دارد به جلو پیمایش کند تا زمانی که ابزاره واسط کاربری که با childElementDescriptors مشخص‌شده مطابقت دارد روی صفحه نمایش داده شود، یا ابزاره پیمایش‌شده دیگر قابل پیمایش نباشد، یا حداکثر تعداد ۵۰ پیمایش انجام شود.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script ارائه شده است که ابزاره واسط کاربر با شناسه منبع "my.app.package:id/scrollable_card_container" را پیمایش می‌کند تا زمانی که ابزاره واسط کاربر با نوشتار "Orange" در صفحه نشان داده شود (یا دیگر پیمایشی قابل انجام نباشد، یا حداکثر تعداد ۵۰ پیمایش انجام شده باشد):

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

کشیدن

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script ارائه شده است که ابزاره میانای کاربری را با شناسه منبع "my.app.package:id/custom_content" تند به‌بالا می‌کشد:

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

نماگرفت گرفتن

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script که نماگرفت می‌گیرد آورده شده است:

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

روی نقطه‌ای در صفحه تک‌ضرب بزنید

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script ارائه شده است که در وسط صفحه ضربه می‌زند:

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

روی نقطه‌ای در عنصر تک‌ضرب بزنید

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script آورده شده است که لغزنده نوار جستجو را به راست حرکت می‌دهد:

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

پایان دادن به خزیدن

این کنش آزمایش Robo را متوقف می‌کند.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script آورده شده است که آزمایش Robo را متوقف می‌کند:

{
  "eventType": "TERMINATE_CRAWL"
}

انتظار

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش Robo script که سه ثانیه منتظر می‌ماند آورده شده است:

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

منتظر شدن برای عنصر

این کنش باعث می‌شود آزمایش Robo منتظر بماند تا عنصری روی صفحه ظاهر شود تا زمان‌بندی مشخص‌شده تمام شود.

جدول زیر مشخصه‌های الزامی را فهرست می‌کند:

در زیر نمونه‌ای از کنش دستورگان Robo را می‌بینید که حداکثر ۳۰ ثانیه منتظر می‌ماند تا ابزاره واسط کاربر با شناسه منبع "my.app.package:id/confirmation_button" روی صفحه ظاهر شود:

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

مراحل بعدی

• با نحوه اجرای Robo script آشنا شوید.