रोबो स्क्रिप्ट के बारे में जानकारी देने वाली गाइड

इस दस्तावेज़ में रोबो स्क्रिप्ट के बारे में रेफ़रंस के तौर पर जानकारी दी गई है. इसमें संरचना, क्षमताएं, इस्तेमाल, रिकॉर्डिंग, और कार्रवाइयों के बारे में जानकारी शामिल है. रोबो स्क्रिप्ट, ऐसी जांच हैं जो मोबाइल ऐप्लिकेशन के लिए, मैन्युअल क्वालिटी एश्योरेंस (क्यूए) टास्क को ऑटोमेट करती हैं. साथ ही, ये लगातार इंटिग्रेशन (सीआई) और लॉन्च से पहले की जाने वाली टेस्टिंग की रणनीतियों को चालू करती हैं. रोबो स्क्रिप्ट एक JSON फ़ाइल होती है, जिसमें यूज़र इंटरफ़ेस (यूआई) और अन्य कार्रवाइयों के क्रम के बारे में बताया जाता है.

रोबो स्क्रिप्ट बनाने के लिए, ये तरीके अपनाए जा सकते हैं:

• रोबो स्क्रिप्ट रिकॉर्डिंग की सुविधा का इस्तेमाल करें. (सिर्फ़ Android के लिए)

• रोबो स्क्रिप्ट को मैन्युअल तरीके से बनाएं. (Android और iOS+)

• रोबो स्क्रिप्ट रिकॉर्ड करें और फिर उसमें मैन्युअल तरीके से बदलाव करें. (सिर्फ़ Android के लिए)

रोबो स्क्रिप्ट का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, रोबो स्क्रिप्ट चलाना लेख पढ़ें.

शुरुआती जानकारी

रोबो टेस्ट के लिए, रोबो स्क्रिप्ट के साथ-साथ अन्य इनपुट भी दिए जाते हैं. जैसे, जांचा जा रहा ऐप्लिकेशन का Android ऐप्लिकेशन पैकेज (APK).

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है, जो किसी उपयोगकर्ता को ऐप्लिकेशन में साइन इन कराती है. यह स्क्रिप्ट, टेस्ट किए जा रहे ऐप्लिकेशन के लॉन्च होने पर ट्रिगर होती है:

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

अगर किसी फ़ाइल में एक ही रोबो स्क्रिप्ट है और उसमें ऊपर दिए गए उदाहरण की तरह डिफ़ॉल्ट app_under_test_shown ट्रिगर करने की शर्त है, तो फ़ाइल में रोबो स्क्रिप्ट को आसान फ़ॉर्मैट में बताया जा सकता है. जैसे, उसकी कार्रवाइयों का क्रम:

[
  {
    "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+ सहायता

iOS+ (बीटा) के लिए Robo में, रोबो स्क्रिप्ट के लिए सीमित सहायता मिलती है. iOS+ के लिए रोबो स्क्रिप्ट सिंटैक्स, Android सिंटैक्स जैसा ही होता है. साथ ही, iOS+ की काम करने वाली सुविधाएं, Android की सुविधाओं की तरह ही काम करती हैं.

iOS+ में ये कार्रवाइयां की जा सकती हैं:

• दावा
• क्लिक
• ज़्यादा देर तक क्लिक करना
• स्‍वाइप
• सभी एलिमेंट को अनदेखा करें
• इंतज़ार करें
• स्क्रीनशॉट लेने के लिए
• क्रॉल को खत्म करना

एलिमेंट डिस्क्रिप्टर में, पहचान करने वाले ये एट्रिब्यूट iOS+ के साथ काम करते हैं:

• कक्षा का नाम
• पैरंट क्लास का नाम
• कॉन्टेंट की जानकारी और रेगुलर एक्सप्रेशन
• टेक्स्ट (और रेगुलर एक्सप्रेशन)

कॉन्टेक्स्ट डिस्क्रिप्टर में ट्रिगर करने की ये स्थितियां, iOS+ में काम करती हैं:

• टेस्ट में ऐप्लिकेशन दिखाया गया
• एलिमेंट मौजूद है
• रोबो स्क्रिप्ट के अलावा कोई दूसरी कार्रवाई की गई

बनावट

रोबो स्क्रिप्ट में कई एट्रिब्यूट होते हैं, जिनसे यह पता चलता है कि रोबो इसे कैसे लागू करता है. इनमें से ज़्यादातर एट्रिब्यूट की वैल्यू सबमिट करना ज़रूरी नहीं है. हालांकि, इनके लिए पहले से डिफ़ॉल्ट वैल्यू सेट होती हैं:

एक फ़ाइल में एक या उससे ज़्यादा रोबो स्क्रिप्ट का कलेक्शन होता है.

यहां एक फ़ाइल का उदाहरण दिया गया है, जिसमें बिना किसी शर्त के दो रोबो स्क्रिप्ट हैं. हर स्क्रिप्ट में एक ऐसी कार्रवाई है जो क्रॉल की शुरुआत में एक बार पूरी होती है:

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

कॉन्टेक्स्ट डिस्क्रिप्टर

कॉन्टेक्स्ट डिस्क्रिप्टर उस कॉन्टेक्स्ट या शर्त के बारे में बताता है जो किसी एक या कई एट्रिब्यूट के कॉम्बिनेशन का इस्तेमाल करके रोबो स्क्रिप्ट को ट्रिगर करता है:

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है, जो स्क्रीन पर मौजूद संसाधन आईडी "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"
        }
      ]
    }
  ]
}

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है, जो ऑप्टिकल कैरेक्टर रिकग्निशन (ओसीआर) की मदद से "Privacy Policy" का पता लगाकर ट्रिगर होती है:

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

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है, जो स्क्रिप्ट के अलावा की गई हर रोबो ऐक्शन के बाद पांच सेकंड तक इंतज़ार करती है:

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

