applicationStart

applicationStart,[PACKAGE]

Starts an application from its package name.

compatibility : universal

applicationToForeground

applicationToForeground,[PACKAGE]

Sets an already launched application to foreground from its package name.

compatibility : universal

applicationKill

applicationKill,[PACKAGE]

Forces an application to stop from its package name.

compatibility : universal

applicationClearData

applicationClearData,[PACKAGE]

Clears the cache of an application from its package name.

compatibility : universal

installApp

installApp,[PACKAGE]

Installs the application from its package name.

uninstallApp

uninstallApp,[PACKAGE]

Uninstalls the application from its package name.

compatibility : universal

applicationCloseAll

Clears every recent application.

assertNotExistsText

assertNotExistsText,[TEXT]

Checks if the element which text or content-desc contains the text selector doesn't exist.

case-sensitive compatibility : universal

assertNotExistsTextExact

assertNotExistsTextExact,[EXACT-TEXT]

Checks if the element which text or content-desc is the exact given selector doesn't exist.

CASE-SENSITIVE compatibility : universal

assertNotExistsId

assertNotExistsId,[ID]

Checks if the element with the id selector doesn't exist.

compatibility : universal

assertNotExistsClass

assertNotExistsClass,[CLASS]

Checks if the element with the class selector doesn't exist.

compatibility : universal

setBrowser

setBrowser,chrome setBrowser,firefox

Sets the browser to use.

launchBrowser

Launches the current set browser. If not set, launches default browser Chrome.

browserClearCache

Clears the cache of the current set browser.

browserNewTab

Opens a new tab on the current set browser.

browserGoToUrl

browserGoToUrl,https://greenspector.com/

Browses the given url on the current set browser.

browserCloseAllTabs

Closes every opened tabs on the current set browser.

browserReset

Browser reset clear cache and user data and prepare the browser for the test.

waitUntilPageLoaded

waitUntilPageLoaded,[DURATION]

Waits until the current web page is loaded.

compatibility : universal

browserPrepareAndOpen

Prepares browser for measurement: (clear cache, close all tabs, close browser and reopen it)

browserCloseAllTabsAndOpen

Closes all browser tabs and open a new tab. (Browser will be closed during process)

browserPrepareAndOpenForReference

Prepares browser for measurement. Clear cache, close all tabs, close browser and reopen it, go to a black page and wait 60s.

changeDefaultSearchEngine

changeDefaultSearchEngine,Google

changeDefaultSearchEngine,Ecosia

Changes browser default search engine (Not supported on Firefox)

enableDisplaySiteAsDesktop

Enables display site as desktop. The browser and website need to be already opened.

disableDisplaySiteAsDesktop

Disables display site as desktop. The browser and website need to be already opened.

longClickById

longClickById

longClickById,[DURATION]

Performs a long click for the given duration on the element which contains the given id selector.

default : 1000 optional duration compatibility : universal

longClickByText

longClickByText,[TEXT]

longClickByText,[TEXT],[DURATION]

Performs a long click for the given duration on the element which contains the given text selector.

default : 1000 optional duration compatibility : universal

longClickByXY

longClickByXY,[X-POS],[Y-POS]

Performs a long click of the given duration on the given coordinate.

default : 1000 compatibility : universal

clickByText

clickByText,[TEXT]

Clicks on the element which contains the given text selector.

CASE-SENSITIVE compatibility : universal

clickByTextExact

clickByTextExact,[TEXT]

Clicks on the element which contains the exact given text selector.

CASE-SENSITIVE compatibility : universal

clickByClass

clickByClass,[CLASS]

Clicks on the element with the given class selector.

compatibility : universal

clickByXY

clickByXY,[X-Pos],[Y-Pos]

Clicks on the element located at the given coordinates.

compatibility : universal

clickByPercent

clickByPercent,[X-Perc],[Y-Perc]

Clicks on the element located at the coordinates calculated from the given percentages of the device screen.

compatibility : universal

clickById

clickById,[ID]

