If the Hypervisor Framework is not supported by your Mac, you can use HAXM to accelerate the Android emulator (described next). Accelerating with HAXM If your Mac does not support the Hypervisor framework (or you are using a version of macOS earlier than 10.10), you can use Intel's Hardware Accelerated Execution Manager ( HAXM ) to speed up the. The following suggestions are often helpful in diagnosing Android emulator issues. Starting the emulator from the command line. If the emulator is not already running, you can start it from the command line (rather than from within Visual Studio for Mac) to view its output. Typically, Android emulator AVD images are stored at the following. The steps to accelerate the Android emulator for Linux are different than for Windows and Mac OS X as Intel HAXM is not compatible with Linux so you would need to use KVM (kernel-based virtual machine) instead. The steps below were carried out using Ubuntu. 12.04 and may differ slightly with other Linux distributions.
-->This article describes the most common warning messages and issuesthat occur while configuring and running the Android Emulator. Inaddition, it describes solutions for resolving these errors as well asvarious troubleshooting tips to help you diagnose emulator problems.
Deployment issues on Windows
Some error messages may be displayed by the emulator when you deployyour app. The most common errors and solutions are explained here.
Deployment errors
If you see an error about a failure to install the APK on the emulatoror a failure to run the Android Debug Bridge (adb), verify that theAndroid SDK can connect to your emulator. To verify emulatorconnectivity, use the following steps:
Launch the emulator from the Android Device Manager (selectyour virtual device and click Start).
Open a command prompt and go to the folder where adb isinstalled. If the Android SDK is installed at its default location,adb is located atC:Program Files (x86)Androidandroid-sdkplatform-toolsadb.exe;if not, modify this path for the location of the Android SDK on yourcomputer.
Type the following command:
If the emulator is accessible from the Android SDK, the emulatorshould appear in the list of attached devices. For example:
If the emulator does not appear in this list, start the AndroidSDK Manager, apply all updates, then try launching theemulator again.
MMIO access error
If the message An MMIO access error has occurred is displayed,restart the emulator.
Missing Google Play Services
If the virtual device you are running in the emulator does not haveGoogle Play Services or Google Play Store installed, this condition isoften caused by creating a virtual device without including thesepackages. When you create a virtual device (seeManaging Virtual Devices with the Android Device Manager),be sure to select one or both of the following options:
- Google APIs – includes Google Play Services in the virtual device.
- Google Play Store – includes Google Play Store in the virtual device.
For example, this virtual device will include Google Play Services and Google Play Store:
Note
Google Play Store images are available only for some base device types suchas Pixel, Pixel 2, Nexus 5, and Nexus 5X.
Performance issues
Performance issues are typically caused by one of the following problems:
The emulator is running without hardware acceleration.
The virtual device running in the emulator is not using an x86-based system image.
The following sections cover these scenarios in more detail.
Hardware acceleration is not enabled
If hardware acceleration is not enabled, starting a virtual device fromthe Device Manager will produce a dialog with an error messageindicating that the Windows Hypervisor Platform (WHPX) is notconfigured properly:
If this error message is displayed, seeHardware acceleration issues below for steps youcan take to verify and enable hardware acceleration.
Acceleration is enabled but the emulator runs too slowly
A common cause for this problem is not using an x86-based image in yourvirtual device (AVD). When you create a virtual device (seeManaging Virtual Devices with the Android Device Manager),be sure to select an x86-based system image:
Hardware acceleration issues
Whether you are using Hyper-V or HAXM for hardware acceleration, youmay run into configuration problems or conflicts with other software onyour computer. You can verify that hardware acceleration is enabled(and which acceleration method the emulator is using) by opening acommand prompt and entering the following command:
This command assumes that the Android SDK is installed at the defaultlocation of C:Program Files (x86)Androidandroid-sdk; if not,modify the above path for the location of the Android SDK on yourcomputer.
Hardware acceleration not available
If Hyper-V is available, a message like the following example will bereturned from the emulator-check.exe accel command:
If HAXM is available, a message like the following example will bereturned:
If hardware acceleration is not available, a message like the followingexample will be displayed (the emulator looks for HAXM if it is unableto find Hyper-V):
If hardware acceleration is not available, seeAccelerating with Hyper-Vto learn how to enable hardware acceleration on your computer.
Incorrect BIOS settings
If the BIOS has not been configured properly to support hardwareacceleration, a message similar to the following example will bedisplayed when you run the emulator-check.exe accel command:
To correct this problem, reboot into your computer's BIOS and enable thefollowing options:
- Virtualization Technology (may have a different label depending on motherboard manufacturer).
- Hardware Enforced Data Execution Prevention.
If hardware acceleration is enabled and the BIOS is configuredproperly, the emulator should run successfully with hardware acceleration.However, problems may still result due to issues that are specific toHyper-V and HAXM, as explained next.
Hyper-V issues
In some cases, enabling both Hyper-V and Windows HypervisorPlatform in the Turn Windows features on or off dialog may notproperly enable Hyper-V. To verify that Hyper-V is enabled, use thefollowing steps:
Enter powershell in the Windows search box.
Right-click Windows PowerShell in the search results and selectRun as administrator.
In the PowerShell console, enter the following command:
If Hyper-V is not enabled, a message similar to the following example will bedisplayed to indicate that the state of Hyper-V is Disabled:
In the PowerShell console, enter the following command:
If the Hypervisor is not enabled, a message similar to the following example will bedisplayed to indicate that the state of HypervisorPlatform is Disabled:
If Hyper-V and/or HypervisorPlatform are not enabled, use the followingPowerShell commands to enable them:
After these commands complete, reboot.
For more information about enabling Hyper-V (including techniques forenabling Hyper-V using the Deployment Image Servicing and Managementtool), seeInstall Hyper-V.
HAXM issues
HAXM issues are often the result of conflicts with other virtualizationtechnologies, incorrect settings, or an out-of-date HAXM driver.
HAXM process is not running
If HAXM is installed, you can verify that the HAXM process is runningby opening a command prompt and entering the following command:
If the HAXM process is running, you should see output similarto the following result:
If STATE is not set to RUNNING, seeHow to Use the Intel Hardware Accelerated Execution Manager to resolve the problem.
HAXM virtualization conflicts
HAXM can conflict with other technologies that use virtualization,such as Hyper-V, Windows Device Guard, and some antivirus software:
Hyper-V – If you are using a version of Windows before theWindows 10 April 2018 update (build 1803) and Hyper-V is enabled,follow the steps in Disabling Hyper-V so thatHAXM can be enabled.
Device Guard – Device Guard and Credential Guard canprevent Hyper-V from being disabled on Windows machines. To disableDevice Guard and Credential Guard, seeDisabling Device Guard.
Antivirus Software – If you are running antivirus softwarethat uses hardware-assisted virtualization (such as Avast), disableor uninstall this software, reboot, and retry the Androidemulator.
Incorrect BIOS settings
If you are using HAXM on a Windows PC, HAXM will not work unlessvirtualization technology (Intel VT-x) is enabled in the BIOS. If VT-xis disabled, you will get an error similar to the following when youattempt to start the Android Emulator:
This computer meets the requirements for HAXM, but IntelVirtualization Technology (VT-x) is not turned on.
To correct this error, boot the computer into the BIOS, enable bothVT-x and SLAT (Second-Level Address Translation), then restart thecomputer back into Windows.
Disabling Hyper-V
If you are using a version of Windows before the Windows 10April 2018 Update (build 1803) and Hyper-V is enabled, you must disableHyper-V and reboot your computer to install and use HAXM. If youare using Windows 10 April 2018 Update (build 1803) or later, AndroidEmulator version 27.2.7 or later can use Hyper-V (instead of HAXM) forhardware acceleration, so it is not necessary to disable Hyper-V.
You can disable Hyper-V from the Control Panel by following thesesteps:
Enter windows features in the Windowssearch box and select Turn Windows features on or off inthe search results.
Uncheck Hyper-V:
Restart the computer.
Alternately, you can use the following PowerShell command to disablethe Hyper-V Hypervisor:
Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-Hypervisor
Intel HAXM and Microsoft Hyper-V cannot both be active at the sametime. Unfortunately, there is no way to switch between Hyper-Vand HAXM without restarting your computer.
In some cases, using the above steps will not succeed in disablingHyper-V if Device Guard and Credential Guard are enabled. If you areunable to disable Hyper-V (or it seems to be disabled but HAXMinstallation still fails), use the steps in the next section to disableDevice Guard and Credential Guard.
Disabling Device Guard
Device Guard and Credential Guard can prevent Hyper-V from beingdisabled on Windows machines. This situation is often a problem fordomain-joined machines that are configured and controlled by an owningorganization. On Windows 10, use the following steps to see if DeviceGuard is running:
Enter System info in the Windows search box and selectSystem Information in the search results.
In the System Summary, look to see if Device GuardVirtualization based security is present and is in the Runningstate:
If Device Guard is enabled, use the following steps to disable it:
Ensure that Hyper-V is disabled (under Turn Windows Featureson or off) as described in the previous section.
In the Windows Search Box, enter gpedit.msc and select the Editgroup policy search result. These steps launch the Local GroupPolicy Editor.
In the Local Group Policy Editor, navigate to ComputerConfiguration > Administrative Templates > System > Device Guard:
Change Turn On Virtualization Based Security to Disabled (asshown above) and exit the Local Group Policy Editor.
In the Windows Search Box, enter cmd. When Command Prompt appearsin the search results, right-click Command Prompt and selectRun as Administrator.
Copy and paste the following commands into the command prompt window(if drive Z: is in use, pick an unused drive letter to useinstead):
Restart your computer. On the boot screen, you should see a prompt similar tothe following message:
Do you want to disable Credential Guard?
Press the indicated key to disable Credential Guard as prompted.
After the computer reboots, check again to ensure that Hyper-V isdisabled (as described in the previous steps).
If Hyper-V is still not disabled, the policies of your domain-joinedcomputer may prevent you from disabling Device Guard or CredentialGuard. In this case, you can request an exemption from your domainadministrator to allow you to opt out of Credential Guard. Alternately,you can use a computer that is not domain-joined if you must use HAXM.
Additional troubleshooting tips
The following suggestions are often helpful in diagnosing Androidemulator issues.
Starting the emulator from the command line
If the emulator is not already running, you can start it from thecommand line (rather than from within Visual Studio) to view itsoutput. Typically, Android emulator AVD images are stored at thefollowing location (replace username with your Windows user name):
C:Usersusername.androidavd
You can launch the emulator with an AVD image from this location bypassing in the folder name of the AVD. For example, this command launchesan AVD named Pixel_API_27:
Android Emulator Intel Haxm Mac Pro
This example assumes that the Android SDK is installed at the defaultlocation of C:Program Files (x86)Androidandroid-sdk; if not,modify the above path for the location of the Android SDK on yourcomputer.
When you run this command, it will produce many lines of output whilethe emulator starts up. In particular, lines such as the followingexample will be printed if hardware acceleration is enabled and workingproperly (in this example, HAXM is used for hardware acceleration):
Viewing Device Manager logs
Often you can diagnose emulator problems by viewing the Device Managerlogs. These logs are written to the following location:
C:UsersusernameAppDataLocalXamarinLogs16.0
You can view each DeviceManager.log file by using a texteditor such as Notepad. The following example log entry indicates thatHAXM was not found on the computer:
Deployment issues on macOS
Some error messages may be displayed by the emulator when you deployyour app. The most common errors and solutions are explained below.
Deployment errors
If you see an error about a failure to install the APK on the emulatoror a failure to run the Android Debug Bridge (adb), verify that theAndroid SDK can connect to your emulator. To verify connectivity, usethe following steps:
Launch the emulator from the Android Device Manager (selectyour virtual device and click Start).
Open a command prompt and go to the folder where adb isinstalled. If the Android SDK is installed at its default location,adb is located at~/Library/Developer/Xamarin/android-sdk-macosx/platform-tools/adb;if not, modify this path for the location of the Android SDK on yourcomputer.
Type the following command:
If the emulator is accessible from the Android SDK, the emulatorshould appear in the list of attached devices. For example:
If the emulator does not appear in this list, start the AndroidSDK Manager, apply all updates, then try launching theemulator again.
MMIO access error
If An MMIO access error has occurred is displayed,restart the emulator.
Missing Google Play Services
If the virtual device you are running in the emulator does not haveGoogle Play Services or Google Play Store installed, this condition isusually caused by creating a virtual device without including thesepackages. When you create a virtual device (seeManaging Virtual Devices with the Android Device Manager),be sure to select one or both of the following:
- Google APIs – includes Google Play Services in the virtual device.
- Google Play Store – includes Google Play Store in the virtual device.
For example, this virtual device will include Google Play Services and Google Play Store:
Note
Google Play Store images are available only for some base device types suchas Pixel, Pixel 2, Nexus 5, and Nexus 5X.
Performance issues
Performance issues are typically caused by one of the following problems:
The emulator is running without hardware acceleration.
The virtual device running in the emulator is not using an x86-based system image.
The following sections cover these scenarios in more detail.
Hardware acceleration is not enabled
If hardware acceleration is not enabled, a dialog may pop up with amessage such as device will run unaccelerated when you deploy yourapp to the Android emulator. If you are not certain whether hardwareacceleration is enabled on your computer (or you would like to knowwhich technology is providing the acceleration), seeHardware acceleration issues below for steps you cantake to verify and enable hardware acceleration.
Acceleration is enabled but the emulator runs too slowly
A common cause for this problem is not using an x86-based image in yourvirtual device. When you create virtual device (seeManaging Virtual Devices with the Android Device Manager),be sure to select an x86-based system image:
Hardware acceleration issues
Whether you are using the Hypervisor Framework or HAXM for hardwareacceleration of the emulator, you may run into problems caused byinstallation issues or an out-of-date version of macOS. The followingsections can help you resolve this issue.
Hypervisor Framework issues
If you are using macOS 10.10 or later on a newer Mac, the Androidemulator will automatically use the Hypervisor Framework for hardwareacceleration. However, some older Macs or Macs running a version ofmacOS earlier than 10.10 may not provide Hypervisor Framework support.
To determine whether or not your Mac supports the Hypervisor Framework,open a Terminal and enter the following command:
If your Mac supports the Hypervisor Framework, the above command willreturn the following result:
If the Hypervisor Framework is not available on your Mac, you canfollow the steps in Accelerating with HAXMto use HAXM for acceleration instead.
HAXM issues
If the Android Emulator does not start properly, this problem is oftencaused by problems with HAXM. HAXM issues are often the result ofconflicts with other virtualization technologies, incorrect settings,or an out-of-date HAXM driver. Try reinstalling the HAXM driver, usingthe steps detailed inInstalling HAXM.
Android Emulator Intel Haxm Mac Free
Additional troubleshooting tips
The following suggestions are often helpful in diagnosing Androidemulator issues.
Starting the emulator from the command line
If the emulator is not already running, you can start it from thecommand line (rather than from within Visual Studio for Mac) to viewits output. Typically, Android emulator AVD images are stored at thefollowing location:
~/.android/avd
You can launch the emulator with an AVD image from this location bypassing in the folder name of the AVD. For example, this commandlaunches an AVD named Pixel_2_API_28:
If the Android SDK is installed at its default location, the emulatoris located in the~/Library/Developer/Xamarin/android-sdk-macosx/emulator directory;if not, modify this path for the location of the Android SDK on yourMac.
When you run this command, it will produce many lines of output whilethe emulator starts up. In particular, lines such as the followingexample will be printed if hardware acceleration is enabled and workingproperly (in this example, Hypervisor Framework is used for hardwareacceleration):
Viewing Device Manager logs
Often you can diagnose emulator problems by viewing the Device Managerlogs. These logs are written to the following location:
~/Library/Logs/XamarinDeviceManager
You can view each Android Devices.log file by double-clicking it toopen it in the Console app. The following example log entry indicatesthat HAXM was not found:
This page is deprecated. Redirecting to https://developer.android.com/studio/run/emulator.html
The Android Studio 2.0 (or higher) preview includes the new Android Emulator 2.0 with improved performance and a new user interface to control device features. This page describes some of the changes compared to the emulator available with the stable version of Android Studio 1.5 and how to setup your development environment to use the Android Emulator.
For best performance with Android Emulator 2.0, your system should meet the following specifications:
Windows: Intel® processor with support for Intel® VT-x, Intel® EM64T (Intel® 64), and Execute Disable (XD) Bit functionality. AMD and Intel Atom processors do not support VT-x virtual machine acceleration.
Linux: Intel® processor with support for Intel® VT-x, Intel® EM64T (Intel® 64), and Execute Disable (XD) Bit functionality or AMD processors with support for AMD Virtualization™ (AMD-V™)
64-bit Operating Systems.
New Features
The most valuable updates to the Android Emulator are the speed improvements. When running with Android Studio 2.0 or higher on an x86 machine, response time is faster than the previous Android Emulator and you can transfer files from your machine faster than a physical Android device.
The latest Android Emulator supports new multi-finger touch inputs, including pinch zoom and two finger rotate gestures. Holding down Alt or Option reveals two finger points. Moving the mouse moves one finger and the second finger is mirrored across an anchor point. Clicking the left mouse button enables pinch-zoom gestures and clicking the right mouse button enables two-finger rotate gestures (such as to tilt the perspective when viewing a map).
The panel on the right side of the emulator lets you perform common tasks, such as rotate the screen, capture screenshots, and zoom in on the display.
To install apps, you can drag and drop an APK right on the emulator. You can also drag and drop other file types and they'll be saved to the /sdcard/Download/ directory.
At the bottom of the toolbar on the right is an ellipsis button that opens the Extended Controls window. In here you'll find various controls that invoke device events and mock device sensors.
Keyboard shortcuts are available for most actions and are listed in the Help panel, listed on the left.
Get Android Emulator 2.0
The new Android Emulator is available with Android Studio 2.0 or higher, which is available in both the Stable, Beta and Canary channels.
Once you make sure you have the appropriate emulator system image and other tools:
Open the SDK Manager from Android Studio.
Click the SDK Platforms tab, and select the check box for a recent version such as the Android 6.0 (Marshmallow). By default, this includes the x86 system image that you need for the emulator. You can see and modify the files to download by clicking Show Package Details at the bottom-right.
Click the SDK Tools tab, then select the check boxes for the following:
Android SDK Tools (25.0.0 or higher to get the new emulator)
Android SDK Platform-Tools (23.1.0 or higher to get the fast ADB)
Intel x86 Emulator Accelerator (HAXM installer) (rev 6.0.1 or higher to get CPU acceleration)
Click OK to check for updates.
Create new Android Virtual Device (AVD)
To take advantage of the new Android Emulator and adb speeds, you need to create new AVDs. In this example below, we are creating a Nexus 5x AVD.
Open the AVD Manager from Android Studio.
Click Create Virtual Device.
Select the defaults for Nexus 5x.
Select a system image, such as Marshmallow - API 23 - x86.
Select Show Advanced Settings.
Select the Multi-Core CPU check box. The number of cores available depends on the number of cores available on your development machine.
Run your new Android Virtual Device by click on the green Play button.
You should see the Android Emulator now start up.
Troubleshooting
Check Intel x86 Emulator Accelerator Installation
If you selected the defaults during the Android Studio installation you should be ready to go. If you created a custom Android Studio installation or run into issues, read the troubleshooting guide below. If your Intel x86 Emulator Accelerator is out of date, Android Studio will automatically inform you and suggest a quick fix to update, as shown in the following screenshot in the AVD Manager.
Installing CPU Accelerator (HAXM)
If you skipped the initial setup of Android Studio, you should make sure the CPU acceleration is installed.
You can manually install Intel x86 Emulator Accelerator by opening intelhaxm-android.exe (on Windows) or intelHAXM_6.0.1.dmg (on Mac) from /sdk/extras/intel/Hardware_Accelerated_Execution_Mangager, as shown below:
Installing HAXM in Windows
Installing HAXM in OS X
For Linux, the Android emulator usesKernel-based Virtual Machine (KVM). If you are using Ubuntu, you can run check your KVM system compatibility by running the following on the command line:
$egrep –c '(vmx|svm)' /proc/cpuinfo
on the command line to check for for a return value of greater than 1
To check if you have KVM installed by running the following on the command line:
$kvm-ok
If KVM is missing or to ensure you have the latest KVM installed, run the following on the command line:
$sudo apt-get install qemu-kvm libvirt-bin ubuntu-vm-builder bridge-utils ia32-libs-multiarch
The linux commands look like the following on Ubuntu:
Known Issues
Emulating inbound phone call freezes emulator.
Screenshot feature crashes emulator in certain conditions.
If an AVD has been opened in a previous version of the emulator, it may not boot in the new emulator, therefore create a new AVD.
OSX - screen doesn't go black when you sleep the device.
Linux - segfault on exit in some conditions.
'-gpu mesa' option not supported.
'-net*' option not supported.
'-no-window' option not supported.
Remote desktop not supported.
Emulated hardware 'recents' key doesn't work in older system images.
Multiple DNS servers not supported.
If you find other issues in the Android Emulator, pleasefile a bug report.
We have more features in the pipeline, but if you may also submit feature requests.