Genymotion PaaS Overview

Source:

Keywords: Genymotion PaaS, device display, logcat, Kiosk mode, SSH Keys Management

Document ID: https://docs.genymotion.com/usage/paas/basic_usage#split1

Access the device display and interface

Genymotion PaaS provides access to the device display and interface on cloud providers.

AWS, GCP, Alibaba, Azure.

AWS

From the EC2 dashboard, select the instance you want to access.

Copy the hostname or public IP from the Details section at the bottom. Paste the hostname or public IP to your web browser. Click open address.

You will get this warning because our certificate is self-signed.

To remove this warning permanently, you must .

Click Advanced and proceed to the address.

Authenticate yourself.

By default, the username is genymotion and the password is the instance ID.

1. Start your instance. 2. Click on the instance name and copy the temporary Web UI password. 3. Get back to the main VM Instances page and click on the instance External IP. 4. You will have the following warning because our certificate is auto-signed. To remove this warning permanently, you must . Click Advanced and Proceed to XX.XX.XX.XX (unsafe) to connect. 5. You will then have to authenticate yourself. Enter username genymotion. Paste the Web UI password.

GCP

From the management console, in Instances, select the running instance you want to access.

Copy the Internet IP address from the IP address column. Paste the Internet IP address to your web browser.

A connection warning will pop up.

To remove this warning permanently, you must .

Click Advanced and Proceed to XX.XX.XX.XX (unsafe) to connect.

You will then have to authenticate yourself.

By default, the username is genymotion. The password is the Instance ID of the instance. The instance ID can be retrieved from the Instance ID/Name column.

Alibaba

From the management console, in Virtual Machines, select the virtual machine you want to access.

Copy the public IP from the Overview section.

Paste the public IP in a new window.

You will get the following warning because our certificate is self-signed.

To remove this warning permanently, you must . Otherwise, just ignore the warning and proceed.

Click Advanced and Proceed to XX.XX.XX.XX (unsafe) to connect.

You will then have to authenticate yourself.

The default username is genymotion. The default password is your virtual machine name.

Example

In this example, user name is "genymotion" and password is "jma-support-6.0-v8.0".

You can change the default username and password, or disable authentication. See .

Azure

You will then access the device display with Genymotion interface.

Change locale

In the device display top bar, click to change the language of the user interface.

This only changes the web user interface language, not the device (Android) language.

Dark mode

The web UI theme now includes a dark mode.

Click to switch between dark and light mode.

Power Off and Reboot

In the upper-right corner of the device display titlebar window, click on to stop or reboot your instance.

Device Logcat

You can access the virtual device real time logcat using ADB or the Device logs panel.

There, you can:

Device content

You can access the device content features from the Device content panel.

There, you can:

File browser

Browse and manage instance files with this box:

You can perform the following actions:

1. Go to the desired folder by clicking on it.

2. Click in the file browser navigation bar.

3. Click or.

1. Click on the desired file.

2. Click or or

Packages

Click on the desired package to start the installation.

Once a package has been installed, it cannot be removed.

Shell

It is now possible to access the instance shell from the front end user interface, by clicking Shell in the left bar menu.

You can then input shell commands.

SSH Keys Management

This features allows you to add other SSH keys and/or remove existing ones.

This features also sets the persist.god.keep_ssh_keys property to true. This property ensures that changes are kept after reboot or restart.

It is also possible to edit keys manually in /data/ssh/authorized_keys.

Supported SSH key types are: ssh-rsa, ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384 and ecdsa-sha2-nistp521.

Go to Configuration and navigate to the SSH Keys section.

Add a new SSH keys

Click in the text field. Copy/paste the SSH public key. Press return.

If the key is valid, the APPLY button will become available. Click the APPLY button to apply the change.

If a private or invalid key is input, an error will be display. The APPLY button will remain greyed out.

Remove an SSH key

Click the x button next to the key to remove an SSH key. Click APPLY to apply the change.

To change an SSH key, simply remove the existing key and add the new one.

Multi-touch

Multi-touch movements are emulated using the following key and mouse combinations:

| Action | Windows/Linux | macOS | | --- | --- | --- | | Zoom in | Ctrl + | Cmd + | | Zoom out | Ctrl + | Cmd + | | Tilt forth | Ctrl + | Cmd + | | Tilt back | Ctrl + | Cmd + | | Rotate clockwise | Shift + Ctrl + | Shift + Cmd + | | Rotate counterclockwise | Shift + Ctrl + | Shift + Cmd + |

Display

The display options allow you to change the device display resolution and add rounded corners to emulate a real device screen aspect.

To access them from the Web interface, go to the Configuration section of your device, or https://{your_instance_IP}/configuration:

Changing Resolution

You need to reboot your device to apply the changes.

From the Resolution section, select a preset resolution from the dropdown list. Alternatively, fill the Width, Height and Density fields to set a custom resolution.

Click APPLY.

You will be prompted to reboot the virtual device to apply the changes. This process can take several seconds.

Android geometry (size and density) can be changed with the persist.graph_mode and persist.dpi properties.

You can use adb or ssh and run the following commands:

> Note: - {WidthxHeight-Depth} is the desired resolution - for example, 720x1280-32 > - {dpi} is the desired density - for example, 240

Change resolution:

adb ssh

Change density:

adb ssh

Reboot the device to apply the changes.

Use the POST method and call the API /android/resolution to set the following variables:

Example

Please refer to for more information.

Rounded corners

This feature is not available with Android Automotive.

In the Rounded corners section, fill the Padding, Bottom radius and Top radius fields with values.

Values must be positive integers.

Click APPLY.

You will be prompted to reboot the virtual device to apply the changes. This process can take several seconds.

Use the PUT method and call the API /android/rounded-corners to set the following variables:

Example

Please refer to for more information.

Root access

Root access can be toggled from the Web UI.

Click to toggle root access:

> Note: This feature is only available with Android 10.0 and above; the toggle switch will be disabled in older versions:

For more information about Root access, please refer to .

Kiosk mode

If you want a user to interact with your application and nothing else, you can configure the virtual device so that it turns into a kiosk mode. Kiosk mode makes the virtual device a single-purpose tool.

Web UI, Command line, HTTP API.

1. Install and launch the application. 2. Open the Configuration panel. 3. In the Kiosk box, you can kiosk and unkiosk the application by clicking the toggle button:

> Warning: If you are using an unrooted (user build) image, you need to and run adb root to use the commands below.

1. Connect to your virtual device with or . 2. Start the application you want to lock in kiosk mode. 3. Once the application is started, use the following commands to lock or unlock it:

Lock:

adb ssh

Unlock:

adb ssh

To lock an application, you can use the POST method and call the API /configuration/kiosk.

To unlock it, use the DELETE method and call the API /configuration/kiosk.

For detailed instructions, please refer to

In kiosk mode, the status bar is hidden and cannot be scrolled down. The Back or Home buttons are unavailable.

If within your application you start another application, this might not work depending on how this application is started. For more information, please refer to the LockTask mode from .

Admin device owner

A default admin device owner is set to make sure kiosk toggle is always available.

If the admin device owner must be changed for some reason, it is possible to disable it by setting the persist.genymotion.device_owner property to false.

This can easily be done with ADB, with the command:

Disabling the Right Toolbar

You can embed the device display with and select which widget to show/hide.

Changing Product Properties

This features allows you to edit the build.prop to emulate a real device more precisely.

Go to the Configuration panel.

Then, go to the Product Properties box.

There, you can change the following build.prop properties:

| | Property Name | | --- | --- | | Display ID | ro.build.display.id | | Product name | ro.product.name | | Manufacturer | ro.product.manufacturer | | Device | ro.product.device | | Board | ro.product.board | | Brand | ro.product.brand | | Model | ro.product.model | | Fingerprint | ro.build.fingerprint | | Build description | ro.build.description |

Misc Features

The following options can be reached from the Configuration tab:

Show pointer location

Show or hide the Android pointer location when clicking in the virtual device.

Animations

Controls Android animations speed ("0" value disables animation):

Virtual Keyboard

Enables or disables virtual keyboard:

Back to top