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