कार्रवाइयां

रोबो स्क्रिप्ट में होने वाली हर कार्रवाई को एक या एक से ज़्यादा एट्रिब्यूट-वैल्यू पेयर के बंडल के तौर पर दिखाया जाता है. इन पेयर के बारे में इस टेबल में बताया गया है:

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है, जिसमें टारगेट किए गए यूज़र इंटरफ़ेस (यूआई) विजेट के बिना दो कार्रवाइयां हैं. इसका मतलब है कि ये कार्रवाइयां किसी खास यूआई विजेट पर काम नहीं करतीं:

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

एलिमेंट डिस्क्रिप्टर

एलिमेंट डिस्क्रिप्टर, पहचान करने वाले इनमें से एक या एक से ज़्यादा एट्रिब्यूट का इस्तेमाल करके, यूज़र इंटरफ़ेस (यूआई) विजेट की पहचान करता है:

अक्सर, इन एट्रिब्यूट की वैल्यू नहीं दी जाती है. उदाहरण के लिए, हो सकता है कि किसी बटन में टेक्स्ट और कॉन्टेंट की जानकारी न हो. भले ही, कुछ एट्रिब्यूट की वैल्यू मौजूद हों, फिर भी हो सकता है कि वे किसी ऐप्लिकेशन की स्क्रीन (resourceId के साथ) पर यूनीक न हों.

उदाहरण के लिए, किसी सूची के आइटम के बीच अंतर करने के लिए, आम तौर पर पैरंट विजेट में उनके अलग-अलग चाइल्ड पोज़िशन का इस्तेमाल किया जाता है. इसका मतलब है कि आम तौर पर, यूज़र इंटरफ़ेस (यूआई) विजेट की पहचान करने के लिए, सिर्फ़ एक एलिमेंट डिस्क्रिप्टर का इस्तेमाल करना काफ़ी नहीं होता. इसलिए, किसी ऐक्शन के elementDescriptors एट्रिब्यूट में एलिमेंट डिस्क्रिप्टर का क्रम होता है. यह क्रम इस तरह से होता है कि पहला एलिमेंट टारगेट यूज़र इंटरफ़ेस (यूआई) विजेट से जुड़ा होता है, दूसरा एलिमेंट टारगेट यूज़र इंटरफ़ेस (यूआई) विजेट के पेरंट विजेट से जुड़ा होता है वगैरह. किसी कार्रवाई के टारगेट यूज़र इंटरफ़ेस (यूआई) विजेट का मिलान तब किया जाता है, जब उसके सभी एलिमेंट डिस्क्रिप्टर, उससे जुड़े यूज़र इंटरफ़ेस (यूआई) विजेट की सब-हायररकी से मैच करते हैं.

यहां टेक्स्ट में बदलाव और क्लिक ऐक्शन वाली रोबो स्क्रिप्ट का उदाहरण दिया गया है. इन दोनों में यह ज़रूरी है कि आप दिए गए एलिमेंट डिस्क्रिप्टर का इस्तेमाल करके, टारगेट यूज़र इंटरफ़ेस (यूआई) विजेट की पहचान करें:

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

