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