Guida di riferimento per gli script Robo

Questo documento fornisce informazioni di riferimento sugli script di Robo, tra cui struttura, funzionalità, utilizzo, registrazione e azioni. Gli script Robo sono test che automatizzano le attività di controllo qualità (QA) manuale per le app mobile e consentono l'integrazione continua (CI) e le strategie di test pre-lancio. Un roboscript è un file JSON che descrive una sequenza di interfaccia utente (UI) e altre azioni.

Puoi creare uno script Robo nei seguenti modi:

• Utilizza la funzionalità di registrazione dello script Robo. (Solo Android)

• Crea lo script Robo manualmente. (Android, iOS e versioni successive).

• Registra lo script Robo e modificalo manualmente. (Solo Android)

Per scoprire di più sull'utilizzo degli script Robo, consulta Eseguire uno script Robo.

Introduzione

Lo script Robo viene fornito al test Robo insieme ad altri input, come il pacchetto Android (APK) dell'app in test.

Di seguito è riportato un esempio di script Robo che consente a un utente di accedere a un'app, che viene attivato all'avvio dell'app-under-test:

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

Se in un file è presente un singolo script Robo e ha la condizione di attivazione app_under_test_shown predefinita, come nell'esempio precedente, puoi specificare lo script Robo in un file utilizzando un formato più semplice, ovvero come sequenza delle relative azioni:

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

Supporto di iOS e versioni successive per gli script Robo

Robo per iOS e versioni successive (beta) offre un supporto limitato per gli script Robo. La sintassi dello script Robo per iOS e versioni successive è identica a quella di Android e le funzionalità supportate per iOS e versioni successive si comportano in modo simile alle loro controparti per Android.

Nota: Robo per iOS e versioni successive è una versione beta. Ciò significa che la funzionalità potrebbe cambiare in modi non compatibili con le versioni precedenti. Una release beta non è soggetta a SLA (accordo sul livello del servizio) o norme sul ritiro e potrebbe ricevere assistenza limitata o nessuna assistenza.

Le seguenti azioni sono supportate in iOS e versioni successive:

• affermazione
• Fai clic su
• Clic prolungato
• Sfioramento
• Ignora tutti gli elementi
• Attendi
• Acquisisci screenshot
• Interrompi la scansione

I seguenti attributi di identificazione nei descrittori degli elementi sono supportati in iOS e versioni successive:

• Nome del corso
• Nome classe predecessore
• Descrizione dei contenuti (e regex)
• Testo (e regex)

In iOS+ sono supportate le seguenti condizioni di attivazione nei descrittori di contesto:

• App in fase di test mostrata
• Elemento presente
• Azione dello script non Robo eseguita

Struttura

Uno script Robo ha diversi attributi che descrivono come Robo lo esegue. La maggior parte di questi attributi è facoltativa con valori predefiniti:

Attributo	Descrizione
id	Un numero intero che consente di monitorare questo script Robo negli output della scansione. Robo ha script Robo integrati con i propri id. Anche se lo stesso id in script Robo diversi non influisce sul loro comportamento, distinguere le azioni di questi script Robo negli output della scansione può essere complicato. Per evitare conflitti, ti consigliamo di assegnare un id univoco di almeno 1000 per gli script Robo.
description	Simile a id, ma più descrittivo.
crawlStage	La fase di una scansione in cui Robo applica questo script Robo. Per impostazione predefinita, è la fase di scansione principale.
priority	La priorità di questo script Robo rispetto ad altri script Robo. Per impostazione predefinita, tutti gli script Robo hanno una priorità pari a 1.
maxNumberOfRuns	Specifica quante volte durante una scansione Robo può eseguire questo script Robo. Per impostazione predefinita, Robo può eseguire uno script Robo una sola volta.
contextDescriptor	Descrive il contesto o la condizione che attiva questo script Robo. Se omessa, la condizione di attivazione di questo script Robo viene considerata sempre soddisfatta. In altre parole, lo script Robo è incondizionato.
actions	Tutte le azioni di questo script Robo.

Un singolo file contiene una raccolta di uno o più script Robo.

Di seguito è riportato un esempio di file con due script Robo incondizionali, ciascuno con una singola azione eseguita una volta all'inizio di una scansione:

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

Descrittore di contesto

Un descrittore di contesto definisce il contesto o la condizione che attiva uno script Robo utilizzando uno o una combinazione di più attributi:

Attributo	Descrizione
"condition": "always"	Attiva sempre uno script Robo.
"condition": "element_present"	Controlla che sullo schermo sia presente un widget UI corrispondente a elementDescriptors o al testo specificato da visionText.
"condition": "element_disabled"	Verifica che sullo schermo sia presente un widget dell'interfaccia utente corrispondente a elementDescriptors con cui non è possibile interagire.
"condition": "element_checked"	Verifica che sullo schermo sia presente e selezionato un widget UI corrispondente a elementDescriptors.
"condition": "app_under_test_shown"	Verifica che l'app in test sia in esecuzione in primo piano.
"condition": "default_launcher_shown"	Verifica che venga visualizzata la schermata Home di un dispositivo, il che significa che non sono in esecuzione app in primo piano.
"condition": "non_roboscript_action_performed"	Verifica che le ultime nonRoboscriptActionCount azioni consecutive eseguite dal test Robo non siano azioni dello script Robo.
negateCondition	Se impostato su true, nega condition. Ad esempio, puoi utilizzare questo attributo per verificare se un widget dell'interfaccia utente NON è presente sullo schermo o se l'app in test NON è in esecuzione in primo piano.
elementDescriptors	Uno o più descrittori di elementi che identificano un widget dell'interfaccia utente sullo schermo. Viene utilizzato in combinazione con le condizioni element_present, element_disabled e element_checked. Si escludono a vicenda con visionText. Per ulteriori informazioni, consulta Descrittori elemento.
visionText	Il testo sullo schermo viene rilevato utilizzando l'API di riconoscimento ottico dei caratteri (OCR). visionText viene utilizzato in combinazione con la condizione element_present. Si escludono a vicenda con elementDescriptors.
nonRoboscriptActionCount	Il numero di azioni consecutive dello script non Robo eseguite in precedenza. Viene utilizzato in combinazione con la condizione non_roboscript_action_performed per attivare uno script Robo dopo ogni nonRoboscriptActionCount azione Robo. Il valore predefinito è 1.

Di seguito è riportato un esempio di script Robo che viene attivato da un widget UI con un ID risorsa "my.app.package:id/page_header" sullo schermo:

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

Di seguito è riportato un esempio di script Robo attivato da"Privacy Policy" rilevato dal riconoscimento ottico dei caratteri (OCR):

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

Di seguito è riportato un esempio di script Robo che attende 5 secondi dopo ogni azione Robo non basata su script:

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

Azioni

Ogni azione in uno script Robo è rappresentata come un bundle di una o più coppie attributo-valore, descritte nella tabella seguente:

Attributo	Descrizione
eventType	Specifica il tipo di azione, ad esempio clic, modifica di testo e così via. Obbligatorio per ogni azione.
elementDescriptors	Descrittori che identificano un widget dell'interfaccia utente. Obbligatorio per tutte le azioni che hanno un widget dell'interfaccia utente di destinazione, ad esempio fare clic su un determinato pulsante.
optional	Se impostato su true, questa azione viene saltata quando non può essere eseguita. Ad esempio, questa azione viene ignorata quando non riesce a trovare il proprio widget dell'interfaccia utente di destinazione su una schermata, senza che lo script robo contenente abbia riscontrato errori. Per impostazione predefinita, il valore è false.
replacementText	Il testo da inserire nel widget dell'interfaccia utente di destinazione. Obbligatorio per le azioni di modifica del testo.
swipeDirection	Specifica la direzione dello scorrimento. Obbligatorio per le azioni di scorrimento.
delayTime	Specifica il tempo di attesa in millisecondi. Obbligatorio per le azioni di attesa.
pointTapXCoordinate e pointTapYCoordinate	Le coordinate dei pixel X e Y del punto toccato. Si escludono a vicenda con pointTapXPercent e pointTapYPercent. Obbligatorio per le azioni di tocco del punto.
pointTapXPercent e pointTapYPercent	Le coordinate X e Y percentuali del punto toccato. Si escludono mutuamente con pointTapXCoordinate e pointTapYCoordinate. Obbligatorio per le azioni di tocco dei punti.

Di seguito è riportato un esempio di script Robo con due azioni senza widget UI di destinazione, il che significa che queste azioni non agiscono su un widget UI specifico:

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

Descrittori di elementi

Un descrittore elemento identifica un widget dell'interfaccia utente utilizzando uno o più dei seguenti attributi di identificazione:

Attributo	Descrizione
className	–
ancestorClassName	Nome della classe dell'antenato della gerarchia dell'interfaccia utente dell'elemento. Un antenato è uno qualsiasi dei nodi principali nella gerarchia dell'interfaccia utente dell'elemento, incluso l'elemento stesso.
resourceId	–
resourceIdRegex	Espressione regolare Java per trovare corrispondenze con resourceId.
contentDescription	–
contentDescriptionRegex	Espressione regolare Java per trovare una corrispondenza con contentDescription.
text (che viene visualizzato sullo schermo)	–
textRegex	Espressione regolare Java per trovare corrispondenze con text.
groupViewChildPosition, recyclerViewChildPosition o adapterViewChildPosition	Rappresenta la posizione secondaria di un widget dell'interfaccia utente a seconda del tipo di widget principale.