Clicks on the element which contains the given identification.

compatibility : universal

clickOnLastElementFound

Clicks on the last element found by previous GDSL command in group Find like findByText or findByTextExact.

compatibility : universal

clickByTextForced

clickByTextForced,[TEXT]

Clicks on the element which contains the given text if exists

compatibility : universal

pressHome

Presses the home button.

compatibility : universal

pause

pause,[DURATION]

Waits the amount of time in millisecond passed as argument.

compatibility : universal

pressEnter

Presses the enter button.

compatibility : universal

pressPower

Presses the power button.

compatibility : universal

pressBack

Presses the back button.

compatibility : universal

pressRecentApps

Presses the recent app button.

compatibility : universal

pressTab

Presses the TAB key. You can navigate to the next element in the view that can get focus. Useful for form.

compatibility : universal

pressMajTab

Presses the MAJ + TAB key. You can navigate to the previous element in the view that can get focus. Useful for form.

compatibility : universal

setVolume

setVolume,min setVolume,mid setVolume,max

Sets the volume of every stream of the device to the given value.

pressKeyCode

pressKeyCode,[KEYCODE]

pressKeyCode,KEYCODE_H or pressKeyCode,36: to press h

pressKeyCode,KEYCODE_H,META_SHIFT_LEFT_ON or pressKeyCode,36,64 : to press h in capital letter

Realize an action using a key code. Can use optional meta State when pressing.

List of keycode and meta state are here : https://developer.android.com/reference/android/view/KeyEvent.

compatibility : universal

openQuickSettings

Opens the quick settings.

compatibility : universal

enableHotspot

Enables the hotspot setting.

disableHotspot

Disables the hotspot setting.

enableSettings

enableSettings,[SETTING-NAME1]|[SETTING-NAME2]|[SETTING-NAME3]

Enables the first setting in the given setting name list.

disableSettings

disableSettings,[SETTING-NAME1]|[SETTING-NAME2]|[SETTING-NAME3]

Disables the first setting in the given setting name list.

dump

dump

dump,[NAME-FILE]

Takes a dump of the current state of the device. If set the dump will be stored in fileName.uix. If not set, the dump will be stored in dump.uix.

optional parameter compatibility : universal

emptyDownloadFolder

Empties the download folder of the device

goToDownloadFolder

Opens the file system and go to the download folder.

selectDownloadFolder

On a opened file system, goes to the download folder

findByText

findByText,[TEXT]

findByText,[TEXT],[RANK]

Finds the nth element which text or content-desc contains the given selector. The element is saved as the last element found.

CASE-SENSITIVE default rank : 1 optional rank compatibility : universal

findByTextExact

findByText,[EXACT-TEXT]

findByText,[EXACT-TEXT],[RANK]

Finds the nth element which text or content-desc is the exact given selector. The element is saved as the last element found.

CASE-SENSITIVE default rank : 1 optional rank compatibility : universal

findById

findById,[ID]

findById,[ID],[RANK]

Finds the nth element with the id selector. The element is saved as the last element found.

default rank : 1 optional rank compatibility : universal

findByClass

findById,[CLASS]

findById,[CLASS],[RANK]

Finds the nth element with the class selector. The element is saved as the last element found.

default rank : 1 optional rank compatibility : universal

findParentLastElementFound

Finds the parent of the last element found. The parent is saved and replaced the last element found.

compatibility : universal

findChildByClassLastElementFound

findChildByClassLastElementFound,[CLASS]

Finds the first child of the last element found using the given class as selector. The parent is saved and replaced the last element found.

compatibility : universal

findChildByIndexLastElementFound

findChildByIndexLastElementFound,[RANK]

Find by index a child of the last element found. The Index matches the index in the screen dump.

default rank : 0 optional rank compatibility : universal

formClickOnFirstEmptyEditText

Clicks on the first empty edit text.

compatibility : universal

formClickOnEditText

formClickOnEditText,[RANK]

Clicks on the nth edit text. 1 is the first element.

default rank : 1 optional rank compatibility : universal

