Run Android on your PC

Add new target

The article describes how to create a target for your own device under Android-x86. Rewritten from the e-mail Chih-wei Huang sent to android-x86 discussion group.

Create a directory

First, you have to create a directory to hold all stuff specific for your target device.

mkdir vendor/xxx/yyy
mkdir device/xxx/yyy
where xxx is usually the vendor's name and yyy is the product name. Historically, we used the vendor/ directory. However, Google suggested to use device/ since Froyo. We encourage to use the new convention device/ as AOSP does.

Create makefiles

At least you have to create four makefiles in the new directory:

This makefile should only contain PRODUCT_MAKEFILES which is a list of product makefiles to expose to the build system. So if your product name is yyy, it is


The product makefile:

You have to define PRODUCT_PACKAGES, PRODUCT_NAME, PRODUCT_DEVICE in it, and call inherit-product to inherit from a product makefile. I suggest to to inherit to get all common x86 rules.

$(call inherit-product,$(SRC_TARGET_DIR)/product/

The board config makefile:

You can override some variables before including $(GENERIC_X86_CONFIG_MK)

set to true if you hope to compile third party apps like ConnectBot, FileManager introduced by Android-x86.
Default: false

Set to false if you don't want ALSA audio.
Default: true.

If you don't need bluetooth, set it to false.
Default: true.

Set to true if you need tslib to calibrate the touchscreen.
Default: false

You can customize your cmdline (kernel boot options)

Set to true if you need wifi support

The android board makefile:

You can override some variables before including


The variables are:
Specify the firmwares to be included in the target. The firmwares are supposed to be already in build/target/board/generic_x86/firmware/.
You may also specify a different directory in LOCAL_FIRMWARES_DIR

Specify a hook script to be added in the initrd.img. Usually the script should contain a detect_hardware function that will be called by the init script.
Read eeepc_info as an implementation example.

If you want to include some prebuilt apps (apk files), set them to this variable.

Specify a kernel config file for this target. If not set, the default android-x86_defconfig will be used.

Besides the four makefiles, you may also add the file init.yyy.rc to do some initializations for your product
The file will be included automatically if exists,and called by Android init on booting(after executing init.rc).