Intel & #174; hardware accelerator execution Manager Installation Guide-Mac OS X *

Introduction

This article will guide you through installing the Intel hardware accelerator execution Manager (Intel HAXM), an Intel virtualization technology (VT) A hardware-assisted virtualization engine (hypervisor) that accelerates Android * development ).

Prerequisites

Intel HAXM requires that the Android * SDK (Version 17 or later) be installed first ). For more information, visit the Android * developer website (http://developer.android.com/sdk ).

System Requirements

Hardware requirements:

• Intel processors supporting intel VT-x, Intel EM64T (Intel 64), and virus protection (XD)
• At least 1 GB of available RAM

Supported operating systems:

• Mac OS X * 10.6 Snow Leopard and 10.7 Lion (32/64 bits)

Important: Intel HAXM cannot be used on systems that do not use an Intel processor or that do not meet the hardware features described in the preceding hardware requirements. To learn about your intel processor capabilities, visit http://ark.intel.com/
In addition, Intel HAXM can only be used on Intel's Android * x86 simulator image.
Intel HAXM cannot be used with ARM * Android * simulator images or non-intel x86 Android * simulator images.

Download intel HAXM

Summary

When installing intel HAXM, you can choose to use the Android * SDK Manager (recommended) or manually (that is, manually download the installer from Intel's website ).

Note: Intel HAXM cannot automatically check for updates now. To obtain the latest version, use the Android * SDK Manager (recommended) or download the Intel HAXM package from the Android * developer website of the Intel Developer zone.

Manual download

1. Go to http://software.intel.com/en-us/android.
2. Select the Intel HAXM installation package for your platform.
3. Decompress the installer and use the installation instructions that suit your platform.

Download from Android * SDK Manager

1. Start Android * SDK manager.
2. Under Extras, select the check box next to "Intel x86 Emulator Accelerator (HAXM.
3. Click "Install package... "Button.
4. View the Intel license agreement. If you Accept the terms, select "Accept" and click "Install ".
5. The SDK manager downloads the installer to the "tools" directory in the main directory of the SDK.
6. Decompress the installer in the "tools" directory and use the installation instructions suitable for your platform.

Install intel HAXM on Mac OS X *

Warning if your system does not meet system requirements (including support for Intel processor features such as Intel virtualization technology (Intel VT), Intel hardware accelerator execution Manager (Intel HAXM) cannot be installed.

1. Download the installation package from http://software.intel.com/en-us/android using the SDK manager.
2. Open the DMG file and run the installation program.
3. If older versions of Intel HAXM have been installed, you will see a dialog box notification:
   
   
   

   Click "OK" to delete the dialog box. Then, you can exit the installer to maintain the current intel HAXM version, or continue to install and upgrade intel HAXM.

4. You will see a welcome page:
   
   
5. Click "continue"
6. The system will prompt you to adjust the amount of memory allocated to Intel HAXM.
   
   
   

   Note: For intel HAXM, this installer is equivalent to a configuration tool. To change the memory settings, run the installer again.

7. The next interface will confirm your intel HAXM memory configuration settings:
   
   
   
8. Select the hard drive that will be used to install intel HAXM and click "Continue ".
9. After installing intel HAXM, click "Close" to exit the installation program.

Intel HAXM is now installed and available.

To confirm whether Intel HAXM is running, open the terminal window and run the following command:

View Source code printing?

1	kextstat | grep intel

If Intel HAXM operates properly, a status message is displayed, prompting"com.intel.kext.intelhaxm"Kernel extension has been loaded.

To stop or start intel HAXM, follow these commands:

Stop:

View Source code printing?

1	sudo kextunload –b com.intel.kext.intelhaxm

Start:

View Source code printing?

1	sudo kextload –b com.intel.kext.intelhaxm

Adjust intel HAXM Memory Allocation

To change the amount of memory allocated to Intel HAXM, run the installer again.

Uninstall intel HAXM

Warning disable all Android * x86 simulator instances before uninstalling intel HAXM. Intel HAXM cannot be uninstalled in use.

To uninstall intel HAXM, open the terminal window and run the following command:

View Source code printing?

1	sudo /System/Library/Extensions/intelhaxm.kext/Contents/Resources/uninstall.sh

The system prompts you to enter the current user password. Uninstall intel HAXM as instructed by the uninstall program.

Important: uninstalling intel HAXM will disable acceleration for all intel x86 Android * simulators. The existing Android * virtual device continues to run, but stops acceleration.

Re-installing intel HAXM will re-enable Android * simulator acceleration.

Use intel HAXM

Intel HAXM requires the use of Android * x86 system images provided by Intel. These images can be downloaded through the Android * SDK manager or through the Intel Developer zone website.

The intel x86 Android * simulator image runs automatically using the emulator-x86 binary that comes with the Android * SDK. If Intel HAXM is successfully installed and runs, simulation can be accelerated (using Intel virtualization technology ).

Troubleshooting

Intel HAXM requires the use of Android * x86 system images provided by Intel. These images can be downloaded through the Android * SDK manager or through the Intel Developer zone website.

Intel virus protection (XD) feature Error
When installing intel HAXM, you may encounter errors related to Intel XD support.
The error message may appear in the following situations:

• The computer processor does not support Intel XD
• Intel XD not enabled

Intel XD is not supported
Intel HAXM requires an Intel processor that uses the virus protection (XD) feature and cannot be used for systems that do not have this hardware feature. To confirm the features of your intel processor, visit http://ark.intel.com /.

Intel XD not enabled
NOTE: If processor support is enabled, the Apple * computer will enable intel XD permanently.
If you receive an error message indicating that Intel XD is not enabled, your computer does not meet the minimum system requirements for using Intel HAXM. To confirm the features of your intel processor, visit http://ark.intel.com /.

Intel virtualization technology (Intel VT-x) Features

When installing intel HAXM, you may encounter errors related to Intel VT-x support.

The error message may appear in the following situations:

The computer's processor does not support Intel VT-x

• Intel VT-x Not Enabled

Intel VT-x is not supported
Intel HAXM requires an Intel processor using the Intel VT-x feature and cannot be used for systems that do not have this hardware feature. To confirm the features of your intel processor, visit http://ark.intel.com /.

Intel VT-x Not Enabled
Note: If the processor is supported, the Apple * computer will enable intel VT-x permanently.
If you receive an error message indicating that Intel VT is not enabled, your computer does not meet the minimum system requirements for using Intel HAXM. To confirm the features of your intel processor, visit http://ark.intel.com /.

Tips and skills

The following are some suggestions to help you use the Intel HAXM driver for the best Android * simulator experience.

• Enable GPU acceleration for your image in the AVD manager. The intel HAXM driver can execute most CPU commands locally using Intel virtualization technology in the processor, and GPU acceleration can migrate OpenGL * calls to the host GPU.
• Run the following command on the terminal to start the simulator:
  
  ./emulator-x86 –avd <avd name> -partition-size 1024 –gpu on
   
  • An Application of 1 GB size can be installed in a partition of 1024. It is different from the SDCard Size Selection in AVD manager. It specifies the size of memory allocated to the simulator to store media files. Setting GPU as an on-premise mode will provide better graphic performance.
  • Make sure that the environment variables you set for the GL library are correct. Use the following command to set LD_LIBRARY_PATH on the terminal. Modify the command to select the installation location of your SDK.
    
    export LD_LIBRARY_PATH=<sdk install location>/tools/lib
    
    To automatically run this command when the new terminal starts, you can add this command to your ~ /. Bash_profile script.
• When installing intel HAXM, set the driver to use half of the available memory in the system. For example, if your system has 6 gig of memory, use 3 gig for the Intel HAXM driver. Compared with the system memory, this balances the memory of the Intel HAXM driver.
• When creating an image, do not set "Device ram size" to greater than the memory allocated to the intel HAXM driver. In the above example, the device memory size should not be greater than 3 gig, because the memory allocated to Intel HAXM is only 3 gig.
• Sometimes, the image will be suspended on the startup interface when the image is started for the first time. The startup process is completed, but the main interface is not displayed. Click the home page of the simulator to open the main interface.
• For more information about how to select the command line for starting the simulator, see the Android * developer website.

Changelog

• Update Linux kernel to 3.4 in the simulator
• Added support for 64-x86 simulators to run on 32-bit and 64-bit Mac OSX
• Fixed a kernel crash when running Mountain Lion 10.8 on the Ivy Bridge platform.
• Improved Stability