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