Spesso questi attributi non sono definiti, ad esempio un pulsante potrebbe non avere testo e descrizione dei contenuti. Anche se sono presenti alcuni valori degli attributi, potrebbero non essere univoci in una determinata schermata dell'app (incluso resourceId).

Ad esempio, è generalmente possibile distinguere gli elementi di un elenco solo utilizzando le diverse posizioni secondarie all'interno del widget principale. Ciò significa che solitamente non è sufficiente utilizzare un solo descrittore elemento per identificare un widget dell'interfaccia utente. Pertanto, l'attributo elementDescriptors di un'azione contiene una sequenza di descrittori di elementi ordinati in modo che il primo corrisponda al widget dell'interfaccia utente di destinazione, il secondo al widget principale del widget dell'interfaccia utente di destinazione e così via. Il widget dell'interfaccia utente di destinazione di un'azione viene associato quando tutti i relativi descrittori elemento corrispondono alla corrispondente sub-gerarchia del widget dell'interfaccia utente.

Di seguito è riportato un esempio di script Robo con una modifica del testo e un'azione di clic, che richiedono entrambi di identificare il widget dell'interfaccia utente di destinazione tramite i descrittori degli elementi forniti:

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

Opzioni di esecuzione

Se vuoi, puoi anteporre all'elenco di azioni in uno script Robo un oggetto JSON che specifica le opzioni di esecuzione dello script. Questa intestazione di configurazione inizia con la parola chiave roboscript seguita da una rappresentazione JSON delle opzioni di esecuzione desiderate.

Gli script Robo supportano le seguenti opzioni di esecuzione:

• executionMode: le opzioni di esecuzione applicate quando è in esecuzione uno script Robo:
  • strict: se impostato su true, lo script Robo non utilizza la corrispondenza parziale, il salto dell'azione corrente e la sospensione. In altre parole, lo script Robo viene eseguito come un normale test di strumentazione e non va a buon fine non appena non è possibile eseguire una delle sue azioni. Per impostazione predefinita, è false.
  • dismiss_popups: se impostato su true, il test Robo ignora eventuali dialoghi imprevisti durante l'esecuzione dello script Robo anche in modalità strict. Questa opzione non ha effetto se non è attiva la modalità strict. Il valore predefinito è false.
  • notify: se impostato su false, lo script Robo non mostra notifiche sullo schermo all'inizio e alla fine dell'esecuzione. Per impostazione predefinita, è true.
• postscript - opzioni di esecuzione applicate al termine di uno script Robo:
  • terminate: se impostato su true, il test Robo interrompe la scansione al termine dello script Robo. Il valore predefinito è false.

Di seguito è riportato un esempio di script Robo eseguito in modalità strict senza notifiche sullo schermo che rimane in modalità di sospensione per tre secondi, dopodiché la scansione si interrompe:

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

Parametri del modello

Un parametro di modello è un segnaposto in uno script Robo che viene sostituito con il valore effettivo quando il test Robo carica lo script Robo per l'esecuzione. I parametri del modello sono preceduti da un doppio trattino basso seguito da un segno di percentuale e sono seguiti da un segno di percentuale seguito da un doppio trattino basso.

Gli script robo supportano il seguente parametro del modello:

• __%APP_PACKAGE_NAME%__: il nome del pacchetto dell'app in test.

Di seguito è riportato un esempio di script Robo che interrompe il processo dell'app in test:

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

Commenti

Uno script Robo può contenere righe di commento, ovvero righe che iniziano con # o //.

Di seguito è riportato un esempio di script Robo con un paio di commenti:

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

Funzionalità

Per impostazione predefinita, lo script Robo rimane attivo finché non sono state completate (o almeno tentate) tutte le azioni di uno script Robo. Il test Robo continua a cercare di trovare una corrispondenza con un'azione dello script Robo ogni volta che sceglie un'azione da eseguire. Lo script Robo impiega le seguenti tecniche per aumentare la robustezza:

