Home | History | Annotate | Download | only in core 
      1 # Only use ANDROID_BUILD_SHELL to wrap around bash.
      2 # DO NOT use other shells such as zsh.
      3 ifdef ANDROID_BUILD_SHELL
      4 SHELL := $(ANDROID_BUILD_SHELL)
      5 else
      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.
      9 SHELL := /bin/bash
     10 endif
     11 
     12 # this turns off the suffix rules built into make
     13 .SUFFIXES:
     14 
     15 # this turns off the RCS / SCCS implicit rules of GNU Make
     16 % : RCS/%,v
     17 % : RCS/%
     18 % : %,v
     19 % : s.%
     20 % : SCCS/s.%
     21 
     22 # If a rule fails, delete $@.
     23 .DELETE_ON_ERROR:
     24 
     25 # Figure out where we are.
     26 #TOP := $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))
     27 #TOP := $(patsubst %/,%,$(TOP))
     28 
     29 # TOPDIR is the normal variable you should use, because
     30 # if we are executing relative to the current directory
     31 # it can be "", whereas TOP must be "." which causes
     32 # pattern matching probles when make strips off the
     33 # trailing "./" from paths in various places.
     34 #ifeq ($(TOP),.)
     35 #TOPDIR :=
     36 #else
     37 #TOPDIR := $(TOP)/
     38 #endif
     39 
     40 # Check for broken versions of make.
     41 # (Allow any version under Cygwin since we don't actually build the platform there.)
     42 ifeq (,$(findstring CYGWIN,$(shell uname -sm)))
     43 ifeq (0,$(shell expr $$(echo $(MAKE_VERSION) | sed "s/[^0-9\.].*//") = 3.81))
     44 ifeq (0,$(shell expr $$(echo $(MAKE_VERSION) | sed "s/[^0-9\.].*//") = 3.82))
     45 $(warning ********************************************************************************)
     46 $(warning *  You are using version $(MAKE_VERSION) of make.)
     47 $(warning *  Android can only be built by versions 3.81 and 3.82.)
     48 $(warning *  see https://source.android.com/source/download.html)
     49 $(warning ********************************************************************************)
     50 $(error stopping)
     51 endif
     52 endif
     53 endif
     54 
     55 # Absolute path of the present working direcotry.
     56 # This overrides the shell variable $PWD, which does not necessarily points to
     57 # the top of the source tree, for example when "make -C" is used in m/mm/mmm.
     58 PWD := $(shell pwd)
     59 
     60 TOP := .
     61 TOPDIR :=
     62 
     63 BUILD_SYSTEM := $(TOPDIR)build/core
     64 
     65 # This is the default target.  It must be the first declared target.
     66 .PHONY: droid
     67 DEFAULT_GOAL := droid
     68 $(DEFAULT_GOAL):
     69 
     70 # Used to force goals to build.  Only use for conditionally defined goals.
     71 .PHONY: FORCE
     72 FORCE:
     73 
     74 # Targets that provide quick help on the build system.
     75 include $(BUILD_SYSTEM)/help.mk
     76 
     77 # Set up various standard variables based on configuration
     78 # and host information.
     79 include $(BUILD_SYSTEM)/config.mk
     80 
     81 # This allows us to force a clean build - included after the config.make
     82 # environment setup is done, but before we generate any dependencies.  This
     83 # file does the rm -rf inline so the deps which are all done below will
     84 # be generated correctly
     85 include $(BUILD_SYSTEM)/cleanbuild.mk
     86 
     87 VERSION_CHECK_SEQUENCE_NUMBER := 3
     88 -include $(OUT_DIR)/versions_checked.mk
     89 ifneq ($(VERSION_CHECK_SEQUENCE_NUMBER),$(VERSIONS_CHECKED))
     90 
     91 $(info Checking build tools versions...)
     92 
     93 ifneq ($(HOST_OS),windows)
     94 ifneq ($(HOST_OS)-$(HOST_ARCH),darwin-ppc)
     95 # check for a case sensitive file system
     96 ifneq (a,$(shell mkdir -p $(OUT_DIR) ; \
     97                 echo a > $(OUT_DIR)/casecheck.txt; \
     98                     echo B > $(OUT_DIR)/CaseCheck.txt; \
     99                 cat $(OUT_DIR)/casecheck.txt))
    100 $(warning ************************************************************)
    101 $(warning You are building on a case-insensitive filesystem.)
    102 $(warning Please move your source tree to a case-sensitive filesystem.)
    103 $(warning ************************************************************)
    104 $(error Case-insensitive filesystems not supported)
    105 endif
    106 endif
    107 endif
    108 
    109 # Make sure that there are no spaces in the absolute path; the
    110 # build system can't deal with them.
    111 ifneq ($(words $(shell pwd)),1)
    112 $(warning ************************************************************)
    113 $(warning You are building in a directory whose absolute path contains)
    114 $(warning a space character:)
    115 $(warning $(space))
    116 $(warning "$(shell pwd)")
    117 $(warning $(space))
    118 $(warning Please move your source tree to a path that does not contain)
    119 $(warning any spaces.)
    120 $(warning ************************************************************)
    121 $(error Directory names containing spaces not supported)
    122 endif
    123 
    124 
    125 # Check for the correct version of java
    126 java_version := $(shell java -version 2>&1 | head -n 1 | grep '^java .*[ "]1\.6[\. "$$]')
    127 ifneq ($(shell java -version 2>&1 | grep -i openjdk),)
    128 java_version :=
    129 endif
    130 ifeq ($(strip $(java_version)),)
    131 $(info ************************************************************)
    132 $(info You are attempting to build with the incorrect version)
    133 $(info of java.)
    134 $(info $(space))
    135 $(info Your version is: $(shell java -version 2>&1 | head -n 1).)
    136 $(info The correct version is: Java SE 1.6.)
    137 $(info $(space))
    138 $(info Please follow the machine setup instructions at)
    139 $(info $(space)$(space)$(space)$(space)https://source.android.com/source/download.html)
    140 $(info ************************************************************)
    141 $(error stop)
    142 endif
    143 
    144 # Check for the correct version of javac
    145 javac_version := $(shell javac -version 2>&1 | head -n 1 | grep '[ "]1\.6[\. "$$]')
    146 ifeq ($(strip $(javac_version)),)
    147 $(info ************************************************************)
    148 $(info You are attempting to build with the incorrect version)
    149 $(info of javac.)
    150 $(info $(space))
    151 $(info Your version is: $(shell javac -version 2>&1 | head -n 1).)
    152 $(info The correct version is: 1.6.)
    153 $(info $(space))
    154 $(info Please follow the machine setup instructions at)
    155 $(info $(space)$(space)$(space)$(space)https://source.android.com/source/download.html)
    156 $(info ************************************************************)
    157 $(error stop)
    158 endif
    159 
    160 ifeq (darwin,$(HOST_OS))
    161 GCC_REALPATH = $(realpath $(shell which gcc))
    162 ifneq ($(findstring llvm-gcc,$(GCC_REALPATH)),)
    163   # Using LLVM GCC results in a non functional emulator due to it
    164   # not honouring global register variables
    165   $(warning ****************************************)
    166   $(warning * gcc is linked to llvm-gcc which will *)
    167   $(warning * not create a useable emulator.       *)
    168   $(warning ****************************************)
    169   BUILD_EMULATOR := false
    170 else
    171   BUILD_EMULATOR := true
    172 endif
    173 # When building on Leopard or above, we need to use the 10.4 SDK
    174 # or the generated binary will not run on Tiger.
    175 darwin_version := $(strip $(shell sw_vers -productVersion))
    176 ifneq ($(filter 10.1 10.2 10.3 10.1.% 10.2.% 10.3.% 10.4 10.4.%,$(darwin_version)),)
    177     $(error Building the Android emulator requires OS X 10.5 or above)
    178 endif
    179 ifneq ($(filter 10.5 10.5.% 10.6 10.6.%,$(darwin_version)),)
    180     # We are on Leopard or Snow Leopard
    181     MSDK=10.5
    182 else
    183     # We are on Lion or beyond, and 10.6 SDK is the minimum in Xcode 4.x
    184    MSDK=10.6
    185 endif
    186 MACOSX_SDK := /Developer/SDKs/MacOSX$(MSDK).sdk
    187 ifeq ($(strip $(wildcard $(MACOSX_SDK))),)
    188   BUILD_EMULATOR := false
    189 endif
    190 else   # HOST_OS is not darwin
    191   BUILD_EMULATOR := true
    192 endif  # HOST_OS is darwin
    193 
    194 $(shell echo 'VERSIONS_CHECKED := $(VERSION_CHECK_SEQUENCE_NUMBER)' \
    195         > $(OUT_DIR)/versions_checked.mk)
    196 $(shell echo 'BUILD_EMULATOR := $(BUILD_EMULATOR)' \
    197         >> $(OUT_DIR)/versions_checked.mk)
    198 endif
    199 
    200 # These are the modifier targets that don't do anything themselves, but
    201 # change the behavior of the build.
    202 # (must be defined before including definitions.make)
    203 INTERNAL_MODIFIER_TARGETS := showcommands checkbuild all incrementaljavac
    204 
    205 .PHONY: incrementaljavac
    206 incrementaljavac: ;
    207 
    208 # WARNING:
    209 # ENABLE_INCREMENTALJAVAC should NOT be enabled by default, because change of
    210 # a Java source file won't trigger rebuild of its dependent Java files.
    211 # You can only enable it by adding "incrementaljavac" to your make command line.
    212 # You are responsible for the correctness of the incremental build.
    213 # This may decrease incremental build time dramatically for large Java libraries,
    214 # such as core.jar, framework.jar, etc.
    215 ENABLE_INCREMENTALJAVAC :=
    216 ifneq (,$(filter incrementaljavac, $(MAKECMDGOALS)))
    217 ENABLE_INCREMENTALJAVAC := true
    218 MAKECMDGOALS := $(filter-out incrementaljavac, $(MAKECMDGOALS))
    219 endif
    220 
    221 # EMMA_INSTRUMENT_STATIC merges the static emma library to each emma-enabled module.
    222 ifeq (true,$(EMMA_INSTRUMENT_STATIC))
    223 EMMA_INSTRUMENT := true
    224 endif
    225 
    226 # Bring in standard build system definitions.
    227 include $(BUILD_SYSTEM)/definitions.mk
    228 
    229 # Bring in dex_preopt.mk
    230 include $(BUILD_SYSTEM)/dex_preopt.mk
    231 
    232 ifneq ($(filter user userdebug eng,$(MAKECMDGOALS)),)
    233 $(info ***************************************************************)
    234 $(info ***************************************************************)
    235 $(info Do not pass '$(filter user userdebug eng tests,$(MAKECMDGOALS))' on \
    236 		the make command line.)
    237 $(info Set TARGET_BUILD_VARIANT in buildspec.mk, or use lunch or)
    238 $(info choosecombo.)
    239 $(info ***************************************************************)
    240 $(info ***************************************************************)
    241 $(error stopping)
    242 endif
    243 
    244 ifneq ($(filter-out $(INTERNAL_VALID_VARIANTS),$(TARGET_BUILD_VARIANT)),)
    245 $(info ***************************************************************)
    246 $(info ***************************************************************)
    247 $(info Invalid variant: $(TARGET_BUILD_VARIANT)
    248 $(info Valid values are: $(INTERNAL_VALID_VARIANTS)
    249 $(info ***************************************************************)
    250 $(info ***************************************************************)
    251 $(error stopping)
    252 endif
    253 
    254 # -----------------------------------------------------------------
    255 # Variable to check java support level inside PDK build.
    256 # Not necessary if the components is not in PDK.
    257 # not defined : not supported
    258 # "sdk" : sdk API only
    259 # "platform" : platform API supproted
    260 TARGET_BUILD_JAVA_SUPPORT_LEVEL := platform
    261 
    262 # -----------------------------------------------------------------
    263 # The pdk (Platform Development Kit) build
    264 include build/core/pdk_config.mk
    265 
    266 # -----------------------------------------------------------------
    267 ###
    268 ### In this section we set up the things that are different
    269 ### between the build variants
    270 ###
    271 
    272 is_sdk_build :=
    273 
    274 ifneq ($(filter sdk win_sdk sdk_addon,$(MAKECMDGOALS)),)
    275 is_sdk_build := true
    276 endif
    277 
    278 ## have selinux ##
    279 ifeq ($(HAVE_SELINUX),true)
    280 ADDITIONAL_BUILD_PROPERTIES += ro.build.selinux=1
    281 endif # HAVE_SELINUX
    282 
    283 ## user/userdebug ##
    284 
    285 user_variant := $(filter user userdebug,$(TARGET_BUILD_VARIANT))
    286 enable_target_debugging := true
    287 tags_to_install :=
    288 ifneq (,$(user_variant))
    289   # Target is secure in user builds.
    290   ADDITIONAL_DEFAULT_PROPERTIES += ro.secure=1
    291 
    292   ifeq ($(user_variant),userdebug)
    293     # Pick up some extra useful tools
    294     tags_to_install += debug
    295 
    296     # Enable Dalvik lock contention logging for userdebug builds.
    297     ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.lockprof.threshold=500
    298   else
    299     # Disable debugging in plain user builds.
    300     enable_target_debugging :=
    301   endif
    302 
    303   # Turn on Dalvik preoptimization for user builds, but only if not
    304   # explicitly disabled and the build is running on Linux (since host
    305   # Dalvik isn't built for non-Linux hosts).
    306   ifneq (true,$(DISABLE_DEXPREOPT))
    307     ifeq ($(user_variant),user)
    308       ifeq ($(HOST_OS),linux)
    309         WITH_DEXPREOPT := true
    310       endif
    311     endif
    312   endif
    313 
    314   # Disallow mock locations by default for user builds
    315   ADDITIONAL_DEFAULT_PROPERTIES += ro.allow.mock.location=0
    316 
    317 else # !user_variant
    318   # Turn on checkjni for non-user builds.
    319   ADDITIONAL_BUILD_PROPERTIES += ro.kernel.android.checkjni=1
    320   # Set device insecure for non-user builds.
    321   ADDITIONAL_DEFAULT_PROPERTIES += ro.secure=0
    322   # Allow mock locations by default for non user builds
    323   ADDITIONAL_DEFAULT_PROPERTIES += ro.allow.mock.location=1
    324 endif # !user_variant
    325 
    326 ifeq (true,$(strip $(enable_target_debugging)))
    327   # Target is more debuggable and adbd is on by default
    328   ADDITIONAL_DEFAULT_PROPERTIES += ro.debuggable=1
    329   # Include the debugging/testing OTA keys in this build.
    330   INCLUDE_TEST_OTA_KEYS := true
    331 else # !enable_target_debugging
    332   # Target is less debuggable and adbd is off by default
    333   ADDITIONAL_DEFAULT_PROPERTIES += ro.debuggable=0
    334 endif # !enable_target_debugging
    335 
    336 ## eng ##
    337 
    338 ifeq ($(TARGET_BUILD_VARIANT),eng)
    339 tags_to_install := debug eng
    340 ifneq ($(filter ro.setupwizard.mode=ENABLED, $(call collapse-pairs, $(ADDITIONAL_BUILD_PROPERTIES))),)
    341   # Don't require the setup wizard on eng builds
    342   ADDITIONAL_BUILD_PROPERTIES := $(filter-out ro.setupwizard.mode=%,\
    343           $(call collapse-pairs, $(ADDITIONAL_BUILD_PROPERTIES))) \
    344           ro.setupwizard.mode=OPTIONAL
    345 endif
    346 endif
    347 
    348 ## tests ##
    349 
    350 ifeq ($(TARGET_BUILD_VARIANT),tests)
    351 tags_to_install := debug eng tests
    352 endif
    353 
    354 ## sdk ##
    355 
    356 ifdef is_sdk_build
    357 
    358 # Detect if we want to build a repository for the SDK
    359 sdk_repo_goal := $(strip $(filter sdk_repo,$(MAKECMDGOALS)))
    360 MAKECMDGOALS := $(strip $(filter-out sdk_repo,$(MAKECMDGOALS)))
    361 
    362 ifneq ($(words $(filter-out $(INTERNAL_MODIFIER_TARGETS),$(MAKECMDGOALS))),1)
    363 $(error The 'sdk' target may not be specified with any other targets)
    364 endif
    365 
    366 # TODO: this should be eng I think.  Since the sdk is built from the eng
    367 # variant.
    368 tags_to_install := debug eng
    369 ADDITIONAL_BUILD_PROPERTIES += xmpp.auto-presence=true
    370 ADDITIONAL_BUILD_PROPERTIES += ro.config.nocheckin=yes
    371 else # !sdk
    372 endif
    373 
    374 BUILD_WITHOUT_PV := true
    375 
    376 ## precise GC ##
    377 
    378 ifneq ($(filter dalvik.gc.type-precise,$(PRODUCT_TAGS)),)
    379   # Enabling type-precise GC results in larger optimized DEX files.  The
    380   # additional storage requirements for ".odex" files can cause /system
    381   # to overflow on some devices, so this is configured separately for
    382   # each product.
    383   ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.dexopt-flags=m=y
    384 endif
    385 
    386 ADDITIONAL_BUILD_PROPERTIES += net.bt.name=Android
    387 
    388 # enable vm tracing in files for now to help track
    389 # the cause of ANRs in the content process
    390 ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.stack-trace-file=/data/anr/traces.txt
    391 
    392 # ------------------------------------------------------------
    393 # Define a function that, given a list of module tags, returns
    394 # non-empty if that module should be installed in /system.
    395 
    396 # For most goals, anything not tagged with the "tests" tag should
    397 # be installed in /system.
    398 define should-install-to-system
    399 $(if $(filter tests,$(1)),,true)
    400 endef
    401 
    402 ifdef is_sdk_build
    403 # For the sdk goal, anything with the "samples" tag should be
    404 # installed in /data even if that module also has "eng"/"debug"/"user".
    405 define should-install-to-system
    406 $(if $(filter samples tests,$(1)),,true)
    407 endef
    408 endif
    409 
    410 
    411 # If they only used the modifier goals (showcommands, checkbuild), we'll actually
    412 # build the default target.
    413 ifeq ($(filter-out $(INTERNAL_MODIFIER_TARGETS),$(MAKECMDGOALS)),)
    414 .PHONY: $(INTERNAL_MODIFIER_TARGETS)
    415 $(INTERNAL_MODIFIER_TARGETS): $(DEFAULT_GOAL)
    416 endif
    417 
    418 # These targets are going to delete stuff, don't bother including
    419 # the whole directory tree if that's all we're going to do
    420 ifeq ($(MAKECMDGOALS),clean)
    421 dont_bother := true
    422 endif
    423 ifeq ($(MAKECMDGOALS),clobber)
    424 dont_bother := true
    425 endif
    426 ifeq ($(MAKECMDGOALS),dataclean)
    427 dont_bother := true
    428 endif
    429 ifeq ($(MAKECMDGOALS),installclean)
    430 dont_bother := true
    431 endif
    432 
    433 # Bring in all modules that need to be built.
    434 ifneq ($(dont_bother),true)
    435 
    436 ifeq ($(HOST_OS)-$(HOST_ARCH),darwin-ppc)
    437 SDK_ONLY := true
    438 $(info Building the SDK under darwin-ppc is actually obsolete and unsupported.)
    439 $(error stop)
    440 endif
    441 
    442 ifeq ($(HOST_OS),windows)
    443 SDK_ONLY := true
    444 endif
    445 
    446 ifeq ($(SDK_ONLY),true)
    447 include $(TOPDIR)sdk/build/sdk_only_whitelist.mk
    448 include $(TOPDIR)development/build/sdk_only_whitelist.mk
    449 
    450 # Exclude tools/acp when cross-compiling windows under linux
    451 ifeq ($(findstring Linux,$(UNAME)),)
    452 subdirs += build/tools/acp
    453 endif
    454 
    455 else	# !SDK_ONLY
    456 ifeq ($(BUILD_TINY_ANDROID), true)
    457 
    458 # TINY_ANDROID is a super-minimal build configuration, handy for board
    459 # bringup and very low level debugging
    460 
    461 subdirs := \
    462 	bionic \
    463 	system/core \
    464 	system/extras/ext4_utils \
    465 	system/extras/su \
    466 	build/libs \
    467 	build/target \
    468 	build/tools/acp \
    469 	external/gcc-demangle \
    470 	external/mksh \
    471 	external/openssl \
    472 	external/yaffs2 \
    473 	external/zlib
    474 else	# !BUILD_TINY_ANDROID
    475 #
    476 # Typical build; include any Android.mk files we can find.
    477 #
    478 subdirs := $(TOP)
    479 
    480 FULL_BUILD := true
    481 
    482 endif	# !BUILD_TINY_ANDROID
    483 
    484 endif	# !SDK_ONLY
    485 
    486 # Before we go and include all of the module makefiles, stash away
    487 # the PRODUCT_* values so that later we can verify they are not modified.
    488 stash_product_vars:=true
    489 ifeq ($(stash_product_vars),true)
    490   $(call stash-product-vars, __STASHED)
    491 endif
    492 
    493 ifneq ($(ONE_SHOT_MAKEFILE),)
    494 # We've probably been invoked by the "mm" shell function
    495 # with a subdirectory's makefile.
    496 include $(ONE_SHOT_MAKEFILE)
    497 # Change CUSTOM_MODULES to include only modules that were
    498 # defined by this makefile; this will install all of those
    499 # modules as a side-effect.  Do this after including ONE_SHOT_MAKEFILE
    500 # so that the modules will be installed in the same place they
    501 # would have been with a normal make.
    502 CUSTOM_MODULES := $(sort $(call get-tagged-modules,$(ALL_MODULE_TAGS)))
    503 FULL_BUILD :=
    504 # Stub out the notice targets, which probably aren't defined
    505 # when using ONE_SHOT_MAKEFILE.
    506 NOTICE-HOST-%: ;
    507 NOTICE-TARGET-%: ;
    508 
    509 else # ONE_SHOT_MAKEFILE
    510 
    511 #
    512 # Include all of the makefiles in the system
    513 #
    514 
    515 # Can't use first-makefiles-under here because
    516 # --mindepth=2 makes the prunes not work.
    517 subdir_makefiles := \
    518 	$(shell build/tools/findleaves.py --prune=out --prune=.repo --prune=.git $(subdirs) Android.mk)
    519 
    520 include $(subdir_makefiles)
    521 
    522 endif # ONE_SHOT_MAKEFILE
    523 
    524 # Now with all Android.mks loaded we can do post cleaning steps.
    525 include $(BUILD_SYSTEM)/post_clean.mk
    526 
    527 ifeq ($(stash_product_vars),true)
    528   $(call assert-product-vars, __STASHED)
    529 endif
    530 
    531 include $(BUILD_SYSTEM)/legacy_prebuilts.mk
    532 ifneq ($(filter-out $(GRANDFATHERED_ALL_PREBUILT),$(strip $(notdir $(ALL_PREBUILT)))),)
    533   $(warning *** Some files have been added to ALL_PREBUILT.)
    534   $(warning *)
    535   $(warning * ALL_PREBUILT is a deprecated mechanism that)
    536   $(warning * should not be used for new files.)
    537   $(warning * As an alternative, use PRODUCT_COPY_FILES in)
    538   $(warning * the appropriate product definition.)
    539   $(warning * build/target/product/core.mk is the product)
    540   $(warning * definition used in all products.)
    541   $(warning *)
    542   $(foreach bad_prebuilt,$(filter-out $(GRANDFATHERED_ALL_PREBUILT),$(strip $(notdir $(ALL_PREBUILT)))),$(warning * unexpected $(bad_prebuilt) in ALL_PREBUILT))
    543   $(warning *)
    544   $(error ALL_PREBUILT contains unexpected files)
    545 endif
    546 
    547 # -------------------------------------------------------------------
    548 # All module makefiles have been included at this point.
    549 # -------------------------------------------------------------------
    550 
    551 # -------------------------------------------------------------------
    552 # Include any makefiles that must happen after the module makefiles
    553 # have been included.
    554 # TODO: have these files register themselves via a global var rather
    555 # than hard-coding the list here.
    556 ifdef FULL_BUILD
    557   # Only include this during a full build, otherwise we can't be
    558   # guaranteed that any policies were included.
    559   -include frameworks/policies/base/PolicyConfig.mk
    560 endif
    561 
    562 # -------------------------------------------------------------------
    563 # Fix up CUSTOM_MODULES to refer to installed files rather than
    564 # just bare module names.  Leave unknown modules alone in case
    565 # they're actually full paths to a particular file.
    566 known_custom_modules := $(filter $(ALL_MODULES),$(CUSTOM_MODULES))
    567 unknown_custom_modules := $(filter-out $(ALL_MODULES),$(CUSTOM_MODULES))
    568 CUSTOM_MODULES := \
    569 	$(call module-installed-files,$(known_custom_modules)) \
    570 	$(unknown_custom_modules)
    571 
    572 # -------------------------------------------------------------------
    573 # Define dependencies for modules that require other modules.
    574 # This can only happen now, after we've read in all module makefiles.
    575 #
    576 # TODO: deal with the fact that a bare module name isn't
    577 # unambiguous enough.  Maybe declare short targets like
    578 # APPS:Quake or HOST:SHARED_LIBRARIES:libutils.
    579 # BUG: the system image won't know to depend on modules that are
    580 # brought in as requirements of other modules.
    581 define add-required-deps
    582 $(1): $(2)
    583 endef
    584 $(foreach m,$(ALL_MODULES), \
    585   $(eval r := $(ALL_MODULES.$(m).REQUIRED)) \
    586   $(if $(r), \
    587     $(eval r := $(call module-installed-files,$(r))) \
    588     $(eval $(call add-required-deps,$(ALL_MODULES.$(m).INSTALLED),$(r))) \
    589    ) \
    590  )
    591 m :=
    592 r :=
    593 i :=
    594 add-required-deps :=
    595 
    596 # -------------------------------------------------------------------
    597 # Figure out our module sets.
    598 #
    599 # Of the modules defined by the component makefiles,
    600 # determine what we actually want to build.
    601 
    602 ifdef FULL_BUILD
    603   # The base list of modules to build for this product is specified
    604   # by the appropriate product definition file, which was included
    605   # by product_config.make.
    606   product_MODULES := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES)
    607   # Filter out the overridden packages before doing expansion
    608   product_MODULES := $(filter-out $(foreach p, $(product_MODULES), \
    609       $(PACKAGES.$(p).OVERRIDES)), $(product_MODULES))
    610   $(call expand-required-modules,product_MODULES,$(product_MODULES))
    611   product_FILES := $(call module-installed-files, $(product_MODULES))
    612   ifeq (0,1)
    613     $(info product_FILES for $(TARGET_DEVICE) ($(INTERNAL_PRODUCT)):)
    614     $(foreach p,$(product_FILES),$(info :   $(p)))
    615     $(error done)
    616   endif
    617 else
    618   # We're not doing a full build, and are probably only including
    619   # a subset of the module makefiles.  Don't try to build any modules
    620   # requested by the product, because we probably won't have rules
    621   # to build them.
    622   product_FILES :=
    623 endif
    624 
    625 # When modules are tagged with debug eng or tests, they are installed
    626 # for those variants regardless of what the product spec says.
    627 debug_MODULES := $(sort \
    628         $(call get-tagged-modules,debug) \
    629         $(call module-installed-files, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_DEBUG)) \
    630     )
    631 eng_MODULES := $(sort \
    632         $(call get-tagged-modules,eng) \
    633         $(call module-installed-files, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_ENG)) \
    634     )
    635 tests_MODULES := $(sort \
    636         $(call get-tagged-modules,tests) \
    637         $(call module-installed-files, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_TESTS)) \
    638     )
    639 
    640 # TODO: Remove the 3 places in the tree that use ALL_DEFAULT_INSTALLED_MODULES
    641 # and get rid of it from this list.
    642 # TODO: The shell is chosen by magic.  Do we still need this?
    643 modules_to_install := $(sort \
    644     $(ALL_DEFAULT_INSTALLED_MODULES) \
    645     $(product_FILES) \
    646     $(foreach tag,$(tags_to_install),$($(tag)_MODULES)) \
    647     $(call get-tagged-modules, shell_$(TARGET_SHELL)) \
    648     $(CUSTOM_MODULES) \
    649   )
    650 
    651 # Some packages may override others using LOCAL_OVERRIDES_PACKAGES.
    652 # Filter out (do not install) any overridden packages.
    653 overridden_packages := $(call get-package-overrides,$(modules_to_install))
    654 ifdef overridden_packages
    655 #  old_modules_to_install := $(modules_to_install)
    656   modules_to_install := \
    657       $(filter-out $(foreach p,$(overridden_packages),$(p) %/$(p).apk), \
    658           $(modules_to_install))
    659 endif
    660 #$(error filtered out
    661 #           $(filter-out $(modules_to_install),$(old_modules_to_install)))
    662 
    663 # Don't include any GNU targets in the SDK.  It's ok (and necessary)
    664 # to build the host tools, but nothing that's going to be installed
    665 # on the target (including static libraries).
    666 ifdef is_sdk_build
    667   target_gnu_MODULES := \
    668               $(filter \
    669                       $(TARGET_OUT_INTERMEDIATES)/% \
    670                       $(TARGET_OUT)/% \
    671                       $(TARGET_OUT_DATA)/%, \
    672                               $(sort $(call get-tagged-modules,gnu)))
    673   $(info Removing from sdk:)$(foreach d,$(target_gnu_MODULES),$(info : $(d)))
    674   modules_to_install := \
    675               $(filter-out $(target_gnu_MODULES),$(modules_to_install))
    676 
    677   # Ensure every module listed in PRODUCT_PACKAGES* gets something installed
    678   # TODO: Should we do this for all builds and not just the sdk?
    679   $(foreach m, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES), \
    680     $(if $(strip $(ALL_MODULES.$(m).INSTALLED)),,\
    681       $(warning $(ALL_MODULES.$(m).MAKEFILE): Module '$(m)' in PRODUCT_PACKAGES has nothing to install!)))
    682   $(foreach m, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_DEBUG), \
    683     $(if $(strip $(ALL_MODULES.$(m).INSTALLED)),,\
    684       $(warning $(ALL_MODULES.$(m).MAKEFILE): Module '$(m)' in PRODUCT_PACKAGES_DEBUG has nothing to install!)))
    685   $(foreach m, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_ENG), \
    686     $(if $(strip $(ALL_MODULES.$(m).INSTALLED)),,\
    687       $(warning $(ALL_MODULES.$(m).MAKEFILE): Module '$(m)' in PRODUCT_PACKAGES_ENG has nothing to install!)))
    688   $(foreach m, $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES_TESTS), \
    689     $(if $(strip $(ALL_MODULES.$(m).INSTALLED)),,\
    690       $(warning $(ALL_MODULES.$(m).MAKEFILE): Module '$(m)' in PRODUCT_PACKAGES_TESTS has nothing to install!)))
    691 endif
    692 
    693 # Install all of the host modules
    694 modules_to_install += $(sort $(modules_to_install) $(ALL_HOST_INSTALLED_FILES))
    695 
    696 # build/core/Makefile contains extra stuff that we don't want to pollute this
    697 # top-level makefile with.  It expects that ALL_DEFAULT_INSTALLED_MODULES
    698 # contains everything that's built during the current make, but it also further
    699 # extends ALL_DEFAULT_INSTALLED_MODULES.
    700 ALL_DEFAULT_INSTALLED_MODULES := $(modules_to_install)
    701 include $(BUILD_SYSTEM)/Makefile
    702 modules_to_install := $(sort $(ALL_DEFAULT_INSTALLED_MODULES))
    703 ALL_DEFAULT_INSTALLED_MODULES :=
    704 
    705 endif # dont_bother
    706 
    707 
    708 # These are additional goals that we build, in order to make sure that there
    709 # is as little code as possible in the tree that doesn't build.
    710 modules_to_check := $(foreach m,$(ALL_MODULES),$(ALL_MODULES.$(m).CHECKED))
    711 
    712 # If you would like to build all goals, and not skip any intermediate
    713 # steps, you can pass the "all" modifier goal on the commandline.
    714 ifneq ($(filter all,$(MAKECMDGOALS)),)
    715 modules_to_check += $(foreach m,$(ALL_MODULES),$(ALL_MODULES.$(m).BUILT))
    716 endif
    717 
    718 # for easier debugging
    719 modules_to_check := $(sort $(modules_to_check))
    720 #$(error modules_to_check $(modules_to_check))
    721 
    722 # -------------------------------------------------------------------
    723 # This is used to to get the ordering right, you can also use these,
    724 # but they're considered undocumented, so don't complain if their
    725 # behavior changes.
    726 .PHONY: prebuilt
    727 prebuilt: $(ALL_PREBUILT)
    728 
    729 # An internal target that depends on all copied headers
    730 # (see copy_headers.make).  Other targets that need the
    731 # headers to be copied first can depend on this target.
    732 .PHONY: all_copied_headers
    733 all_copied_headers: ;
    734 
    735 $(ALL_C_CPP_ETC_OBJECTS): | all_copied_headers
    736 
    737 # All the droid stuff, in directories
    738 .PHONY: files
    739 files: prebuilt \
    740         $(modules_to_install) \
    741         $(modules_to_check) \
    742         $(INSTALLED_ANDROID_INFO_TXT_TARGET)
    743 
    744 # -------------------------------------------------------------------
    745 
    746 .PHONY: checkbuild
    747 checkbuild: $(modules_to_check)
    748 
    749 .PHONY: ramdisk
    750 ramdisk: $(INSTALLED_RAMDISK_TARGET)
    751 
    752 .PHONY: factory_ramdisk
    753 factory_ramdisk: $(INSTALLED_FACTORY_RAMDISK_TARGET)
    754 
    755 .PHONY: factory_bundle
    756 factory_bundle: $(INSTALLED_FACTORY_BUNDLE_TARGET)
    757 
    758 .PHONY: systemtarball
    759 systemtarball: $(INSTALLED_SYSTEMTARBALL_TARGET)
    760 
    761 .PHONY: boottarball
    762 boottarball: $(INSTALLED_BOOTTARBALL_TARGET)
    763 
    764 .PHONY: userdataimage
    765 userdataimage: $(INSTALLED_USERDATAIMAGE_TARGET)
    766 
    767 ifneq (,$(filter userdataimage, $(MAKECMDGOALS)))
    768 $(call dist-for-goals, userdataimage, $(BUILT_USERDATAIMAGE_TARGET))
    769 endif
    770 
    771 .PHONY: userdatatarball
    772 userdatatarball: $(INSTALLED_USERDATATARBALL_TARGET)
    773 
    774 .PHONY: cacheimage
    775 cacheimage: $(INSTALLED_CACHEIMAGE_TARGET)
    776 
    777 .PHONY: bootimage
    778 bootimage: $(INSTALLED_BOOTIMAGE_TARGET)
    779 
    780 ifeq ($(BUILD_TINY_ANDROID), true)
    781 INSTALLED_RECOVERYIMAGE_TARGET :=
    782 endif
    783 
    784 # Build files and then package it into the rom formats
    785 .PHONY: droidcore
    786 droidcore: files \
    787 	systemimage \
    788 	$(INSTALLED_BOOTIMAGE_TARGET) \
    789 	$(INSTALLED_RECOVERYIMAGE_TARGET) \
    790 	$(INSTALLED_USERDATAIMAGE_TARGET) \
    791 	$(INSTALLED_CACHEIMAGE_TARGET) \
    792 	$(INSTALLED_FILES_FILE)
    793 
    794 # dist_files only for putting your library into the dist directory with a full build.
    795 .PHONY: dist_files
    796 
    797 # Dist for droid if droid is among the cmd goals, or no cmd goal is given.
    798 ifneq ($(filter droid,$(MAKECMDGOALS))$(filter ||,|$(filter-out $(INTERNAL_MODIFIER_TARGETS),$(MAKECMDGOALS))|),)
    799 
    800 ifneq ($(TARGET_BUILD_APPS),)
    801   # If this build is just for apps, only build apps and not the full system by default.
    802 
    803   unbundled_build_modules :=
    804   ifneq ($(filter all,$(TARGET_BUILD_APPS)),)
    805     # If they used the magic goal "all" then build all apps in the source tree.
    806     unbundled_build_modules := $(foreach m,$(sort $(ALL_MODULES)),$(if $(filter APPS,$(ALL_MODULES.$(m).CLASS)),$(m)))
    807   else
    808     unbundled_build_modules := $(TARGET_BUILD_APPS)
    809   endif
    810 
    811   apps_only_installed_files := $(foreach m,$(unbundled_build_modules),$(ALL_MODULES.$(m).INSTALLED))
    812   # dist the unbundled app.
    813   $(call dist-for-goals,apps_only, $(apps_only_installed_files))
    814 
    815   ifeq ($(EMMA_INSTRUMENT),true)
    816     $(EMMA_META_ZIP) : $(apps_only_installed_files)
    817 
    818     $(call dist-for-goals,apps_only, $(EMMA_META_ZIP))
    819   endif
    820 
    821 .PHONY: apps_only
    822 apps_only: $(unbundled_build_modules)
    823 
    824 droid: apps_only
    825 
    826 else # TARGET_BUILD_APPS
    827   $(call dist-for-goals, droidcore, \
    828     $(INTERNAL_UPDATE_PACKAGE_TARGET) \
    829     $(INTERNAL_OTA_PACKAGE_TARGET) \
    830     $(SYMBOLS_ZIP) \
    831     $(INSTALLED_FILES_FILE) \
    832     $(INSTALLED_BUILD_PROP_TARGET) \
    833     $(BUILT_TARGET_FILES_PACKAGE) \
    834     $(INSTALLED_ANDROID_INFO_TXT_TARGET) \
    835     $(INSTALLED_RAMDISK_TARGET) \
    836     $(INSTALLED_FACTORY_RAMDISK_TARGET) \
    837     $(INSTALLED_FACTORY_BUNDLE_TARGET) \
    838    )
    839 
    840   ifneq ($(TARGET_BUILD_PDK),true)
    841     $(call dist-for-goals, droidcore, \
    842       $(APPS_ZIP) \
    843       $(INTERNAL_EMULATOR_PACKAGE_TARGET) \
    844       $(PACKAGE_STATS_FILE) \
    845     )
    846   endif
    847 
    848   ifeq ($(EMMA_INSTRUMENT),true)
    849     $(EMMA_META_ZIP) : $(INSTALLED_SYSTEMIMAGE)
    850 
    851     $(call dist-for-goals, dist_files, $(EMMA_META_ZIP))
    852   endif
    853 
    854 # Building a full system-- the default is to build droidcore
    855 droid: droidcore dist_files
    856 
    857 endif # TARGET_BUILD_APPS
    858 endif # droid in $(MAKECMDGOALS)
    859 
    860 
    861 .PHONY: droid
    862 
    863 # phony target that include any targets in $(ALL_MODULES)
    864 .PHONY: all_modules
    865 all_modules: $(ALL_MODULES)
    866 
    867 .PHONY: docs
    868 docs: $(ALL_DOCS)
    869 
    870 .PHONY: sdk
    871 ALL_SDK_TARGETS := $(INTERNAL_SDK_TARGET)
    872 sdk: $(ALL_SDK_TARGETS)
    873 ifneq ($(filter sdk win_sdk,$(MAKECMDGOALS)),)
    874 $(call dist-for-goals,sdk win_sdk, \
    875     $(ALL_SDK_TARGETS) \
    876     $(SYMBOLS_ZIP) \
    877     $(INSTALLED_BUILD_PROP_TARGET) \
    878 )
    879 endif
    880 
    881 .PHONY: lintall
    882 
    883 .PHONY: samplecode
    884 sample_MODULES := $(sort $(call get-tagged-modules,samples))
    885 sample_APKS_DEST_PATH := $(TARGET_COMMON_OUT_ROOT)/samples
    886 sample_APKS_COLLECTION := \
    887         $(foreach module,$(sample_MODULES),$(sample_APKS_DEST_PATH)/$(notdir $(module)))
    888 $(foreach module,$(sample_MODULES),$(eval $(call \
    889         copy-one-file,$(module),$(sample_APKS_DEST_PATH)/$(notdir $(module)))))
    890 sample_ADDITIONAL_INSTALLED := \
    891         $(filter-out $(modules_to_install) $(modules_to_check) $(ALL_PREBUILT),$(sample_MODULES))
    892 samplecode: $(sample_APKS_COLLECTION)
    893 	@echo "Collect sample code apks: $^"
    894 	# remove apks that are not intended to be installed.
    895 	rm -f $(sample_ADDITIONAL_INSTALLED)
    896 
    897 .PHONY: findbugs
    898 findbugs: $(INTERNAL_FINDBUGS_HTML_TARGET) $(INTERNAL_FINDBUGS_XML_TARGET)
    899 
    900 .PHONY: clean
    901 clean:
    902 	@rm -rf $(OUT_DIR)
    903 	@echo "Entire build directory removed."
    904 
    905 .PHONY: clobber
    906 clobber: clean
    907 
    908 # The rules for dataclean and installclean are defined in cleanbuild.mk.
    909 
    910 #xxx scrape this from ALL_MODULE_NAME_TAGS
    911 .PHONY: modules
    912 modules:
    913 	@echo "Available sub-modules:"
    914 	@echo "$(call module-names-for-tag-list,$(ALL_MODULE_TAGS))" | \
    915 	      tr -s ' ' '\n' | sort -u | $(COLUMN)
    916 
    917 .PHONY: showcommands
    918 showcommands:
    919 	@echo >/dev/null
    920 
    921 .PHONY: nothing
    922 nothing:
    923 	@echo Successfully read the makefiles.
    924