الدليل المرجعي لنصوص Robo البرمجية

يوفّر هذا المستند معلومات مرجعية حول نصوص Robo البرمجية، بما في ذلك البنية والإمكانات والاستخدام والتسجيل والإجراءات. نصوص Robo البرمجية هي اختبارات تعمل على أتمتة مهام ضمان الجودة (QA) اليدوية للتطبيقات على الأجهزة الجوّالة، وتتيح استراتيجيات الدمج المستمر (CI) واختبار الإطلاق التجريبي. نص Robo البرمجي هو ملف JSON يصف سلسلة من واجهة المستخدم (UI) وإجراءات أخرى.

يمكنك إنشاء نص Robo بالطرق التالية:

• استخدِم ميزة تسجيل نص Robo البرمجي. (على أجهزة Android فقط)

• أنشئ نص Robo البرمجي يدويًا. (Android وiOS+)

• تسجيل نص Robo البرمجي ثم تعديله يدويًا (على أجهزة Android فقط)

لمزيد من المعلومات حول استخدام نصوص Robo البرمجية، يُرجى الاطّلاع على مقالة تشغيل نص Robo برمجي.

مقدمة

يتم توفير نص Robo البرمجي لاختبار Robo إلى جانب الإدخالات الأخرى، مثل حزمة تطبيق Android (APK) قيد الاختبار.

في ما يلي مثال على نص برمجي لبرنامج Robo يسجّل دخول المستخدم إلى أحد التطبيقات، ويتم تشغيله عند تشغيل التطبيق قيد الاختبار:

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

إذا كان هناك نص برمجي واحد لـ Robo في ملف وكان يتضمّن شرط التشغيل التلقائي app_under_test_shown، كما في المثال أعلاه، يمكنك تحديد النص البرمجي لـ Robo في ملف باستخدام تنسيق أبسط، مثل تسلسل إجراءاته:

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

إتاحة نصوص Robo البرمجية على أجهزة iOS+

يوفّر Robo لنظام التشغيل iOS+‎ (إصدار تجريبي) دعمًا محدودًا لنصوص Robo البرمجية. The Robo script syntax for iOS+ is identical to Android syntax, and supported iOS+ features behave similarly to their Android counterparts.

تتوفّر الإجراءات التالية في iOS+‎:

• Assertion
• النقر
• النقر مع الاستمرار
• التمرير سريعًا
• تجاهُل كل العناصر
• انتظار
• أخذ لقطة شاشة
• إنهاء الزحف

تتوفّر السمات التعريفية التالية في واصفات العناصر في نظام التشغيل iOS+‎:

• اسم الصف
• اسم الفئة الأصل
• وصف المحتوى (والتعبير النمطي)
• النص (والتعبير النمطي)

تتوفّر شروط التفعيل التالية في واصفات السياق في نظام التشغيل iOS والإصدارات الأحدث:

• يظهر التطبيق قيد الاختبار
• العنصر متوفّر
• تم تنفيذ إجراء نص برمجي غير آلي

البنية

يحتوي نص Robo البرمجي على عدة سمات تصف كيفية تنفيذه من خلال Robo. معظم هذه السمات اختيارية وتتضمّن قيمًا تلقائية محدّدة مسبقًا:

يحتوي ملف واحد على مجموعة من نصوص Robo البرمجية.

في ما يلي مثال على ملف يتضمّن نصَّي Robo برمجيَّين غير مشروطَين، يتضمّن كلّ منهما إجراءً واحدًا يتم تنفيذه مرة واحدة في بداية الزحف:

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

وصف السياق

يحدّد واصف السياق السياق أو الشرط الذي يؤدي إلى تشغيل نص برمجي لبرنامج Robo باستخدام سمة واحدة أو مجموعة من السمات:

في ما يلي مثال على نص برمجي لبرنامج 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 يتم تشغيله من خلال "Privacy Policy" الذي تم رصده من خلال ميزة "التعرّف البصري على الأحرف" (OCR):

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

في ما يلي مثال على نص Robo برمجي ينتظر لمدة 5 ثوانٍ بعد كل إجراء Robo غير برمجي:

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

