main.mk revision c048c9b598b36dc7506a954cc0d3d80f308b1b13
1# Only use ANDROID_BUILD_SHELL to wrap around bash.
2# DO NOT use other shells such as zsh.
3ifdef ANDROID_BUILD_SHELL
4SHELL := $(ANDROID_BUILD_SHELL)
5else
6# Use bash, not whatever shell somebody has installed as /bin/sh
7# This is repeated in config.mk, since envsetup.sh runs that file
8# directly.
9SHELL := /bin/bash
10endif
11
12# this turns off the suffix rules built into make
13.SUFFIXES:
14
15# If a rule fails, delete $@.
16.DELETE_ON_ERROR:
17
18# Figure out where we are.
19#TOP := $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))
20#TOP := $(patsubst %/,%,$(TOP))
21
22# TOPDIR is the normal variable you should use, because
23# if we are executing relative to the current directory
24# it can be "", whereas TOP must be "." which causes
25# pattern matching probles when make strips off the
26# trailing "./" from paths in various places.
27#ifeq ($(TOP),.)
28#TOPDIR :=
29#else
30#TOPDIR := $(TOP)/
31#endif
32
33# check for broken versions of make
34ifeq (0,$(shell expr $$(echo $(MAKE_VERSION) | sed "s/[^0-9\.].*//") \>= 3.81))
35$(warning ********************************************************************************)
36$(warning *  You are using version $(MAKE_VERSION) of make.)
37$(warning *  You must upgrade to version 3.81 or greater.)
38$(warning *  see file://$(shell pwd)/docs/development-environment/machine-setup.html)
39$(warning ********************************************************************************)
40$(error stopping)
41endif
42
43TOP := .
44TOPDIR :=
45
46BUILD_SYSTEM := $(TOPDIR)build/core
47
48# This is the default target.  It must be the first declared target.
49.PHONY: droid
50DEFAULT_GOAL := droid
51$(DEFAULT_GOAL):
52
53# Set up various standard variables based on configuration
54# and host information.
55include $(BUILD_SYSTEM)/config.mk
56
57# This allows us to force a clean build - included after the config.make
58# environment setup is done, but before we generate any dependencies.  This
59# file does the rm -rf inline so the deps which are all done below will
60# be generated correctly
61include $(BUILD_SYSTEM)/cleanbuild.mk
62
63VERSION_CHECK_SEQUENCE_NUMBER := 1
64-include $(OUT_DIR)/versions_checked.mk
65ifneq ($(VERSION_CHECK_SEQUENCE_NUMBER),$(VERSIONS_CHECKED))
66
67$(info Checking build tools versions...)
68
69ifneq ($(HOST_OS),windows)
70ifneq ($(HOST_OS)-$(HOST_ARCH),darwin-ppc)
71# check for a case sensitive file system
72ifneq (a,$(shell mkdir -p $(OUT_DIR) ; \
73                echo a > $(OUT_DIR)/casecheck.txt; \
74                    echo B > $(OUT_DIR)/CaseCheck.txt; \
75                cat $(OUT_DIR)/casecheck.txt))
76$(warning ************************************************************)
77$(warning You are building on a case-insensitive filesystem.)
78$(warning Please move your source tree to a case-sensitive filesystem.)
79$(warning ************************************************************)
80$(error Case-insensitive filesystems not supported)
81endif
82endif
83endif
84
85# Make sure that there are no spaces in the absolute path; the
86# build system can't deal with them.
87ifneq ($(words $(shell pwd)),1)
88$(warning ************************************************************)
89$(warning You are building in a directory whose absolute path contains)
90$(warning a space character:)
91$(warning $(space))
92$(warning "$(shell pwd)")
93$(warning $(space))
94$(warning Please move your source tree to a path that does not contain)
95$(warning any spaces.)
96$(warning ************************************************************)
97$(error Directory names containing spaces not supported)
98endif
99
100
101# The windows build server currently uses 1.6.  This will be fixed.
102ifneq ($(HOST_OS),windows)
103
104# Check for the correct version of java
105java_version := $(shell java -version 2>&1 | head -n 1 | grep '[ "]1\.5[\. "$$]')
106ifeq ($(strip $(java_version)),)
107$(info ************************************************************)
108$(info You are attempting to build with the incorrect version)
109$(info of java.)
110$(info $(space))
111$(info Your version is: $(shell java -version 2>&1 | head -n 1).)
112$(info The correct version is: 1.5.)
113$(info $(space))
114$(info Please follow the machine setup instructions at)
115$(info $(space)$(space)$(space)$(space)http://source.android.com/download)
116$(info ************************************************************)
117$(error stop)
118endif
119
120# Check for the correct version of javac
121javac_version := $(shell javac -version 2>&1 | head -n 1 | grep '[ "]1\.5[\. "$$]')
122ifeq ($(strip $(javac_version)),)
123$(info ************************************************************)
124$(info You are attempting to build with the incorrect version)
125$(info of javac.)
126$(info $(space))
127$(info Your version is: $(shell javac -version 2>&1 | head -n 1).)
128$(info The correct version is: 1.5.)
129$(info $(space))
130$(info Please follow the machine setup instructions at)
131$(info $(space)$(space)$(space)$(space)http://source.android.com/download)
132$(info ************************************************************)
133$(error stop)
134endif
135
136endif # windows
137
138$(shell echo 'VERSIONS_CHECKED := $(VERSION_CHECK_SEQUENCE_NUMBER)' \
139        > $(OUT_DIR)/versions_checked.mk)
140endif
141
142# These are the modifier targets that don't do anything themselves, but
143# change the behavior of the build.
144# (must be defined before including definitions.make)
145INTERNAL_MODIFIER_TARGETS := showcommands checkbuild
146
147# Bring in standard build system definitions.
148include $(BUILD_SYSTEM)/definitions.mk
149
150ifneq ($(filter eng user userdebug tests,$(MAKECMDGOALS)),)
151$(info ***************************************************************)
152$(info ***************************************************************)
153$(info Don't pass '$(filter eng user userdebug tests,$(MAKECMDGOALS))' on \
154		the make command line.)
155# XXX The single quote on this line fixes gvim's syntax highlighting.
156# Without which, the rest of this file is impossible to read.
157$(info Set TARGET_BUILD_VARIANT in buildspec.mk, or use lunch or)
158$(info choosecombo.)
159$(info ***************************************************************)
160$(info ***************************************************************)
161$(error stopping)
162endif
163
164ifneq ($(filter-out $(INTERNAL_VALID_VARIANTS),$(TARGET_BUILD_VARIANT)),)
165$(info ***************************************************************)
166$(info ***************************************************************)
167$(info Invalid variant: $(TARGET_BUILD_VARIANT)
168$(info Valid values are: $(INTERNAL_VALID_VARIANTS)
169$(info ***************************************************************)
170$(info ***************************************************************)
171$(error stopping)
172endif
173
174###
175### In this section we set up the things that are different
176### between the build variants
177###
178
179is_sdk_build :=
180ifneq ($(filter sdk,$(MAKECMDGOALS)),)
181is_sdk_build := true
182endif
183ifneq ($(filter win_sdk,$(MAKECMDGOALS)),)
184is_sdk_build := true
185endif
186ifneq ($(filter sdk_addon,$(MAKECMDGOALS)),)
187is_sdk_build := true
188endif
189
190
191## user/userdebug ##
192
193user_variant := $(filter userdebug user,$(TARGET_BUILD_VARIANT))
194enable_target_debugging := true
195ifneq (,$(user_variant))
196  # Target is secure in user builds.
197  ADDITIONAL_DEFAULT_PROPERTIES += ro.secure=1
198
199  tags_to_install := user
200  ifeq ($(user_variant),userdebug)
201    # Pick up some extra useful tools
202    tags_to_install += debug
203
204    # Enable Dalvik lock contention logging for userdebug builds.
205    ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.lockprof.threshold=500
206  else
207    # Disable debugging in plain user builds.
208    enable_target_debugging :=
209  endif
210 
211  # TODO: Always set WITH_DEXPREOPT (for user builds) once it works on OSX.
212  # Also, remove the corresponding block in config/product_config.make.
213  ifeq ($(HOST_OS)-$(WITH_DEXPREOPT_buildbot),linux-true)
214    WITH_DEXPREOPT := true
215  endif
216  
217  # Disallow mock locations by default for user builds
218  ADDITIONAL_DEFAULT_PROPERTIES += ro.allow.mock.location=0
219  
220else # !user_variant
221  # Turn on checkjni for non-user builds.
222  ADDITIONAL_BUILD_PROPERTIES += ro.kernel.android.checkjni=1
223  # Set device insecure for non-user builds.
224  ADDITIONAL_DEFAULT_PROPERTIES += ro.secure=0
225  # Allow mock locations by default for non user builds
226  ADDITIONAL_DEFAULT_PROPERTIES += ro.allow.mock.location=1
227endif # !user_variant
228
229ifeq (true,$(strip $(enable_target_debugging)))
230  # Target is more debuggable and adbd is on by default
231  ADDITIONAL_DEFAULT_PROPERTIES += ro.debuggable=1 persist.service.adb.enable=1
232  # Include the debugging/testing OTA keys in this build.
233  INCLUDE_TEST_OTA_KEYS := true
234else # !enable_target_debugging
235  # Target is less debuggable and adbd is off by default
236  ADDITIONAL_DEFAULT_PROPERTIES += ro.debuggable=0 persist.service.adb.enable=0
237endif # !enable_target_debugging
238
239## eng ##
240
241ifeq ($(TARGET_BUILD_VARIANT),eng)
242tags_to_install := user debug eng
243  # Don't require the setup wizard on eng builds
244  ADDITIONAL_BUILD_PROPERTIES := $(filter-out ro.setupwizard.mode=%,\
245          $(call collapse-pairs, $(ADDITIONAL_BUILD_PROPERTIES))) \
246          ro.setupwizard.mode=OPTIONAL
247endif
248
249## tests ##
250
251ifeq ($(TARGET_BUILD_VARIANT),tests)
252tags_to_install := user debug eng tests
253endif
254
255## sdk ##
256
257ifdef is_sdk_build
258ifneq ($(words $(filter-out $(INTERNAL_MODIFIER_TARGETS),$(MAKECMDGOALS))),1)
259$(error The 'sdk' target may not be specified with any other targets)
260endif
261
262# TODO: this should be eng I think.  Since the sdk is built from the eng
263# variant.
264tags_to_install := user debug eng
265ADDITIONAL_BUILD_PROPERTIES += xmpp.auto-presence=true
266ADDITIONAL_BUILD_PROPERTIES += ro.config.nocheckin=yes
267else # !sdk
268endif
269
270# build the full stagefright library
271ifneq ($(strip BUILD_WITH_FULL_STAGEFRIGHT),)
272BUILD_WITH_FULL_STAGEFRIGHT := true
273endif
274
275## precise GC ##
276
277ifneq ($(filter dalvik.gc.type-precise,$(PRODUCT_TAGS)),)
278  # Enabling type-precise GC results in larger optimized DEX files.  The
279  # additional storage requirements for ".odex" files can cause /system
280  # to overflow on some devices, so this is configured separately for
281  # each product.
282  ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.dexopt-flags=m=y
283endif
284
285# Install an apns-conf.xml file if one's not already being installed.
286ifeq (,$(filter %:system/etc/apns-conf.xml, $(PRODUCT_COPY_FILES)))
287  PRODUCT_COPY_FILES += \
288        development/data/etc/apns-conf_sdk.xml:system/etc/apns-conf.xml
289  ifeq ($(filter eng tests,$(TARGET_BUILD_VARIANT)),)
290    $(warning implicitly installing apns-conf_sdk.xml)
291  endif
292endif
293# If we're on an eng or tests build, but not on the sdk, and we have
294# a better one, use that instead.
295ifneq ($(filter eng tests,$(TARGET_BUILD_VARIANT)),)
296  ifndef is_sdk_build
297    apns_to_use := $(wildcard vendor/google/etc/apns-conf.xml)
298    ifneq ($(strip $(apns_to_use)),)
299      PRODUCT_COPY_FILES := \
300            $(filter-out %:system/etc/apns-conf.xml,$(PRODUCT_COPY_FILES)) \
301            $(strip $(apns_to_use)):system/etc/apns-conf.xml
302    endif
303  endif
304endif
305
306ADDITIONAL_BUILD_PROPERTIES += net.bt.name=Android
307
308# enable vm tracing in files for now to help track
309# the cause of ANRs in the content process
310ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.stack-trace-file=/data/anr/traces.txt
311
312# ------------------------------------------------------------
313# Define a function that, given a list of module tags, returns
314# non-empty if that module should be installed in /system.
315
316# For most goals, anything not tagged with the "tests" tag should
317# be installed in /system.
318define should-install-to-system
319$(if $(filter tests,$(1)),,true)
320endef
321
322ifdef is_sdk_build
323# For the sdk goal, anything with the "samples" tag should be
324# installed in /data even if that module also has "eng"/"debug"/"user".
325define should-install-to-system
326$(if $(filter samples tests,$(1)),,true)
327endef
328endif
329
330
331# If they only used the modifier goals (showcommands, checkbuild), we'll actually
332# build the default target.
333ifeq ($(filter-out $(INTERNAL_MODIFIER_TARGETS),$(MAKECMDGOALS)),)
334.PHONY: $(INTERNAL_MODIFIER_TARGETS)
335$(INTERNAL_MODIFIER_TARGETS): $(DEFAULT_GOAL)
336endif
337
338# These targets are going to delete stuff, don't bother including
339# the whole directory tree if that's all we're going to do
340ifeq ($(MAKECMDGOALS),clean)
341dont_bother := true
342endif
343ifeq ($(MAKECMDGOALS),clobber)
344dont_bother := true
345endif
346ifeq ($(MAKECMDGOALS),dataclean)
347dont_bother := true
348endif
349ifeq ($(MAKECMDGOALS),installclean)
350dont_bother := true
351endif
352
353# Bring in all modules that need to be built.
354ifneq ($(dont_bother),true)
355
356ifeq ($(HOST_OS),windows)
357SDK_ONLY := true
358endif
359ifeq ($(HOST_OS)-$(HOST_ARCH),darwin-ppc)
360SDK_ONLY := true
361endif
362
363ifeq ($(SDK_ONLY),true)
364
365# ----- SDK for Windows ------
366# These configure the build targets that are available for the SDK under Cygwin.
367# The first section defines all the C/C++ tools that can be compiled under Cygwin,
368# the second section defines all the Java ones (assuming javac is available.)
369
370subdirs := \
371	prebuilt \
372	build/libs/host \
373	build/tools/zipalign \
374	dalvik/dexdump \
375	dalvik/libdex \
376	dalvik/tools/dmtracedump \
377	dalvik/tools/hprof-conv \
378	development/tools/line_endings \
379	development/tools/etc1tool \
380	sdk/emulator/mksdcard \
381	sdk/sdklauncher \
382	development/host \
383	external/expat \
384	external/libpng \
385	external/qemu \
386	external/sqlite/dist \
387	external/zlib \
388	frameworks/base/libs/utils \
389	frameworks/base/tools/aapt \
390	frameworks/base/tools/aidl \
391	frameworks/base/opengl/libs \
392	system/core/adb \
393	system/core/fastboot \
394	system/core/libcutils \
395	system/core/liblog \
396	system/core/libzipfile
397
398# The following can only be built if "javac" is available.
399# This check is used when building parts of the SDK under Cygwin.
400ifneq (,$(shell which javac 2>/dev/null))
401$(warning sdk-only: javac available.)
402subdirs += \
403	build/tools/signapk \
404	dalvik/dx \
405	dalvik/libcore \
406	sdk/archquery \
407	sdk/androidprefs \
408	sdk/apkbuilder \
409	sdk/jarutils \
410	sdk/layoutlib_api \
411	sdk/layoutlib_utils \
412	sdk/ninepatch \
413	sdk/sdkstats \
414	sdk/sdkmanager \
415	sdk/layoutopt \
416	development/apps \
417	development/tools/mkstubs \
418	frameworks/base/tools/layoutlib \
419	packages
420else
421$(warning sdk-only: javac not available.)
422endif
423
424# Exclude tools/acp when cross-compiling windows under linux
425ifeq ($(findstring Linux,$(UNAME)),)
426subdirs += build/tools/acp
427endif
428
429else	# !SDK_ONLY
430ifeq ($(BUILD_TINY_ANDROID), true)
431
432# TINY_ANDROID is a super-minimal build configuration, handy for board 
433# bringup and very low level debugging
434
435subdirs := \
436	bionic \
437	system/core \
438	build/libs \
439	build/target \
440	build/tools/acp \
441	build/tools/apriori \
442	build/tools/kcm \
443	build/tools/soslim \
444	external/elfcopy \
445	external/elfutils \
446	external/yaffs2 \
447	external/zlib
448else	# !BUILD_TINY_ANDROID
449
450#
451# Typical build; include any Android.mk files we can find.
452#
453subdirs := $(TOP)
454
455FULL_BUILD := true
456
457endif	# !BUILD_TINY_ANDROID
458
459endif	# !SDK_ONLY
460
461ifneq ($(ONE_SHOT_MAKEFILE),)
462# We've probably been invoked by the "mm" shell function
463# with a subdirectory's makefile.
464include $(ONE_SHOT_MAKEFILE)
465# Change CUSTOM_MODULES to include only modules that were
466# defined by this makefile; this will install all of those
467# modules as a side-effect.  Do this after including ONE_SHOT_MAKEFILE
468# so that the modules will be installed in the same place they
469# would have been with a normal make.
470CUSTOM_MODULES := $(sort $(call get-tagged-modules,$(ALL_MODULE_TAGS)))
471FULL_BUILD :=
472# Stub out the notice targets, which probably aren't defined
473# when using ONE_SHOT_MAKEFILE.
474NOTICE-HOST-%: ;
475NOTICE-TARGET-%: ;
476
477else # ONE_SHOT_MAKEFILE
478
479#
480# Include all of the makefiles in the system
481#
482
483# Can't use first-makefiles-under here because
484# --mindepth=2 makes the prunes not work.
485subdir_makefiles := \
486	$(shell build/tools/findleaves.py --prune=out --prune=.repo --prune=.git $(subdirs) Android.mk)
487
488include $(subdir_makefiles)
489endif # ONE_SHOT_MAKEFILE
490
491# -------------------------------------------------------------------
492# All module makefiles have been included at this point.
493# -------------------------------------------------------------------
494
495# -------------------------------------------------------------------
496# Include any makefiles that must happen after the module makefiles
497# have been included.
498# TODO: have these files register themselves via a global var rather
499# than hard-coding the list here.
500ifdef FULL_BUILD
501  # Only include this during a full build, otherwise we can't be
502  # guaranteed that any policies were included.
503  -include frameworks/policies/base/PolicyConfig.mk
504endif
505
506# -------------------------------------------------------------------
507# Fix up CUSTOM_MODULES to refer to installed files rather than
508# just bare module names.  Leave unknown modules alone in case
509# they're actually full paths to a particular file.
510known_custom_modules := $(filter $(ALL_MODULES),$(CUSTOM_MODULES))
511unknown_custom_modules := $(filter-out $(ALL_MODULES),$(CUSTOM_MODULES))
512CUSTOM_MODULES := \
513	$(call module-installed-files,$(known_custom_modules)) \
514	$(unknown_custom_modules)
515
516# -------------------------------------------------------------------
517# Define dependencies for modules that require other modules.
518# This can only happen now, after we've read in all module makefiles.
519#
520# TODO: deal with the fact that a bare module name isn't
521# unambiguous enough.  Maybe declare short targets like
522# APPS:Quake or HOST:SHARED_LIBRARIES:libutils.
523# BUG: the system image won't know to depend on modules that are
524# brought in as requirements of other modules.
525define add-required-deps
526$(1): $(2)
527endef
528$(foreach m,$(ALL_MODULES), \
529  $(eval r := $(ALL_MODULES.$(m).REQUIRED)) \
530  $(if $(r), \
531    $(eval r := $(call module-installed-files,$(r))) \
532    $(eval $(call add-required-deps,$(ALL_MODULES.$(m).INSTALLED),$(r))) \
533   ) \
534 )
535m :=
536r :=
537add-required-deps :=
538
539# -------------------------------------------------------------------
540# Figure out our module sets.
541
542# Of the modules defined by the component makefiles,
543# determine what we actually want to build.
544Default_MODULES := $(sort $(ALL_DEFAULT_INSTALLED_MODULES) \
545                          $(CUSTOM_MODULES))
546# TODO: Remove the 3 places in the tree that use
547# ALL_DEFAULT_INSTALLED_MODULES and get rid of it from this list.
548
549ifdef FULL_BUILD
550  # The base list of modules to build for this product is specified
551  # by the appropriate product definition file, which was included
552  # by product_config.make.
553  user_PACKAGES := $(call module-installed-files, \
554                       $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES))
555  ifeq (0,1)
556    $(info user packages for $(TARGET_DEVICE) ($(INTERNAL_PRODUCT)):)
557    $(foreach p,$(user_PACKAGES),$(info :   $(p)))
558    $(error done)
559  endif
560else
561  # We're not doing a full build, and are probably only including
562  # a subset of the module makefiles.  Don't try to build any modules
563  # requested by the product, because we probably won't have rules
564  # to build them.
565  user_PACKAGES :=
566endif
567# Use tags to get the non-APPS user modules.  Use the product
568# definition files to get the APPS user modules.
569user_MODULES := $(sort $(call get-tagged-modules,user))
570user_MODULES := $(user_MODULES) $(user_PACKAGES)
571
572eng_MODULES := $(sort $(call get-tagged-modules,eng))
573debug_MODULES := $(sort $(call get-tagged-modules,debug))
574tests_MODULES := $(sort $(call get-tagged-modules,tests))
575
576ifeq ($(strip $(tags_to_install)),)
577$(error ASSERTION FAILED: tags_to_install should not be empty)
578endif
579modules_to_install := $(sort $(Default_MODULES) \
580          $(foreach tag,$(tags_to_install),$($(tag)_MODULES)))
581
582# Some packages may override others using LOCAL_OVERRIDES_PACKAGES.
583# Filter out (do not install) any overridden packages.
584overridden_packages := $(call get-package-overrides,$(modules_to_install))
585ifdef overridden_packages
586#  old_modules_to_install := $(modules_to_install)
587  modules_to_install := \
588      $(filter-out $(foreach p,$(overridden_packages),$(p) %/$(p).apk), \
589          $(modules_to_install))
590endif
591#$(error filtered out
592#           $(filter-out $(modules_to_install),$(old_modules_to_install)))
593
594# Don't include any GNU targets in the SDK.  It's ok (and necessary)
595# to build the host tools, but nothing that's going to be installed
596# on the target (including static libraries).
597ifdef is_sdk_build
598  target_gnu_MODULES := \
599              $(filter \
600                      $(TARGET_OUT_INTERMEDIATES)/% \
601                      $(TARGET_OUT)/% \
602                      $(TARGET_OUT_DATA)/%, \
603                              $(sort $(call get-tagged-modules,gnu)))
604  $(info Removing from sdk:)$(foreach d,$(target_gnu_MODULES),$(info : $(d)))
605  modules_to_install := \
606              $(filter-out $(target_gnu_MODULES),$(modules_to_install))
607endif
608
609
610# build/core/Makefile contains extra stuff that we don't want to pollute this
611# top-level makefile with.  It expects that ALL_DEFAULT_INSTALLED_MODULES
612# contains everything that's built during the current make, but it also further
613# extends ALL_DEFAULT_INSTALLED_MODULES.
614ALL_DEFAULT_INSTALLED_MODULES := $(modules_to_install)
615include $(BUILD_SYSTEM)/Makefile
616modules_to_install := $(sort $(ALL_DEFAULT_INSTALLED_MODULES))
617ALL_DEFAULT_INSTALLED_MODULES :=
618
619endif # dont_bother
620
621# These are additional goals that we build, in order to make sure that there
622# is as little code as possible in the tree that doesn't build.
623modules_to_check := $(foreach m,$(ALL_MODULES),$(ALL_MODULES.$(m).CHECKED))
624
625# If you would like to build all goals, and not skip any intermediate
626# steps, you can pass the "all" modifier goal on the commandline.
627ifneq ($(filter all,$(MAKECMDGOALS)),)
628modules_to_check += $(foreach m,$(ALL_MODULES),$(ALL_MODULES.$(m).BUILT))
629endif
630
631# for easier debugging
632modules_to_check := $(sort $(modules_to_check))
633#$(error modules_to_check $(modules_to_check))
634
635# -------------------------------------------------------------------
636# This is used to to get the ordering right, you can also use these,
637# but they're considered undocumented, so don't complain if their
638# behavior changes.
639.PHONY: prebuilt
640prebuilt: $(ALL_PREBUILT)
641
642# An internal target that depends on all copied headers
643# (see copy_headers.make).  Other targets that need the
644# headers to be copied first can depend on this target.
645.PHONY: all_copied_headers
646all_copied_headers: ;
647
648$(ALL_C_CPP_ETC_OBJECTS): | all_copied_headers
649
650# All the droid stuff, in directories
651.PHONY: files
652files: prebuilt \
653        $(modules_to_install) \
654        $(modules_to_check) \
655        $(INSTALLED_ANDROID_INFO_TXT_TARGET)
656
657# -------------------------------------------------------------------
658
659.PHONY: checkbuild
660checkbuild: $(modules_to_check)
661
662.PHONY: ramdisk
663ramdisk: $(INSTALLED_RAMDISK_TARGET)
664
665.PHONY: systemtarball
666systemtarball: $(INSTALLED_SYSTEMTARBALL_TARGET)
667
668.PHONY: userdataimage
669userdataimage: $(INSTALLED_USERDATAIMAGE_TARGET)
670
671.PHONY: userdatatarball
672userdatatarball: $(INSTALLED_USERDATATARBALL_TARGET)
673
674.PHONY: bootimage
675bootimage: $(INSTALLED_BOOTIMAGE_TARGET)
676
677ifeq ($(BUILD_TINY_ANDROID), true)
678INSTALLED_RECOVERYIMAGE_TARGET :=
679endif
680
681# Build files and then package it into the rom formats
682.PHONY: droidcore
683droidcore: files \
684	systemimage \
685	$(INSTALLED_BOOTIMAGE_TARGET) \
686	$(INSTALLED_RECOVERYIMAGE_TARGET) \
687	$(INSTALLED_USERDATAIMAGE_TARGET) \
688	$(INSTALLED_FILES_FILE)
689
690ifneq ($(TARGET_BUILD_APPS),)
691  # If this build is just for apps, only build apps and not the full system by default.
692
693  unbundled_build_modules :=
694  ifneq ($(filter all,$(TARGET_BUILD_APPS)),)
695    # If they used the magic goal "all" then build all apps in the source tree.
696    unbundled_build_modules := $(foreach m,$(sort $(ALL_MODULES)),$(if $(filter APPS,$(ALL_MODULES.$(m).CLASS)),$(m)))
697  else
698    unbundled_build_modules := $(TARGET_BUILD_APPS)
699  endif
700
701  # dist the unbundled app.
702  $(call dist-for-goals,apps_only, \
703    $(foreach m,$(unbundled_build_modules),$(ALL_MODULES.$(m).INSTALLED)) \
704  )
705
706.PHONY: apps_only
707apps_only: $(unbundled_build_modules)
708
709droid: apps_only
710
711else # TARGET_BUILD_APPS
712  $(call dist-for-goals, droidcore, \
713    $(INTERNAL_UPDATE_PACKAGE_TARGET) \
714    $(INTERNAL_OTA_PACKAGE_TARGET) \
715    $(SYMBOLS_ZIP) \
716    $(APPS_ZIP) \
717    $(INTERNAL_EMULATOR_PACKAGE_TARGET) \
718    $(PACKAGE_STATS_FILE) \
719    $(INSTALLED_FILES_FILE) \
720    $(INSTALLED_BUILD_PROP_TARGET) \
721    $(BUILT_TARGET_FILES_PACKAGE) \
722    $(INSTALLED_ANDROID_INFO_TXT_TARGET) \
723   )
724
725  # Tests are installed in userdata.img.  If we're building the tests
726  # variant, copy it for "make tests dist".  Also copy a zip of the
727  # contents of userdata.img, so that people can easily extract a
728  # single .apk.
729  ifeq ($(TARGET_BUILD_VARIANT),tests)
730  $(call dist-for-goals, droid, \
731    $(INSTALLED_USERDATAIMAGE_TARGET) \
732    $(BUILT_TESTS_ZIP_PACKAGE) \
733   )
734  endif
735
736# Building a full system-- the default is to build droidcore
737droid: droidcore
738
739endif # TARGET_BUILD_APPS
740
741
742.PHONY: droid tests
743tests: droidcore
744
745.PHONY: docs
746docs: $(ALL_DOCS)
747
748.PHONY: sdk
749ALL_SDK_TARGETS := $(INTERNAL_SDK_TARGET)
750sdk: $(ALL_SDK_TARGETS)
751$(call dist-for-goals,sdk, \
752	$(ALL_SDK_TARGETS) \
753	$(SYMBOLS_ZIP) \
754 )
755
756.PHONY: findbugs
757findbugs: $(INTERNAL_FINDBUGS_HTML_TARGET) $(INTERNAL_FINDBUGS_XML_TARGET)
758
759.PHONY: clean
760dirs_to_clean := \
761	$(PRODUCT_OUT) \
762	$(TARGET_COMMON_OUT_ROOT) \
763	$(HOST_OUT) \
764	$(HOST_COMMON_OUT_ROOT)
765clean:
766	@for dir in $(dirs_to_clean) ; do \
767	    echo "Cleaning $$dir..."; \
768	    rm -rf $$dir; \
769	done
770	@echo "Clean."; \
771
772.PHONY: clobber
773clobber:
774	@rm -rf $(OUT_DIR)
775	@echo "Entire build directory removed."
776
777# The rules for dataclean and installclean are defined in cleanbuild.mk.
778
779#xxx scrape this from ALL_MODULE_NAME_TAGS
780.PHONY: modules
781modules:
782	@echo "Available sub-modules:"
783	@echo "$(call module-names-for-tag-list,$(ALL_MODULE_TAGS))" | \
784	      sed -e 's/  */\n/g' | sort -u | $(COLUMN)
785
786.PHONY: showcommands
787showcommands:
788	@echo >/dev/null
789