این سند اطلاعات مرجعی درباره 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 را توصیف میکند. اکثر این مشخصهها اختیاری هستند و مقادیر پیشفرض ازپیشتعریفشده دارند:
| مشخصه | شرح |
id
|
عدد صحیحی که به ردیابی این Robo script در بروندادهای خزیدن کمک میکند.
Robo دارای اسکریپتهای Robo داخلی با idهای خودشان است. اگرچه
id یکسان در دستورگانهای Robo مختلف بر رفتار آنها تأثیر نمیگذارد،
تشخیص کنشها از این دستورگانهای Robo در بروندادهای خزیدن میتواند چالشبرانگیز باشد. توصیه میکنیم برای جلوگیری از هرگونه تداخل، id منحصربهفردی با مقدار
1000 یا بالاتر برای Robo scripts اختصاص دهید.
|
description
|
مشابه id اما توصیفیتر.
|
crawlStage
|
مرحلهای از خزیدن Robo که Robo این دستورات Robo را در آن اعمال میکند. بهطور پیشفرض، این مرحله اصلی خزیدن است. |
priority
|
اولویت این Robo script درمقایسه با Robo scriptهای دیگر.
بهطور پیشفرض، همه Robo scripts اولویت 1 دارند.
|
maxNumberOfRuns
|
مشخص میکند Robo چند بار درطول خزیدن میتواند این اسکریپت Robo را اجرا کند. بهطور پیشفرض، Robo میتواند یکبار اسکریپت Robo را اجرا کند. |
contextDescriptor
|
بافت یا شرایطی را که این Robo script را راهاندازی میکند شرح میدهد. اگر حذف شود، شرط راهاندازی این Robo script همیشه برآوردهشده درنظر گرفته میشود؛ بهعبارت دیگر، Robo script بدون شرط است. |
actions
|
همه کنشهای این Robo script. |
یک فایل حاوی مجموعهای از یک یا چند 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 را راهاندازی میکند:
| مشخصه | شرح |
|---|---|
"condition": "always"
|
همیشه یک Robo script را راهاندازی میکند. |
"condition": "element_present"
|
بررسی میکند که ابزاره واسط کاربری که با elementDescriptors یا
نوشتار مشخصشده با visionText مطابقت دارد در صفحه وجود داشته باشد.
|
"condition": "element_disabled"
|
بررسی میکند که ابزاره واسط کاربری که با elementDescriptors مطابقت دارد
در صفحه وجود داشته باشد و نتوان با آن تعامل برقرار کرد.
|
"condition": "element_checked"
|
بررسی میکند که ابزاره واسط کاربری منطبق با elementDescriptors در صفحه وجود داشته باشد و علامت زده شده باشد.
|
"condition": "app_under_test_shown"
|
بررسی میکند که برنامه تحت آزمایش در پیشزمینه اجرا میشود. |
"condition": "default_launcher_shown"
|
بررسی میکند که صفحه اصلی دستگاه نشان داده شود، یعنی هیچ برنامهای در پیشزمینه اجرا نشود. |
"condition": "non_roboscript_action_performed"
|
بررسی میکند که nonRoboscriptActionCount کنش متوالی آخر
انجامشده توسط آزمایش Robo، کنشهای اسکریپت Robo نباشند.
|
negateCondition
|
اگر روی true تنظیم شود، condition را نفی میکند. برای مثال، میتوانید از این مشخصه برای بررسی اینکه آیا ابزاره UI در صفحه وجود ندارد یا اینکه برنامه تحت آزمایش در پیشزمینه اجرا نمیشود استفاده کنید.
|
elementDescriptors
|
یک یا چند توصیفکننده عنصر که ابزاره واسط کاربر را در صفحه شناسایی میکند.
این نشانگر در ترکیب با شرایط element_present،
element_disabled، و element_checked
استفاده میشود. با visionText ناسازگار است. برای اطلاعات بیشتر،
توصیفکنندههای عنصر را ببینید.
|
visionText
|
نوشتار روی صفحه بااستفاده از میانای برنامهسازی کاربردی «تشخیص نوری نویسه» (OCR) شناسایی میشود. visionText در ترکیب با شرط element_present استفاده میشود. با elementDescriptors ناسازگار است.
|
nonRoboscriptActionCount
|
تعداد کنشهای غیردستورگان Robo متوالی که قبلاً انجام شده است. این گزینه در ترکیب با شرط non_roboscript_action_performed استفاده میشود تا دستورگان Robo را پساز هر nonRoboscriptActionCount کنش Robo راهاندازی کند. بهطور پیشفرض،
1 است.
|
در زیر نمونهای از دستور 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 بهصورت دستهای از یک یا چند جفت مقدار-ویژگی نشان داده میشود که در جدول زیر شرح داده شده است:
| مشخصه | شرح |
eventType
|
نوع کنش را مشخص میکند، برای مثال، کلیک، ویرایش نوشتار، و غیره. برای هر کنش الزامی است. |
elementDescriptors
|
توصیفکنندههایی که ابزاره میانای کاربر را شناسایی میکنند. برای همه کنشهایی که ابزاره واسط کاربر هدف دارند، مثل کلیک کردن روی دکمهای خاص، الزامی است. |
optional
|
اگر روی true تنظیم شده باشد، وقتی این کنش قابلاجرا نباشد، از آن رد میشود. برای مثال، وقتی این کنش نمیتواند ابزارک واسط کاربر هدفش را در صفحهای پیدا کند، نادیده گرفته میشود—بدون اینکه Robo script حاوی آن ناموفق شود. بهطور پیشفرض، مقدار false است.
|
replacementText
|
نوشتاری که باید در ابزاره میانای کاربر هدف وارد شود. برای کنشهای ویرایش نوشتار الزامی است. |
swipeDirection
|
جهت تند کشیدن را مشخص میکند. برای کنشهای تند کشیدن الزامی است. |
delayTime
|
مدت زمان انتظار را به میلیثانیه مشخص میکند. برای کنشهای انتظار الزامی است. |
pointTapXCoordinate و pointTapYCoordinate
|
مختصات پیکسلی X و Y مربوط به نقطهای که روی آن تکضرب زده شده است. بهصورت متقابل انحصاری
با pointTapXPercent و pointTapYPercent.
برای کنشهای تکضرب زدن روی نقطه الزامی است.
|
pointTapXPercent و pointTapYPercent
|
درصد مختصات X و Y نقطه تکضربزدهشده. بهصورت متقابل
انحصاری با pointTapXCoordinate و
pointTapYCoordinate. برای کنشهای تکضرب زدن روی نقطه الزامی است.
|
در زیر نمونهای از دستور Robo با دو کنش بدون ابزارههای هدف واسط کاربر آورده شده است، یعنی این کنشها روی ابزاره واسط کاربر خاصی اجرا نمیشوند:
[
{
"eventType": "WAIT",
"delayTime": 3000
},
{
"eventType": "PRESSED_BACK"
}
]
توصیفگرهای عنصر
توصیفکننده عنصر، ابزارک واسط کاربر را بااستفاده از یک یا چند مورد از مشخصههای شناسایی زیر شناسایی میکند:
| مشخصه | شرح |
className
|
– |
ancestorClassName
|
نام کلاس عنصر سلسلهمراتب واسط کاربر. جد هرکدام از گرههای والد در سلسلهمراتب واسط کاربر عنصر است، ازجمله خود عنصر. |
resourceId
|
– |
resourceIdRegex
|
عبارت باقاعده Java برای مطابقت با resourceId.
|
contentDescription
|
– |
contentDescriptionRegex
|
عبارت باقاعده Java برای مطابقت با contentDescription.
|
text (که روی صفحهنمایش ظاهر میشود)
|
– |
textRegex
|
عبارت باقاعده Java برای مطابقت با text.
|
groupViewChildPosition،
recyclerViewChildPosition، یا
adapterViewChildPosition
|
نشاندهنده موقعیت فرزند ابزاره میانای کاربر بسته به نوع ابزاره والد آن است. |
اغلب این مشخصهها تعریفنشده هستند، برای مثال، ممکن است دکمهای نوشتار و شرح محتوا نداشته باشد. حتی اگر برخیاز مقادیر مشخصه وجود داشته باشند،
ممکن است در صفحه برنامه خاصی (ازجمله 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 script با شیء JSON که گزینههای اجرا را برای آن Robo script مشخص میکند پیشوند کنید. این
سرصفحه پیکربندی با کلیدواژه roboscript شروع میشود و بهدنبال آن
نمایش JSON گزینههای اجرای انتخابشده میآید.
اسکریپتهای Robo از گزینههای اجرای زیر پشتیبانی میکنند:
executionMode- گزینههای اجرا که هنگام اجرای Robo script اعمال میشود:strict- اگر رویtrueتنظیم شود، Robo script از تطابق جزئی، رد شدن از کنش فعلی، و تعلیق استفاده نمیکند. یعنی Robo script بهعنوان یک آزمایش ابزار دقیق معمولی اجرا میشود و بهمحض اینکه هرکدام از کنشهای آن قابلاجرا نباشد، ناموفق میشود. بهطور پیشفرض،falseاست.dismiss_popups- اگر رویtrueتنظیم شده باشد، آزمایش Robo هرگونه کادر گفتگوی غیرمنتظره را هنگام اجرای دستور Robo حتی در حالتstrictرد میکند. این گزینه وقتی در حالتstrictنباشید تأثیری ندارد. بهطور پیشفرض،falseاست.notify- اگر رویfalseتنظیم شود، دستور Robo اعلانهای روی صفحه را در ابتدا و انتهای اجرایش نشان نمیدهد. بهطور پیشفرض،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 test آن Robo script را برای اجرا بار میکند، با مقدار واقعی جایگزین میشود. پارامترهای الگو با دو زیرخط و سپس علامت درصد پیشوندگذاری میشوند و با علامت درصد و سپس دو زیرخط پسوندگذاری میشوند.
اسکریپتهای Robo از پارامتر الگوی زیر پشتیبانی میکنند:
__%APP_PACKAGE_NAME%__- نام بسته برنامه تحت آزمایش.
در زیر نمونهای از دستور Robo آورده شده است که فرایند برنامه درحال آزمایش را متوقف میکند:
[
{
"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 بهطور کامل مطابقت نداشته باشد، معیارهای مطابقت
تسهیل میشود و مطابقت دوباره امتحان میشود. مطابقت جزئی
توصیفکننده بیرونیترین عنصر را هنگام مطابقت دادن
ابزاره هدف میانای کاربری کنش Robo script درنظر نمیگیرد.
اگر تطابق جزئی موفقیتآمیز باشد، کنش Robo script مربوطه طبق معمول انجام میشود. این تکنیک از سناریوهایی پشتیبانی میکند که در آنها ساختار برنامه تغییر میکند، برای مثال، بین نسخههای برنامه، زمانی که عناصر صفحه بازآرایی میشوند. |
| رد شدن از کنش فعلی | اگر کنش فعلی Robo script بهطور کامل یا جزئی مطابقت نداشته باشد،
Robo سعی میکند کنش بعدی Robo script را مطابقت دهد. اگر کنش بعدی بهطور کامل یا جزئی مطابقت داشته باشد، آزمایش Robo از کنش Robo script فعلی رد میشود (و هرگز به آن برنمیگردد) و کنش بعدی را انجام میدهد.
این تکنیک از سناریوهایی پشتیبانی میکند که رفتار برنامه بین نسخهها تغییر میکند یا ناپایدار است، برای مثال، زمانی که یک کادر گفتگوی متناوب ممکن است در صفحههای مختلف درطول ضبط درمقابل بازپخش Robo script ظاهر شود. |
| تعلیق | اگر هیچکدام از کنشهای فعلی یا بعدی دستورگان Robo بهطور کامل یا
جزئی مطابقت نداشته باشند، دستورگان Robo موقتاً تعلیق میشود و آزمایش Robo
کنشی را برای اجرا بااستفاده از استراتژیهای دیگرش انتخاب میکند. پساز تکمیل این کنش،
آزمایش Robo اجرای Robo script را ازسر میگیرد.
تا زمانی که کنشهای فعلی یا بعدی Robo script مطابقت نداشته باشند، Robo script برای هر تعداد کنش بهحالت تعلیق باقی میماند. بنابراین، Robo اسکریپتها لزوماً نباید مقدمهای برای آزمایش Robo باشند، و میتوانید کنشهای اسکریپت Robo را با کنشهای استاندارد آزمایش Robo درهمآمیزید. این تکنیک از سناریوهایی پشتیبانی میکند که رفتار برنامه ناپایدار است، یا زمانی که تغییرات بین نسخههای برنامه بهاندازهای بزرگ است که آزمایش Robo باید «شکافها را با اقدامات استاندارد خود پر کند». |
اولویتها
اگر Robo script به maxNumberOfRuns خود برسد، دیگر نمیتواند در خزش معینی راهاندازی شود. اگر بیشاز یک Robo script بتواند توسط زمینه فعلی راهاندازی شود، اولویت با انتخاب Robo script است که بهترتیب زیر:
- مشخصه
contextDescriptorدارد. - بالاترین
priorityرا داشته باشد (بهطور پیشفرض، همه Robo scriptهاpriorityاجرای یکسان1دارند). - اگر اولویتهای 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 موارد زیر را بهترتیب راهاندازی میکند:
"Robo script 2"زیرا بالاترین اولویت را دارد."Robo script 1"زیرا زودتر از سایر Robo scripts قابلاجرا با اولویت یکسان ظاهر میشود."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 قابلاجرا هستند:
| مرحله خزیدن | شرح |
pre_crawl
|
قبلاز اینکه Robo راهاندازی شود و خزیدن در برنامه تحت آزمایش را شروع کند. |
post_crawl
|
پساز اینکه Robo خزیدن در برنامه تحت آزمایش را بهپایان رساند. مدت زمان
post_crawl Robo script نباید از ۱۵ ثانیه بیشتر باشد
وگرنه ممکن است خزیدن بهدلیل اتمام مهلت پایان یابد.
|
crawl
|
مرحله اصلی خزیدن، زمانی که Robo در برنامه تحت آزمایش میخزد. |
close_screen
|
وقتی Robo سعی میکند از صفحهنمایش دادهشده برگردد (برگشتن به عقب)، وقتی همه کنشهای ممکن در این صفحهنمایش کاوش شده باشد. بهطور پیشفرض، Robo دکمه برگشت را فشار میدهد که در برخی سناریوها نامطلوب است. |
اگر مشخصه crawlStage از Robo script نامشخص باشد، به این معنی است که
crawl است.
در زیر نمونهای از Robo script آورده شده است که دادههای کاربر برنامه تحت آزمایش را قبلاز شروع خزیدن Robo در آن پاک میکند:
{
"id": 1000,
"crawlStage": "pre_crawl",
"actions": [
{
"eventType": "ADB_SHELL_COMMAND",
"command": "pm clear __%APP_PACKAGE_NAME%__"
}
]
}
در زیر نمونهای از Robo script آورده شده است که به 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 را توصیف میکند:
| مشخصه | شرح |
priority
|
اولویت این کنش شرطی درمقایسه با دیگر کنشهای شرطی در Robo script حاوی آن. بهطور پیشفرض، همه
کنشهای شرطی اولویت 1 دارند.
|
maxNumberOfRuns
|
تعداد دفعاتی که این کنش شرطی میتواند درطول یک اجرای Robo script حاوی آن انجام شود. بهطور پیشفرض، همه کنشهای شرطی را میتوان حداکثر یکبار در یک اجرای Robo script حاوی آنها انجام داد. |
contextDescriptor
|
بافت یا شرطی که این کنش شرطی را راهاندازی میکند. این عنصر ساختاری مشابه با contextDescriptor دستور Robo دارد و قابلیتهای مشابهی ارائه میدهد. |
وقتی راهاندازی میشود، اسکریپت Robo کنشهای غیرشرطی خود را یکییکی بهترتیب ظاهر شدن انجام میدهد. اگر Robo script حاوی کنشهای شرطی باشد، این کنشها هر بار قبلاز انتخاب کنش غیرشرطی برای اجرا درنظر گرفته میشوند. اگر هر کنش شرطی براساس اولویت و تعداد دفعات باقیمانده اجرا راهاندازی و انتخاب شود، سپس Robo script این کنش شرطی را انجام میدهد. درغیراینصورت، Robo script کنش غیرشرطی زیر را انجام میدهد. برای معتبر بودن، Robo script باید حداقل یک کنش غیرشرطی داشته باشد.
در زیر نمونهای از یک Robo script غیرمشروط با یک کنش مشروط آورده شده است که اگر کادرهای گفتگو در هر نقطهای از اجرای Robo script ظاهر شوند، آنها را رد میکند:
{
"id": 1000,
"actions": [
{
"description": "Dismiss dialog",
"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 script میتواند ترکیبی از کنشهای نادیده گرفتن، شرطی، و غیرشرطی باشد. برخلاف سایر کنشهای 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 بهطور پویا بار میشوند و ممکن است با چند تند کشیدن از صفحه فعلی نمایش داده شوند. ازآنجاییکه اندازه صفحهنمایش و تعداد تند کشیدنهای لازم برای رسیدن به این فرزند برای انواع مختلف دستگاهها متفاوت است، تکیه بر موقعیت دادههای فرزند که مطلق است بسیار مطمئنتر است. It is a less robust approach to rely on the number of swipes that are required to bring this child to the screen and then use its screen position.
بنابراین، Robo script موقعیتهای مطلق دادههای فرزندان RecyclerView را که هدف کنشهای Robo script هستند بهصورت recyclerViewChildPosition ضبط میکند. دستور Robo همچنین موقعیتهای مطلق دادههای فرزندان AdapterView را که هدف کنشهای دستور Robo هستند بهصورت adapterViewChildPosition ضبط میکند.
کنشها روی فرزندان RecyclerView و AdapterView در مراحل زیر انجام میشوند:
آزمایش Robo مطمئن میشود که فرزند مربوطه ازطریق کنش موقعیتیابی در RecyclerView یا AdapterView حاوی آن روی صفحه نمایش داده میشود.
آزمایش 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 بهدلیل عدم موفقیت اثبات متوقف میشود.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "ASSERTION"
|
-- |
contextDescriptor
|
بافت یا شرایط ادعاشده را توصیف میکند. این عنصر ساختاری مشابه با contextDescriptor دستور Robo دارد و قابلیتهای مشابهی ارائه میدهد. |
در زیر نمونهای از یک ادعای 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"
}
}
کلیک
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
|---|---|
eventType
|
نوع کنش Robo script را مشخص میکند. |
"eventType": "VIEW_CLICKED"
|
روی عنصر هدف برنامه درحال آزمایش کلیک میکند. |
"eventType": "SOFT_KEYBOARD_CLICK"
|
روی عنصر هدف صفحهکلید نرمافزاری کلیک میکند. |
"eventType": "SOFT_KEYBOARD_RANDOM_CLICK"
|
روی عناصر تصادفی صفحهکلید نرمافزاری تا
maxNumberOfRuns بار کلیک میکند.
|
"eventType": "LIST_ITEM_CLICKED"
|
توسط ضبطکننده Robo script در Android Studio برای کلیک کردن روی موارد فهرست استفاده میشود. |
elementDescriptors
|
ابزاره میانای کاربر کلیکشده را بااستفاده از سلسلهمراتب میانای کاربر Android شناسایی میکند.
با visionText ناسازگار است.
|
visionText
|
عنصر کلیکشده را بااستفاده از OCR شناسایی میکند. با elementDescriptors ناسازگار است.
|
matchIndex
|
نمایه رخداد عنصر هدف منطبق را مشخص میکند،
وقتی عنصر هدف بااستفاده از visionText شناسایی میشود.
اگر 0 باشد، کنش Robo script اولین عنصر منطبق را انتخاب میکند، اگر 1 باشد، دومین عنصر منطبق را انتخاب میکند، و به همین ترتیب برای منطبقهای بعدی ادامه میدهد. ترتیب از چپ به راست و از بالا به پایین تعیین میشود. مقدار پیشفرض 0 است (اولین
مورد منطبق انتخاب میشود).
|
maxNumberOfRuns
|
مشخص میکند چند بار روی عنصر تصادفی صفحهکلید نرمافزاری کلیک شود،
وقتی eventType برابر با SOFT_KEYBOARD_RANDOM_CLICK است.
مقدار پیشفرض 1 است.
|
در زیر نمونهای از کنش Robo script آورده شده است که روی دکمهای با شناسه منبع "com.google.samples.apps.topeka:id/done" کلیک میکند:
{
"eventType": "VIEW_CLICKED",
"elementDescriptors": [
{
"resourceId": "com.google.samples.apps.topeka:id/done"
}
]
}
در زیر نمونهای از کنش Robo script آورده شده است که بااستفاده از OCR روی دومین
مورد کلمه "Search" شناساییشده در صفحه کلیک میکند:
{
"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
}
غیرفعال کردن صفحهکلید نرمافزاری
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "DISABLE_KEYBOARD"
|
-- |
در زیر نمونهای از کنش Robo script که صفحهکلید نرمافزاری را غیرفعال میکند آورده شده است:
{
"eventType": "DISABLE_KEYBOARD"
}
اجرای فرمان پوسته adb
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "ADB_SHELL_COMMAND"
|
-- |
command
|
فرمان پوسته «پل اشکالزدایی Android» (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 استفاده نکنید.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "PERMISSIONS_REQUEST"
|
-- |
نادیده گرفتن همه عناصر روی صفحه
این کنش باعث میشود Robo همه عناصر موجود در هر صفحهای را که راهانداز دستور Robo است نادیده بگیرد.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "ALL_ELEMENTS_IGNORED"
|
-- |
در زیر نمونهای از کنش Robo script آورده شده است که باعث میشود Robo همه عناصر روی صفحه را نادیده بگیرد:
{
"eventType": "ALL_ELEMENTS_IGNORED"
}
نادیده گرفتن عنصر
این کنش باعث میشود Robo عنصر (یا عناصری) را که با elementDescriptors مشخصشده مطابقت دارد نادیده بگیرد.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "ELEMENT_IGNORED"
|
-- |
elementDescriptors
|
ابزاره(های) نادیدهگرفتهشده میانای کاربری را بااستفاده از سلسلهمراتب میانای کاربری Android شناسایی میکند. |
مشخصه زیر اختیاری است:
ignoreChildren- اگر رویtrueتنظیم شده باشد، Robo همه فرزندان ابزاره(های) واسط کاربر نادیدهگرفتهشده را نیز نادیده میگیرد. بهطور پیشفرض،falseاست.
در زیر نمونهای از کنش Robo script آورده شده است که باعث میشود Robo همه عناصری را که شرح محتوای آنها با "Avatar" شروع میشود نادیده بگیرد:
{
"eventType": "ELEMENT_IGNORED",
"elementDescriptors": [
{
"contentDescriptionRegex": "Avatar.*"
}
]
}
نوشتار ورودی
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
|---|---|
eventType
|
نوع کنش Robo script را مشخص میکند. |
"eventType": "VIEW_TEXT_CHANGED"
|
نوشتار ارائهشده را در ابزاره میانای کاربر هدف وارد میکند. |
"eventType": "ENTER_TEXT"
|
نوشتار دادهشده را در ابزاره واسط کاربر هدف وارد میکند و سپس
رویداد KEYCODE_ENTER را به این ابزاره واسط کاربر ارسال میکند.
|
elementDescriptors
|
ابزاره رابط کاربری هدف را بااستفاده از سلسلهمراتب رابط کاربری Android شناسایی میکند. |
replacementText
|
نوشتاری که باید در ابزاره میانای کاربر هدف وارد شود. |
در زیر نمونهای از کنش 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"
}
]
}
کلیک طولانی
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "VIEW_LONG_CLICKED"
|
-- |
elementDescriptors
|
ابزاره رابط کاربری هدف را بااستفاده از سلسلهمراتب رابط کاربری Android شناسایی میکند. با visionText ناسازگار است.
|
visionText
|
عنصری را که روی آن کلیک طولانی شده است بااستفاده از OCR شناسایی میکند. با elementDescriptors ناسازگار است.
|
matchIndex
|
نمایه رخداد عنصر هدف منطبق را مشخص میکند،
وقتی عنصر هدف بااستفاده از visionText شناسایی میشود.
اگر 0 باشد، کنش Robo script اولین عنصر منطبق را انتخاب میکند، اگر 1 باشد، دومین عنصر منطبق را انتخاب میکند، و به همین ترتیب برای منطبقهای بعدی ادامه میدهد. ترتیب از چپ به راست و از بالا به پایین تعیین میشود. مقدار پیشفرض 0 است (اولین
مورد منطبق انتخاب میشود).
|
مشخصه زیر اختیاری است:
delayTime- مشخص میکند که فشار دادن کلیک طولانی چقدر طول میکشد، برحسب میلیثانیه.
در زیر نمونهای از کنش دستورگان Robo آورده شده است که کلیک پنج ثانیهای را روی ابزاره واسط کاربر با شرح محتوای "Avatar 8" انجام میدهد:
{
"eventType": "VIEW_LONG_CLICKED",
"elementDescriptors": [
{
"contentDescription": "Avatar 8"
}
],
"delayTime": 5000
}
انجام اشاره یکنقطهای
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
|---|---|
"eventType": "ONE_POINT_GESTURE"
|
-- |
coordinates
|
دو مختصات برای اشاره یکنقطهای، با قالب «(x1,y1)->(x2,y2)» بهصورت درصد یا پیکسل. |
مشخصه زیر اختیاری است:
dragAndDrop- اگر رویtrueتنظیم شده باشد، اشاره یکنقطهای کنش کشیدن و رها کردن را انجام میدهد. بهطور پیشفرض،falseاست.
در زیر نمونهای از کنش اشاره یکنقطهای Robo script آورده شده است که تند کشیدن به پایین را انجام میدهد:
{
"eventType": "ONE_POINT_GESTURE",
"coordinates": "(50%,25%)->(50%,75%)"
}
اشاره دو نقطهای انجام دهید
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
|---|---|
"eventType": "TWO_POINT_GESTURE"
|
-- |
coordinates
|
چهار مختصات برای اشاره دو نقطهای، با قالب «(x1,y1)->(x2,y2),(x3,y3)->(x4,y4)» بهصورت درصد یا پیکسل. |
در زیر نمونهای از کنش Robo script آورده شده است که اشاره نزدیک کردن انگشتان را انجام میدهد:
{
"eventType": "TWO_POINT_GESTURE",
"coordinates": "(50%,50%)->(25%,50%),(50%,50%)->(75%,50%)"
}
اجرای کنش IME
این کنش دکمه کنش فعلی را، مثلاً بعدی، تمام، و جستجو، در «ویرایشگر روش ورودی» (IME) برای ابزاره میانای کاربر هدف مشخصشده فشار میدهد.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
|---|---|
"eventType": "PRESSED_EDITOR_ACTION"
|
-- |
elementDescriptors
|
ابزاره رابط کاربری هدف را بااستفاده از سلسلهمراتب رابط کاربری Android شناسایی میکند. |
در زیر نمونهای از کنش 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"
}
]
}
فشار دادن دکمه برگشتن
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
eventType
|
نوع کنش Robo script را مشخص میکند. |
"eventType": "PRESSED_BACK"
|
رویداد KEYCODE_BACK را به دستگاه ارسال میکند.
|
"eventType": "PRESSED_BACK_EMULATOR_28"
|
توسط ضبطکننده Robo script در Android Studio برای فشار دادن دکمه برگشت در شبیهسازهای API 28 استفاده میشود. |
در زیر نمونهای از کنش Robo script آورده شده است که دکمه برگشت را فشار میدهد:
{
"eventType": "PRESSED_BACK"
}
فشار دادن دکمه صفحه اصلی
این کنش رویداد KEYCODE_HOME را به دستگاه ارسال میکند.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "GO_HOME"
|
-- |
در زیر نمونهای از کنش Robo script آورده شده است که دکمه صفحه اصلی را فشار میدهد:
{
"eventType": "GO_HOME"
}
پیمایش عنصر برای نمایش داده شدن
این کنش باعث میشود آزمایش Robo ابزاره واسط کاربری را که با elementDescriptors مشخصشده مطابقت دارد به جلو پیمایش کند تا زمانی که ابزاره واسط کاربری که با childElementDescriptors مشخصشده مطابقت دارد در صفحه نشان داده شود، یا ابزاره پیمایششده دیگر قابل پیمایش نباشد، یا حداکثر تعداد ۵۰ پیمایش انجام شود.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "ELEMENT_SCROLL_INTO_VIEW"
|
-- |
elementDescriptors
|
ابزارک رابط کاربری پیمایششده را بااستفاده از سلسلهمراتب رابط کاربری Android شناسایی میکند. |
childElementDescriptors
|
ابزارک واسط کاربر را برای پیمایش بااستفاده از سلسلهمراتب واسط کاربر Android شناسایی میکند. |
در زیر نمونهای از کنش 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"
}
]
}
کشیدن
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
|---|---|
"eventType": "VIEW_SWIPED"
|
-- |
swipeDirection
|
جهت تند کشیدن را مشخص میکند:
|
elementDescriptors
|
ابزاره رابط کاربری هدف را بااستفاده از سلسلهمراتب رابط کاربری Android شناسایی میکند. |
در زیر نمونهای از کنش Robo script ارائه شده است که ابزاره میانای کاربر را با شناسه منبع "my.app.package:id/custom_content" تند بهبالا میکشد:
{
"eventType": "VIEW_SWIPED",
"swipeDirection": "Up",
"elementDescriptors": [
{
"resourceId": "my.app.package:id/custom_content"
}
]
}
نماگرفت گرفتن
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "TAKE_SCREENSHOT"
|
-- |
screenshotName
|
نام فایل نماگرفت را مشخص میکند. |
در زیر نمونهای از کنش Robo script که نماگرفت میگیرد آورده شده است:
{
"eventType": "TAKE_SCREENSHOT",
"screenshotName": "my_screenshot"
}
روی نقطهای در صفحه تکضرب بزنید
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
|---|---|
"eventType": "POINT_TAP"
|
-- |
pointTapXCoordinate
|
مختصات پیکسلی X نقطه تکضربزدهشده. بهصورت متقابل انحصاری با
pointTapXPercent و pointTapYPercent.
|
pointTapYCoordinate
|
مختصات پیکسلی Y نقطه تکضربزدهشده. بهصورت متقابل انحصاری با
pointTapXPercent و pointTapYPercent.
|
pointTapXPercent
|
درصد مختصات X نقطه تکضرب زدهشده. بهصورت متقابل انحصاری با
pointTapXCoordinate و pointTapYCoordinate.
|
pointTapYPercent
|
درصد مختصات Y نقطه تکضربزدهشده. بهصورت متقابل انحصاری با
pointTapXCoordinate و pointTapYCoordinate.
|
در زیر نمونهای از کنش Robo script آورده شده است که در وسط صفحه تکضرب میزند:
{
"eventType": "POINT_TAP",
"pointTapXPercent": 50,
"pointTapYPercent": 50
}
روی نقطهای در عنصر تکضرب بزنید
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "POINT_TAP_ELEMENT"
|
-- |
pointTapXPercent
|
مختصات X درصدی در عنصر هدف. |
pointTapYPercent
|
مختصات Y درصدی در عنصر هدف. |
elementDescriptors
|
ابزاره هدف واسط کاربر را بااستفاده از سلسلهمراتب واسط کاربر Android شناسایی میکند. |
در زیر نمونهای از کنش Robo script آورده شده است که لغزنده نوار جستجو را به سمت راست حرکت میدهد:
{
"eventType": "POINT_TAP_ELEMENT",
"pointTapXPercent": 80,
"pointTapYPercent": 50,
"elementDescriptors": [
{
"resourceId": "my.app.package:id/my_seekbar"
}
]
}
پایان دادن به خزیدن
این کنش آزمایش Robo را متوقف میکند.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
|---|---|
"eventType": "TERMINATE_CRAWL"
|
-- |
در زیر نمونهای از کنش Robo script آورده شده است که آزمایش Robo را متوقف میکند:
{
"eventType": "TERMINATE_CRAWL"
}
انتظار
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "WAIT" (or "DELAYED_MESSAGE_POSTED")
|
-- |
delayTime
|
مدت زمان انتظار را به میلیثانیه مشخص میکند. |
در زیر نمونهای از کنش Robo script آورده شده است که سه ثانیه منتظر میماند:
{
"eventType": "WAIT",
"delayTime": 3000
}
منتظر شدن برای عنصر
این کنش باعث میشود آزمایش Robo تا زمان رسیدن به مهلت زمانی مشخصشده منتظر بماند تا عنصری روی صفحه ظاهر شود.
جدول زیر مشخصههای الزامی را فهرست میکند:
| مشخصه | شرح |
"eventType": "WAIT_FOR_ELEMENT"
|
-- |
delayTime
|
زمان انتظار را به میلیثانیه مشخص میکند. |
elementDescriptors
|
ابزاره واسط کاربر منتظر را بااستفاده از سلسلهمراتب واسط کاربر Android شناسایی میکند. |
در زیر نمونهای از کنش Robo script آورده شده است که حداکثر ۳۰ ثانیه منتظر میماند تا ابزاره واسط کاربر با شناسه منبع "my.app.package:id/confirmation_button" روی صفحه ظاهر شود:
{
"eventType": "WAIT_FOR_ELEMENT",
"delayTime": 30000,
"elementDescriptors": [
{
"resourceId": "my.app.package:id/confirmation_button"
}
]
}