लागू करने के विकल्प

आपके पास रोबो स्क्रिप्ट में, एक JSON ऑब्जेक्ट के साथ कार्रवाइयों की सूची को प्रीफ़िक्स करने का विकल्प होता है. यह सूची, उस रोबो स्क्रिप्ट को लागू करने के विकल्प तय करती है. यह कॉन्फ़िगरेशन हेडर, roboscript कीवर्ड से शुरू होता है. इसके बाद, पसंद के हिसाब से एक्ज़ीक्यूशन के विकल्पों को JSON दिखाया जाता है.

रोबो स्क्रिप्ट, इन विकल्पों के साथ काम करती हैं:

• executionMode - रोबो स्क्रिप्ट के चलने पर, एक्ज़ीक्यूशन के विकल्प लागू होते हैं:
  • strict - अगर इसे true पर सेट किया जाता है, तो रोबो स्क्रिप्ट कुछ हद तक मैच करने, मौजूदा कार्रवाई को स्किप करने, और निलंबन की सुविधा का इस्तेमाल नहीं करती है. इसका मतलब है कि रोबो स्क्रिप्ट को सामान्य इंस्ट्रूमेंटेशन टेस्ट के तौर पर चलाया जाता है और अगर इसकी कोई भी कार्रवाई पूरी नहीं की जा सकती, तो यह टेस्ट फ़ेल हो जाता है. डिफ़ॉल्ट रूप से, यह false होता है.
  • dismiss_popups - अगर इसे true पर सेट किया जाता है, तो रोबो टेस्ट strict मोड में भी, रोबो स्क्रिप्ट को चलाते समय किसी भी अनचाहे डायलॉग को खारिज कर देता है. strict मोड में न होने पर, इस विकल्प का कोई असर नहीं पड़ता. डिफ़ॉल्ट रूप से, यह false है.
  • notify - अगर रोबो स्क्रिप्ट को false पर सेट किया जाता है, तो यह सुविधा लागू होने की शुरुआत और आखिर में, स्क्रीन पर सूचनाएं नहीं दिखाती है. डिफ़ॉल्ट रूप से, यह true होता है.
• postscript - रोबो स्क्रिप्ट पूरी होने के बाद लागू होने वाले, लागू करने के विकल्प:
  • terminate - अगर इसे true पर सेट किया जाता है, तो रोबो स्क्रिप्ट पूरी होने के बाद, रोबो टेस्ट क्रॉल करना बंद कर देता है. डिफ़ॉल्ट रूप से, यह false होता है.

यहां strict मोड में, स्क्रीन पर सूचनाएं दिखाए बिना चलाई गई रोबो स्क्रिप्ट का उदाहरण दिया गया है. यह स्क्रिप्ट तीन सेकंड के लिए रुकती है और इसके बाद क्रॉल करना बंद कर देती है:

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

टेंप्लेट पैरामीटर

टेंप्लेट पैरामीटर, रोबो स्क्रिप्ट में मौजूद एक प्लेसहोल्डर होता है. जब रोबो टेस्ट, उस रोबो स्क्रिप्ट को लागू करने के लिए लोड करता है, तो उसे असल वैल्यू से बदल दिया जाता है. टेंप्लेट के पैरामीटर के आगे डबल अंडरस्कोर और उसके बाद प्रतिशत का चिह्न होता है. साथ ही, पैरामीटर के आखिर में प्रतिशत का चिह्न और उसके बाद डबल अंडरस्कोर होता है.

रोबो स्क्रिप्ट, इन टेंप्लेट पैरामीटर के साथ काम करती हैं:

• __%APP_PACKAGE_NAME%__ - ऐप्लिकेशन की जांच में लगे पैकेज का नाम.

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है, जो जांचे जा रहे ऐप्लिकेशन की प्रोसेस को रोकती है:

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

टिप्पणियां

रोबो स्क्रिप्ट में टिप्पणी वाली लाइनें हो सकती हैं. ये लाइनें # या // से शुरू होती हैं.

कुछ टिप्पणियों वाली रोबो स्क्रिप्ट का एक उदाहरण नीचे दिया गया है:

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

मिलने वाली अनुमतियां