Tecnica	Descrizione
Corrispondenza parziale	Se non è possibile trovare una corrispondenza completa per l'azione dello script Robo corrente, i criteri di corrispondenza vengono allentati e la corrispondenza viene riprovata. La corrispondenza parziale non considera il descrittore dell'elemento più esterno quando corrisponde al widget UI di destinazione di un'azione di script Robo. Se la corrispondenza parziale riesce, l'azione dello script Robo corrispondente viene eseguita come di consueto. Questa tecnica supporta gli scenari in cui la struttura dell'app cambia, ad esempio tra le versioni dell'app, quando gli elementi della schermata vengono riorganizzati.
Ignora l'azione corrente	Se non è possibile trovare una corrispondenza completa o parziale per l'azione dello script Robo corrente, Robo tenta di trovare una corrispondenza per l'azione dello script Robo successiva. Se l'azione successiva corrisponde completamente o parzialmente, il test Robo salta (e non torna mai) l'azione dello script Robo corrente ed esegue quella successiva. Questa tecnica supporta gli scenari in cui il comportamento dell'app cambia tra le versioni o è inaffidabile, ad esempio quando una finestra di dialogo intermittente potrebbe apparire su schermate diverse durante la registrazione rispetto alla riproduzione di uno script di Robo.
Sospendi	Se non è possibile trovare una corrispondenza completa o parziale per le azioni dello script Robo corrente o successive, lo script Robo viene sospeso temporaneamente e il test Robo sceglie un'azione da eseguire utilizzando le altre strategie. Al termine di questa azione, il test Robo riprende l'esecuzione dello script Robo. Finché non è possibile associare le azioni dello script Robo correnti o successive, lo script Robo rimane sospeso per un numero qualsiasi di azioni. Pertanto, gli script Robo non devono necessariamente essere un prologo per un test Robo e puoi alternare le azioni degli script Robo con quelle dei test Robo standard. Questa tecnica supporta gli scenari in cui il comportamento dell'app è incostante o quando le modifiche tra le versioni dell'app sono sufficientemente grandi da richiedere al test Robo di "colmare le lacune" con le sue azioni standard.

Priorità

Se uno script Robo raggiunge il proprio maxNumberOfRuns, non può più essere attivato in una determinata scansione. Se più script Robo possono essere attivati dal contesto corrente, la priorità viene assegnata scegliendo, nell'ordine che segue, lo script Robo che:

1. Ha un attributo contextDescriptor.
2. Ha il valore priority più alto (per impostazione predefinita, tutti gli script Robo hanno lo stesso valore priority di esecuzione di 1).
3. Viene visualizzato per primo nell'elenco degli script Robo, se le priorità degli script Robo sono uguali.

Di seguito è riportato un esempio di file con tre script Robo che eseguono la stessa azione e vengono attivati dalla stessa condizione. L'app sotto il test è in primo piano:

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

Quando l'app in test è in primo piano, Robo attiva quanto segue, in ordine:

1. "Robo script 2" perché ha la priorità più alta.
2. "Robo script 1" perché viene visualizzato prima tra gli script Robo rimanenti applicabili con la stessa priorità.
3. "Robo script 3" come ultimo script Robo applicabile.

Esecuzioni ripetute

Per impostazione predefinita, Robo attiva uno script Robo al massimo una volta durante una scansione. Questo può essere modificato tramite l'attributo maxNumberOfRuns.

Di seguito è riportato un esempio di script Robo che porta app-under-test in background per un massimo di 10 volte:

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

Fase di scansione

Gli script Robo sono applicabili in diverse fasi di una determinata scansione Robo:

Fase di scansione	Descrizione
pre_crawl	Prima che Robo venga lanciato e inizi la scansione dell'app in test.
post_crawl	Dopo che Robo ha completato la scansione dell'app in test. Uno script robopost_crawl non deve superare i 15 secondi di durata, altrimenti la scansione potrebbe terminare con un timeout.
crawl	La fase di scansione principale, quando Robo esegue la scansione dell'app in test.
close_screen	Quando Robo prova a tornare indietro (backtrack) da una determinata schermata, quando vengono esplorate tutte le azioni possibili in questa schermata. Per impostazione predefinita, Robo preme Indietro, il che non è auspicabile in alcuni scenari.

Se l'attributo crawlStage di uno script Robo non viene specificato, si presume che sia crawl.

Di seguito è riportato un esempio di script Robo che cancella i dati dell'utente dell'app in test prima che Robo inizi a eseguirne la scansione:

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

Di seguito è riportato un esempio di script Robo che indica a Robo di fare clic su "Cancel" ogni volta che tenta di tornare indietro (eseguire un "backtrack") da una finestra di dialogo di conferma:

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

Azioni condizionali

Uno script Robo può contenere azioni condizionali. Le azioni condizionali hanno tre attributi aggiuntivi che descrivono come vengono eseguite da Robo:

Attributo	Descrizione
priority	La priorità di questa azione condizionale rispetto ad altre azioni condizionali all'interno dello script Robo contenente. Per impostazione predefinita, tutte le azioni conditional hanno una priorità pari a 1.
maxNumberOfRuns	Il numero di volte in cui questa azione condizionale può essere eseguita durante un'esecuzione dello script Robo contenente. Per impostazione predefinita, tutte le azioni condizionali possono essere eseguite al massimo una volta in un'unica esecuzione dello script Robo contenitore.
contextDescriptor	Il contesto/la condizione che attiva questa azione condizionale. Ha la stessa struttura e offre funzionalità simili a quelle di contextDescriptor dello script Robo.

