Utils (ZD)

Owned by ZL Support
Last updated: Oct 24, 2021
5 min read

Table of contents

Description

This action contains functions for work directly in the virtual machine (VM): installation of applications, start, stop, executing the console command (AdB Shell), etc.

How to add an action to the project?

Through the context menu Add Action → Android → Utils

Or use smart search.

How to work with action?

Install application

This action allows you to install the application from the APK file.

Uninstall application

This action allows you to delete the installed application by its name.

The application name can be found using the installed applications (ZD) tool.

Open application

Allows you to start the previously installed application

The application name can be found using the installed applications (ZD) tool.

Close application

Closes the application (command analog adb shell am force-stop com.package)

The application name can be found using the installed applications (ZD) tool.

Application cleanup

Erase all application data.

Or you can clear only the cache without deleting the data.

The application name can be found using the installed applications (ZD) tool.

Save application’s data

This feature allows you to save all application data (something like saving a profile in Zennoposter).

The application name can be found using the installed applications (ZD) tool.

Path to archive file - here you must specify the path where archived application data will be saved (archive format - tar.gz)

Before saving the data, the application is better to close using the run of the Emulation of the keyboard with such text inside {AndroidKeys.HOME} - this is the emulation of the HOME key.

If the application will be open at the time of data saving the application, that is, the likelihood that part of the data will be in RAM, and not in files and this data will not be saved.

It is also not worth it for these purposes to close the application using action to Close application, because this action kills the process, which can also lead to data loss.

Restore application’s data

Using this feature, you can load the data of this application that were saved using the Save application’s data (described above).

The application name can be found using the installed applications (ZD) tool.

Path to archive file - here you must specify the path to the archive with the data from the application.

When recovering data, the application must be installed in the system, but not started!

Console command (ADB Shell)

This action is not the ADB commands!

Action allows you to perform built-in Android Console Linux commands.
Approximately the same as the execution of commands in the Annex Terminal Emulator for Android.

Since version 2.2.5 the action has a timeout and it is 10 seconds. If the command is not finished within this time, the action will exit with an error.

Examples of commands:

ls -la /sdcard/Download - get all the files and directories on the path /sdcard/Download
pm list packages - all installed applications.
pm list packages -3 - only third-party applications.

Command ADB Shell - is a command you need to execute.

Save the result to a variable - here you need to specify an existing one or create a new variable in which the result of the work will be saved.

-rw-rw---- root sdcard_r 0 2019-01-25 16:42 .nomedia drwxrwx--- u0_a22 sdcard_r 2019-01-26 16:40 com.android.browser drwxrwx--- u0_a15 sdcard_r 2021-07-03 17:57 com.android.vending drwxrwx--- u0_a23 sdcard_r 2021-07-03 22:53 com.cyanogenmod.filemanager drwxrwx--- u0_a8 sdcard_r 2019-04-11 13:29 com.google.android.gms drwxrwx--- u0_a12 sdcard_r 2019-01-25 16:42 com.microvirt.guide

Set Geo-location

This action allows you to replace the location of the device.

Latitude - permissible values from -90 to 90.
Longitude - permissible values from -180 to 180.

You can use fractional values. Fractional separator or. (point), or, (comma).
Example: latitude and longitude of New York 40.7143 and -74.006

WiFi settings

Using this action, you can replace the WiFi network name (SSID) through which the emulator is "connected".

Reset Google Advert ID

This action resets the advertising device identifier.

Get structure of elements (XML)

Using this action, you can obtain the structure of the screen elements in the form of an XML string. These are the same data as displayed in the element tree window, only as an XML string.

Then this data can be disassembled using the action JSON and XML and XPath processing.

Among the most useful attributes that can be obtained from the item:

  • coordinates and a width with a height (attribute bounds)

  • displayed text (attribute text)

  • Information about whether the element is displayed (attribute displayed)

Scaling

This action allows you to zoom out or zoom in.

Coordinates - a point relative to which the scale will change.
Coefficient - how much you need to reduce\zoom in scale.