# 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
Warning
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
Stop
:
You can also stop it from the main page:
# Deploying an application
To deploy an application to a virtual device, use either of the following methods.
Important
If installing an application fails, it may mean that it uses ARM code. For more information, please refer to Applications with native ARM code.
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).
# Drag and drop
Drag and drop the application APK file into the virtual device window.
# File upload widget
See Features and Emulated Sensors - File Upload.
# Connect to 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, you will need to install the Open GApps package. See Installing Open GApps.
# 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.
Disclaimer
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.
Note
If you wish to install applications with native ARM code from Google Play Store, you have to install the ARM translation tool before the OpenGApps package (see Applications with native ARM code)
To install the Open GApps package:
- From your running virtual device display, click on the File upload widget
and INSTALL OPEN GAPPS.
Then ChooseINSTALL
- 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.
# Applications with native ARM code
Important
Genymotion does not support arm64-v8.
Genymotion virtual devices architecture is x86 (32-bit). If your application relies on ARM native code, you must install an ARM translation tool to make it work. The ARM translation tool must match your virtual device Android version:
Warning
For legal reasons, Genymobile cannot provide you with any ARM translation tools.
# Graphical method
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, with adb (see gmsaas - Connect an instance to adb):
adb reboot
Verify that the translation tools have been properly installed with this command:
adb shell getprop ro.product.cpu.abilist
If successful, this should return
x86,armeabi-v7a,armeabi
Save your device to keep the changes (see Saving a virtual device)
Install your APK file with one of the manual methods
# Command line method with ADB
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
adb reboot
Save your device to keep the changes (see Saving a virtual device)
Install your APK file with one of the manual methods
# 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.
Note
Your template will appear as "saving" in the Templates list. The saving process should take less that a minute to complete.
Saved virtual devices are stored in the Templates section:
You can also overwrite an already customized virtual device using
and