Quando viene attivato, uno script Robo esegue le azioni non condizionali una alla volta in ordine di apparizione. Se uno script Robo contiene azioni condizionali, queste vengono prese in considerazione ogni volta prima di scegliere un'azione non condizionale da eseguire. Se viene attivata e selezionata un'azione condizionale in base alla sua priorità e al numero rimanente di esecuzioni, lo script Robo esegue questa azione condizionale. In caso contrario, lo script Robo esegue la seguente azione non condizionale. Per essere valido, uno script Robo deve contenere almeno un'azione non condizionale.

Di seguito è riportato un esempio di script Robo incondizionato con un'azione condizionale che chiude le finestre di dialogo popup se vengono visualizzate in qualsiasi momento durante l'esecuzione dello script Robo:

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

Azioni ignorate

Uno script Robo può contenere istruzioni per consentire a Robo di ignorare determinati widget UI o tutti i widget UI su una determinata schermata. Queste istruzioni sono rappresentate come ignorando le "azioni" con eventType ELEMENT_IGNORED e ALL_ELEMENTS_IGNORED rispettivamente.

Ogni volta che l'attributo contextDescriptor di uno script Robo contenente azioni di ignoramento corrisponde a una determinata schermata, Robo non interagisce con i widget dell'interfaccia utente scelti come target dalle sue azioni di ignoramento (a meno che un'altra azione dello script Robo non indichi a Robo di eseguire un'azione su uno dei widget dell'interfaccia utente ignorati).

Uno script Robo può contenere una combinazione di azioni di ignoramento, condizionali e non condizionali. A differenza di altre azioni dello script Robo, le azioni di ignoramento vengono applicate purché il valore contextDescriptor dello script Robo contenente corrisponda a una schermata durante una scansione di Robo, indipendentemente dai valori degli attributi priority e maxNumberOfRuns.

Di seguito è riportato un esempio di file con due script Robo. Il primo script Robo fa in modo che Robo ignori tutti i widget dell'interfaccia utente in una schermata contenente un widget dell'interfaccia utente con un ID risorsa "my.app.package:id/ignored_screen". Il secondo script Robo consente a Robo di ignorare i widget UI i cui ID risorsa corrispondono all'espressione regolare Java ".*:id/done" su una schermata contenente un widget UI con un ID risorsa "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"
          }
        ]
      }
    ]
  }
]

Supporto di RecyclerView e AdapterView

Gli elementi secondari dei widget RecyclerView e AdapterView vengono caricati dinamicamente e potrebbero essere visualizzati a molti scorrimenti di distanza dalla schermata corrente. Poiché le dimensioni di un display e il numero di scorrimenti necessari per accedere a questo elemento sono diversi per i vari fattori di forma dei dispositivi, è molto più affidabile fare affidamento sulla posizione dei dati dell'elemento, che è assoluta. Si tratta di un approccio meno affidabile che si basa sul numero di scorrimenti necessari per visualizzare l'elemento e poi utilizza la sua posizione sullo schermo.

Pertanto, lo script Robo acquisisce le posizioni assolute dei dati dei figli di RecyclerView che sono i target delle azioni dello script Robo come recyclerViewChildPosition. Lo script Robo acquisisce anche le posizioni absolute dei dati degli elementi AdapterView secondari che sono target delle azioni dello script Robo come adapterViewChildPosition.

Le azioni sugli elementi secondari di RecyclerView e AdapterView vengono eseguite nei seguenti passaggi:

1. Il test Robo assicura che l'elemento secondario corrispondente venga visualizzato sullo schermo tramite un'azione di posizionamento sul relativo RecyclerView o AdapterView.

2. Il test Robo esegue l'azione registrata direttamente sull'elemento secondario, poiché è già visualizzato sullo schermo.

Di seguito è riportato un esempio di azione di clic su un elemento AdapterView (android.widget.GridView) secondario:

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

Di seguito è riportato un esempio di azione di clic su un elemento figlio 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
    }
  ]
}

Registra uno script Robo in Android Studio ed eseguilo in Test Lab

Puoi creare uno script Robo in Android Studio, che viene salvato come file JSON. Puoi quindi caricare il file JSON su Firebase Test Lab con l'applicazione ed eseguire il test di conseguenza.

Quando esegui un test Robo con uno script allegato, il test Robo esegue prima le azioni predefinite e poi esplora l'app come al solito.

Per creare un file JSON dello script Robo in Android Studio, segui i passaggi descritti in Registrare uno script Robo utilizzando Test Lab in Android Studio.

Azioni dello script Robo

Il seguente attributo facoltativo comune si applica a tutte le azioni:

• description: consente di monitorare l'esecuzione di questa azione dello script Robo negli output del test Robo.

affermazione

Se la condizione asserta è vera, lo script Robo passa all'azione successiva, che potrebbe essere un'altra asserzione. Altrimenti, l'esecuzione dello script Robo viene interrotta a causa di un'asserzione non riuscita.

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "ASSERTION"	--
contextDescriptor	Descrive il contesto o la condizione affermati. Ha la stessa struttura e offre funzionalità simili al contextDescriptor dello script Robo.

Di seguito è riportato un esempio di asserzione dello script Robo che verifica che l'app in test sia in primo piano:

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

Di seguito è riportato un esempio di asserzione di script Robo che verifica che su uno schermo sia presente un widget UI con ID risorsa "com.google.samples.apps.topeka:id/done":

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

Di seguito è riportato un esempio di asserzione dello script Robo che verifica che "Settings" NON venga rilevato su uno schermo utilizzando l'OCR:

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

Fai clic su

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
eventType	Specifica il tipo di azione dello script Robo.
"eventType": "VIEW_CLICKED"	Fai clic sull'elemento target dell'app in test.
"eventType": "SOFT_KEYBOARD_CLICK"	Consente di fare clic sull'elemento target della tastiera virtuale.
"eventType": "SOFT_KEYBOARD_RANDOM_CLICK"	Fa clic su elementi casuali della tastiera virtuale fino a maxNumberOfRuns volte.
"eventType": "LIST_ITEM_CLICKED"	Utilizzato dal registratore di script Robo in Android Studio per fare clic sugli elementi dell'elenco.
elementDescriptors	Identifica il widget dell'interfaccia utente su cui è stato fatto clic utilizzando la gerarchia dell'interfaccia utente di Android. Si escludono a vicenda con visionText.
visionText	Identifica l'elemento su cui è stato fatto clic utilizzando l'OCR. Si escludono a vicenda con elementDescriptors.
matchIndex	Specifica l'indice dell'occorrenza dell'elemento target corrispondente, quando l'elemento target è identificato utilizzando visionText. Se è 0, l'azione dello script Robo sceglie il primo elemento corrispondente, se è 1, l'azione dello script Robo sceglie il secondo elemento corrispondente e così via. L'ordinamento viene determinato da sinistra a destra e dall'alto verso il basso. Il valore predefinito è 0 (viene scelta la prima corrispondenza).
maxNumberOfRuns	Specifica quante volte fare clic su un elemento casuale della tastiera virtuale, quando eventType è SOFT_KEYBOARD_RANDOM_CLICK. Il valore predefinito è 1.

Di seguito è riportato un esempio di azione di script Robo che fa clic su un pulsante con l'ID risorsa "com.google.samples.apps.topeka:id/done":

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

Di seguito è riportato un esempio di azione dello script Robo che fa clic sulla seconda occorrenza della parola "Search" rilevata su una schermata utilizzando l'OCR:

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

Di seguito è riportato un esempio di azione dello script Robo che fa clic su un elemento della tastiera soft con descrizione dei contenuti "Emoji button":

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

Di seguito è riportato un esempio di azione di script Robo che fa clic su elementi della tastiera virtuale casuali fino a cinque volte:

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

Disattivare la tastiera virtuale

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "DISABLE_KEYBOARD"	--

Di seguito è riportato un esempio di azione dello script Robo che disattiva la tastiera virtuale:

{
  "eventType": "DISABLE_KEYBOARD"
}

Esegui comando shell adb

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "ADB_SHELL_COMMAND"	--
command	Il comando shell Android Debug Bridge (adb) da eseguire.

Il seguente attributo è facoltativo:

• expectedOutputRegex: l'output previsto del comando come espressione regolare Java. Se l'output non corrisponde, l'azione dello script Robo non va a buon fine. Per impostazione predefinita, si tratta di una stringa vuota, il che significa che l'output non è controllato.

Di seguito è riportato un esempio di azione dello script Robo che cancella i dati utente dell'app in test:

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

Concedi le autorizzazioni

Questa azione viene registrata dallo script recorder Robo in Android Studio per la compatibilità con le versioni precedenti di Espresso Test Recorder. Il test Robo concede tutte le autorizzazioni all'app in test all'inizio di ogni scansione, pertanto questa azione è un'operazione senza effetti. NON utilizzare questa azione negli script Robo.

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "PERMISSIONS_REQUEST"	--

Ignorare tutti gli elementi di una schermata

Con questa azione, Robo ignora tutti gli elementi su qualsiasi schermata che attiva lo script Robo contenente.

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "ALL_ELEMENTS_IGNORED"	--

Di seguito è riportato un esempio di azione dello script Robo che consente a Robo di ignorare tutti gli elementi di una schermata:

{
  "eventType": "ALL_ELEMENTS_IGNORED"
}

