core/main.mk

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