formClickOnCheckbox

formClickOnCheckbox,[RANK]

Clicks on the nth checkbox. 1 is the first element.

default rank : 1 optional rank compatibility : universal

performIMEAction

Presses the blue button of the Gboard to perform the IME action highlighted (search, done, next, enter ...)

enableWifi

Enables the wifi on the device.

disableWifi

Disables the wifi on the device.

enableData

Enables the mobile data on the device.

disableData

Disables the mobile data on the device.

enableBluetooth

Enables the bluetooth on the device.

compatibility : universal

disableBluetooth

Disables the bluetooth on the device.

compatibility : universal

enableNFC

Enables the NFC on the device.

disableNFC

Disables the NFC on the device.

enableAirplaneMode

Enables airplane mode on the device.

disableAirplaneMode

Disables airplane mode on the device.

switchActiveNetworkToMode

switchActiveNetworkToMode,2G switchActiveNetworkToMode,3G switchActiveNetworkToMode,4G

Disables the wifi, activates the data and switches to the given network mode. (The network has to be active in less than 20s.)

switchNetworkMode

switchNetworkMode,2G switchNetworkMode,3G switchNetworkMode,4G

Switches the network mode to the given one.

authInitOTPManual

authInitOTPManual,[URL-JSON]

Inits OTP to use with manual actions. The command checks that the url point to a json file in the correct format {"value"=""}, the value must be an empty string. When your application or site uses OTP authentication, you can manually use a public JSON file to communicate the OTP code to GDSL.

compatibility : universal

authInitOTPMailsac

authInitOTPMailsac,[EMAIL-MAILSAC],[KEY]

authInitMailsacOTP,user@mailsac.com,myKey

Inits OTP to use with mailsac. This command uses mailsac email and api key to clear message in your inbox. After calling this command, you can log in on your app or website with the mailsac email.

compatibility : universal

authWaitAndStoreOTP

Waits for the OTP to become available and stores it in memory. The command tries to get the OTP which need to be an expression of 4-20 digits during a maximum of 10 minutes.

compatibility : universal

authEnterStoredOTP

Enters the stored OTP (previously stored in memory) in the current selected field by clicking on the keyboard keys for each character.

compatibility : universal

measureStart

measureStart,CHRGT_home

Starts a measure which can be identified by the given name.

compatibility : universal

measureStop

Stops the current measure.

compatibility : universal

setLandscapeOrientation

Sets device orientation to landscape.

compatibility : universal

setPortraitOrientation

Sets device orientation to portrait.

compatibility : universal

screenSetLuminosity

screenSetLuminosity,[VALUE]

Changes the screen brightness according to the given value. The new screen brightness value should be between 0 and 255. If out of bounds, the closest value in bounds is taken.

compatibility : universal

screenUnlock

Unlocks the screen. Works only if no unlock securities are presents.

compatibility : universal

screenTurnOnAndUnlock

Turns on the device and unlocks the screen if necessary.

screenTurnOnAndUnlockAndEnterPIN

screenTurnOnAndUnlockAndEnterPIN,[PIN]

Turns on the device, unlocks the screen and enter PIN

screenTurnOff

Turns off the device.

compatibility : universal

setWallpaper

setWallpaper,[IMAGE-PATH]

setWallpaper,/sdcard/Download/green.png

Sets the wallpaper with an image file.

clearWallpaper

Clears the wallpaper by putting the device factory wallpaper (android version >= 28 or P)

takeScreenshot

takeScreenshot,[FILE-NAME]

takeScreenshort,[FILE-NAME],true

takeScreenshort,[FILE-NAME],false

Takes a screenshot. The screenshot will be saved on the file with name fileName.png. When screenshot can't be taken, if true, the test continues ignoring the error, if false, the test stops and throws the error.

default boolean : false optional boolean compatibility : universal

scrollDownwardUntilEnd

Scrolls downward until the end of the screen (max : 20 scrolls)

compatibility : universal

scrollUpwardUntilBeginning