Ignorare un elemento

Con questa azione, Robo ignora uno o più elementi che corrispondono al valore elementDescriptors specificato.

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "ELEMENT_IGNORED"	--
elementDescriptors	Identifica i widget dell'interfaccia utente ignorati utilizzando la gerarchia dell'interfaccia utente di Android.

Il seguente attributo è facoltativo:

• ignoreChildren: se impostato su true, Robo ignora anche tutti i discendenti dei widget UI ignorati. Il valore predefinito è false.

Di seguito è riportato un esempio di azione dello script Robo che fa in modo che Robo ignori tutti gli elementi le cui descrizioni dei contenuti iniziano con "Avatar":

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

Testo di input

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
eventType	Specifica il tipo di azione dello script Robo.
"eventType": "VIEW_TEXT_CHANGED"	Inserisce il testo specificato nel widget dell'interfaccia utente di destinazione.
"eventType": "ENTER_TEXT"	inserisce il testo specificato nel widget dell'interfaccia utente di destinazione e invia un evento KEYCODE_ENTER a questo widget UI.
elementDescriptors	Identifica il widget dell'interfaccia utente di destinazione utilizzando la gerarchia dell'interfaccia utente di Android.
replacementText	Il testo da inserire nel widget dell'interfaccia utente di destinazione.

Di seguito è riportato un esempio di azione di script Robo che inserisce "John" in un widget UI con l'ID risorsa "com.google.samples.apps.topeka:id/first_name":

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

Clic lungo

Nella tabella seguente sono elencati gli attributi obbligatori:

Attributo	Descrizione
"eventType": "VIEW_LONG_CLICKED"	--
elementDescriptors	Identifica il widget dell'interfaccia utente di destinazione utilizzando la gerarchia dell'interfaccia utente di Android. Si escludono a vicenda con visionText.
visionText	Identifica l'elemento su cui è stato fatto clic a lungo utilizzando l'OCR. Si escludono a vicenda con elementDescriptors.
matchIndex	Specifica l'indice dell'occorrenza dell'elemento target corrispondente quando l'elemento target viene identificato utilizzando visionText. Se è 0, l'azione dello script Robo seleziona il primo elemento corrispondente, se è 1, seleziona il secondo elemento corrispondente e così via. L'ordinamento viene determinato da sinistra a destra e dall'alto verso il basso. Il valore predefinito è 0 (viene scelta la prima corrispondenza).

Il seguente attributo è facoltativo:

• delayTime: specifica la durata della pressione di un clic prolungato in millisecondi.

Di seguito è riportato un esempio di azione dello script Robo che esegue un clic di cinque secondi su un widget dell'interfaccia utente con descrizione dei contenuti "Avatar 8":

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

Esegui un gesto con un punto

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "ONE_POINT_GESTURE"	--
coordinates	Due coordinate per un gesto a un punto, formattate come "(x1,y1)->(x2,y2)" in percentuale o in pixel.

Il seguente attributo è facoltativo:

• dragAndDrop: se impostato su true, il gesto a un punto esegue un'azione di trascinamento. Il valore predefinito è false.

Di seguito è riportato un esempio di azione di gesto con un punto dello script Robo che consente di eseguire uno scorrimento verso il basso:

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

Eseguire un gesto con due punti

Nella tabella seguente sono elencati gli attributi obbligatori:

Attributo	Descrizione
"eventType": "TWO_POINT_GESTURE"	--
coordinates	Quattro coordinate per un gesto a due punti, formattate come "(x1,y1)->(x2,y2),(x3,y3)->(x4,y4)" in percentuale o in pixel.

Di seguito è riportato un esempio di azione dello script Robo che esegue un gesto di pinching out:

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

Eseguire un'azione IME

Questa azione preme il pulsante di azione corrente, ad esempio Avanti, Fine e Ricerca, nell'editor di metodi di immissione (IME) per il widget dell'interfaccia utente di destinazione specificato.

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "PRESSED_EDITOR_ACTION"	--
elementDescriptors	Identifica il widget UI di destinazione utilizzando la gerarchia della UI Android.

Di seguito è riportato un esempio di azione dello script Robo che esegue un'azione IME su un widget dell'interfaccia utente con l'ID risorsa "com.google.samples.apps.topeka:id/first_name":

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

Premi Indietro

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
eventType	Specifica il tipo di azione dello script Robo.
"eventType": "PRESSED_BACK"	Invia un evento KEYCODE_BACK al dispositivo.
"eventType": "PRESSED_BACK_EMULATOR_28"	Utilizzato dal registratore di script Robo in Android Studio per premere Indietro sugli emulatori API 28.

Di seguito è riportato un esempio di azione dello script Robo che preme Indietro:

{
  "eventType": "PRESSED_BACK"
}

Premi Home

Questa azione invia un evento KEYCODE_HOME al dispositivo.

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "GO_HOME"	--

Di seguito è riportato un esempio di azione dello script Robo che preme il tasto Home:

{
  "eventType": "GO_HOME"
}

Scorri un elemento finché non diventa visibile

Questa azione fa scorrere in avanti il widget dell'interfaccia utente corrispondente al elementDescriptors specificato finché il widget dell'interfaccia utente corrispondente al elementDescriptors specificato non è presente sullo schermo, finché non è possibile scorrere più il widget o non viene raggiunto il numero massimo di 50 scorrimenti.childElementDescriptors

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "ELEMENT_SCROLL_INTO_VIEW"	--
elementDescriptors	Identifica il widget dell'interfaccia utente scorrevole utilizzando la gerarchia dell'interfaccia utente di Android.
childElementDescriptors	Identifica il widget dell'interfaccia utente fino al quale scorrere utilizzando la gerarchia dell'interfaccia utente di Android.

Di seguito è riportato un esempio di azione dello script di Robo che scorre il widget UI con l'ID risorsa "my.app.package:id/scrollable_card_container" finché il widget UI con il testo "Orange" non è presente sullo schermo (o non è possibile eseguire altri scorrimenti o viene raggiunto il numero massimo di 50 scorrimenti):

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

Sfioramento

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "VIEW_SWIPED"	--
swipeDirection	Specifica la direzione dello scorrimento: Left Right Up Down Forward: Down o Right a seconda della scorrevolezza verticale o orizzontale del widget dell'interfaccia utente di destinazione. Backward: Up o Left a seconda della scorrevolezza verticale o orizzontale del widget UI di destinazione.
elementDescriptors	Identifica il widget dell'interfaccia utente di destinazione utilizzando la gerarchia dell'interfaccia utente di Android.

Di seguito è riportato un esempio di azione dello script Robo che scorre verso l'alto un widget UI con l'ID risorsa "my.app.package:id/custom_content":

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

Acquisisci screenshot

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "TAKE_SCREENSHOT"	--
screenshotName	Specifica il nome del file dello screenshot.

Di seguito è riportato un esempio di azione dello script Robo che acquisisce uno screenshot:

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

Tocca un punto sullo schermo

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "POINT_TAP"	--
pointTapXCoordinate	La coordinata X in pixel del punto toccato. Si escludono a vicenda con pointTapXPercent e pointTapYPercent.
pointTapYCoordinate	La coordinata Y in pixel del punto toccato. Si escludono a vicenda con pointTapXPercent e pointTapYPercent.
pointTapXPercent	La coordinata X percentuale del punto toccato. Si escludono a vicenda con pointTapXCoordinate e pointTapYCoordinate.
pointTapYPercent	La coordinata Y percentuale del punto toccato. Si escludono a vicenda con pointTapXCoordinate e pointTapYCoordinate.

Di seguito è riportato un esempio di azione dello script Robo che esegue un tocco al centro di una schermata:

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

Tocca un punto all'interno di un elemento

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "POINT_TAP_ELEMENT"	--
pointTapXPercent	La coordinata X percentuale all'interno dell'elemento target.
pointTapYPercent	La coordinata Y percentuale all'interno dell'elemento target.
elementDescriptors	Identifica il widget UI di destinazione utilizzando la gerarchia della UI Android.

Di seguito è riportato un esempio di azione dello script Robo che sposta il cursore di una barra di scorrimento verso destra:

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

Interrompi la scansione

Questa azione interrompe il test Robo.

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "TERMINATE_CRAWL"	--

Di seguito è riportato un esempio di azione dello script Robo che interrompe un test Robo:

{
  "eventType": "TERMINATE_CRAWL"
}

Attendi

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "DELAYED_MESSAGE_POSTED"	--
delayTime	Specifica il tempo di attesa in millisecondi.

Di seguito è riportato un esempio di azione dello script Robo che attende tre secondi:

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

Attendi un elemento

Questa azione fa in modo che il test Robo attenda che un elemento venga visualizzato sullo schermo fino al timeout specificato.

La tabella seguente elenca gli attributi obbligatori:

Attributo	Descrizione
"eventType": "WAIT_FOR_ELEMENT"	--
delayTime	Specifica il timeout di attesa in millisecondi.
elementDescriptors	Identifica il widget dell'interfaccia utente a cui è stato aspettato utilizzando la gerarchia dell'interfaccia utente di Android.

Di seguito è riportato un esempio di azione dello script Robo che attende fino a 30 secondi per la visualizzazione sullo schermo di un widget UI con l'ID risorsa "my.app.package:id/confirmation_button":

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

Passaggi successivi

• Scopri come eseguire uno script Robo.