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