Raf: +Build Configuration

2011-06-11T20:01:01Z

Stinebd: Transitional page.

2011-02-05T03:39:26Z

Transitional page.

New page

With the XDAndroid source checked out, the build system must be configured to build an XDAndroid product for one of the [[Supported Devices|supported targets]]. Build system configuration is done via a single file in the root of the XDAndroid source tree whose name is <tt>buildspec.mk</tt>. The following configuration documentation applies to <tt>froyo</tt> and later branches.

<div class="warning">'''NOTE''' For build configuration options for the <tt>eclair</tt> branch, please see [[Eclair Build Configuration]].</div>

The Android build system will use <tt>buildspec.mk</tt> to pass a variety of variables to the <tt>make</tt> program which parses all of the Makefile recipes that comprise the build system. Most of the variables supported by <tt>buildspec.mk</tt> are self-explanatory, especially after becoming familiar with the basics of an Android system.

==Build System Configuration==
Simply create a blank plain-text file in the root of your XDAndroid source tree. Name the file <tt>buildspec.mk</tt> and edit it with your preferred text editor.

Variables are each defined on their own single line. Similar to other configuration files, anything which proceeds a pound sign (#) is ignored as a comment.

To instruct the build system to generate an XDAndroid system image, the following variables '''must''' be defined in <tt>buildspec.mk</tt>...

<syntaxhighlight lang="make"># Configure for an XDAndroid release engineering target.
TARGET_PRODUCT := full_msm
TARGET_BUILD_VARIANT := eng
TARGET_BUILD_TYPE := release
TARGET_USERIMAGES_USE_EXT2 := true</syntaxhighlight>

The final line in the above example, which enables <tt>TARGET_USERIMAGES_USE_EXT2</tt>, will have the Android build system generate ext2 filesystems. On the live device, these filesystems are mounted writable. The XDAndroid boot process supports an ext2-based system partition image, named <tt>system.ext2</tt> on the SD card. This is highly recommended.

After completing the build configuration and saving the <tt>buildspec.mk</tt> file, you can proceed with [[Building and Packaging]] the system.

← Older revision		Revision as of 20:01, 11 June 2011
Line 2:		Line 2:

	<div class="warning">'''NOTE''' For build configuration options for the <tt>eclair</tt> branch, please see [[Eclair Build Configuration]].</div>		<div class="warning">'''NOTE''' For build configuration options for the <tt>eclair</tt> branch, please see [[Eclair Build Configuration]].</div>
		+	<div class="warning">'''NOTE''' For build configuration options for the <tt>gingerbread</tt> branch, please see [[Build Configuration]].</div>

	The Android build system will use <tt>buildspec.mk</tt> to pass a variety of variables to the <tt>make</tt> program which parses all of the Makefile recipes that comprise the build system. Most of the variables supported by <tt>buildspec.mk</tt> are self-explanatory, especially after becoming familiar with the basics of an Android system.		The Android build system will use <tt>buildspec.mk</tt> to pass a variety of variables to the <tt>make</tt> program which parses all of the Makefile recipes that comprise the build system. Most of the variables supported by <tt>buildspec.mk</tt> are self-explanatory, especially after becoming familiar with the basics of an Android system.

Froyo Build Configuration - Revision history

Raf: +Build Configuration

Stinebd: Transitional page.