डिफ़ॉल्ट रूप से, रोबो स्क्रिप्ट तब तक चालू रहती है, जब तक उसकी सभी कार्रवाइयां पूरी नहीं हो जातीं या कम से कम कोशिश नहीं की जाती. रोबो टेस्ट, कोई कार्रवाई चुनते समय, रोबो स्क्रिप्ट ऐक्शन से मैच करने की कोशिश करता रहता है. रोबो स्क्रिप्ट, ताकत बढ़ाने के लिए यहां दी गई तकनीकों का इस्तेमाल करती है:

प्राथमिकताएं

अगर कोई रोबो स्क्रिप्ट अपने maxNumberOfRuns तक पहुंच जाती है, तो उसे किसी क्रॉल में ट्रिगर नहीं किया जा सकता. अगर मौजूदा कॉन्टेक्स्ट से एक से ज़्यादा रोबो स्क्रिप्ट ट्रिगर हो सकती हैं, तो इन रोबो स्क्रिप्ट को प्राथमिकता दी जाती है:

1. इसमें contextDescriptor एट्रिब्यूट है.
2. सबसे ज़्यादा priority है (डिफ़ॉल्ट रूप से, सभी रोबो स्क्रिप्ट में 1 का एक ही priority होता है).
3. अगर रोबो स्क्रिप्ट की प्राथमिकताएं एक जैसी हैं, तो यह रोबो स्क्रिप्ट की सूची में सबसे पहले दिखती है.

यहां एक फ़ाइल का उदाहरण दिया गया है, जिसमें तीन रोबो स्क्रिप्ट हैं. ये स्क्रिप्ट एक ही कार्रवाई करती हैं और एक ही शर्त से ट्रिगर होती हैं. यह शर्त है कि जांचा जा रहा ऐप्लिकेशन फ़ोरग्राउंड में हो:

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

जब जांचा जा रहा ऐप्लिकेशन फ़ोरग्राउंड में हो, तो रोबो इन चरणों को क्रम से ट्रिगर करता है:

1. "Robo script 2", क्योंकि इसकी प्राथमिकता सबसे ज़्यादा है.
2. "Robo script 1", क्योंकि यह लागू होने वाली बाकी रोबो स्क्रिप्ट के बीच, एक ही प्राथमिकता के साथ पहले दिखती है.
3. "Robo script 3" को आखिरी बार लागू की गई रोबो स्क्रिप्ट के तौर पर सेट किया गया है.

बार-बार चलाए जाने वाले रन

डिफ़ॉल्ट रूप से, रोबो किसी क्रॉल के दौरान ज़्यादा से ज़्यादा एक बार रोबो स्क्रिप्ट को ट्रिगर करता है. इसे maxNumberOfRuns एट्रिब्यूट की मदद से अडजस्ट किया जा सकता है.

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है, जो जांच में शामिल ऐप्लिकेशन को 10 बार बैकग्राउंड में ले जाती है:

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

क्रॉल स्टेज

रोबो स्क्रिप्ट, किसी रोबो क्रॉल के अलग-अलग चरणों में लागू होती हैं:

अगर रोबो स्क्रिप्ट के crawlStage एट्रिब्यूट की जानकारी नहीं दी गई है, तो यह crawl माना जाएगा.

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है. यह स्क्रिप्ट, जांच में शामिल ऐप्लिकेशन के उपयोगकर्ता का डेटा, रोबो के क्रॉल करने से पहले मिटा देती है:

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

यहां एक रोबो स्क्रिप्ट का उदाहरण दिया गया है. यह स्क्रिप्ट, पुष्टि करने वाले डायलॉग से वापस जाने (बैकट्रैक) की कोशिश करने पर, रोबो को "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"
        }
      ]
    }
  ]
}

शर्तें पूरी होने पर ट्रिगर होने वाली कार्रवाइयां

रोबो स्क्रिप्ट में शर्तों के हिसाब से कार्रवाइयां हो सकती हैं. शर्तें पूरी होने पर ट्रिगर होने वाली कार्रवाइयों में तीन और एट्रिब्यूट होते हैं. इनसे यह पता चलता है कि रोबो इन कार्रवाइयों को कैसे करता है:

ट्रिगर होने पर, रोबो स्क्रिप्ट अपनी बिना शर्त वाली कार्रवाइयों को एक-एक करके, दिखने के क्रम में करती है. अगर किसी रोबो स्क्रिप्ट में शर्तों के हिसाब से कार्रवाई करने की सुविधा है, तो बिना शर्त के कार्रवाई करने की सुविधा चुनने से पहले, हर बार इन शर्तों को ध्यान में रखा जाता है. अगर कोई शर्त पूरी होने पर ट्रिगर होने वाली कार्रवाई, अपनी प्राथमिकता और बाकी बचे रन की संख्या के आधार पर ट्रिगर और चुनी जाती है, तो रोबो स्क्रिप्ट इस शर्त पूरी होने पर ट्रिगर होने वाली कार्रवाई को पूरा करती है. अगर ऐसा नहीं होता है, तो रोबो स्क्रिप्ट, शर्त के बिना यह कार्रवाई करती है. किसी रोबो स्क्रिप्ट को मान्य बनाने के लिए, उसमें कम से कम एक ऐसी कार्रवाई होनी चाहिए जिसमें शर्त शामिल न हो.

यहां उदाहरण के तौर पर, बिना किसी शर्त के

{
  "id": 1000,
  "actions": [
    {
      "description": "Dismiss popup",
      "maxNumberOfRuns": 100,
      "contextDescriptor": {
        "condition": "default_launcher_shown",
        "negateCondition": true
      },
      "eventType": "GO_HOME"
    },
    {
      "description": "Screen off",
      "eventType": "ADB_SHELL_COMMAND",
      "command": "input keyevent 26"
    },
    {
      "description": "Wait for 10 seconds",
      "eventType": "DELAYED_MESSAGE_POSTED",
      "delayTime": 10000
    },
    {
      "description": "Screen on",
      "eventType": "ADB_SHELL_COMMAND",
      "command": "input keyevent 82"
    },
    {
      "description": "Wait for 10 seconds",
      "eventType": "DELAYED_MESSAGE_POSTED",
      "delayTime": 10000
    }
}

कार्रवाइयों को अनदेखा करना

रोबो स्क्रिप्ट में, रोबो को किसी खास स्क्रीन पर मौजूद यूज़र इंटरफ़ेस (यूआई) विजेट या सभी यूआई विजेट को अनदेखा करने के निर्देश शामिल किए जा सकते हैं. इन निर्देशों को eventType ELEMENT_IGNORED और ALL_ELEMENTS_IGNORED के साथ "कार्रवाइयों" को अनदेखा करने के तौर पर दिखाया गया है.

जब भी कार्रवाइयों को अनदेखा करने वाली रोबो स्क्रिप्ट का contextDescriptor एट्रिब्यूट किसी स्क्रीन से मेल खाता है, तो रोबो इसकी कार्रवाई को अनदेखा करके टारगेट किए गए किसी भी यूज़र इंटरफ़ेस (यूआई) विजेट के साथ इंटरैक्ट नहीं करता है (जब तक कि रोबो की कोई दूसरी स्क्रिप्ट, अनदेखा किए गए यूआई विजेट में से किसी एक पर कार्रवाई करने के लिए कहती है).

रोबो स्क्रिप्ट में, अनदेखा करने, शर्तों के हिसाब से, और बिना शर्त के कार्रवाई करने वाली कार्रवाइयां शामिल हो सकती हैं. रोबो स्क्रिप्ट की अन्य कार्रवाइयों के उलट, अनदेखा की जाने वाली कार्रवाइयां तब तक लागू होती हैं, जब तक कि उनमें शामिल रोबो स्क्रिप्ट का contextDescriptor, रोबो क्रॉल के दौरान किसी स्क्रीन से मैच करता है. इस बात से कोई फ़र्क़ नहीं पड़ता कि priority और maxNumberOfRuns एट्रिब्यूट की वैल्यू क्या है.

यहां दो रोबो स्क्रिप्ट वाली फ़ाइल का उदाहरण दिया गया है. पहली रोबो स्क्रिप्ट, रोबो को स्क्रीन पर मौजूद सभी यूज़र इंटरफ़ेस (यूआई) विजेट को अनदेखा करती है. इसमें रिसॉर्स आईडी "my.app.package:id/ignored_screen" वाला यूज़र इंटरफ़ेस (यूआई) विजेट होता है. दूसरी रोबो स्क्रिप्ट, रिसॉर्स आईडी ".*: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 के विजेट, डाइनैमिक तौर पर लोड होते हैं. इन्हें मौजूदा स्क्रीन से कई स्वाइप करके, अलग दिखाया जा सकता है. बच्चे के डिवाइस के नाप या आकार के हिसाब से, स्क्रीन का साइज़ और उसे कितनी बार स्वाइप किया जा सकता है, यह अलग-अलग होता है. इसलिए, बच्चे के डिवाइस के डेटा की जगह की सटीक जानकारी पर भरोसा करना ज़्यादा बेहतर होता है. इस बच्चे को स्क्रीन पर लाने के लिए, स्क्रीन पर स्वाइप करने की संख्या पर भरोसा करना और फिर स्क्रीन पर उसकी पोज़िशन का इस्तेमाल करना, कम असरदार तरीका है.

इसलिए, रोबो स्क्रिप्ट, RecyclerView के उन चाइल्ड की डेटा पोज़िशन को कैप्चर करती है जो रोबो स्क्रिप्ट ऐक्शन के टारगेट के तौर पर recyclerViewChildPosition के तौर पर मौजूद होते हैं. रोबो स्क्रिप्ट, adapterViewChildPosition के तौर पर, उन AdapterView चाइल्ड की डेटा पोज़िशन को भी कैप्चर करती है जो रोबो स्क्रिप्ट ऐक्शन के टारगेट होते हैं.

RecyclerView और AdapterView के चाइल्ड पर कार्रवाइयां, इन चरणों में की जाती हैं:

1. रोबो टेस्ट यह पक्का करता है कि उसमें मौजूद RecyclerView या AdapterView पर पोज़िशनिंग ऐक्शन की मदद से, स्क्रीन पर उसी एलिमेंट को दिखाया जाए.

2. रोबो टेस्ट, रिकॉर्ड की गई कार्रवाई को सीधे चाइल्ड एलिमेंट पर करता है, क्योंकि वह पहले से ही स्क्रीन पर दिख रहा होता है.

यहां 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
    }
  ]
}

