# Basic Steps
In this section, you will find the basic steps to setup, launch and use a virtual device instance.
# Starting a virtual device
- Select a template from the Default templates section in the Resources view (see Graphical Interface) that matches the device you wish to emulate.
- Click and Start
# Stopping a virtual device
Closing your web browser or logging out will not stop your running virtual devices; they have to be stopped manually.
To stop a running device, click from the device webUI and select
You can also stop it from the main page:
# Deploying an application
If installing an application fails, it may mean that it uses ARM code. For more information, please refer to Applications with native ARM code. Genymotion SaaS does not support arm64/aarch64.
To deploy an application to a virtual device, you first need to create and launch a new instance (see Starting a virtual device) or launch a saved instance (see Saving a virtual device). Then, use either one of the following methods:
# Drag and drop
Drag and drop the application APK file into the virtual device window.
# File upload widget
# With ADB
Connect ADB to your virtual device (see gmsaas command line tool - Connect an instance to adb for instructions). And run the following command:
adb install <application.apk>
# Install the application using Google Play Store
To do so, install the Open GApps package. This will install Google Play Store.
# Installing Open GApps
The application you are developing or testing may require an interaction with Google Play Services (e.g.: in-app purchasing, advertising, etc.). However, for Intellectual Property reasons, Google Apps (Gmail, Drive, Calendar...) and Google Play services are not included in Genymotion virtual devices by default. You need to install them via Open GApps.
GENYMOBILE SAS assumes no liability whatsoever resulting from the download, install and use of Google Play Services within your virtual devices. You are solely responsible for the use and assume all liability related thereto. Moreover, GENYMOBILE SAS disclaims any warranties of any kind, either express or implied, including, without limitation, implied warranties of merchantability, or fitness for a particular purpose regarding the compatibility of the Open GApps packages with any version of Genymotion.
In no event shall GENYMOBILE SAS or its affiliates, or their respective officers, directors, employees, or agents be liable with respect to your download or use of the Google Play Services and you release GENYMOBILE SAS from any liability related thereto. You agree to defend, indemnify and hold harmless GENYMOBILE SAS for any claims or costs related to your use or download of the Google Play Services.
To install the Open GApps package:
- From your running virtual device display, click on the File upload widget and INSTALL OPEN GAPPS.
- Click INSTALL
- Wait for the package to upload and install.
- When done, you will be prompted to reboot the virtual device.
- (Optional) Open the Play Store and configure your account.
If you wish to install applications with native ARM code from Google Play Store, you have to install the ARM translation tool before the Open GApps package (see Applications with native ARM code)
# Applications with native ARM code
Genymotion SaaS virtual devices architecture is x86 (32-bit). To deploy applications for ARMv7 (32-bit), you must install an ARM translation tool which matches your virtual device Android version.
- For Intellectual Property reasons, we cannot distribute any ARM translation tools.
- Using ARM translation tools with Genymotion SaaS (Cloud) is not officially supported - we cannot guarantee Genymotion operations nor provide technical support in this case. Do it at your own risks!
# Install ARM translation tools
- There are no ARM translation tools for Android 10 and above.
- ARM translation tools cannot interpret applications for arm64/aarch64.
- Drag'n drop the ARM translation tools zip file to the device display, or use the File upload widget.
- Once installed, reboot your virtual device.
- Verify that the translation tools have been properly installed. See Verification
- Save your device to keep the changes. See Saving a virtual device
Alternatively, you can install the ARM translation tools by command line:
- Connect your instance to ADB with gmsaas (See Contact a device to ADB)
- Upload the ARM translation tools zip file to the device with this command:
adb push Genymotion-ARM-Translation_for_X.X.zip /sdcard/Download/
- Flash the tools:
adb shell /system/bin/flash-archive.sh /sdcard/Download/Genymotion-ARM-Translation_for_X.x.zip
- Once complete, reboot the virtual device with
- Save your device to keep the changes (see Saving a virtual device)
Use the following ADB command to verify the ARM translation tools installation:
adb shell getprop ro.product.cpu.abilist
This should return
x86,armeabi-v7a,armeabi. If not, the installation has failed.
# Install your application
# Saving a virtual device
From a predefined template, once your setup is done, you can save your virtual device.
Within your virtual device user interface, click and
Name your virtual device. This will stop the running device, start the template saving process and redirect you to the Resources page with the Templates filter on.
Your template will appear as "saving" in the Templates list. The saving process should take less than a minute to complete.
Saved virtual devices are stored in the Templates section:
You can also overwrite a saved virtual device by clicking and