Eclair Build Configuration - Revision history

Raf: +Build Configuration

2011-06-11T20:01:30Z

+Build Configuration

Raf: +Froyo Build Configuration

2011-06-11T19:59:29Z

+Froyo Build Configuration

Stinebd: Reverted edits by Ocyjytu (talk) to last revision by Stinebd

2010-11-24T03:15:11Z

Reverted edits by Ocyjytu (talk) to last revision by Stinebd

Ocyjytu at 02:42, 24 November 2010

2010-11-24T02:42:04Z

Stinebd: Created page with 'With the XDAndroid source checked out, the build system must be configured to build an XDAndroid product for one of the supported targets. Build system conf…'

2010-07-14T02:27:25Z

Created page with 'With the XDAndroid source checked out, the build system must be configured to build an XDAndroid product for one of the supported targets. Build system conf…'

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 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 := xdandroid_msm_us
TARGET_BUILD_VARIANT := eng
TARGET_BUILD_TYPE := release</syntaxhighlight>

The following table outlines some optional <tt>buildspec.mk</tt> flags which are used often.

{|class="slimtable"
!Variable
!Effect
|-
|<tt>USE_GOOGLE_APPS := true</tt>
|Add extracted, proprietary Google apps to the system image.
|-
|<tt>KITCHEN_BUILD := true</tt>
|Add absolutely no proprietary bits to the system image. Used for kitchen base images.
|-
|<tt>WITH_JIT := true</tt>
|Enable the Just-in-Time compiler for the Dalvik VM.
|-
|<tt>TARGET_USERIMAGES_USE_EXT2 := true</tt>
|Build an ext2 system image (currently needed along with KITCHEN_BUILD for kitchen base images).
|}

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>froyo</tt> branch, please see [[Froyo Build Configuration]].</div>		<div class="warning">'''NOTE''' For build configuration options for the <tt>froyo</tt> branch, please see [[Froyo 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.

← Older revision		Revision as of 19:59, 11 June 2011
Line 1:		Line 1:
	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>.		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>.
		+
		+	<div class="warning">'''NOTE''' For build configuration options for the <tt>froyo</tt> branch, please see [[Froyo 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.

@@ Line 1: / Line 1: @@
-----
+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 Android build system will use &lt;tt>buildspec.mk&lt;/tt> to pass a variety of variables to the &lt;tt>make&lt;/tt> program which parses all of the Makefile recipes that comprise the build system. Most of the variables supported by &lt;tt>buildspec.mk&lt;/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.
 ==Build System Configuration==
-Simply create a blank plain-text file in the root of your XDAndroid source tree. Name the file &lt;tt>buildspec.mk&lt;/tt> and edit it with your preferred text editor.
+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 &lt;tt>buildspec.mk&lt;/tt>...
+To instruct the build system to generate an XDAndroid system image, the following variables '''must''' be defined in <tt>buildspec.mk</tt>...
-&lt;syntaxhighlight lang="make"># Configure for an XDAndroid release engineering target.
+<syntaxhighlight lang="make"># Configure for an XDAndroid release engineering target.
 TARGET_PRODUCT := xdandroid_msm_us
 TARGET_BUILD_VARIANT := eng
-TARGET_BUILD_TYPE := release&lt;/syntaxhighlight>
+TARGET_BUILD_TYPE := release</syntaxhighlight>
-The following table outlines some optional &lt;tt>buildspec.mk&lt;/tt> flags which are used often.
+The following table outlines some optional <tt>buildspec.mk</tt> flags which are used often.
 {|class="slimtable"
@@ Line 29: / Line 21: @@
 !Effect
 |-
-|&lt;tt>USE_GOOGLE_APPS := true&lt;/tt>
+|<tt>USE_GOOGLE_APPS := true</tt>
 |Add extracted, proprietary Google apps to the system image.
 |-
-|&lt;tt>KITCHEN_BUILD := true&lt;/tt>
+|<tt>KITCHEN_BUILD := true</tt>
 |Add absolutely no proprietary bits to the system image. Used for kitchen base images.
 |-
-|&lt;tt>WITH_JIT := true&lt;/tt>
+|<tt>WITH_JIT := true</tt>
 |Enable the Just-in-Time compiler for the Dalvik VM.
 |-
-|&lt;tt>TARGET_USERIMAGES_USE_EXT2 := true&lt;/tt>
+|<tt>TARGET_USERIMAGES_USE_EXT2 := true</tt>
 |Build an ext2 system image (currently needed along with KITCHEN_BUILD for kitchen base images).
 |}
-After completing the build configuration and saving the &lt;tt>buildspec.mk&lt;/tt> file, you can proceed with [[Building and Packaging]] the system.
+After completing the build configuration and saving the <tt>buildspec.mk</tt> file, you can proceed with [[Building and Packaging]] the system.