Android Studio में रोबो स्क्रिप्ट रिकॉर्ड करें और उसे Test Lab में चलाएं

Android Studio में रोबो स्क्रिप्ट बनाई जा सकती है. यह स्क्रिप्ट को JSON फ़ाइल के तौर पर सेव करती है. इसके बाद, ऐप्लिकेशन वाली JSON फ़ाइल को Firebase Test Lab पर अपलोड किया जा सकता है और उसी हिसाब से टेस्ट किया जा सकता है.

जब अटैच की गई स्क्रिप्ट के साथ कोई रोबो टेस्ट चलाया जाता है, तो रोबो टेस्ट पहले, आपकी स्क्रिप्ट से पहले की कार्रवाइयां करता है और फिर ऐप्लिकेशन को हमेशा की तरह एक्सप्लोर करता है.

Android Studio में रोबो स्क्रिप्ट की JSON फ़ाइल बनाने के लिए, Android Studio में Test Lab का इस्तेमाल करके रोबो स्क्रिप्ट रिकॉर्ड करना लेख में दिया गया तरीका अपनाएं.

रोबो स्क्रिप्ट से जुड़ी कार्रवाइयां

सभी कार्रवाइयों पर, नीचे दिया गया सामान्य वैकल्पिक एट्रिब्यूट लागू होता है:

• description - यह रोबो स्क्रिप्ट ऐक्शन को रोबो के टेस्ट आउटपुट में लागू होने का ट्रैक रखने में मदद करता है.

दावा

अगर एश्यर्ड कंडीशन सही है, तो रोबो स्क्रिप्ट अगली कार्रवाई पर जाती है. यह कार्रवाई कोई दूसरा एश्योरेशन हो सकती है. ऐसा न होने पर, असर न होने की वजह से रोबो स्क्रिप्ट का क्रियान्वयन रोक दिया जाता है.

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां रोबो स्क्रिप्ट के ऐसे एश्योरेशन का उदाहरण दिया गया है जो यह जांच करता है कि जांचा जा रहा ऐप्लिकेशन फ़ोरग्राउंड में है या नहीं:

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

यहां रोबो स्क्रिप्ट के ऐसे एश्योरेशन का उदाहरण दिया गया है जो यह जांच करता है कि संसाधन आईडी "com.google.samples.apps.topeka:id/done" वाला यूज़र इंटरफ़ेस विजेट, स्क्रीन पर मौजूद है या नहीं:

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

यहां रोबो स्क्रिप्ट के ऐसे दावे का उदाहरण दिया गया है जो यह जांच करता है कि "Settings", ओसीआर का इस्तेमाल करके स्क्रीन पर नहीं मिला है:

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