Scrolls upward until the beginning of the screen (max : 20 scrolls)

compatibility : universal

scrollLeftwardUntilEnd

Scrolls leftward until the end of the screen (max : 20 scrolls)

compatibility : universal

scrollRightwardUntilBeginning

Scrolls rightward until the beginning of the screen (max : 20 scrolls)

compatibility : universal

scrollDownward

Scrolls downward the screen (only one scroll).

compatibility : universal

scrollUpward

Scrolls upward the screen (only one scroll).

compatibility : universal

scrollLeftward

Scrolls leftward the screen (only one scroll).

compatibility : universal

scrollRightward

Scrolls rightward the screen (only one scroll).

compatibility : universal

scrollToText

scrollToText,[TEXT] = scrollToText,[TEXT],false (vertical)

scrollToText,[TEXT],true (horizontal)

Scrolls vertically or horizontally to find the exact text.

default boolean : false optional boolean compatibility : universal

swipeRightward

swipeRighward,[percY]

Swipes rightward the screen. The swipe gesture is from screen point A (X 90%, Y percY) to screen point B (X 10%, Y percY).

compatibility : universal

swipeLeftward

swipeLeftward,[percY]

Swipes leftward the screen. The swipe gesture is from screen point A (X 10%, Y percY) to screen point B (X 90%, Y percY).

compatibility : universal

swipeUpward

swipeUpward

swipeUpward,[percX],[percStartY]

Swipes upward the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y 90%).

default percx : 50 default percstarty : 10 optional perc compatibility : universal

swipeUpwardToText

swipeUpwardToText,[TEXT]

swipeUpwardToText,[TEXT],[ITERATIONS],[percX]

Swipes upward to find the first element which text or content-desc contains the given selector. The swipe gesture is from screen point A (X 50%, Y 10%) to screen point B (X 50%, Y 90%).

CASE-SENSITIVE default iterations : 10 (max 30) default percx: 50 optional iterations and percx compatibility : universal

swipeDownward

swipeDownward

swipeDownward,[percX],[percStartY]

Swipes downward the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y 10%).

default percx : 50 default percstarty : 90 optional perc compatibility : universal

swipeDownwardToText

swipeDownwardToText,[TEXT]

swipeDownwardToText,[TEXT],[ITERATION]

Swipes downward to find the first element which text or content-desc contains the given selector. The swipe gesture is from screen point A (X 50%, Y 90%) to screen point B (X 50%, Y 10%).

case-insensitive default iterations : 10 (max 30) compatibility : universal

swipeVertical

swipeVertical,[percStartY],[percEndY],[percX]

swipeVertical,[percStartY],[percEndY],[percX],[DURATION]

Swipes vertically the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y percEndY).

default duration : 500 optional duration compatibility : universal

swipeHorizontal

swipeHorizontal,[percStartX],[percEndX],[percY]

swipeHorizontal,[percStartX],[percEndX],[percY],[DURATION]

Swipes horizontally the screen. The swipe gesture is from screen point A (X percStartX, Y percY) to screen point B (X percEndX, Y percY).

default duration : 500 optional duration compatibility : universal

setTextByText

setTextByText,[TEXT],[TEXT-SELECTOR]

Pastes the given text into the element which contains the given text selector.

compatibility : universal

setTextByDesc

setTextByDesc,[TEXT],[DESC-SELECTOR]

Pastes the given text into the element which contains the given desc selector.

compatibility : universal

setTextByTextExact

setTextByText,[TEXT],[EXACT-TEXT-SELECTOR]

Pastes the given text into the element which has the given exact text selector.

compatibility : universal

setTextById

setTextById,[TEXT],[ID-SELECTOR]

Pastes the given text into the element which contains the given id selector.

compatibility : universal

enterText

enterText,[TEXT]

enterText,[TEXT],[FREQUENCY]

Enters the given text in the current selected field clicking on the keyboard keys for each character. Text is entered character by character at the given frequency

optional frequency compatibility : universal

setTextLastElementFound

