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