الإجراءات

يتم تمثيل كل إجراء في نص Robo البرمجي كمجموعة من زوج واحد أو أكثر من أزواج السمات والقيم، والتي تم وصفها في الجدول التالي:

في ما يلي مثال على نص برمجي لـ Robo يتضمّن إجراءَين بدون تطبيقات مصغّرة مستهدَفة لواجهة المستخدم، ما يعني أنّ هذين الإجراءَين لا يعملان على تطبيق مصغّر محدّد لواجهة المستخدم:

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

واصفات العناصر

يحدّد واصف العنصر تطبيق واجهة مستخدم مصغّر باستخدام سمة واحدة أو أكثر من السمات التعريفية التالية:

غالبًا ما تكون هذه السمات غير محددة، على سبيل المثال، قد لا يحتوي الزر على نص ووصف للمحتوى. حتى إذا كانت بعض قيم السمات متوفّرة، قد لا تكون فريدة على شاشة تطبيق معيّنة (بما في ذلك resourceId).

على سبيل المثال، لا يمكن عادةً التفريق بين عناصر القائمة إلا باستخدام مواضعها الفرعية المختلفة داخل التطبيق المصغّر الرئيسي. وهذا يعني أنّ استخدام واصف عنصر واحد فقط لتحديد تطبيق مصغّر لواجهة المستخدم لا يكون كافيًا في العادة. لذلك، تحتوي سمة elementDescriptors الخاصة بالإجراء على تسلسل من واصفات العناصر التي يتم ترتيبها بحيث يتوافق الواصف الأول مع تطبيق واجهة المستخدم المصغّر المستهدف، ويتوافق الواصف الثاني مع التطبيق المصغّر الرئيسي لتطبيق واجهة المستخدم المصغّر المستهدف، وهكذا. تتم مطابقة التطبيق المصغّر المستهدف لواجهة المستخدم الخاص بالإجراء عندما تتطابق جميع واصفات العناصر مع التسلسل الهرمي الفرعي للتطبيق المصغّر المقابل لواجهة المستخدم.

في ما يلي مثال على نص برمجي لبرنامج Robo يتضمّن إجراءات تغيير النص والنقر، وكلاهما يتطلّب منك تحديد تطبيق واجهة المستخدم المستهدَف باستخدام واصفات العناصر المقدَّمة:

[
  {
    "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 برمجي:
  • ‫strict: في حال ضبطها على true، لا يستخدم نص Robo البرمجي المطابقة الجزئية وتخطّي الإجراء الحالي والتعليق. وهذا يعني أنّه يتم تنفيذ نص Robo البرمجي كاختبار لقياس حالة التطبيق ويفشل بمجرد تعذُّر تنفيذ أي من إجراءاته. القيمة التلقائية هي false.
  • ‫dismiss_popups: إذا تم ضبطه على true، يتجاهل اختبار Robo أي مربّعات حوار غير متوقّعة أثناء تنفيذ نص Robo البرمجي حتى في وضع strict. وليس لهذا الخيار أي تأثير في حال عدم تفعيل وضع strict. القيمة التلقائية هي false.
  • ‫notify: في حال ضبطها على false، لا يعرض نص Robo البرمجي إشعارات على الشاشة في بداية تنفيذه ونهايته. القيمة التلقائية هي true.
• postscript - خيارات التنفيذ التي يتم تطبيقها بعد اكتمال نص Robo البرمجي:
  • ‫terminate: إذا تم ضبطه على true، سيتوقف اختبار Robo عن الزحف بعد اكتمال نص Robo البرمجي. القيمة التلقائية هي false.

في ما يلي مثال على نص برمجي لبرنامج Robo يتم تنفيذه في وضع strict بدون إشعارات على الشاشة وينتظر لمدة ثلاث ثوانٍ، وبعد ذلك يتوقف الزحف:

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

مَعلمات النماذج

مَعلمة النموذج هي عنصر نائب في نص Robo برمجي يتم استبداله بالقيمة الفعلية عندما يحمّل اختبار Robo ذلك النص البرمجي لتنفيذه. تتم إضافة شرطة سفلية مزدوجة متبوعة بعلامة النسبة المئوية إلى بداية مَعلمات النموذج، وتتم إضافة علامة النسبة المئوية متبوعة بشرطة سفلية مزدوجة إلى نهاية المَعلمات.

تتيح نصوص Robo البرمجية مَعلمة النموذج التالية:

• ‫__%APP_PACKAGE_NAME%__: اسم حزمة التطبيق قيد الاختبار

في ما يلي مثال على نص Robo برمجي يوقف عملية التطبيق قيد الاختبار:

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

تعليقات

يمكن أن يحتوي نص Robo البرمجي على أسطر تعليقات، وهي أسطر تبدأ بـ # أو //.

في ما يلي مثال على نص برمجي لبرنامج Robo مع بعض التعليقات:

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

الإمكانات

يظلّ نص Robo البرمجي نشطًا تلقائيًا إلى أن تكتمل جميع إجراءاته (أو على الأقل تتم محاولة تنفيذها). يواصل اختبار Robo محاولة مطابقة إجراء نص Robo برمجي كلما اختار إجراءً لتنفيذه. يستخدم نص Robo البرمجي الأساليب التالية لزيادة الفعالية:

الأولويات

إذا وصل نص Robo البرمجي إلى maxNumberOfRuns، لن يعود بالإمكان تشغيله في عملية زحف معيّنة. إذا كان من الممكن تشغيل أكثر من نص برمجي واحد من Robo في السياق الحالي، يتم منح الأولوية من خلال اختيار النص البرمجي من Robo بالترتيب التالي:

1. يحتوي على سمة contextDescriptor.
2. أن يكون له أعلى priority (وفقًا للإعدادات التلقائية، يكون لجميع نصوص Robo البرمجية نفس priority التنفيذ وهو 1).
3. يظهر أولاً في قائمة نصوص Robo البرمجية، إذا كانت أولويات نصوص Robo البرمجية متطابقة.

في ما يلي مثال على ملف يتضمّن ثلاثة نصوص Robo برمجية تنفّذ الإجراء نفسه ويتم تشغيلها من خلال الشرط نفسه، وهو أن يكون التطبيق قيد الاختبار في المقدّمة:

[
  {
    "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 البرمجية المتبقية القابلة للتطبيق والتي لها الأولوية نفسها.
3. ‫"Robo script 3" كآخر نص Robo برمجي قابل للتطبيق.

عمليات تشغيل متكرّرة

بشكل تلقائي، يشغّل Robo نص Robo البرمجي مرة واحدة على الأكثر أثناء الزحف. ويمكن تعديل ذلك من خلال السمة maxNumberOfRuns.

في ما يلي مثال على نص Robo برمجي ينقل التطبيق قيد الاختبار إلى الخلفية لعدد يصل إلى 10 مرات:

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

مرحلة الزحف

يمكن تطبيق نصوص Robo البرمجية في مراحل مختلفة من عملية زحف Robo معيّنة:

إذا لم يتم تحديد سمة crawlStage لملف Robo النصي، يتم اعتبارها 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 البرمجي على إجراءات شرطية. تتضمّن الإجراءات الشرطية ثلاث سمات إضافية تصف كيفية تنفيذ Robo لها:

عند تشغيل نص Robo البرمجي، ينفّذ إجراءاته غير المشروطة واحدًا تلو الآخر حسب ترتيب ظهورها. إذا كان نص Robo البرمجي يحتوي على إجراءات شرطية، يتم أخذها في الاعتبار في كل مرة قبل اختيار إجراء غير شرطي لتنفيذه. إذا تم تفعيل أي إجراء شرطي واختياره بناءً على أولويته وعدد مرات التشغيل المتبقية، سينفّذ نص Robo البرمجي هذا الإجراء الشرطي. وإلا، سينفّذ نص Robo البرمجي الإجراء غير المشروط التالي. لكي يكون نص Robo البرمجي صالحًا، يجب أن يحتوي على إجراء واحد على الأقل غير مشروط.

في ما يلي مثال على نص برمجي غير مشروط لـ 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 البرمجي على تعليمات لـ Robo لتجاهل تطبيقات مصغّرة معيّنة لواجهة المستخدم أو جميع التطبيقات المصغّرة لواجهة المستخدم على شاشة معيّنة. يتم تمثيل هذه التعليمات على أنّها تجاهل "الإجراءات" باستخدام eventType ELEMENT_IGNORED وALL_ELEMENTS_IGNORED على التوالي.

عندما تتطابق السمة contextDescriptor لنص Robo برمجي يحتوي على إجراءات تجاهل مع شاشة معيّنة، لا يتفاعل Robo مع أي تطبيقات مصغّرة لواجهة المستخدم تستهدفها إجراءات التجاهل (ما لم يؤدِّ إجراء آخر من نصوص Robo البرمجية إلى تنفيذ Robo لإجراء على أحد التطبيقات المصغّرة لواجهة المستخدم التي تم تجاهلها).

يمكن أن يحتوي نص Robo البرمجي على مزيج من الإجراءات التي يتم تجاهلها والإجراءات الشرطية وغير الشرطية. على عكس إجراءات نصوص Robo البرمجية الأخرى، يتم تطبيق إجراءات التجاهل طالما أنّ السمة contextDescriptor لنص Robo البرمجي الذي يحتوي عليها تتطابق مع شاشة أثناء زحف Robo، بغض النظر عن قيم السمتَين priority وmaxNumberOfRuns.

في ما يلي مثال على ملف يتضمّن نصَّي Robo برمجيَّين. يؤدي نص Robo البرمجي الأول إلى تجاهل 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 البرمجي مواضع البيانات المطلقة للعناصر الفرعية في RecyclerView التي تكون أهدافًا لإجراءات نص Robo البرمجي على النحو التالي: recyclerViewChildPosition. يلتقط نص Robo أيضًا مواضع البيانات المطلقة للعناصر الثانوية في AdapterView التي تستهدفها إجراءات نص Robo كـ adapterViewChildPosition.

يتم تنفيذ الإجراءات على العناصر الثانوية في RecyclerView وAdapterView في الخطوات التالية:

1. يضمن اختبار Robo عرض العنصر الفرعي المقابل على الشاشة من خلال إجراء تحديد الموضع على RecyclerView أو AdapterView الذي يتضمّنه.

2. ينفّذ اختبار Robo الإجراء المسجَّل مباشرةً على العنصر الفرعي، لأنّه معروض على الشاشة.

في ما يلي مثال على إجراء نقر على عنصر فرعي في AdapterView (android.widget.GridView):

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

في ما يلي مثال على إجراء نقرة على عنصر فرعي في RecyclerView (android.support.v7.widget.RecyclerView):

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

تسجيل نص Robo برمجي في "استوديو Android" وتشغيله في Test Lab

يمكنك إنشاء نص برمجي Robo في "استوديو Android"، والذي يحفظ النص البرمجي كملف JSON. يمكنك بعد ذلك تحميل ملف JSON إلى Firebase Test Lab مع التطبيق وإجراء الاختبار وفقًا لذلك.

عند إجراء اختبار Robo مع إرفاق نص برمجي، ينفِّذ اختبار Robo أولاً الإجراءات التي تشتمل على نص برمجي، ثم يستكشف التطبيق كالمعتاد.

لإنشاء ملف JSON لنص Robo البرمجي في "استوديو Android"، اتّبِع الخطوات الواردة في مقالة تسجيل نص Robo البرمجي باستخدام Test Lab في "استوديو Android".

إجراءات نصوص Robo البرمجية

تنطبق السمة الاختيارية الشائعة التالية على جميع الإجراءات:

• ‫description: يساعد في تتبُّع تنفيذ إجراء نص Robo البرمجي هذا في مخرجات اختبار Robo.

Assertion

إذا كان الشرط المُثبَت صحيحًا، يواصل نص Robo البرمجي الإجراء التالي، والذي قد يكون تأكيدًا آخر. وإلا، سيتم إيقاف تنفيذ نص Robo البرمجي بسبب فشل التأكيد.

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على تأكيد في نص برمجي لبرنامج Robo يتحقّق من أنّ التطبيق قيد الاختبار في المقدّمة:

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

في ما يلي مثال على تأكيد نص برمجي لبرنامج Robo يتحقّق من أنّ تطبيق واجهة المستخدم المصغّر الذي يحمل رقم تعريف المورد "com.google.samples.apps.topeka:id/done" موجود على الشاشة:

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

في ما يلي مثال على تأكيد في نص برمجي لـ Robo يتحقّق من عدم رصد "Settings" على الشاشة باستخدام تقنية التعرّف البصري على الأحرف (OCR):

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

النقر

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص برمجي لبرنامج Robo ينقر على زر يحمل معرّف المورد "com.google.samples.apps.topeka:id/done":

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

في ما يلي مثال على إجراء في نص Robo البرمجي ينقر على الكلمة "Search" في المرة الثانية التي يتم فيها رصدها على الشاشة باستخدام تقنية التعرّف البصري على الأحرف (OCR):

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

في ما يلي مثال على إجراء في نص Robo البرمجي ينقر على عنصر في لوحة المفاتيح الافتراضية يتضمّن وصف المحتوى "Emoji button":

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

في ما يلي مثال على إجراء في نص Robo البرمجي ينقر على عناصر عشوائية في لوحة المفاتيح الافتراضية ما يصل إلى خمس مرات:

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

إيقاف لوحة المفاتيح الافتراضية

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص Robo البرمجي يوقف لوحة المفاتيح الافتراضية:

{
  "eventType": "DISABLE_KEYBOARD"
}

تنفيذ أمر واجهة adb

يعرض الجدول التالي السمات المطلوبة:

السمة التالية اختيارية:

• ‫expectedOutputRegex: الناتج المتوقّع للأمر كتعبير عادي في Java وفي حال عدم تطابُق الناتج، سيتعذّر تنفيذ إجراء نص Robo البرمجي. وتكون القيمة التلقائية هي سلسلة فارغة، ما يعني أنّه لا يتم التحقّق من الناتج.

في ما يلي مثال على إجراء نص Robo برمجي يمحو بيانات مستخدم التطبيق قيد الاختبار:

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

منح الأذونات

يتم تسجيل هذا الإجراء من خلال مسجّل نصوص Robo البرمجية في "استوديو Android" للتوافق مع الأنظمة القديمة من خلال مسجّل اختبار Espresso. يمنح اختبار Robo جميع الأذونات للتطبيق قيد الاختبار في بداية كل عملية زحف، وبالتالي، لا يؤدي هذا الإجراء إلى أي نتيجة. لا تستخدم هذا الإجراء في نصوص Robo البرمجية.

يعرض الجدول التالي السمات المطلوبة:

تجاهُل جميع العناصر على الشاشة

يؤدي هذا الإجراء إلى تجاهل Robo لجميع العناصر على أي شاشة تؤدي إلى تشغيل النص البرمجي لـ Robo الذي يحتوي عليها.

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء نص Robo برمجي يجعل Robo يتجاهل جميع العناصر على الشاشة:

{
  "eventType": "ALL_ELEMENTS_IGNORED"
}

تجاهُل عنصر

يؤدي هذا الإجراء إلى تجاهل Robo لعنصر (أو عناصر) يتطابق مع السمة elementDescriptors المحدّدة.

يعرض الجدول التالي السمات المطلوبة:

السمة التالية اختيارية:

• ‫ignoreChildren: في حال ضبطها على true، يتجاهل Robo أيضًا جميع العناصر التابعة لعناصر واجهة المستخدم التي تم تجاهلها. القيمة التلقائية هي false.

في ما يلي مثال على إجراء نص Robo برمجي يجعل Robo يتجاهل جميع العناصر التي تبدأ أوصاف محتواها بـ "Avatar":

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

النص الذي تم إدخاله

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص برمجي لبرنامج Robo يُدخل "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 برمجي ينفّذ نقرة لمدة خمس ثوانٍ على تطبيق مصغّر لواجهة المستخدم يتضمّن وصف المحتوى "Avatar 8":

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

تنفيذ إيماءة بنقطة واحدة

يعرض الجدول التالي السمات المطلوبة:

السمة التالية اختيارية:

• dragAndDrop: في حال ضبطه على true، تؤدي الإيماءة بنقطة واحدة إلى تنفيذ إجراء السحب والإفلات. القيمة التلقائية هي false.

في ما يلي مثال على إجراء إيماءة بنقطة واحدة في نص برمجي لبرنامج Robo ينفّذ تمرير سريعًا للأسفل:

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

تنفيذ إيماءة بنقطتَين

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص برمجي لبرنامج Robo ينفّذ إيماءة التكبير:

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

تنفيذ إجراء IME

يؤدي هذا الإجراء إلى الضغط على زر الإجراء الحالي، مثل "التالي" و"تم" و"بحث"، في "محرر أسلوب الإدخال" (IME) لعنصر واجهة المستخدم المستهدَف المحدّد.

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص Robo البرمجي ينفّذ إجراءً في "محرّر أسلوب الإدخال" (IME) على تطبيق مصغّر لواجهة المستخدم يحمل رقم تعريف المورد "com.google.samples.apps.topeka:id/first_name":

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

اضغط على زر الرجوع

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص برمجي لبرنامج Robo يضغط على زر الرجوع:

{
  "eventType": "PRESSED_BACK"
}

الضغط على زر الشاشة الرئيسية

يؤدي هذا الإجراء إلى إرسال حدث KEYCODE_HOME إلى الجهاز.

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص برمجي لـ Robo يضغط على زر الشاشة الرئيسية:

{
  "eventType": "GO_HOME"
}

التمرير للوصول إلى عنصر معيّن

يؤدي هذا الإجراء إلى جعل اختبار Robo يمرّر للأمام التطبيق المصغّر لواجهة المستخدم الذي يتطابق مع elementDescriptors المحدّد إلى أن يظهر التطبيق المصغّر لواجهة المستخدم الذي يتطابق مع childElementDescriptors المحدّد على الشاشة، أو إلى أن يتعذّر تمرير التطبيق المصغّر الذي تم تمريره، أو إلى أن يتم الوصول إلى الحد الأقصى لعدد مرات التمرير وهو 50 مرة.

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص Robo البرمجي يمرّر أداة واجهة المستخدم التي تحمل رقم تعريف المورد "my.app.package:id/scrollable_card_container" إلى أن تظهر أداة واجهة المستخدم التي تحمل النص "Orange" على الشاشة (أو إلى أن يتعذّر إجراء المزيد من عمليات التمرير أو يتم الوصول إلى الحد الأقصى لعدد عمليات التمرير وهو 50):

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

التمرير سريعًا

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص Robo البرمجي يمرّر سريعًا للأعلى على تطبيق مصغّر لواجهة المستخدم يحمل رقم تعريف المورد "my.app.package:id/custom_content":

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

أخذ لقطة شاشة

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء نص برمجي لبرنامج Robo يأخذ لقطة شاشة:

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

انقر على نقطة على الشاشة

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص Robo البرمجي ينقر في منتصف الشاشة:

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

النقر على نقطة داخل عنصر

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص Robo البرمجي ينقل شريط التمرير الخاص بشريط البحث إلى اليمين:

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

إنهاء الزحف

يؤدي هذا الإجراء إلى إيقاف اختبار Robo.

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء نص Robo برمجي يوقف اختبار Robo:

{
  "eventType": "TERMINATE_CRAWL"
}

انتظار

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص Robo البرمجي ينتظر لمدة ثلاث ثوانٍ:

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

انتظار عنصر

يؤدي هذا الإجراء إلى جعل اختبار Robo ينتظر ظهور عنصر على الشاشة حتى انتهاء المهلة المحدّدة.

يعرض الجدول التالي السمات المطلوبة:

في ما يلي مثال على إجراء في نص برمجي لبرنامج Robo ينتظر لمدة تصل إلى 30 ثانية حتى يظهر على الشاشة تطبيق مصغّر لواجهة المستخدم يحمل رقم تعريف المورد "my.app.package:id/confirmation_button":

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

الخطوات التالية

• كيفية تنفيذ نص برمجي لـ Robo