Issues

You can check if gmsaas is well configured by using the command gmsaas doctor.

The exit code is 0 in case of success. The exit code is 1 otherwise. For example:

$ gmsaas doctor
Check up finished.
Authentication OK.
Android SDK OK.

Support

Whatever your problem is, the Support Team will need logs to speed up the investigations. To generate the logs:

1. Reproduce your issue 2. Run gmsaas logzip: an archive named gmsaas-logs-YYYYMMDD-HHMMSS.zip will be created in the current directory 3. Send a technical support request

Don't forget to attach the logs archive.

Known issues

ModuleNotFoundError: No module named 'pkg_resources'

This is due to Python 3.12 which brokes gmsaas dependencies. Upgrade gmsaas to fix it.

If gmsaas upgrade is not an short term option for you, you can manually install the missing dependency:

pip3 install [--user] --force-reinstall gmsaas

pip3 install [--user] setuptools

On macOS "Error: unable to connect to Genymotion SaaS server"

Check gmsaas log file (you can find it in ~/.Genymobile/gmsaas/gmsaas.log). If you see a line like this:

ssl.SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:749)

Then your Python installation is missing SSL certificates. This is caused by a change in the way Python handles SSL connections since Python 3.6.0.

You can install the missing certificates by running the Install Certificates.command script which can be found in the folder where you installed Python.

You can about this issue from (scroll down to the "Notes on this release" section).

ModuleNotFoundError: No module named 'engineio.async_tornado'

python-engineio dependency is outdated. You need to upgrade it.

Simplest way to do so is:

pip3 install [--user] --force-reinstall gmsaas

psutil error at installation time

Linux

If error is Python.h: No such file or directory, the Python development package is missing. To install it:

Ubuntu/Debian

sudo apt install python3-dev

Fedora

dnf install python3-devel

macOS

If error is xcrun: error: invalid active developer path, XCode is missing. To install it:

xcode-select --install