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