main.mk revision bacf5f8008e4361d810895dd251354ac348cbf27
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# this turns off the RCS / SCCS implicit rules of GNU Make
16% : RCS/%,v
17% : RCS/%
18% : %,v
19% : s.%
20% : SCCS/s.%
21
22# If a rule fails, delete $@.
23.DELETE_ON_ERROR:
24
25# Figure out where we are.
26#TOP := $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))
27#TOP := $(patsubst %/,%,$(TOP))
28
29# TOPDIR is the normal variable you should use, because
30# if we are executing relative to the current directory
31# it can be "", whereas TOP must be "." which causes
32# pattern matching probles when make strips off the
33# trailing "./" from paths in various places.
34#ifeq ($(TOP),.)
35#TOPDIR :=
36#else
37#TOPDIR := $(TOP)/
38#endif
39
40# Check for broken versions of make.
41# (Allow any version under Cygwin since we don't actually build the platform there.)
42ifeq (,$(findstring CYGWIN,$(shell uname -sm)))
43ifneq (1,$(strip $(shell expr $(MAKE_VERSION) \>= 3.81)))
44$(warning ********************************************************************************)
45$(warning *  You are using version $(MAKE_VERSION) of make.)
46$(warning *  Android can only be built by versions 3.81 and higher.)
47$(warning *  see https://source.android.com/source/download.html)
48$(warning ********************************************************************************)
49$(error stopping)
50endif
51endif
52
53# Absolute path of the present working direcotry.
54# This overrides the shell variable $PWD, which does not necessarily points to
55# the top of the source tree, for example when "make -C" is used in m/mm/mmm.
56PWD := $(shell pwd)
57
58TOP := .
59TOPDIR :=
60
61BUILD_SYSTEM := $(TOPDIR)build/core
62
63# This is the default target.  It must be the first declared target.
64.PHONY: droid
65DEFAULT_GOAL := droid
66$(DEFAULT_GOAL):
67
68# Used to force goals to build.  Only use for conditionally defined goals.
69.PHONY: FORCE
70FORCE:
71
72# These goals don't need to collect and include Android.mks/CleanSpec.mks
73# in the source tree.
74dont_bother_goals := clean clobber dataclean installclean \
75    help out \
76    snod systemimage-nodeps \
77    stnod systemtarball-nodeps \
78    userdataimage-nodeps userdatatarball-nodeps \
79    cacheimage-nodeps \
80    vendorimage-nodeps \
81    ramdisk-nodeps \
82    bootimage-nodeps \
83    recoveryimage-nodeps
84
85ifneq ($(filter $(dont_bother_goals), $(MAKECMDGOALS)),)
86dont_bother := true
87endif
88
89# Targets that provide quick help on the build system.
90include $(BUILD_SYSTEM)/help.mk
91
92# Set up various standard variables based on configuration
93# and host information.
94include $(BUILD_SYSTEM)/config.mk
95
96# CTS-specific config.
97-include cts/build/config.mk
98
99# This allows us to force a clean build - included after the config.mk
100# environment setup is done, but before we generate any dependencies.  This
101# file does the rm -rf inline so the deps which are all done below will
102# be generated correctly
103include $(BUILD_SYSTEM)/cleanbuild.mk
104
105# Include the google-specific config
106-include vendor/google/build/config.mk
107
108VERSION_CHECK_SEQUENCE_NUMBER := 5
109-include $(OUT_DIR)/versions_checked.mk
110ifneq ($(VERSION_CHECK_SEQUENCE_NUMBER),$(VERSIONS_CHECKED))
111
112$(info Checking build tools versions...)
113
114ifneq ($(HOST_OS),windows)
115# check for a case sensitive file system
116ifneq (a,$(shell mkdir -p $(OUT_DIR) ; \
117                echo a > $(OUT_DIR)/casecheck.txt; \
118                    echo B > $(OUT_DIR)/CaseCheck.txt; \
119                cat $(OUT_DIR)/casecheck.txt))
120$(warning ************************************************************)
121$(warning You are building on a case-insensitive filesystem.)
122$(warning Please move your source tree to a case-sensitive filesystem.)
123$(warning ************************************************************)
124$(error Case-insensitive filesystems not supported)
125endif
126endif
127
128# Make sure that there are no spaces in the absolute path; the
129# build system can't deal with them.
130ifneq ($(words $(shell pwd)),1)
131$(warning ************************************************************)
132$(warning You are building in a directory whose absolute path contains)
133$(warning a space character:)
134$(warning $(space))
135$(warning "$(shell pwd)")
136$(warning $(space))
137$(warning Please move your source tree to a path that does not contain)
138$(warning any spaces.)
139$(warning ************************************************************)
140$(error Directory names containing spaces not supported)
141endif
142
143java_version_str := $(shell unset _JAVA_OPTIONS && java -version 2>&1)
144javac_version_str := $(shell unset _JAVA_OPTIONS && javac -version 2>&1)
145
146# Check for the correct version of java, should be 1.7 by
147# default, and 1.8 if EXPERIMENTAL_USE_JAVA8 is set
148ifneq ($(EXPERIMENTAL_USE_JAVA8),)
149required_version := "1.8.x"
150required_javac_version := "1.8"
151java_version := $(shell echo '$(java_version_str)' | grep 'openjdk .*[ "]1\.8[\. "$$]')
152javac_version := $(shell echo '$(javac_version_str)' | grep '[ "]1\.8[\. "$$]')
153else # default
154required_version := "1.7.x"
155required_javac_version := "1.7"
156java_version := $(shell echo '$(java_version_str)' | grep '^java .*[ "]1\.7[\. "$$]')
157javac_version := $(shell echo '$(javac_version_str)' | grep '[ "]1\.7[\. "$$]')
158endif # if EXPERIMENTAL_USE_JAVA8
159
160ifeq ($(strip $(java_version)),)
161$(info ************************************************************)
162$(info You are attempting to build with the incorrect version)
163$(info of java.)
164$(info $(space))
165$(info Your version is: $(java_version_str).)
166$(info The required version is: $(required_version))
167$(info $(space))
168$(info Please follow the machine setup instructions at)
169$(info $(space)$(space)$(space)$(space)https://source.android.com/source/initializing.html)
170$(info ************************************************************)
171$(error stop)
172endif
173
174# Check for the current JDK.
175#
176# For Java 1.7, we require OpenJDK on linux and Oracle JDK on Mac OS.
177requires_openjdk := false
178ifeq ($(HOST_OS), linux)
179requires_openjdk := true
180endif
181
182
183# Check for the current jdk
184ifeq ($(requires_openjdk), true)
185# The user asked for java7 openjdk, so check that the host
186# java version is really openjdk
187ifeq ($(shell echo '$(java_version_str)' | grep -i openjdk),)
188$(info ************************************************************)
189$(info You asked for an OpenJDK 7 build but your version is)
190$(info $(java_version_str).)
191$(info ************************************************************)
192$(error stop)
193endif # java version is not OpenJdk
194else # if requires_openjdk
195ifneq ($(shell echo '$(java_version_str)' | grep -i openjdk),)
196$(info ************************************************************)
197$(info You are attempting to build with an unsupported JDK.)
198$(info $(space))
199$(info You use OpenJDK but only Sun/Oracle JDK is supported.)
200$(info Please follow the machine setup instructions at)
201$(info $(space)$(space)$(space)$(space)https://source.android.com/source/download.html)
202$(info ************************************************************)
203$(error stop)
204endif # java version is not Sun Oracle JDK
205endif # if requires_openjdk
206
207# Check for the correct version of javac
208ifeq ($(strip $(javac_version)),)
209$(info ************************************************************)
210$(info You are attempting to build with the incorrect version)
211$(info of javac.)
212$(info $(space))
213$(info Your version is: $(javac_version_str).)
214$(info The required version is: $(required_javac_version))
215$(info $(space))
216$(info Please follow the machine setup instructions at)
217$(info $(space)$(space)$(space)$(space)https://source.android.com/source/download.html)
218$(info ************************************************************)
219$(error stop)
220endif
221
222
223ifndef BUILD_EMULATOR
224  # Emulator binaries are now provided under prebuilts/android-emulator/
225  BUILD_EMULATOR := false
226endif
227
228$(shell echo 'VERSIONS_CHECKED := $(VERSION_CHECK_SEQUENCE_NUMBER)' \
229        > $(OUT_DIR)/versions_checked.mk)
230$(shell echo 'BUILD_EMULATOR ?= $(BUILD_EMULATOR)' \
231        >> $(OUT_DIR)/versions_checked.mk)
232endif
233
234# These are the modifier targets that don't do anything themselves, but
235# change the behavior of the build.
236# (must be defined before including definitions.make)
237INTERNAL_MODIFIER_TARGETS := showcommands all incrementaljavac
238
239.PHONY: incrementaljavac
240incrementaljavac: ;
241
242# WARNING:
243# ENABLE_INCREMENTALJAVAC should NOT be enabled by default, because change of
244# a Java source file won't trigger rebuild of its dependent Java files.
245# You can only enable it by adding "incrementaljavac" to your make command line.
246# You are responsible for the correctness of the incremental build.
247# This may decrease incremental build time dramatically for large Java libraries,
248# such as core.jar, framework.jar, etc.
249ENABLE_INCREMENTALJAVAC :=
250ifneq (,$(filter incrementaljavac, $(MAKECMDGOALS)))
251ENABLE_INCREMENTALJAVAC := true
252MAKECMDGOALS := $(filter-out incrementaljavac, $(MAKECMDGOALS))
253endif
254
255# EMMA_INSTRUMENT_STATIC merges the static emma library to each emma-enabled module.
256ifeq (true,$(EMMA_INSTRUMENT_STATIC))
257EMMA_INSTRUMENT := true
258endif
259
260# Bring in standard build system definitions.
261include $(BUILD_SYSTEM)/definitions.mk
262
263# Bring in dex_preopt.mk
264include $(BUILD_SYSTEM)/dex_preopt.mk
265
266ifneq ($(filter user userdebug eng,$(MAKECMDGOALS)),)
267$(info ***************************************************************)
268$(info ***************************************************************)
269$(info Do not pass '$(filter user userdebug eng,$(MAKECMDGOALS))' on \
270       the make command line.)
271$(info Set TARGET_BUILD_VARIANT in buildspec.mk, or use lunch or)
272$(info choosecombo.)
273$(info ***************************************************************)
274$(info ***************************************************************)
275$(error stopping)
276endif
277
278ifneq ($(filter-out $(INTERNAL_VALID_VARIANTS),$(TARGET_BUILD_VARIANT)),)
279$(info ***************************************************************)
280$(info ***************************************************************)
281$(info Invalid variant: $(TARGET_BUILD_VARIANT))
282$(info Valid values are: $(INTERNAL_VALID_VARIANTS))
283$(info ***************************************************************)
284$(info ***************************************************************)
285$(error stopping)
286endif
287
288# -----------------------------------------------------------------
289# Variable to check java support level inside PDK build.
290# Not necessary if the components is not in PDK.
291# not defined : not supported
292# "sdk" : sdk API only
293# "platform" : platform API supproted
294TARGET_BUILD_JAVA_SUPPORT_LEVEL := platform
295
296# -----------------------------------------------------------------
297# The pdk (Platform Development Kit) build
298include build/core/pdk_config.mk
299
300# -----------------------------------------------------------------
301###
302### In this section we set up the things that are different
303### between the build variants
304###
305
306is_sdk_build :=
307
308ifneq ($(filter sdk win_sdk sdk_addon,$(MAKECMDGOALS)),)
309is_sdk_build := true
310endif
311
312# Add build properties for ART. These define system properties used by installd
313# to pass flags to dex2oat.
314ADDITIONAL_BUILD_PROPERTIES += persist.sys.dalvik.vm.lib.2=libart
315ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.isa.$(TARGET_ARCH).variant=$(DEX2OAT_TARGET_CPU_VARIANT)
316ifneq ($(DEX2OAT_TARGET_INSTRUCTION_SET_FEATURES),)
317  ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.isa.$(TARGET_ARCH).features=$(DEX2OAT_TARGET_INSTRUCTION_SET_FEATURES)
318endif
319
320ifdef TARGET_2ND_ARCH
321  ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.isa.$(TARGET_2ND_ARCH).variant=$($(TARGET_2ND_ARCH_VAR_PREFIX)DEX2OAT_TARGET_CPU_VARIANT)
322  ifneq ($($(TARGET_2ND_ARCH_VAR_PREFIX)DEX2OAT_TARGET_INSTRUCTION_SET_FEATURES),)
323    ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.isa.$(TARGET_2ND_ARCH).features=$($(TARGET_2ND_ARCH_VAR_PREFIX)DEX2OAT_TARGET_INSTRUCTION_SET_FEATURES)
324  endif
325endif
326
327## user/userdebug ##
328
329user_variant := $(filter user userdebug,$(TARGET_BUILD_VARIANT))
330enable_target_debugging := true
331tags_to_install :=
332ifneq (,$(user_variant))
333  # Target is secure in user builds.
334  ADDITIONAL_DEFAULT_PROPERTIES += ro.secure=1
335
336  ifeq ($(user_variant),userdebug)
337    # Pick up some extra useful tools
338    tags_to_install += debug
339  else
340    # Disable debugging in plain user builds.
341    enable_target_debugging :=
342  endif
343
344  # Turn on Dalvik preoptimization for user builds, but only if not
345  # explicitly disabled and the build is running on Linux (since host
346  # Dalvik isn't built for non-Linux hosts).
347  ifeq (,$(WITH_DEXPREOPT))
348    ifeq ($(user_variant),user)
349      ifeq ($(HOST_OS),linux)
350        # TODO: turn on WITH_DEXPREOPT for libart user builds.
351        # WITH_DEXPREOPT := true
352      endif
353    endif
354  endif
355
356  # Disallow mock locations by default for user builds
357  ADDITIONAL_DEFAULT_PROPERTIES += ro.allow.mock.location=0
358
359else # !user_variant
360  # Turn on checkjni for non-user builds.
361  ADDITIONAL_BUILD_PROPERTIES += ro.kernel.android.checkjni=1
362  # Set device insecure for non-user builds.
363  ADDITIONAL_DEFAULT_PROPERTIES += ro.secure=0
364  # Allow mock locations by default for non user builds
365  ADDITIONAL_DEFAULT_PROPERTIES += ro.allow.mock.location=1
366endif # !user_variant
367
368ifeq (true,$(strip $(enable_target_debugging)))
369  # Target is more debuggable and adbd is on by default
370  ADDITIONAL_DEFAULT_PROPERTIES += ro.debuggable=1
371  # Enable Dalvik lock contention logging.
372  ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.lockprof.threshold=500
373  # Include the debugging/testing OTA keys in this build.
374  INCLUDE_TEST_OTA_KEYS := true
375else # !enable_target_debugging
376  # Target is less debuggable and adbd is off by default
377  ADDITIONAL_DEFAULT_PROPERTIES += ro.debuggable=0
378endif # !enable_target_debugging
379
380## eng ##
381
382ifeq ($(TARGET_BUILD_VARIANT),eng)
383tags_to_install := debug eng
384ifneq ($(filter ro.setupwizard.mode=ENABLED, $(call collapse-pairs, $(ADDITIONAL_BUILD_PROPERTIES))),)
385  # Don't require the setup wizard on eng builds
386  ADDITIONAL_BUILD_PROPERTIES := $(filter-out ro.setupwizard.mode=%,\
387          $(call collapse-pairs, $(ADDITIONAL_BUILD_PROPERTIES))) \
388          ro.setupwizard.mode=OPTIONAL
389endif
390ifndef is_sdk_build
391  # Don't even verify the image on eng builds to speed startup
392  ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.image-dex2oat-filter=verify-none
393  # Don't compile apps on eng builds to speed startup
394  ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.dex2oat-filter=interpret-only
395endif
396endif
397
398## sdk ##
399
400ifdef is_sdk_build
401
402# Detect if we want to build a repository for the SDK
403sdk_repo_goal := $(strip $(filter sdk_repo,$(MAKECMDGOALS)))
404MAKECMDGOALS := $(strip $(filter-out sdk_repo,$(MAKECMDGOALS)))
405
406ifneq ($(words $(filter-out $(INTERNAL_MODIFIER_TARGETS) checkbuild emulator_tests target-files-package,$(MAKECMDGOALS))),1)
407$(error The 'sdk' target may not be specified with any other targets)
408endif
409
410# TODO: this should be eng I think.  Since the sdk is built from the eng
411# variant.
412tags_to_install := debug eng
413ADDITIONAL_BUILD_PROPERTIES += xmpp.auto-presence=true
414ADDITIONAL_BUILD_PROPERTIES += ro.config.nocheckin=yes
415else # !sdk
416endif
417
418BUILD_WITHOUT_PV := true
419
420ADDITIONAL_BUILD_PROPERTIES += net.bt.name=Android
421
422# enable vm tracing in files for now to help track
423# the cause of ANRs in the content process
424ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.stack-trace-file=/data/anr/traces.txt
425
426# ------------------------------------------------------------
427# Define a function that, given a list of module tags, returns
428# non-empty if that module should be installed in /system.
429
430# For most goals, anything not tagged with the "tests" tag should
431# be installed in /system.
432define should-install-to-system
433$(if $(filter tests,$(1)),,true)
434endef
435
436ifdef is_sdk_build
437# For the sdk goal, anything with the "samples" tag should be
438# installed in /data even if that module also has "eng"/"debug"/"user".
439define should-install-to-system
440$(if $(filter samples tests,$(1)),,true)
441endef
442endif
443
444
445# If they only used the modifier goals (showcommands, etc), we'll actually
446# build the default target.
447ifeq ($(filter-out $(INTERNAL_MODIFIER_TARGETS),$(MAKECMDGOALS)),)
448.PHONY: $(INTERNAL_MODIFIER_TARGETS)
449$(INTERNAL_MODIFIER_TARGETS): $(DEFAULT_GOAL)
450endif
451
452# Bring in all modules that need to be built.
453ifeq ($(HOST_OS),windows)
454SDK_ONLY := true
455endif
456
457ifeq ($(SDK_ONLY),true)
458include $(TOPDIR)sdk/build/windows_sdk_whitelist.mk
459include $(TOPDIR)development/build/windows_sdk_whitelist.mk
460
461# Exclude tools/acp when cross-compiling windows under linux
462ifeq ($(findstring Linux,$(UNAME)),)
463subdirs += build/tools/acp
464endif
465
466else	# !SDK_ONLY
467#
468# Typical build; include any Android.mk files we can find.
469#
470subdirs := $(TOP)
471
472FULL_BUILD := true
473
474endif	# !SDK_ONLY
475
476# Before we go and include all of the module makefiles, stash away
477# the PRODUCT_* values so that later we can verify they are not modified.
478stash_product_vars:=true
479ifeq ($(stash_product_vars),true)
480  $(call stash-product-vars, __STASHED)
481endif
482
483ifneq ($(ONE_SHOT_MAKEFILE),)
484# We've probably been invoked by the "mm" shell function
485# with a subdirectory's makefile.
486include $(ONE_SHOT_MAKEFILE)
487# Change CUSTOM_MODULES to include only modules that were
488# defined by this makefile; this will install all of those
489# modules as a side-effect.  Do this after including ONE_SHOT_MAKEFILE
490# so that the modules will be installed in the same place they
491# would have been with a normal make.
492CUSTOM_MODULES := $(sort $(call get-tagged-modules,$(ALL_MODULE_TAGS)))
493FULL_BUILD :=
494# Stub out the notice targets, which probably aren't defined
495# when using ONE_SHOT_MAKEFILE.
496NOTICE-HOST-%: ;
497NOTICE-TARGET-%: ;
498
499# A helper goal printing out install paths
500.PHONY: GET-INSTALL-PATH
501GET-INSTALL-PATH:
502	@$(foreach m, $(ALL_MODULES), $(if $(ALL_MODULES.$(m).INSTALLED), \
503		echo 'INSTALL-PATH: $(m) $(ALL_MODULES.$(m).INSTALLED)';))
504
505else # ONE_SHOT_MAKEFILE
506
507ifneq ($(dont_bother),true)
508#
509# Include all of the makefiles in the system
510#
511
512# Can't use first-makefiles-under here because
513# --mindepth=2 makes the prunes not work.
514subdir_makefiles := \
515	$(shell build/tools/findleaves.py --prune=$(OUT_DIR) --prune=.repo --prune=.git $(subdirs) Android.mk)
516
517$(foreach mk, $(subdir_makefiles), $(info including $(mk) ...)$(eval include $(mk)))
518
519endif # dont_bother
520
521endif # ONE_SHOT_MAKEFILE
522
523# Now with all Android.mks loaded we can do post cleaning steps.
524include $(BUILD_SYSTEM)/post_clean.mk
525
526ifeq ($(stash_product_vars),true)
527  $(call assert-product-vars, __STASHED)
528endif
529
530include $(BUILD_SYSTEM)/legacy_prebuilts.mk
531ifneq ($(filter-out $(GRANDFATHERED_ALL_PREBUILT),$(strip $(notdir $(ALL_PREBUILT)))),)
532  $(warning *** Some files have been added to ALL_PREBUILT.)
533  $(warning *)
534  $(warning * ALL_PREBUILT is a deprecated mechanism that)
535  $(warning * should not be used for new files.)
536  $(warning * As an alternative, use PRODUCT_COPY_FILES in)
537  $(warning * the appropriate product definition.)
538  $(warning * build/target/product/core.mk is the product)
539  $(warning * definition used in all products.)
540  $(warning *)
541  $(foreach bad_prebuilt,$(filter-out $(GRANDFATHERED_ALL_PREBUILT),$(strip $(notdir $(ALL_PREBUILT)))),$(warning * unexpected $(bad_prebuilt) in ALL_PREBUILT))
542  $(warning *)
543  $(error ALL_PREBUILT contains unexpected files)
544endif
545
546# -------------------------------------------------------------------
547# All module makefiles have been included at this point.
548# -------------------------------------------------------------------
549
550
551# -------------------------------------------------------------------
552# Fix up CUSTOM_MODULES to refer to installed files rather than
553# just bare module names.  Leave unknown modules alone in case
554# they're actually full paths to a particular file.
555known_custom_modules := $(filter $(ALL_MODULES),$(CUSTOM_MODULES))
556unknown_custom_modules := $(filter-out $(ALL_MODULES),$(CUSTOM_MODULES))
557CUSTOM_MODULES := \
558	$(call module-installed-files,$(known_custom_modules)) \
559	$(unknown_custom_modules)
560
561# -------------------------------------------------------------------
562# Define dependencies for modules that require other modules.
563# This can only happen now, after we've read in all module makefiles.
564#
565# TODO: deal with the fact that a bare module name isn't
566# unambiguous enough.  Maybe declare short targets like
567# APPS:Quake or HOST:SHARED_LIBRARIES:libutils.
568# BUG: the system image won't know to depend on modules that are
569# brought in as requirements of other modules.
570#
571# Resolve the required module name to 32-bit or 64-bit variant.
572# Get a list of corresponding 32-bit module names, if one exists.
573define get-32-bit-modules
574$(strip $(foreach m,$(1),\
575  $(if $(ALL_MODULES.$(m)$(TARGET_2ND_ARCH_MODULE_SUFFIX).CLASS),\
576    $(m)$(TARGET_2ND_ARCH_MODULE_SUFFIX))))
577endef
578# Get a list of corresponding 32-bit module names, if one exists;
579# otherwise return the original module name
580define get-32-bit-modules-if-we-can
581$(strip $(foreach m,$(1),\
582  $(if $(ALL_MODULES.$(m)$(TARGET_2ND_ARCH_MODULE_SUFFIX).CLASS),\
583    $(m)$(TARGET_2ND_ARCH_MODULE_SUFFIX),
584    $(m))))
585endef
586
587# If a module is built for 32-bit, the required modules must be 32-bit too;
588# Otherwise if the module is an exectuable or shared library,
589#   the required modules must be 64-bit;
590#   otherwise we require both 64-bit and 32-bit variant, if one exists.
591$(foreach m,$(ALL_MODULES),\
592  $(eval r := $(ALL_MODULES.$(m).REQUIRED))\
593  $(if $(r),\
594    $(if $(ALL_MODULES.$(m).FOR_2ND_ARCH),\
595      $(eval r_r := $(call get-32-bit-modules-if-we-can,$(r))),\
596      $(if $(filter EXECUTABLES SHARED_LIBRARIES,$(ALL_MODULES.$(m).CLASS)),\
597        $(eval r_r := $(r)),\
598        $(eval r_r := $(r) $(call get-32-bit-modules,$(r)))\
599       )\
600     )\
601     $(eval ALL_MODULES.$(m).REQUIRED := $(strip $(r_r)))\
602  )\
603)
604r_r :=
605
606define add-required-deps
607$(1): | $(2)
608endef
609
610$(foreach m,$(ALL_MODULES), \
611  $(eval r := $(ALL_MODULES.$(m).REQUIRED)) \
612  $(if $(r), \
613    $(eval r := $(call module-installed-files,$(r))) \
614    $(eval t_m := $(filter $(TARGET_OUT_ROOT)/%, $(ALL_MODULES.$(m).INSTALLED))) \
615    $(eval h_m := $(filter $(HOST_OUT_ROOT)/%, $(ALL_MODULES.$(m).INSTALLED))) \
616    $(eval t_r := $(filter $(TARGET_OUT_ROOT)/%, $(r))) \
617    $(eval h_r := $(filter $(HOST_OUT_ROOT)/%, $(r))) \
618    $(eval t_m := $(filter-out $(t_r), $(t_m))) \
619    $(eval h_m := $(filter-out $(h_r), $(h_m))) \
620    $(if $(t_m), $(eval $(call add-required-deps, $(t_m),$(t_r)))) \
621    $(if $(h_m), $(eval $(call add-required-deps, $(h_m),$(h_r)))) \
622   ) \
623 )
624
625t_m :=
626h_m :=
627t_r :=
628h_r :=
629
630# Establish the dependecies on the shared libraries.
631# It also adds the shared library module names to ALL_MODULES.$(m).REQUIRED,
632# so they can be expanded to product_MODULES later.
633# $(1): TARGET_ or HOST_.
634# $(2): non-empty for 2nd arch.
635define resolve-shared-libs-depes
636$(foreach m,$($(if $(2),$($(1)2ND_ARCH_VAR_PREFIX))$(1)DEPENDENCIES_ON_SHARED_LIBRARIES),\
637  $(eval p := $(subst :,$(space),$(m)))\
638  $(eval mod := $(firstword $(p)))\
639  $(eval deps := $(subst $(comma),$(space),$(lastword $(p))))\
640  $(if $(2),$(eval deps := $(addsuffix $($(1)2ND_ARCH_MODULE_SUFFIX),$(deps))))\
641  $(eval r := $(filter $($(1)OUT_ROOT)/%,$(call module-installed-files,\
642    $(deps))))\
643  $(eval $(call add-required-deps,$(word 2,$(p)),$(r)))\
644  $(eval ALL_MODULES.$(mod).REQUIRED += $(deps)))
645endef
646
647$(call resolve-shared-libs-depes,TARGET_)
648ifdef TARGET_2ND_ARCH
649$(call resolve-shared-libs-depes,TARGET_,true)
650endif
651$(call resolve-shared-libs-depes,HOST_)
652ifdef HOST_2ND_ARCH
653$(call resolve-shared-libs-depes,HOST_,true)
654endif
655
656m :=
657r :=
658p :=
659deps :=
660add-required-deps :=
661
662# -------------------------------------------------------------------
663# Figure out our module sets.
664#
665# Of the modules defined by the component makefiles,
666# determine what we actually want to build.
667
668###########################################################
669## Expand a module name list with REQUIRED modules
670###########################################################
671# $(1): The variable name that holds the initial module name list.
672#       the variable will be modified to hold the expanded results.
673# $(2): The initial module name list.
674# Returns empty string (maybe with some whitespaces).
675define expand-required-modules
676$(eval _erm_new_modules := $(sort $(filter-out $($(1)),\
677  $(foreach m,$(2),$(ALL_MODULES.$(m).REQUIRED)))))\
678$(if $(_erm_new_modules),$(eval $(1) += $(_erm_new_modules))\
679  $(call expand-required-modules,$(1),$(_erm_new_modules)))
680endef
681
682ifdef FULL_BUILD
683  # The base list of modules to build for this product is specified
684  # by the appropriate product definition file, which was included
685  # by product_config.mk.
686  product_MODULES := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES)
687  # Filter out the overridden packages before doing expansion
688  product_MODULES := $(filter-out $(foreach p, $(product_MODULES), \
689      $(PACKAGES.$(p).OVERRIDES)), $(product_MODULES))
690
691  # Resolve the :32 :64 module name
692  modules_32 := $(patsubst %:32,%,$(filter %:32, $(product_MODULES)))
693  modules_64 := $(patsubst %:64,%,$(filter %:64, $(product_MODULES)))
694  modules_rest := $(filter-out %:32 %:64,$(product_MODULES))
695  # Note for 32-bit product, $(modules_32) and $(modules_64) will be
696  # added as their original module names.
697  product_MODULES := $(call get-32-bit-modules-if-we-can, $(modules_32))
698  product_MODULES += $(modules_64)
699  # For the rest we add both
700  product_MODULES += $(call get-32-bit-modules, $(modules_rest))
701  product_MODULES += $(modules_rest)
702
703  $(call expand-required-modules,product_MODULES,$(product_MODULES))
704
705  product_FILES := $(call module-installed-files, $(product_MODULES))
706  ifeq (0,1)
707    $(info product_FILES for $(TARGET_DEVICE) ($(INTERNAL_PRODUCT)):)
708    $(foreach p,$(product_FILES),$(info :   $(p)))
709    $(error done)
710  endif
711else
712  # We're not doing a full build, and are probably only including
713  # a subset of the module makefiles.  Don't try to build any modules
714  # requested by the product, because we probably won't have rules
715  # to build them.
716  product_FILES :=
717endif
718
719eng_MODULES := $(sort \
720        $(call get-tagged-modules,eng) \
721        $(call module-installed-files, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_ENG)) \
722    )
723debug_MODULES := $(sort \
724        $(call get-tagged-modules,debug) \
725        $(call module-installed-files, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_DEBUG)) \
726    )
727tests_MODULES := $(sort \
728        $(call get-tagged-modules,tests) \
729        $(call module-installed-files, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_TESTS)) \
730    )
731
732# TODO: Remove the 3 places in the tree that use ALL_DEFAULT_INSTALLED_MODULES
733# and get rid of it from this list.
734modules_to_install := $(sort \
735    $(ALL_DEFAULT_INSTALLED_MODULES) \
736    $(product_FILES) \
737    $(foreach tag,$(tags_to_install),$($(tag)_MODULES)) \
738    $(CUSTOM_MODULES) \
739  )
740
741# Some packages may override others using LOCAL_OVERRIDES_PACKAGES.
742# Filter out (do not install) any overridden packages.
743overridden_packages := $(call get-package-overrides,$(modules_to_install))
744ifdef overridden_packages
745#  old_modules_to_install := $(modules_to_install)
746  modules_to_install := \
747      $(filter-out $(foreach p,$(overridden_packages),$(p) %/$(p).apk), \
748          $(modules_to_install))
749endif
750#$(error filtered out
751#           $(filter-out $(modules_to_install),$(old_modules_to_install)))
752
753# Don't include any GNU targets in the SDK.  It's ok (and necessary)
754# to build the host tools, but nothing that's going to be installed
755# on the target (including static libraries).
756ifdef is_sdk_build
757  target_gnu_MODULES := \
758              $(filter \
759                      $(TARGET_OUT_INTERMEDIATES)/% \
760                      $(TARGET_OUT)/% \
761                      $(TARGET_OUT_DATA)/%, \
762                              $(sort $(call get-tagged-modules,gnu)))
763  $(info Removing from sdk:)$(foreach d,$(target_gnu_MODULES),$(info : $(d)))
764  modules_to_install := \
765              $(filter-out $(target_gnu_MODULES),$(modules_to_install))
766
767  # Ensure every module listed in PRODUCT_PACKAGES* gets something installed
768  # TODO: Should we do this for all builds and not just the sdk?
769  dangling_modules :=
770  $(foreach m, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES), \
771    $(if $(strip $(ALL_MODULES.$(m).INSTALLED) $(ALL_MODULES.$(m)$(TARGET_2ND_ARCH_MODULE_SUFFIX).INSTALLED)),,\
772      $(eval dangling_modules += $(m))))
773  ifneq ($(dangling_modules),)
774    $(warning: Modules '$(dangling_modules)' in PRODUCT_PACKAGES have nothing to install!)
775  endif
776  $(foreach m, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_DEBUG), \
777    $(if $(strip $(ALL_MODULES.$(m).INSTALLED)),,\
778      $(warning $(ALL_MODULES.$(m).MAKEFILE): Module '$(m)' in PRODUCT_PACKAGES_DEBUG has nothing to install!)))
779  $(foreach m, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_ENG), \
780    $(if $(strip $(ALL_MODULES.$(m).INSTALLED)),,\
781      $(warning $(ALL_MODULES.$(m).MAKEFILE): Module '$(m)' in PRODUCT_PACKAGES_ENG has nothing to install!)))
782  $(foreach m, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_TESTS), \
783    $(if $(strip $(ALL_MODULES.$(m).INSTALLED)),,\
784      $(warning $(ALL_MODULES.$(m).MAKEFILE): Module '$(m)' in PRODUCT_PACKAGES_TESTS has nothing to install!)))
785endif
786
787# build/core/Makefile contains extra stuff that we don't want to pollute this
788# top-level makefile with.  It expects that ALL_DEFAULT_INSTALLED_MODULES
789# contains everything that's built during the current make, but it also further
790# extends ALL_DEFAULT_INSTALLED_MODULES.
791ALL_DEFAULT_INSTALLED_MODULES := $(modules_to_install)
792include $(BUILD_SYSTEM)/Makefile
793modules_to_install := $(sort $(ALL_DEFAULT_INSTALLED_MODULES))
794ALL_DEFAULT_INSTALLED_MODULES :=
795
796
797# These are additional goals that we build, in order to make sure that there
798# is as little code as possible in the tree that doesn't build.
799modules_to_check := $(foreach m,$(ALL_MODULES),$(ALL_MODULES.$(m).CHECKED))
800
801# If you would like to build all goals, and not skip any intermediate
802# steps, you can pass the "all" modifier goal on the commandline.
803ifneq ($(filter all,$(MAKECMDGOALS)),)
804modules_to_check += $(foreach m,$(ALL_MODULES),$(ALL_MODULES.$(m).BUILT))
805endif
806
807# for easier debugging
808modules_to_check := $(sort $(modules_to_check))
809#$(error modules_to_check $(modules_to_check))
810
811# -------------------------------------------------------------------
812# This is used to to get the ordering right, you can also use these,
813# but they're considered undocumented, so don't complain if their
814# behavior changes.
815.PHONY: prebuilt
816prebuilt: $(ALL_PREBUILT)
817
818# An internal target that depends on all copied headers
819# (see copy_headers.make).  Other targets that need the
820# headers to be copied first can depend on this target.
821.PHONY: all_copied_headers
822all_copied_headers: ;
823
824$(ALL_C_CPP_ETC_OBJECTS): | all_copied_headers
825
826# All the droid stuff, in directories
827.PHONY: files
828files: prebuilt \
829        $(modules_to_install) \
830        $(INSTALLED_ANDROID_INFO_TXT_TARGET)
831
832# -------------------------------------------------------------------
833
834.PHONY: checkbuild
835checkbuild: $(modules_to_check)
836ifeq (true,$(ANDROID_BUILD_EVERYTHING_BY_DEFAULT)$(filter $(MAKECMDGOALS),checkbuild))
837droid: checkbuild
838else
839# ANDROID_BUILD_EVERYTHING_BY_DEFAULT not set, or checkbuild is one of the cmd goals.
840checkbuild: droid
841endif
842
843.PHONY: ramdisk
844ramdisk: $(INSTALLED_RAMDISK_TARGET)
845
846.PHONY: systemtarball
847systemtarball: $(INSTALLED_SYSTEMTARBALL_TARGET)
848
849.PHONY: boottarball
850boottarball: $(INSTALLED_BOOTTARBALL_TARGET)
851
852.PHONY: userdataimage
853userdataimage: $(INSTALLED_USERDATAIMAGE_TARGET)
854
855ifneq (,$(filter userdataimage, $(MAKECMDGOALS)))
856$(call dist-for-goals, userdataimage, $(BUILT_USERDATAIMAGE_TARGET))
857endif
858
859.PHONY: userdatatarball
860userdatatarball: $(INSTALLED_USERDATATARBALL_TARGET)
861
862.PHONY: cacheimage
863cacheimage: $(INSTALLED_CACHEIMAGE_TARGET)
864
865.PHONY: vendorimage
866vendorimage: $(INSTALLED_VENDORIMAGE_TARGET)
867
868.PHONY: bootimage
869bootimage: $(INSTALLED_BOOTIMAGE_TARGET)
870
871# phony target that include any targets in $(ALL_MODULES)
872.PHONY: all_modules
873ifndef BUILD_MODULES_IN_PATHS
874all_modules: $(ALL_MODULES)
875else
876# BUILD_MODULES_IN_PATHS is a list of paths relative to the top of the tree
877module_path_patterns := $(foreach p, $(BUILD_MODULES_IN_PATHS),\
878    $(if $(filter %/,$(p)),$(p)%,$(p)/%))
879my_all_modules := $(sort $(foreach m, $(ALL_MODULES),$(if $(filter\
880    $(module_path_patterns), $(addsuffix /,$(ALL_MODULES.$(m).PATH))),$(m))))
881all_modules: $(my_all_modules)
882endif
883
884
885# Build files and then package it into the rom formats
886.PHONY: droidcore
887droidcore: files \
888	systemimage \
889	$(INSTALLED_BOOTIMAGE_TARGET) \
890	$(INSTALLED_RECOVERYIMAGE_TARGET) \
891	$(INSTALLED_USERDATAIMAGE_TARGET) \
892	$(INSTALLED_CACHEIMAGE_TARGET) \
893	$(INSTALLED_VENDORIMAGE_TARGET) \
894	$(INSTALLED_FILES_FILE)
895
896# dist_files only for putting your library into the dist directory with a full build.
897.PHONY: dist_files
898
899ifneq ($(TARGET_BUILD_APPS),)
900  # If this build is just for apps, only build apps and not the full system by default.
901
902  unbundled_build_modules :=
903  ifneq ($(filter all,$(TARGET_BUILD_APPS)),)
904    # If they used the magic goal "all" then build all apps in the source tree.
905    unbundled_build_modules := $(foreach m,$(sort $(ALL_MODULES)),$(if $(filter APPS,$(ALL_MODULES.$(m).CLASS)),$(m)))
906  else
907    unbundled_build_modules := $(TARGET_BUILD_APPS)
908  endif
909
910  # Dist the installed files if they exist.
911  apps_only_installed_files := $(foreach m,$(unbundled_build_modules),$(ALL_MODULES.$(m).INSTALLED))
912  $(call dist-for-goals,apps_only, $(apps_only_installed_files))
913  # For uninstallable modules such as static Java library, we have to dist the built file,
914  # as <module_name>.<suffix>
915  apps_only_dist_built_files := $(foreach m,$(unbundled_build_modules),$(if $(ALL_MODULES.$(m).INSTALLED),,\
916      $(if $(ALL_MODULES.$(m).BUILT),$(ALL_MODULES.$(m).BUILT):$(m)$(suffix $(ALL_MODULES.$(m).BUILT)))\
917      $(if $(ALL_MODULES.$(m).AAR),$(ALL_MODULES.$(m).AAR):$(m).aar)\
918      ))
919  $(call dist-for-goals,apps_only, $(apps_only_dist_built_files))
920
921  ifeq ($(EMMA_INSTRUMENT),true)
922    $(EMMA_META_ZIP) : $(apps_only_installed_files)
923
924    $(call dist-for-goals,apps_only, $(EMMA_META_ZIP))
925  endif
926
927  $(PROGUARD_DICT_ZIP) : $(apps_only_installed_files)
928  $(call dist-for-goals,apps_only, $(PROGUARD_DICT_ZIP))
929
930  $(SYMBOLS_ZIP) : $(apps_only_installed_files)
931  $(call dist-for-goals,apps_only, $(SYMBOLS_ZIP))
932
933.PHONY: apps_only
934apps_only: $(unbundled_build_modules)
935
936droid: apps_only
937
938# Combine the NOTICE files for a apps_only build
939$(eval $(call combine-notice-files, \
940    $(target_notice_file_txt), \
941    $(target_notice_file_html), \
942    "Notices for files for apps:", \
943    $(TARGET_OUT_NOTICE_FILES), \
944    $(apps_only_installed_files)))
945
946
947else # TARGET_BUILD_APPS
948  $(call dist-for-goals, droidcore, \
949    $(INTERNAL_UPDATE_PACKAGE_TARGET) \
950    $(INTERNAL_OTA_PACKAGE_TARGET) \
951    $(SYMBOLS_ZIP) \
952    $(INSTALLED_FILES_FILE) \
953    $(INSTALLED_BUILD_PROP_TARGET) \
954    $(BUILT_TARGET_FILES_PACKAGE) \
955    $(INSTALLED_ANDROID_INFO_TXT_TARGET) \
956    $(INSTALLED_RAMDISK_TARGET) \
957   )
958
959  # Put a copy of the radio/bootloader files in the dist dir.
960  $(foreach f,$(INSTALLED_RADIOIMAGE_TARGET), \
961    $(call dist-for-goals, droidcore, $(f)))
962
963  ifneq ($(ANDROID_BUILD_EMBEDDED),true)
964  ifneq ($(TARGET_BUILD_PDK),true)
965    $(call dist-for-goals, droidcore, \
966      $(APPS_ZIP) \
967      $(INTERNAL_EMULATOR_PACKAGE_TARGET) \
968      $(PACKAGE_STATS_FILE) \
969    )
970  endif
971  endif
972
973  ifeq ($(EMMA_INSTRUMENT),true)
974    $(EMMA_META_ZIP) : $(INSTALLED_SYSTEMIMAGE)
975
976    $(call dist-for-goals, dist_files, $(EMMA_META_ZIP))
977  endif
978
979# Building a full system-- the default is to build droidcore
980droid: droidcore dist_files
981
982endif # TARGET_BUILD_APPS
983
984.PHONY: docs
985docs: $(ALL_DOCS)
986
987.PHONY: sdk
988ALL_SDK_TARGETS := $(INTERNAL_SDK_TARGET)
989sdk: $(ALL_SDK_TARGETS)
990$(call dist-for-goals,sdk win_sdk, \
991    $(ALL_SDK_TARGETS) \
992    $(SYMBOLS_ZIP) \
993    $(INSTALLED_BUILD_PROP_TARGET) \
994)
995
996# umbrella targets to assit engineers in verifying builds
997.PHONY: java native target host java-host java-target native-host native-target \
998        java-host-tests java-target-tests native-host-tests native-target-tests \
999        java-tests native-tests host-tests target-tests tests
1000# some synonyms
1001.PHONY: host-java target-java host-native target-native \
1002        target-java-tests target-native-tests
1003host-java : java-host
1004target-java : java-target
1005host-native : native-host
1006target-native : native-target
1007target-java-tests : java-target-tests
1008target-native-tests : native-target-tests
1009tests : host-tests target-tests
1010
1011# To catch more build breakage, check build tests modules in eng and userdebug builds.
1012ifneq ($(TARGET_BUILD_PDK),true)
1013ifneq ($(filter eng userdebug,$(TARGET_BUILD_VARIANT)),)
1014droidcore : target-tests host-tests
1015endif
1016endif
1017
1018.PHONY: lintall
1019
1020ifneq (,$(filter samplecode, $(MAKECMDGOALS)))
1021.PHONY: samplecode
1022sample_MODULES := $(sort $(call get-tagged-modules,samples))
1023sample_APKS_DEST_PATH := $(TARGET_COMMON_OUT_ROOT)/samples
1024sample_APKS_COLLECTION := \
1025        $(foreach module,$(sample_MODULES),$(sample_APKS_DEST_PATH)/$(notdir $(module)))
1026$(foreach module,$(sample_MODULES),$(eval $(call \
1027        copy-one-file,$(module),$(sample_APKS_DEST_PATH)/$(notdir $(module)))))
1028sample_ADDITIONAL_INSTALLED := \
1029        $(filter-out $(modules_to_install) $(modules_to_check) $(ALL_PREBUILT),$(sample_MODULES))
1030samplecode: $(sample_APKS_COLLECTION)
1031	@echo "Collect sample code apks: $^"
1032	# remove apks that are not intended to be installed.
1033	rm -f $(sample_ADDITIONAL_INSTALLED)
1034endif  # samplecode in $(MAKECMDGOALS)
1035
1036.PHONY: findbugs
1037findbugs: $(INTERNAL_FINDBUGS_HTML_TARGET) $(INTERNAL_FINDBUGS_XML_TARGET)
1038
1039.PHONY: clean
1040clean:
1041	@rm -rf $(OUT_DIR)/*
1042	@echo "Entire build directory removed."
1043
1044.PHONY: clobber
1045clobber: clean
1046
1047# The rules for dataclean and installclean are defined in cleanbuild.mk.
1048
1049#xxx scrape this from ALL_MODULE_NAME_TAGS
1050.PHONY: modules
1051modules:
1052	@echo "Available sub-modules:"
1053	@echo "$(call module-names-for-tag-list,$(ALL_MODULE_TAGS))" | \
1054	      tr -s ' ' '\n' | sort -u | $(COLUMN)
1055
1056.PHONY: showcommands
1057showcommands:
1058	@echo >/dev/null
1059
1060.PHONY: nothing
1061nothing:
1062	@echo Successfully read the makefiles.
1063