क्लिक

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां एक रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है, जो संसाधन आईडी "com.google.samples.apps.topeka:id/done" वाले बटन पर क्लिक करता है:

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

यहां एक रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है. यह ओसीआर का इस्तेमाल करके, स्क्रीन पर "Search" शब्द के दूसरी बार दिखने पर क्लिक करता है:

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

यहां रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण दिया गया है, जो कॉन्टेंट के ब्यौरे "Emoji button" वाले सॉफ़्ट कीबोर्ड एलिमेंट पर क्लिक करता है:

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

रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण नीचे दिया गया है, जो किसी भी सॉफ़्ट कीबोर्ड एलिमेंट पर पांच बार तक क्लिक करता है:

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

सॉफ़्ट कीबोर्ड बंद करें

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां एक रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है, जो सॉफ़्ट कीबोर्ड को बंद करता है:

{
  "eventType": "DISABLE_KEYBOARD"
}

adb shell कमांड चलाना

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यह एट्रिब्यूट ज़रूरी नहीं है:

• expectedOutputRegex - Java रेगुलर एक्सप्रेशन के तौर पर, कमांड का अनुमानित आउटपुट. अगर आउटपुट मेल नहीं खाता है, तो रोबो स्क्रिप्ट ऐक्शन काम नहीं करता. डिफ़ॉल्ट रूप से, यह एक खाली स्ट्रिंग होती है. इसका मतलब है कि आउटपुट की जांच नहीं की जाती.

यहां एक रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है, जो जांच में शामिल ऐप्लिकेशन के उपयोगकर्ता का डेटा मिटाता है:

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

अनुमतियां दें

यह कार्रवाई, Android Studio में रोबो स्क्रिप्ट रिकॉर्डर की मदद से रिकॉर्ड की जाती है. ऐसा इसलिए किया जाता है, ताकि Espresso Test Recorder के साथ पिछली रिकॉर्डिंग काम करती रहे. रोबो टेस्ट, हर क्रॉल की शुरुआत में, जांचे जा रहे ऐप्लिकेशन को सभी अनुमतियां देता है. इसलिए, यह कार्रवाई कोई काम की नहीं है. अपनी रोबो स्क्रिप्ट में इस कार्रवाई का इस्तेमाल न करें.

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

स्क्रीन पर मौजूद सभी एलिमेंट को अनदेखा करना

इस कार्रवाई से रोबो, किसी भी स्क्रीन पर मौजूद उन सभी एलिमेंट को अनदेखा कर देता है जो रोबो स्क्रिप्ट को ट्रिगर करते हैं.

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट की सूची दी गई है:

यहां रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण दिया गया है, जिससे रोबो किसी स्क्रीन पर मौजूद सभी एलिमेंट को अनदेखा कर देता है:

{
  "eventType": "ALL_ELEMENTS_IGNORED"
}

किसी एलिमेंट को अनदेखा करना

इस कार्रवाई से, Robo उस एलिमेंट (या एलिमेंट) को अनदेखा कर देता है जो बताए गए elementDescriptors से मेल खाता है.

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

इस एट्रिब्यूट को शामिल करना ज़रूरी नहीं है:

• ignoreChildren - अगर इसे true पर सेट किया जाता है, तो रोबो उन यूज़र इंटरफ़ेस विजेट के सभी डिसेंटेंट को भी अनदेखा कर देता है जिन्हें अनदेखा किया गया है. डिफ़ॉल्ट रूप से, यह false होता है.

यहां रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण दिया गया है. इसकी मदद से, रोबो उन सभी एलिमेंट को अनदेखा करता है जिनके कॉन्टेंट की जानकारी "Avatar" से शुरू होती है:

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

इनपुट टेक्स्ट

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण दिया गया है. यह "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 - इससे पता चलता है कि लंबे समय तक दबाए रखने पर, बटन को दबाए रखने का समय कितना है. इसे मिलीसेकंड में दिखाया जाता है.

यहां रोबो स्क्रिप्ट की एक ऐसी कार्रवाई का उदाहरण दिया गया है जो कॉन्टेंट की जानकारी "Avatar 8" वाले यूज़र इंटरफ़ेस (यूआई) विजेट पर पांच सेकंड तक क्लिक करती है:

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

एक पॉइंट के जेस्चर का इस्तेमाल करें

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

