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