setTextLastElementFound,[TEXT]

Pastes the given text in the last found element.

compatibility : universal

enterTextFast

enterTextFast,[TEXT]

Taps the text specified in parameter. Enter all text at once.

compatibility : universal

openSettingsMenuWithName

openSettingsMenuWithName,[MENU-NAME]

Opens the menu described by the given name in the device settings. The menu name may be distinct depending on the phone model or Android version, so you can try various names using "|".

"Preferred network|network mode" → if the "Preferred network" menu is not found, the command attempts to open the "Network mode" menu

setCompressedLayoutHierarchy

setCompressedLayoutHierarchy,true (enable compression)

setCompressedLayoutHierarchy,false (disable)

Enables or disables layout hierarchy compression. This general configuration for uiautomator can be called at any time during a GDSL test. If compression is enabled, the layout hierarchy derived from the Accessibility framework will only contain nodes that are important for uiautomator testing. Any unnecessary surrounding layout nodes that make viewing and searching the hierarchy inefficient are removed.

compatibility : universal

setWaitForIdle

setWaitForIdle,true (use the default uiautomator timeout)

setWaitForIdle,false (do not wait for idle state)

Sets the timeout for waiting for the user interface to go into an idle state before starting a uiautomator action. This general configuration for uiautomator can be called at any time during a GDSL test.

compatibility : universal

waitIdle

Waits for device idle. Only use in specific cases for web view refresh issues.

compatibility : universal

waitUntilText

waitUntilText,[TEXT]

waitUntilText,[TEXT],[TIMEOUT]

Waits for a view element with text specified, to become visible on the screen until a specified timeout. If it is not found, an error is thrown.

CASE-inSENSITIVE default timeout: 30000 optional timeout compatibility : universal

waitUntilDesc

waitUntilDesc,[DESC]

waitUntilDesc,[DESC],[TIMEOUT]

Waits for a view element with content-desc specified, to become visible on the screen until a specified timeout. If it is not found, an error is thrown.

CASE-inSENSITIVE default timeout: 30000 optional timeout compatibility : universal

waitUntilTextBeforeClick

• waitUntilTextBeforeClick,[TEXT] = waitUntilTextBeforeClick,[TEXT],false

Waits for a view element with text specified, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max.

default boolean : false optional boolean compatibility : universal

waitUntilDescBeforeClick

• waitUntilDescBeforeClick,[DESC] = waitUntilDescBeforeClick,[DESC],false

Waits for a view element with content-desc specified, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max.

default boolean : false optional boolean CASE-inSENSITIVE compatibility : universal

waitUntilTextExact

waitUntilTextExact,[EXACT-TEXT]

waitUntilTextExact,[EXACT-TEXT],[TIMEOUT]

Waits for a view element, with the exact text selected, to become visible on the screen until a specified timeout. If it is not found, an error is thrown.

CASE-SENSITIVE default timeout: 30000 optional timeout compatibility : universal

waitUntilTextExactBeforeClick

• waitUntilTextExactBeforeClick,[EXACT-TEXT] = waitUntilTextExactBeforeClick,[EXACT-TEXT],false

Waits for a view element, with the exact text selected, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max.

CASE-SENSITIVE default boolean : false optional boolean compatibility : universal

waitUntilDescExact

waitUntilDescExact,[EXACT-DESC]

waitUntilDescExact,[EXACT-DESC],[TIMEOUT]

Waits for a view element, with the exact content-desc selected, to become visible on the screen until a specified timeout. If it is not found, an error is thrown.

CASE-SENSITIVE default timeout: 30000 optional timeout compatibility : universal

waitUntilDescExactBeforeClick

• waitUntilDescExactBeforeClick,[EXACT-DESC] = waitUntilDescExactBeforeClick,[EXACT-DESC],false

Waits for a view element, with the exact content-desc selected, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max.

CASE-SENSITIVE default boolean : false optional boolean compatibility : universal

waitUntilId

waitUntilId,[ID]

waitUntilId,[ID],[TIMEOUT]