इस एट्रिब्यूट को शामिल करना ज़रूरी नहीं है:

• dragAndDrop - अगर इसे true पर सेट किया जाता है, तो एक-पॉइंट जेस्चर से, खींचकर छोड़ने की कार्रवाई की जाती है. डिफ़ॉल्ट रूप से, यह false है.

यहां रोबो स्क्रिप्ट के एक-पॉइंट जेस्चर ऐक्शन का उदाहरण दिया गया है, जो नीचे की ओर स्वाइप करता है:

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

दो उंगलियों से जेस्चर करना

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

नीचे रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण दिया गया है, जो पिंच आउट जेस्चर करता है:

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

IME से कार्रवाई करें

इस कार्रवाई से, तय किए गए टारगेट यूज़र इंटरफ़ेस (यूआई) विजेट के लिए, इनपुट के तरीके के एडिटर (IME) पर 'आगे बढ़ें', 'हो गया', और 'खोजें' बटन पर मौजूदा कार्रवाई बटन दबाया जाता है.

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां एक रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है, जो रिसॉर्स आईडी "com.google.samples.apps.topeka:id/first_name" वाले यूज़र इंटरफ़ेस विजेट पर IME ऐक्शन करता है:

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

'वापस जाएं' दबाएं

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां एक रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है, जो 'वापस जाएं' बटन को दबाता है:

{
  "eventType": "PRESSED_BACK"
}

होम बटन दबाएं

यह कार्रवाई, डिवाइस पर KEYCODE_HOME इवेंट भेजती है.

इस टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां होम बटन को दबाने वाली रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है:

{
  "eventType": "GO_HOME"
}

किसी एलिमेंट को स्क्रोल करके देखना

इस कार्रवाई से, रोबो टेस्ट, तय किए गए elementDescriptors से मैच करने वाले यूज़र इंटरफ़ेस (यूआई) विजेट को तब तक आगे की ओर स्क्रोल करता है, जब तक कि तय किए गए childElementDescriptors से मैच करने वाला यूज़र इंटरफ़ेस (यूआई) विजेट स्क्रीन पर मौजूद न हो जाए या स्क्रोल किए गए विजेट को अब स्क्रोल न किया जा सके या ज़्यादा से ज़्यादा 50 स्क्रोल तक पहुंच न जाए.

इस टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां एक रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है. यह रिसॉर्स आईडी "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"
    }
  ]
}

स्‍वाइप

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण दिया गया है. यह रिसॉर्स आईडी "my.app.package:id/custom_content" वाले यूज़र इंटरफ़ेस (यूआई) विजेट को ऊपर की ओर स्वाइप करता है:

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

स्क्रीनशॉट लेना

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट की सूची दी गई है:

यहां स्क्रीनशॉट लेने वाली रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है:

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

स्क्रीन पर किसी बिंदु पर टैप करना

इस टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां स्क्रीन के बीच में टैप करने वाली रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है:

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

किसी एलिमेंट में मौजूद किसी पॉइंट पर टैप करना

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण नीचे दिया गया है, जो सीकबार के स्लाइडर को दाईं ओर ले जाता है:

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

क्रॉल को खत्म करना

इससे रोबो टेस्ट रुक जाता है.

यहां दी गई टेबल में ज़रूरी एट्रिब्यूट की सूची दी गई है:

यहां रोबो स्क्रिप्ट ऐक्शन का एक उदाहरण दिया गया है, जो रोबो टेस्ट को रोकता है:

{
  "eventType": "TERMINATE_CRAWL"
}

इंतज़ार करें

इस टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां तीन सेकंड तक इंतज़ार करने वाली रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है:

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

किसी एलिमेंट के दिखने का इंतज़ार करना

इस कार्रवाई से, रोबो टेस्ट, तय किए गए टाइम आउट तक स्क्रीन पर किसी एलिमेंट के दिखने का इंतज़ार करता है.

इस टेबल में ज़रूरी एट्रिब्यूट दिए गए हैं:

यहां एक रोबो स्क्रिप्ट ऐक्शन का उदाहरण दिया गया है. यह स्क्रीन पर, संसाधन आईडी "my.app.package:id/confirmation_button" वाले यूज़र इंटरफ़ेस (यूआई) विजेट के दिखने के लिए 30 सेकंड तक इंतज़ार करता है:

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

अगले चरण

• रोबो स्क्रिप्ट चलाने का तरीका जानें.