core/main.mk

   1
   2 # Use bash, not whatever shell somebody has installed as /bin/sh
   3 # This is repeated in config.mk, since envsetup.sh runs that file
   4 # directly.
   5 SHELL := /bin/bash
   6
   7 # this turns off the suffix rules built into make
   8 .SUFFIXES:
   9
  10 # If a rule fails, delete $@.
  11 .DELETE_ON_ERROR:
  12
  13 # Figure out where we are.
  14 #TOP := $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))
  15 #TOP := $(patsubst %/,%,$(TOP))
  16
  17 # TOPDIR is the normal variable you should use, because
  18 # if we are executing relative to the current directory
  19 # it can be "", whereas TOP must be "." which causes
  20 # pattern matching probles when make strips off the
  21 # trailing "./" from paths in various places.
  22 #ifeq ($(TOP),.)
  23 #TOPDIR :=
  24 #else
  25 #TOPDIR := $(TOP)/
  26 #endif
  27
  28 # check for broken versions of make
  29 ifeq (0,$(shell expr $$(echo $(MAKE_VERSION) | sed "s/[^0-9\.].*//") \>= 3.81))
  30 $(warning ********************************************************************************)
  31 $(warning *  You are using version $(MAKE_VERSION) of make.)
  32 $(warning *  You must upgrade to version 3.81 or greater.)
  33 $(warning *  see file://$(shell pwd)/docs/development-environment/machine-setup.html)
  34 $(warning ********************************************************************************)
  35 $(error stopping)
  36 endif
  37
  38 TOP := .
  39 TOPDIR :=
  40
  41 BUILD_SYSTEM := $(TOPDIR)build/core
  42
  43 # This is the default target.  It must be the first declared target.
  44 DEFAULT_GOAL := droid
  45 $(DEFAULT_GOAL):
  46
  47 # Set up various standard variables based on configuration
  48 # and host information.
  49 include $(BUILD_SYSTEM)/config.mk
  50
  51 # This allows us to force a clean build - included after the config.make
  52 # environment setup is done, but before we generate any dependencies.  This
  53 # file does the rm -rf inline so the deps which are all done below will
  54 # be generated correctly
  55 include $(BUILD_SYSTEM)/cleanbuild.mk
  56
  57 ifneq ($(HOST_OS),windows)
  58 ifneq ($(HOST_OS)-$(HOST_ARCH),darwin-ppc)
  59 # check for a case sensitive file system
  60 ifneq (a,$(shell mkdir -p $(OUT_DIR) ; \
  61                 echo a > $(OUT_DIR)/casecheck.txt; \
  62                     echo B > $(OUT_DIR)/CaseCheck.txt; \
  63                 cat $(OUT_DIR)/casecheck.txt))
  64 $(warning ************************************************************)
  65 $(warning You are building on a case-insensitive filesystem.)
  66 $(warning Please move your source tree to a case-sensitive filesystem.)
  67 $(warning ************************************************************)
  68 $(error Case-insensitive filesystems not supported)
  69 endif
  70 endif
  71 endif
  72
  73 # Make sure that there are no spaces in the absolute path; the
  74 # build system can't deal with them.
  75 ifneq ($(words $(shell pwd)),1)
  76 $(warning ************************************************************)
  77 $(warning You are building in a directory whose absolute path contains)
  78 $(warning a space character:)
  79 $(warning $(space))
  80 $(warning "$(shell pwd)")
  81 $(warning $(space))
  82 $(warning Please move your source tree to a path that does not contain)
  83 $(warning any spaces.)
  84 $(warning ************************************************************)
  85 $(error Directory names containing spaces not supported)
  86 endif
  87
  88 # These are the modifier targets that don't do anything themselves, but
  89 # change the behavior of the build.
  90 # (must be defined before including definitions.make)
  91 INTERNAL_MODIFIER_TARGETS := showcommands
  92
  93 # Bring in standard build system definitions.
  94 include $(BUILD_SYSTEM)/definitions.mk
  95
  96 ifneq ($(filter eng user userdebug tests,$(MAKECMDGOALS)),)
  97 $(info ***************************************************************)
  98 $(info ***************************************************************)
  99 $(info Don't pass '$(filter eng user userdebug tests,$(MAKECMDGOALS))' on \
 100                 the make command line.)
 101 # XXX The single quote on this line fixes gvim's syntax highlighting.
 102 # Without which, the rest of this file is impossible to read.
 103 $(info Set TARGET_BUILD_VARIANT in buildspec.mk, or use lunch or)
 104 $(info choosecombo.)
 105 $(info ***************************************************************)
 106 $(info ***************************************************************)
 107 $(error stopping)
 108 endif
 109
 110 ifneq ($(filter-out $(INTERNAL_VALID_VARIANTS),$(TARGET_BUILD_VARIANT)),)
 111 $(info ***************************************************************)
 112 $(info ***************************************************************)
 113 $(info Invalid variant: $(TARGET_BUILD_VARIANT)
 114 $(info Valid values are: $(INTERNAL_VALID_VARIANTS)
 115 $(info ***************************************************************)
 116 $(info ***************************************************************)
 117 $(error stopping)
 118 endif
 119
 120 ###
 121 ### In this section we set up the things that are different
 122 ### between the build variants
 123 ###
 124
 125 is_sdk_build :=
 126 ifneq ($(filter sdk,$(MAKECMDGOALS)),)
 127 is_sdk_build := true
 128 endif
 129 ifneq ($(filter sdk_addon,$(MAKECMDGOALS)),)
 130 is_sdk_build := true
 131 endif
 132
 133
 134 ## user/userdebug ##
 135
 136 user_variant := $(filter userdebug user,$(TARGET_BUILD_VARIANT))
 137 enable_target_debugging := true
 138 ifneq (,$(user_variant))
 139   # Target is secure in user builds.
 140   ADDITIONAL_DEFAULT_PROPERTIES += ro.secure=1
 141
 142   tags_to_install := user
 143   ifeq ($(user_variant),userdebug)
 144     # Pick up some extra useful tools
 145     tags_to_install += debug
 146   else
 147     # Disable debugging in plain user builds.
 148     enable_target_debugging :=
 149   endif
 150
 151   # TODO: Always set WITH_DEXPREOPT (for user builds) once it works on OSX.
 152   # Also, remove the corresponding block in config/product_config.make.
 153   ifeq ($(HOST_OS)-$(WITH_DEXPREOPT_buildbot),linux-true)
 154     WITH_DEXPREOPT := true
 155   endif
 156
 157   # Disallow mock locations by default for user builds
 158   ADDITIONAL_DEFAULT_PROPERTIES += ro.allow.mock.location=0
 159
 160 else # !user_variant
 161   # Turn on checkjni for non-user builds.
 162   ADDITIONAL_BUILD_PROPERTIES += ro.kernel.android.checkjni=1
 163   # Set device insecure for non-user builds.
 164   ADDITIONAL_DEFAULT_PROPERTIES += ro.secure=0
 165   # Allow mock locations by default for non user builds
 166   ADDITIONAL_DEFAULT_PROPERTIES += ro.allow.mock.location=1
 167 endif # !user_variant
 168
 169 ifeq (true,$(strip $(enable_target_debugging)))
 170   # Target is more debuggable and adbd is on by default
 171   ADDITIONAL_DEFAULT_PROPERTIES += ro.debuggable=1 persist.service.adb.enable=1
 172   # Include the debugging/testing OTA keys in this build.
 173   INCLUDE_TEST_OTA_KEYS := true
 174 else # !enable_target_debugging
 175   # Target is less debuggable and adbd is off by default
 176   ADDITIONAL_DEFAULT_PROPERTIES += ro.debuggable=0 persist.service.adb.enable=0
 177 endif # !enable_target_debugging
 178
 179 ## eng ##
 180
 181 ifeq ($(TARGET_BUILD_VARIANT),eng)
 182 tags_to_install := user debug eng
 183   # Don't require the setup wizard on eng builds
 184   ADDITIONAL_BUILD_PROPERTIES := $(filter-out ro.setupwizard.mode=%,\
 185           $(call collapse-pairs, $(ADDITIONAL_BUILD_PROPERTIES)))
 186 endif
 187
 188 ## tests ##
 189
 190 ifeq ($(TARGET_BUILD_VARIANT),tests)
 191 tags_to_install := user debug eng tests
 192 endif
 193
 194 ## sdk ##
 195
 196 ifdef is_sdk_build
 197 ifneq ($(words $(filter-out $(INTERNAL_MODIFIER_TARGETS),$(MAKECMDGOALS))),1)
 198 $(error The 'sdk' target may not be specified with any other targets)
 199 endif
 200 # TODO: this should be eng I think.  Since the sdk is built from the eng
 201 # variant.
 202 tags_to_install := user debug eng
 203 ADDITIONAL_BUILD_PROPERTIES += xmpp.auto-presence=true
 204 ADDITIONAL_BUILD_PROPERTIES += ro.config.nocheckin=yes
 205 else # !sdk
 206 # Enable sync for non-sdk builds only (sdk builds lack SubscribedFeedsProvider).
 207 ADDITIONAL_BUILD_PROPERTIES += ro.config.sync=yes
 208 endif
 209
 210 # Install an apns-conf.xml file if one's not already being installed.
 211 ifeq (,$(filter %:system/etc/apns-conf.xml, $(PRODUCT_COPY_FILES)))
 212   PRODUCT_COPY_FILES += \
 213         development/data/etc/apns-conf_sdk.xml:system/etc/apns-conf.xml
 214   ifeq ($(filter eng tests,$(TARGET_BUILD_VARIANT)),)
 215     $(warning implicitly installing apns-conf_sdk.xml)
 216   endif
 217 endif
 218 # If we're on an eng or tests build, but not on the sdk, and we have
 219 # a better one, use that instead.
 220 ifneq ($(filter eng tests,$(TARGET_BUILD_VARIANT)),)
 221   ifdef is_sdk_build
 222     apns_to_use := $(wildcard vendor/google/etc/apns-conf.xml)
 223     ifneq ($(strip $(apns_to_use)),)
 224       PRODUCT_COPY_FILES := \
 225             $(filter-out %:system/etc/apns-conf.xml,$(PRODUCT_COPY_FILES)) \
 226             $(strip $(apns_to_use)):system/etc/apns-conf.xml
 227     endif
 228   endif
 229 endif
 230
 231 ADDITIONAL_BUILD_PROPERTIES += net.bt.name=Android
 232
 233 # enable vm tracing in files for now to help track
 234 # the cause of ANRs in the content process
 235 ADDITIONAL_BUILD_PROPERTIES += dalvik.vm.stack-trace-file=/data/anr/traces.txt
 236
 237
 238 # ------------------------------------------------------------
 239 # Define a function that, given a list of module tags, returns
 240 # non-empty if that module should be installed in /system.
 241
 242 # For most goals, anything not tagged with the "tests" tag should
 243 # be installed in /system.
 244 define should-install-to-system
 245 $(if $(filter tests,$(1)),,true)
 246 endef
 247
 248 ifdef is_sdk_build
 249 # For the sdk goal, anything with the "samples" tag should be
 250 # installed in /data even if that module also has "eng"/"debug"/"user".
 251 define should-install-to-system
 252 $(if $(filter samples tests,$(1)),,true)
 253 endef
 254 endif
 255
 256
 257 # If all they typed was make showcommands, we'll actually build
 258 # the default target.
 259 ifeq ($(MAKECMDGOALS),showcommands)
 260 .PHONY: showcommands
 261 showcommands: $(DEFAULT_GOAL)
 262 endif
 263
 264 # These targets are going to delete stuff, don't bother including
 265 # the whole directory tree if that's all we're going to do
 266 ifeq ($(MAKECMDGOALS),clean)
 267 dont_bother := true
 268 endif
 269 ifeq ($(MAKECMDGOALS),clobber)
 270 dont_bother := true
 271 endif
 272 ifeq ($(MAKECMDGOALS),dataclean)
 273 dont_bother := true
 274 endif
 275 ifeq ($(MAKECMDGOALS),installclean)
 276 dont_bother := true
 277 endif
 278
 279 # Bring in all modules that need to be built.
 280 ifneq ($(dont_bother),true)
 281
 282 subdir_makefiles :=
 283
 284 ifeq ($(HOST_OS),windows)
 285 SDK_ONLY := true
 286 endif
 287 ifeq ($(HOST_OS)-$(HOST_ARCH),darwin-ppc)
 288 SDK_ONLY := true
 289 endif
 290
 291 ifeq ($(SDK_ONLY),true)
 292
 293 subdirs := \
 294         prebuilt \
 295         build/libs/host \
 296         dalvik/dexdump \
 297         dalvik/libdex \
 298         dalvik/tools/dmtracedump \
 299         dalvik/tools/hprof-conv \
 300         development/emulator/mksdcard \
 301         development/tools/line_endings \
 302         development/host \
 303         external/expat \
 304         external/libpng \
 305         external/qemu \
 306         external/sqlite/dist \
 307         external/zlib \
 308         frameworks/base/libs/utils \
 309         frameworks/base/tools/aapt \
 310         frameworks/base/tools/aidl \
 311         system/core/adb \
 312         system/core/fastboot \
 313         system/core/libcutils \
 314         system/core/liblog \
 315         system/core/libzipfile
 316
 317 # The following can only be built if "javac" is available.
 318 # This check is used when building parts of the SDK under Cygwin.
 319 ifneq (,$(shell which javac 2>/dev/null))
 320 $(warning sdk-only: javac available.)
 321 subdirs += \
 322         build/tools/signapk \
 323         build/tools/zipalign \
 324         dalvik/dx \
 325         dalvik/libcore \
 326         development/apps \
 327         development/tools/androidprefs \
 328         development/tools/apkbuilder \
 329         development/tools/jarutils \
 330         development/tools/layoutlib_utils \
 331         development/tools/ninepatch \
 332         development/tools/sdkstats \
 333         development/tools/sdkmanager \
 334         development/tools/mkstubs \
 335         frameworks/base \
 336         frameworks/base/tools/layoutlib \
 337         external/googleclient \
 338         packages
 339 else
 340 $(warning sdk-only: javac not available.)
 341 endif
 342
 343 # Exclude tools/acp when cross-compiling windows under linux
 344 ifeq ($(findstring Linux,$(UNAME)),)
 345 subdirs += build/tools/acp
 346 endif
 347
 348 else    # !SDK_ONLY
 349 ifeq ($(BUILD_TINY_ANDROID), true)
 350
 351 # TINY_ANDROID is a super-minimal build configuration, handy for board
 352 # bringup and very low level debugging
 353
 354 INTERNAL_DEFAULT_DOCS_TARGETS :=
 355
 356 subdirs := \
 357         bionic \
 358         system/core \
 359         build/libs \
 360         build/target \
 361         build/tools/acp \
 362         build/tools/apriori \
 363         build/tools/kcm \
 364         build/tools/soslim \
 365         external/elfcopy \
 366         external/elfutils \
 367         external/yaffs2 \
 368         external/zlib
 369 else    # !BUILD_TINY_ANDROID
 370
 371 #
 372 # Typical build; include any Android.mk files we can find.
 373 #
 374 INTERNAL_DEFAULT_DOCS_TARGETS := offline-sdk-docs
 375 subdirs := $(TOP)
 376
 377 FULL_BUILD := true
 378
 379 endif   # !BUILD_TINY_ANDROID
 380
 381 endif   # !SDK_ONLY
 382
 383 # Can't use first-makefiles-under here because
 384 # --mindepth=2 makes the prunes not work.
 385 subdir_makefiles += \
 386         $(shell build/tools/findleaves.sh --prune="./out" $(subdirs) Android.mk)
 387
 388 # Boards may be defined under $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)
 389 # or under vendor/*/$(TARGET_DEVICE).  Search in both places, but
 390 # make sure only one exists.
 391 # Real boards should always be associated with an OEM vendor.
 392 board_config_mk := \
 393         $(strip $(wildcard \
 394                 $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/BoardConfig.mk \
 395                 vendor/*/$(TARGET_DEVICE)/BoardConfig.mk \
 396         ))
 397 ifeq ($(board_config_mk),)
 398   $(error No config file found for TARGET_DEVICE $(TARGET_DEVICE))
 399 endif
 400 ifneq ($(words $(board_config_mk)),1)
 401   $(error Multiple board config files for TARGET_DEVICE $(TARGET_DEVICE): $(board_config_mk))
 402 endif
 403 include $(board_config_mk)
 404 TARGET_DEVICE_DIR := $(patsubst %/,%,$(dir $(board_config_mk)))
 405 board_config_mk :=
 406
 407 # Clean up/verify variables defined by the board config file.
 408 TARGET_BOOTLOADER_BOARD_NAME := $(strip $(TARGET_BOOTLOADER_BOARD_NAME))
 409 TARGET_CPU_ABI := $(strip $(TARGET_CPU_ABI))
 410 ifeq ($(TARGET_CPU_ABI),)
 411   $(error No TARGET_CPU_ABI defined by board config: $(board_config_mk))
 412 endif
 413
 414 #
 415 # Include all of the makefiles in the system
 416 #
 417
 418 ifneq ($(ONE_SHOT_MAKEFILE),)
 419 # We've probably been invoked by the "mm" shell function
 420 # with a subdirectory's makefile.
 421 include $(ONE_SHOT_MAKEFILE)
 422 # Change CUSTOM_MODULES to include only modules that were
 423 # defined by this makefile; this will install all of those
 424 # modules as a side-effect.  Do this after including ONE_SHOT_MAKEFILE
 425 # so that the modules will be installed in the same place they
 426 # would have been with a normal make.
 427 CUSTOM_MODULES := $(sort $(call get-tagged-modules,$(ALL_MODULE_TAGS),))
 428 FULL_BUILD :=
 429 INTERNAL_DEFAULT_DOCS_TARGETS :=
 430 # Stub out the notice targets, which probably aren't defined
 431 # when using ONE_SHOT_MAKEFILE.
 432 NOTICE-HOST-%: ;
 433 NOTICE-TARGET-%: ;
 434 else
 435 include $(subdir_makefiles)
 436 endif
 437 # -------------------------------------------------------------------
 438 # All module makefiles have been included at this point.
 439 # -------------------------------------------------------------------
 440
 441 # -------------------------------------------------------------------
 442 # Include any makefiles that must happen after the module makefiles
 443 # have been included.
 444 # TODO: have these files register themselves via a global var rather
 445 # than hard-coding the list here.
 446 ifdef FULL_BUILD
 447   # Only include this during a full build, otherwise we can't be
 448   # guaranteed that any policies were included.
 449   -include frameworks/policies/base/PolicyConfig.mk
 450 endif
 451
 452 # -------------------------------------------------------------------
 453 # Fix up CUSTOM_MODULES to refer to installed files rather than
 454 # just bare module names.  Leave unknown modules alone in case
 455 # they're actually full paths to a particular file.
 456 known_custom_modules := $(filter $(ALL_MODULES),$(CUSTOM_MODULES))
 457 unknown_custom_modules := $(filter-out $(ALL_MODULES),$(CUSTOM_MODULES))
 458 CUSTOM_MODULES := \
 459         $(call module-installed-files,$(known_custom_modules)) \
 460         $(unknown_custom_modules)
 461
 462 # -------------------------------------------------------------------
 463 # Define dependencies for modules that require other modules.
 464 # This can only happen now, after we've read in all module makefiles.
 465 #
 466 # TODO: deal with the fact that a bare module name isn't
 467 # unambiguous enough.  Maybe declare short targets like
 468 # APPS:Quake or HOST:SHARED_LIBRARIES:libutils.
 469 # BUG: the system image won't know to depend on modules that are
 470 # brought in as requirements of other modules.
 471 define add-required-deps
 472 $(1): $(2)
 473 endef
 474 $(foreach m,$(ALL_MODULES), \
 475   $(eval r := $(ALL_MODULES.$(m).REQUIRED)) \
 476   $(if $(r), \
 477     $(eval r := $(call module-installed-files,$(r))) \
 478     $(eval $(call add-required-deps,$(ALL_MODULES.$(m).INSTALLED),$(r))) \
 479    ) \
 480  )
 481 m :=
 482 r :=
 483 add-required-deps :=
 484
 485 # -------------------------------------------------------------------
 486 # Figure out our module sets.
 487
 488 # Of the modules defined by the component makefiles,
 489 # determine what we actually want to build.
 490 # If a module has the "restricted" tag on it, it
 491 # poisons the rest of the tags and shouldn't appear
 492 # on any list.
 493 Default_MODULES := $(sort $(ALL_DEFAULT_INSTALLED_MODULES) \
 494                           $(ALL_BUILT_MODULES) \
 495                           $(CUSTOM_MODULES))
 496 # TODO: Remove the 3 places in the tree that use
 497 # ALL_DEFAULT_INSTALLED_MODULES and get rid of it from this list.
 498
 499 ifdef FULL_BUILD
 500   # The base list of modules to build for this product is specified
 501   # by the appropriate product definition file, which was included
 502   # by product_config.make.
 503   user_PACKAGES := $(call module-installed-files, \
 504                        $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGES))
 505   ifeq (0,1)
 506     $(info user packages for $(TARGET_DEVICE) ($(INTERNAL_PRODUCT)):)
 507     $(foreach p,$(user_PACKAGES),$(info :   $(p)))
 508     $(error done)
 509   endif
 510 else
 511   # We're not doing a full build, and are probably only including
 512   # a subset of the module makefiles.  Don't try to build any modules
 513   # requested by the product, because we probably won't have rules
 514   # to build them.
 515   user_PACKAGES :=
 516 endif
 517 # Use tags to get the non-APPS user modules.  Use the product
 518 # definition files to get the APPS user modules.
 519 user_MODULES := $(sort $(call get-tagged-modules,user,_class@APPS restricted))
 520 user_MODULES := $(user_MODULES) $(user_PACKAGES)
 521
 522 eng_MODULES := $(sort $(call get-tagged-modules,eng,restricted))
 523 debug_MODULES := $(sort $(call get-tagged-modules,debug,restricted))
 524 tests_MODULES := $(sort $(call get-tagged-modules,tests,restricted))
 525
 526 ifeq ($(strip $(tags_to_install)),)
 527 $(error ASSERTION FAILED: tags_to_install should not be empty)
 528 endif
 529 modules_to_install := $(sort $(Default_MODULES) \
 530           $(foreach tag,$(tags_to_install),$($(tag)_MODULES)))
 531
 532 # Some packages may override others using LOCAL_OVERRIDES_PACKAGES.
 533 # Filter out (do not install) any overridden packages.
 534 overridden_packages := $(call get-package-overrides,$(modules_to_install))
 535 ifdef overridden_packages
 536 #  old_modules_to_install := $(modules_to_install)
 537   modules_to_install := \
 538       $(filter-out $(foreach p,$(overridden_packages),$(p) %/$(p).apk), \
 539           $(modules_to_install))
 540 endif
 541 #$(error filtered out
 542 #           $(filter-out $(modules_to_install),$(old_modules_to_install)))
 543
 544 # Don't include any GNU targets in the SDK.  It's ok (and necessary)
 545 # to build the host tools, but nothing that's going to be installed
 546 # on the target (including static libraries).
 547 ifdef is_sdk_build
 548   target_gnu_MODULES := \
 549               $(filter \
 550                       $(TARGET_OUT_INTERMEDIATES)/% \
 551                       $(TARGET_OUT)/% \
 552                       $(TARGET_OUT_DATA)/%, \
 553                               $(sort $(call get-tagged-modules,gnu)))
 554   $(info Removing from sdk:)$(foreach d,$(target_gnu_MODULES),$(info : $(d)))
 555   modules_to_install := \
 556               $(filter-out $(target_gnu_MODULES),$(modules_to_install))
 557 endif
 558
 559
 560 # config/Makefile contains extra stuff that we don't want to pollute this
 561 # top-level makefile with.  It expects that ALL_DEFAULT_INSTALLED_MODULES
 562 # contains everything that's built during the current make, but it also further
 563 # extends ALL_DEFAULT_INSTALLED_MODULES.
 564 ALL_DEFAULT_INSTALLED_MODULES := $(modules_to_install)
 565 include $(BUILD_SYSTEM)/Makefile
 566 modules_to_install := $(sort $(ALL_DEFAULT_INSTALLED_MODULES))
 567 ALL_DEFAULT_INSTALLED_MODULES :=
 568
 569 endif # dont_bother
 570
 571 # -------------------------------------------------------------------
 572 # This is used to to get the ordering right, you can also use these,
 573 # but they're considered undocumented, so don't complain if their
 574 # behavior changes.
 575 .PHONY: prebuilt
 576 prebuilt: $(ALL_PREBUILT)
 577
 578 # An internal target that depends on all copied headers
 579 # (see copy_headers.make).  Other targets that need the
 580 # headers to be copied first can depend on this target.
 581 .PHONY: all_copied_headers
 582 all_copied_headers: ;
 583
 584 $(ALL_C_CPP_ETC_OBJECTS): | all_copied_headers
 585
 586 # All the droid stuff, in directories
 587 .PHONY: files
 588 files: prebuilt $(modules_to_install) $(INSTALLED_ANDROID_INFO_TXT_TARGET)
 589
 590 # -------------------------------------------------------------------
 591
 592 .PHONY: ramdisk
 593 ramdisk: $(INSTALLED_RAMDISK_TARGET)
 594
 595 .PHONY: systemtarball
 596 systemtarball: $(INSTALLED_SYSTEMTARBALL_TARGET)
 597
 598 .PHONY: userdataimage
 599 userdataimage: $(INSTALLED_USERDATAIMAGE_TARGET)
 600
 601 .PHONY: userdatatarball
 602 userdatatarball: $(INSTALLED_USERDATATARBALL_TARGET)
 603
 604 .PHONY: bootimage
 605 bootimage: $(INSTALLED_BOOTIMAGE_TARGET)
 606
 607 ifeq ($(BUILD_TINY_ANDROID), true)
 608 INSTALLED_RECOVERYIMAGE_TARGET :=
 609 endif
 610
 611 # Build files and then package it into the rom formats
 612 .PHONY: droidcore
 613 droidcore: files \
 614         systemimage \
 615         $(INSTALLED_BOOTIMAGE_TARGET) \
 616         $(INSTALLED_RECOVERYIMAGE_TARGET) \
 617         $(INSTALLED_USERDATAIMAGE_TARGET) \
 618         $(INTERNAL_DEFAULT_DOCS_TARGETS) \
 619         $(INSTALLED_FILES_FILE)
 620
 621 # The actual files built by the droidcore target changes depending
 622 # on the build variant.
 623 .PHONY: droid tests
 624 droid tests: droidcore
 625
 626 $(call dist-for-goals, droid, \
 627         $(INTERNAL_UPDATE_PACKAGE_TARGET) \
 628         $(INTERNAL_OTA_PACKAGE_TARGET) \
 629         $(SYMBOLS_ZIP) \
 630         $(APPS_ZIP) \
 631         $(INTERNAL_EMULATOR_PACKAGE_TARGET) \
 632         $(PACKAGE_STATS_FILE) \
 633         $(INSTALLED_FILES_FILE) \
 634         $(INSTALLED_BUILD_PROP_TARGET) \
 635         $(BUILT_TARGET_FILES_PACKAGE) \
 636  )
 637
 638 # Tests are installed in userdata.img.  If we're building the tests
 639 # variant, copy it for "make tests dist".  Also copy a zip of the
 640 # contents of userdata.img, so that people can easily extract a
 641 # single .apk.
 642 ifeq ($(TARGET_BUILD_VARIANT),tests)
 643 $(call dist-for-goals, droid, \
 644         $(INSTALLED_USERDATAIMAGE_TARGET) \
 645         $(BUILT_TESTS_ZIP_PACKAGE) \
 646  )
 647 endif
 648
 649 .PHONY: docs
 650 docs: $(ALL_DOCS)
 651
 652 .PHONY: sdk
 653 ALL_SDK_TARGETS := $(INTERNAL_SDK_TARGET)
 654 sdk: $(ALL_SDK_TARGETS)
 655 $(call dist-for-goals,sdk,$(ALL_SDK_TARGETS))
 656
 657 .PHONY: findbugs
 658 findbugs: $(INTERNAL_FINDBUGS_HTML_TARGET) $(INTERNAL_FINDBUGS_XML_TARGET)
 659
 660 .PHONY: clean
 661 dirs_to_clean := \
 662         $(PRODUCT_OUT) \
 663         $(TARGET_COMMON_OUT_ROOT) \
 664         $(HOST_OUT) \
 665         $(HOST_COMMON_OUT_ROOT)
 666 clean:
 667         @for dir in $(dirs_to_clean) ; do \
 668             echo "Cleaning $$dir..."; \
 669             rm -rf $$dir; \
 670         done
 671         @echo "Clean."; \
 672
 673 .PHONY: clobber
 674 clobber:
 675         @rm -rf $(OUT_DIR)
 676         @echo "Entire build directory removed."
 677
 678 # The rules for dataclean and installclean are defined in cleanbuild.mk.
 679
 680 #xxx scrape this from ALL_MODULE_NAME_TAGS
 681 .PHONY: modules
 682 modules:
 683         @echo "Available sub-modules:"
 684         @echo "$(call module-names-for-tag-list,$(ALL_MODULE_TAGS))" | \
 685               sed -e 's/  */\n/g' | sort -u | $(COLUMN)
 686
 687 .PHONY: showcommands
 688 showcommands:
 689         @echo >/dev/null
 690