Intel® Atom™ x86 Image for Android* Gingerbread Installation Instructions - Recommended

Introduction

This document will guide you through installing the Intel® Atom™ x86 image for Android* Gingerbread, which can be used for development on Intel’s x86 architecture. The steps presented below are the same, regardless of the OS.

Prerequisites

The Android x86 Emulator Image requires the Android SDK to be installed. For instructions on installing and configuring the Android SDK, refer to the Android developer website ( http://developer.android.com/sdk/ ).

The x86 Emulator Image for Android can be accelerated using Intel Hardware Accelerated Execution Manager (HAXM). For more information, refer to the “Optimization” section of this document.

Installation

Downloading through Android SDK Manager

Start the Android SDK Manager program.

Under Android 2.3.3 (API 10), select “Intel x86 Atom System Image”:

Once selected, click on the "Install package" button.

Review the Intel Corporation license agreement. If you accept the terms, select the "Accept" option and click on the "Install" button.

At this point, the Android SDK Manager will download and install the system image to your Android SDK folder (<sdk>/system-images/android-10/default/x86/). The download and install will take several minutes, depending on your connection speed.

Verify that the Intel x86 Atom System Image is shown as "Installed" under the Status column, as shown below:

Using the System Image

  1. Start the Android AVD Manager
     

  2. Create a new AVD, setting “Target” to “Android 2.3.3 – API Level 10”, and “CPU/ABI” to “Intel Atom (x86)”:
     

  3. Once you select your configuration settings, click on the "OK" button.
     

  4. The new virtual device should appear on the Android Virtual Device Manager. Select the new device and click on the "Start..." button, as shown below:
     

  5. The Launch Options window should appear. Select the screen size and dpi for your system. Otherwise, the emulator might exceed the dimensions of your viewing screen. Click on the "Launch" button, as shown below:
     

  6. After a few moments, the emulator should launch and you should see the screen below:
     

Optimization

CPU Acceleration

The performance of the x86 Image for Android GingerBread can be improved with hardware-based virtualization using Intel VT-x technology. If your computer has an Intel processor with VT-x support, it is recommended that Intel Hardware Acceleration Execution Manager (HAXM) be used in conjunction with this system image. For more information about Intel HAXM, visit http://www.intel.com/software/android.

Note: Intel HAXM is for Windows and OS X operating systems only. For Linux hosts, Kernel-based Virtual Machine (KVM) can be used to accelerate emulation performance. For information on installing and configuring KVM on Ubuntu, refer to this guide: https://help.ubuntu.com/community/KVM/Installation

GPU Acceleration

The Intel Atom x86 Image for Android Gingerbread can make use of hardware GPU features to increase the performance of games, graphics-intensive programs, and user interface elements.

Note: The functionality and performance of GPU acceleration is highly dependent on your computer’s graphics card and graphics drivers.

To use hardware GPU acceleration, perform these steps:

  1. Open the Android AVD Manager.
  2. Select the AVD and click the “Edit” button.
  3. The AVD editor window will appear. In the Emulator Options section, check the “Use Host GPU” option:


     
  4. Click the “OK” button to save the AVD.
  5. After the AVD has been modified, a dialog box will appear confirming the AVD settings:


     

    In the confirmation dialog, the “hw.gpu.enabled=yes” line indicates that GPU acceleration is enabled for that particular AVD.
    Note: The GPU acceleration must be enabled on a per-AVD basis.

    Copyright (C) 2012 Intel Corporation. All rights reserved.

    Intel, Atom, and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.

    All products, computer systems, dates, and figures specified are preliminary based on current expectations, and are subject to change without notice.

    * Other names and brands may be claimed as the property of others.

For further instructions on how to use the Android Emulator, visit: http://developer.android.com/guide/developing/devices/emulator.html

For more complete information about compiler optimizations, see our Optimization Notice.

17 comments

Top
Bevan T.'s picture

Please review these procedures for the latest versions of the Android SDK and AVD Manager (Revision: 22.3) as I am currently unable to identify any of the Intel x86 Atom System Images in the AVD Target list (as per point 10 above), and I have the complete list of options loaded from the SDK Manager with the exception of the Google TV addon which is not available for Windows in API12.

My OS is Windows 8 Professional.

 

anonymous's picture

This image does not work with gpu emulation on - with gpu off it works fine.

I tried x86 atom Api-15 image with gpu on that works, but not the Api-10 image. Any ideas ?
Thanks,
Ahmed

anonymous's picture

AVD can't work with Haxm under Windows XP with either the following error (running under non-privileged user):
Starting emulator for AVD 'My_Test_Android_x86_Atom'
emulator: device fd:1648
HAX is not working and emulator runs in emulation mode
emulator: Open the vm devcie error:\\.\hax_vm00, ec:2
emulator: Open vm device error:(null)
emulator: Failed to create HAX VM

or with message below (running under Administrator):
Starting emulator for AVD 'My_Test_Android_x86_Atom'
emulator: device fd:1712
HAX is not working and emulator runs in emulation mode
emulator: error code:31
emulator: Failed to create vm ffffffff
emulator: Failed to create HAX VM

intelhaxm is running:

sc query intelhaxm

SERVICE_NAME: intelhaxm
TYPE : 1 KERNEL_DRIVER
STATE : 4 RUNNING
(STOPPABLE,NOT_PAUSABLE,IGNORES_SHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0

Android 4.0.3 level 15
image for Atom x86
Windows XP sp3, 32bit, all the latest updates
HAXM installed w/o any problems

Tao W. (Intel)'s picture

Hello, we upgraded our site to IDZ ( Intel Developer Zone) last month. During this transition, there may be inconveniences for developers to post comments. These inconvenience will be resolved shortly. Thanks

anonymous's picture

When I originally commented I clicked that the -Notify me when new comments are added- checkbox and already if a comment is added I get four emails with that the exact same comment. Possibly there is by any other system you are able to remove me from that service? Thanks!

anonymous's picture

I have the same issue reported by jaxx. Everytime I try and install this using the SDK Manager, the download gets stuck at some point.

anonymous's picture

why this install/download ALLWAYS failing.. it stops for me at 5 - 25% ...
how big is the download and why does it always fail ???

anonymous's picture

Hi Hernan, any word on the 4.0 image?

hernan-alijo (Intel)'s picture

Hi Philippe! KVM is available for Linux. See if this doc helps you: http://intel.ly/HVY9o0
And there's also more information on installing the HAXM on different OSs here: http://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager/

hernan-alijo (Intel)'s picture

Hi Tshung! An x86 ICS system image for emulation will be available soon. Please, stay tune.

Pages

Add a Comment

Have a technical question? Visit our forums. Have site or software product issues? Contact support.