Waits for a view element, with the exact id selected, to become visible on the screen until a specified timeout. If is not found, an error is thrown.

default timeout: 30000 optional timeout compatibility : universal

waitUntilIdBeforeClick

• waitUntilIdBeforeClick,[ID] =waitUntilIdBeforeClick,[ID],false

• waitUntilIdBeforeClick,[ID],true

Waits for a view element, with the exact id selected, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max.

default boolean : false optional boolean compatibility : universal

waitUntilGoneId

waitUntilGoneId,[ID]

waitUntilGoneId,[ID],[TIMEOUT]

Waits until there is no view element, with the exact id selected, visible on the screen until a specified timeout. If it is still found, an error is thrown.

default timeout: 30000 optional timeout compatibility : universal

waitUntilGoneText

waitUntilGoneText,[TEXT]

waitUntilGoneText,[TEXT],[TIMEOUT]

Waits until there is no view element, with text selected, visible on the screen until a specified timeout. If it is still found, an error is thrown.

CASE-inSENSITIVE default timeout: 30000 optional timeout compatibility : universal

waitUntilGoneTextExact

waitUntilGoneTextExact,[EXACT-TEXT]

waitUntilGoneTextExact,[EXACT-TEXT],[TIMEOUT]

Waits until there is no view element, with the exact text selected, visible on the screen until a specified timeout. If it is still found, an error is thrown.

CASE-SENSITIVE default timeout: 30000 optional timeout compatibility : universal

waitUntilGoneDesc

waitUntilGoneDesc,[DESC]

waitUntilGoneDesc,[DESC],[TIMEOUT]

Waits until there is no view element, with content-desc selected, visible on the screen until a specified timeout. If it is still found, an error is thrown.

CASE-inSENSITIVE default timeout: 30000 optional timeout compatibility : universal

waitUntilGoneDescExact

waitUntilGoneDescExact,[EXACT-DESC]

waitUntilGoneDescExact,[EXACT-DESC],[TIMEOUT]

Waits until there is no view element, with content-desc selected, visible on the screen until a specified timeout. If it is still found, an error is thrown.

CASE-SENSITIVE default timeout: 30000 optional timeout compatibility : universal

waitUntilGoneClass

waitUntilGoneClass,[CLASS]

waitUntilGoneClass,[CLASS],[TIMEOUT]

Waits until there is no view element, with class selected, visible on the screen until a specified timeout. If it is still found, an error is thrown.

default timeout: 30000 optional timeout compatibility : universal

waitUntilWindowUpdate

waitUntilWindowUpdate,[PACKAGE-NAME]

waitUntilWindowUpdate,null

Waits for a window content update event to occur. The specified window package name can be null. If null, a window update from any front-end window will end the wait.

compatibility : universal

pinchInById

pinchInById,[ID],[PERC]

pinchInById,[ID],[PERC],[DURATION]

Pinches in the element with id selected according to a percentage of the object's diagonal length. If a too large duration and small percentage are used, nothing may happen.

default duration: 500 optional duration compatibility : universal

pinchOutById

pinchOutById,[ID],[PERC]

pinchOutById,[ID],[PERC],[DURATION]

Pinches out the element with id selected according to a percentage of the object’s diagonal length. If a too large duration and small percentage are used, nothing may happen.

default duration: 500 optional duration compatibility : universal

pinchInByText

pinchInByText,[TXT],[PERC]

pinchInByText,[TEXT],[PERC],[DURATION]

Pinches in the element with text selected according to a percentage of the object’s diagonal length. If a too large duration and small percentage are used, nothing may happen.

CASE-inSENSITIVE default duration: 500 optional duration compatibility : universal

pinchOutByText

pinchOutByText,[TXT],[PERC]

pinchOutByText,[TEXT],[PERC],[DURATION]

Pinches out the element with text selected according to a percentage of the object’s diagonal length. If a too large duration and small percentage are used, nothing may happen.

CASE-inSENSITIVE default duration: 500 optional duration compatibility : universal