Android Build System - Revision history

Tim Bird: Add notes about kernel build tools in AOSP

2012-05-22T23:14:33Z

Add notes about kernel build tools in AOSP

Fmaker at 23:15, 14 September 2011

2011-09-14T23:15:53Z

Tim Bird: /* Steps for adding a new program to the Android source tree */

2011-07-21T17:57:06Z

‎Steps for adding a new program to the Android source tree

VU3RDD: A few minor edits to clarify the targets provided by Android build system

2011-05-02T14:11:40Z

A few minor edits to clarify the targets provided by Android build system

Tim Bird: /* Steps for adding a new program to the Android source tree */

2011-03-08T22:35:41Z

‎Steps for adding a new program to the Android source tree

Tim Bird: /* Steps for adding a new program to the Android source tree */

2010-10-21T23:19:26Z

‎Steps for adding a new program to the Android source tree

Tim Bird: /* Specifying what to build */ fix url wrap problem

2010-10-16T01:19:37Z

‎Specifying what to build: fix url wrap problem

Tim Bird: /* Specifying what to build */ update codepainters url

2010-10-16T01:18:22Z

‎Specifying what to build: update codepainters url

Tim Bird: /* Seeing the actual commands used to build the software */

2010-09-20T22:08:39Z

‎Seeing the actual commands used to build the software

Tim Bird: add steps for adding a new native arm program to the build

2010-09-02T21:00:11Z

add steps for adding a new native arm program to the build

← Older revision		Revision as of 23:14, 22 May 2012
Line 207:		Line 207:

	See http://www.aton.com/android-native-development-using-the-android-open-source-project/ for a lot more detail.		See http://www.aton.com/android-native-development-using-the-android-open-source-project/ for a lot more detail.
		+
		+	== Building the kernel ==
		+	The kernel is "outside" of the normal Android build system (indeed, the kernel is not included by default in the Android Open Source Project). However, there are tools in AOSP for building a kernel.
		+	If you are building the kernel, start on this page: http://source.android.com/source/building-kernels.html
		+
		+	If you are building the kernel for the emulator, you may also want to look at:
		+	http://stackoverflow.com/questions/1809774/android-kernel-compile-and-test-with-android-emulator
		+
		+	And, Ron M wrote (on the android-kernel mailing list, on May 21, 2012):
		+
		+	This post is very old - but nothing has changes as far as AOSP is concerned, so
		+	in case anyone is interested and runs into this problem when building for QEMU:
		+
		+	There is actually a nice and shorter way to build the kernel for your QEMU
		+	target provided by the AOSP:
		+
		+	1. cd to your kernel source dir (Only goldfish 2.6.29 works out of the box for the emulator)
		+
		+	2. ${ANDROID_BUILD_TOP}/external/qemu/distrib/build-kernel.sh -j=64 --arch=x86 --out=$YourOutDir
		+
		+	3. emulator -kernel ${YourOutDir}/kernel-qemu # run emulator:
		+
		+
		+	Step #2 calls the toolbox.sh wrapper scripts which works around the SSE
		+	disabling gcc warning - which happens for GCC < 4.5 (as in the AOSP prebuilt X86
		+	toolchain).
		+
		+	This script adds the " -mfpmath=387 -fno-pic" in case it is an X86 and that in
		+	turn eliminates the compilation errors seen above.
		+
		+	To have finer control over the build process, you can use the "toolbox.sh"
		+	wrapper and set some other stuff without modifying the script files.
		+
		+	An example for building the same emulator is below:
		+
		+	# Set arch
		+	export ARCH=x86
		+	# Have make refer to the QEMU wrapper script for building android over x86
		+	(eliminates the errors listed above)
		+	export
		+	CROSS_COMPILE=${ANDROID_BUILD_TOP}/external/qemu/distrib/kernel-toolchain/android-kernel-toolchain-
		+	# Put your cross compiler here. I am using the AOSP prebuilt one in this example
		+	export
		+	REAL_CROSS_COMPILE=${ANDROID_BUILD_TOP}/prebuilt/linux-x86/toolchain/i686-android-linux-4.4.3/bin/i686-android-linux-
		+	# Configure your kernel - here I am taking the default goldfish_defconfig
		+	make goldfish_defconfig
		+	# build
		+	make -j64
		+	# Run emulator:
		+	emulator -kernel arch/x86/boot/bzImage -show-kernel
		+
		+
		+	This works for the 2.6.29 goldfish branch. If anyone is using the emulator with
		+	a 3+ kernel I would be like to hear about it.
		+

	[[Category:Android]]		[[Category:Android]]

← Older revision		Revision as of 23:15, 14 September 2011
Line 1:		Line 1:
−	Basics of the Android Build system ~~are~~ described at:	+	Basics of the Android Build system were described at ('''Down as of 9/2011'''):
	http://source.android.com/porting/build_system.html		http://source.android.com/porting/build_system.html

@@ Line 203: / Line 203: @@
 * add the directory name in ANDROID/build/core/main.mk  after external/zlib as external/myprogram
 * make from the root of the source tree
 See http://www.aton.com/android-native-development-using-the-android-open-source-project/ for a lot more detail.
 [[Category:Android]]

@@ Line 126: / Line 126: @@
 * make all - make everything, whether it is included in the product definition or not
 * make clean - remove all built files (prepare for a new build). Same as rm -rf out/<configuration>/
-* make targets - should show a list of targets, but it doesn't for me on eclair
+* make modules - shows a list of submodules that can be built (List of all LOCAL_MODULE definitions)
-* make <local_module> - make a specific module
+* make <local_module> - make a specific module (note that this is not the same as directory name. It is the LOCAL_MODULE definition in the Android.mk file)
 * make clean-<local_module> - clean a specific module

@@ Line 203: / Line 203: @@
 * add the directory name in ANDROID/build/core/main.mk  after external/zlib as external/myprogram
 * make from the root of the source tree
 [[Category:Android]]

@@ Line 196: / Line 196: @@
 == Adding a new program to build ==
 === Steps for adding a new program to the Android source tree ===
-# make a directory under 'external'
+* make a directory under 'external'
 ** e.g. ANDROID/external/myprogram
-# create your C/cpp files.
+* create your C/cpp files.
-# create Android.mk as clone of external/ping/Android.mk
+* create Android.mk as clone of external/ping/Android.mk
-# Change the names ping.c and ping to match your C/cpp files and program name
+* Change the names ping.c and ping to match your C/cpp files and program name
-# add the directory name in ANDROID/build/core/main.mk  after external/zlib as external/myprogram
+* add the directory name in ANDROID/build/core/main.mk  after external/zlib as external/myprogram
-# make from the root of the source tree
+* make from the root of the source tree
 [[Category:Android]]

@@ Line 97: / Line 97: @@
 Descriptions of these different build variants are at http://source.android.com/porting/build_system.html#androidBuildVariants
-The build process from a user perspective is described pretty well in this blog post: [http://blog.codepainters.com/2009/12/18/first-android-platform-build/
+The build process from a user perspective is described pretty well in this blog post: [http://blog.codepainters.com/2009/12/18/first-android-platform-build/ First Android platform build] by CodePainters, December 2009
- First Android platform build] by CodePainters, December 2009
 === Actually building the system ===

@@ Line 112: / Line 112: @@
 This can be used in conjunction with another make target, to see the commands for that build.
 That is, 'showcommands' is not a target itself, but just a modifier for the specified build.
 === Make targets ===