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