definitions.mk revision 5dbb529de9f84e731e26b83525f3f599f1914aca
1#
2# Copyright (C) 2008 The Android Open Source Project
3#
4# Licensed under the Apache License, Version 2.0 (the "License");
5# you may not use this file except in compliance with the License.
6# You may obtain a copy of the License at
7#
8#      http://www.apache.org/licenses/LICENSE-2.0
9#
10# Unless required by applicable law or agreed to in writing, software
11# distributed under the License is distributed on an "AS IS" BASIS,
12# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13# See the License for the specific language governing permissions and
14# limitations under the License.
15#
16
17##
18## Common build system definitions.  Mostly standard
19## commands for building various types of targets, which
20## are used by others to construct the final targets.
21##
22
23# These are variables we use to collect overall lists
24# of things being processed.
25
26# Full paths to all of the documentation
27ALL_DOCS:=
28
29# The short names of all of the targets in the system.
30# For each element of ALL_MODULES, two other variables
31# are defined:
32#   $(ALL_MODULES.$(target)).BUILT
33#   $(ALL_MODULES.$(target)).INSTALLED
34# The BUILT variable contains LOCAL_BUILT_MODULE for that
35# target, and the INSTALLED variable contains the LOCAL_INSTALLED_MODULE.
36# Some targets may have multiple files listed in the BUILT and INSTALLED
37# sub-variables.
38ALL_MODULES:=
39
40# Full paths to targets that should be added to the "make droid"
41# set of installed targets.
42ALL_DEFAULT_INSTALLED_MODULES:=
43
44# Full paths to all targets that will be built.
45ALL_BUILT_MODULES:=
46
47# The list of tags that have been defined by
48# LOCAL_MODULE_TAGS.  Each word in this variable maps
49# to a corresponding ALL_MODULE_TAGS.<tagname> variable
50# that contains all of the INSTALLED_MODULEs with that tag.
51ALL_MODULE_TAGS:=
52
53# Similar to ALL_MODULE_TAGS, but contains the short names
54# of all targets for a particular tag.  The top-level variable
55# won't have the list of tags;  ust ALL_MODULE_TAGS to get
56# the list of all known tags.  (This means that this variable
57# will always be empty; it's just here as a placeholder for
58# its sub-variables.)
59ALL_MODULE_NAME_TAGS:=
60
61# Full paths to all prebuilt files that will be copied
62# (used to make the dependency on acp)
63ALL_PREBUILT:=
64
65# Full path to all files that are made by some tool
66ALL_GENERATED_SOURCES:=
67
68# Full path to all asm, C, C++, lex and yacc generated C files.
69# These all have an order-only dependency on the copied headers
70ALL_C_CPP_ETC_OBJECTS:=
71
72# The list of dynamic binaries that haven't been stripped/compressed/prelinked.
73ALL_ORIGINAL_DYNAMIC_BINARIES:=
74
75# These files go into the SDK
76ALL_SDK_FILES:=
77
78# Files for dalvik.  This is often build without building the rest of the OS.
79INTERNAL_DALVIK_MODULES:=
80
81# All findbugs xml files
82ALL_FINDBUGS_FILES:=
83
84###########################################################
85## Debugging; prints a variable list to stdout
86###########################################################
87
88# $(1): variable name list, not variable values
89define print-vars
90$(foreach var,$(1), \
91  $(info $(var):) \
92  $(foreach word,$($(var)), \
93    $(info $(space)$(space)$(word)) \
94   ) \
95 )
96endef
97
98###########################################################
99## Evaluates to true if the string contains the word true,
100## and empty otherwise
101## $(1): a var to test
102###########################################################
103
104define true-or-empty
105$(filter true, $(1))
106endef
107
108
109###########################################################
110## Retrieve the directory of the current makefile
111###########################################################
112
113# Figure out where we are.
114define my-dir
115$(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST),$(MAKEFILE_LIST))))
116endef
117
118###########################################################
119## Retrieve a list of all makefiles immediately below some directory
120###########################################################
121
122define all-makefiles-under
123$(wildcard $(1)/*/Android.mk)
124endef
125
126###########################################################
127## Look under a directory for makefiles that don't have parent
128## makefiles.
129###########################################################
130
131# $(1): directory to search under
132# Ignores $(1)/Android.mk
133define first-makefiles-under
134$(shell build/tools/findleaves.sh --mindepth=2 $(1) Android.mk)
135endef
136
137###########################################################
138## Retrieve a list of all makefiles immediately below your directory
139###########################################################
140
141define all-subdir-makefiles
142$(call all-makefiles-under,$(call my-dir))
143endef
144
145###########################################################
146## Look in the named list of directories for makefiles,
147## relative to the current directory.
148###########################################################
149
150# $(1): List of directories to look for under this directory
151define all-named-subdir-makefiles
152$(wildcard $(addsuffix /Android.mk, $(addprefix $(my-dir)/,$(1))))
153endef
154
155###########################################################
156## Find all of the java files under the named directories.
157## Meant to be used like:
158##    SRC_FILES := $(call all-java-files-under,src tests)
159###########################################################
160
161define all-java-files-under
162$(patsubst ./%,%, \
163  $(shell cd $(LOCAL_PATH) ; \
164          find $(1) -name "*.java" -and -not -name ".*") \
165 )
166endef
167
168###########################################################
169## Find all of the java files from here.  Meant to be used like:
170##    SRC_FILES := $(call all-subdir-java-files)
171###########################################################
172
173define all-subdir-java-files
174$(call all-java-files-under,.)
175endef
176
177###########################################################
178## Find all of the c files under the named directories.
179## Meant to be used like:
180##    SRC_FILES := $(call all-c-files-under,src tests)
181###########################################################
182
183define all-c-files-under
184$(patsubst ./%,%, \
185  $(shell cd $(LOCAL_PATH) ; \
186          find $(1) -name "*.c" -and -not -name ".*") \
187 )
188endef
189
190###########################################################
191## Find all of the c files from here.  Meant to be used like:
192##    SRC_FILES := $(call all-subdir-c-files)
193###########################################################
194
195define all-subdir-c-files
196$(call all-c-files-under,.)
197endef
198
199###########################################################
200## Find all files named "I*.aidl" under the named directories,
201## which must be relative to $(LOCAL_PATH).  The returned list
202## is relative to $(LOCAL_PATH).
203###########################################################
204
205define all-Iaidl-files-under
206$(patsubst ./%,%, \
207  $(shell cd $(LOCAL_PATH) ; \
208          find $(1) -name "I*.aidl" -and -not -name ".*") \
209 )
210endef
211
212###########################################################
213## Find all of the "I*.aidl" files under $(LOCAL_PATH).
214###########################################################
215
216define all-subdir-Iaidl-files
217$(call all-Iaidl-files-under,.)
218endef
219
220###########################################################
221## Find all of the html files from here.  Meant to be used like:
222##    SRC_FILES := $(call all-subdir-html-files)
223###########################################################
224
225define all-subdir-html-files
226$(patsubst ./%,%,$(shell cd $(LOCAL_PATH) ; find . -name "*.html"))
227endef
228
229###########################################################
230## Find all of the files matching pattern
231##    SRC_FILES := $(call find-subdir-files, <pattern>)
232###########################################################
233
234define find-subdir-files
235$(patsubst ./%,%,$(shell cd $(LOCAL_PATH) ; find $(1)))
236endef
237
238###########################################################
239# find the files in the subdirectory $1 of LOCAL_DIR
240# matching pattern $2, filtering out files $3
241# e.g.
242#     SRC_FILES += $(call find-subdir-subdir-files, \
243#                         css, *.cpp, DontWantThis.cpp)
244###########################################################
245
246define find-subdir-subdir-files
247$(filter-out $(patsubst %,$(1)/%,$(3)),$(patsubst ./%,%,$(shell cd \
248            $(LOCAL_PATH) ; find $(1) -maxdepth 1 -name $(2))))
249endef
250
251###########################################################
252## Find all of the files matching pattern
253##    SRC_FILES := $(call all-subdir-java-files)
254###########################################################
255
256define find-subdir-assets
257$(if $(1),$(patsubst ./%,%, \
258	$(shell if [ -d $(1) ] ; then cd $(1) ; find ./ -type f -and -not -type l ; fi)), \
259	$(warning Empty argument supplied to find-subdir-assets) \
260)
261endef
262
263###########################################################
264## Find various file types in a list of directories relative to $(LOCAL_PATH)
265###########################################################
266
267define find-other-java-files
268	$(call find-subdir-files,$(1) -name "*.java" -and -not -name ".*")
269endef
270
271define find-other-html-files
272	$(call find-subdir-files,$(1) -name "*.html" -and -not -name ".*")
273endef
274
275###########################################################
276## Scan through each directory of $(1) looking for files
277## that match $(2) using $(wildcard).  Useful for seeing if
278## a given directory or one of its parents contains
279## a particular file.  Returns the first match found,
280## starting furthest from the root.
281###########################################################
282
283define find-parent-file
284$(strip \
285  $(eval _fpf := $(wildcard $(strip $(1))/$(strip $(2)))) \
286  $(if $(_fpf),$(_fpf), \
287       $(if $(filter-out ./ .,$(1)), \
288             $(call find-parent-file,$(patsubst %/,%,$(dir $(1))),$(2)) \
289        ) \
290   ) \
291)
292endef
293
294###########################################################
295## Function we can evaluate to introduce a dynamic dependency
296###########################################################
297
298define add-dependency
299$(1): $(2)
300endef
301
302###########################################################
303## Set up the dependencies for a prebuilt target
304##  $(call add-prebuilt-file, srcfile, [targetclass])
305###########################################################
306
307define add-prebuilt-file
308    $(eval $(include-prebuilt))
309endef
310
311define include-prebuilt
312    include $$(CLEAR_VARS)
313    LOCAL_SRC_FILES := $(1)
314    LOCAL_BUILT_MODULE_STEM := $(1)
315    LOCAL_MODULE_SUFFIX := $$(suffix $(1))
316    LOCAL_MODULE := $$(basename $(1))
317    LOCAL_MODULE_CLASS := $(2)
318    include $$(BUILD_PREBUILT)
319endef
320
321###########################################################
322## do multiple prebuilts
323##  $(call target class, files ...)
324###########################################################
325
326define add-prebuilt-files
327    $(foreach f,$(2),$(call add-prebuilt-file,$f,$(1)))
328endef
329
330
331
332###########################################################
333## The intermediates directory.  Where object files go for
334## a given target.  We could technically get away without
335## the "_intermediates" suffix on the directory, but it's
336## nice to be able to grep for that string to find out if
337## anyone's abusing the system.
338###########################################################
339
340# $(1): target class, like "APPS"
341# $(2): target name, like "NotePad"
342# $(3): if non-empty, this is a HOST target.
343# $(4): if non-empty, force the intermediates to be COMMON
344define intermediates-dir-for
345$(strip \
346    $(eval _idfClass := $(strip $(1))) \
347    $(if $(_idfClass),, \
348        $(error $(LOCAL_PATH): Class not defined in call to intermediates-dir-for)) \
349    $(eval _idfName := $(strip $(2))) \
350    $(if $(_idfName),, \
351        $(error $(LOCAL_PATH): Name not defined in call to intermediates-dir-for)) \
352    $(eval _idfPrefix := $(if $(strip $(3)),HOST,TARGET)) \
353    $(if $(filter $(_idfClass),$(COMMON_MODULE_CLASSES))$(4), \
354        $(eval _idfIntBase := $($(_idfPrefix)_OUT_COMMON_INTERMEDIATES)) \
355      , \
356        $(eval _idfIntBase := $($(_idfPrefix)_OUT_INTERMEDIATES)) \
357     ) \
358    $(_idfIntBase)/$(_idfClass)/$(_idfName)_intermediates \
359)
360endef
361
362# Uses LOCAL_MODULE_CLASS, LOCAL_MODULE, and LOCAL_IS_HOST_MODULE
363# to determine the intermediates directory.
364#
365# $(1): if non-empty, force the intermediates to be COMMON
366define local-intermediates-dir
367$(strip \
368    $(if $(strip $(LOCAL_MODULE_CLASS)),, \
369        $(error $(LOCAL_PATH): LOCAL_MODULE_CLASS not defined before call to local-intermediates-dir)) \
370    $(if $(strip $(LOCAL_MODULE)),, \
371        $(error $(LOCAL_PATH): LOCAL_MODULE not defined before call to local-intermediates-dir)) \
372    $(call intermediates-dir-for,$(LOCAL_MODULE_CLASS),$(LOCAL_MODULE),$(LOCAL_IS_HOST_MODULE),$(1)) \
373)
374endef
375
376###########################################################
377## Convert "path/to/libXXX.so" to "-lXXX".
378## Any "path/to/libXXX.a" elements pass through unchanged.
379###########################################################
380
381define normalize-libraries
382$(foreach so,$(filter %.so,$(1)),-l$(patsubst lib%.so,%,$(notdir $(so))))\
383$(filter-out %.so,$(1))
384endef
385
386# TODO: change users to call the common version.
387define normalize-host-libraries
388$(call normalize-libraries,$(1))
389endef
390
391define normalize-target-libraries
392$(call normalize-libraries,$(1))
393endef
394
395###########################################################
396## Convert a list of short module names (e.g., "framework", "Browser")
397## into the list of files that are built for those modules.
398## NOTE: this won't return reliable results until after all
399## sub-makefiles have been included.
400## $(1): target list
401###########################################################
402
403define module-built-files
404$(foreach module,$(1),$(ALL_MODULES.$(module).BUILT))
405endef
406
407###########################################################
408## Convert a list of short modules names (e.g., "framework", "Browser")
409## into the list of files that are installed for those modules.
410## NOTE: this won't return reliable results until after all
411## sub-makefiles have been included.
412## $(1): target list
413###########################################################
414
415define module-installed-files
416$(foreach module,$(1),$(ALL_MODULES.$(module).INSTALLED))
417endef
418
419###########################################################
420## Convert a list of short modules names (e.g., "framework", "Browser")
421## into the list of files that should be used when linking
422## against that module as a public API.
423## TODO: Allow this for more than JAVA_LIBRARIES modules
424## NOTE: this won't return reliable results until after all
425## sub-makefiles have been included.
426## $(1): target list
427###########################################################
428
429define module-stubs-files
430$(foreach module,$(1),$(ALL_MODULES.$(module).STUBS))
431endef
432
433###########################################################
434## Evaluates to the timestamp file for a doc module, which
435## is the dependency that should be used.
436## $(1): doc module
437###########################################################
438
439define doc-timestamp-for
440$(OUT_DOCS)/$(strip $(1))-timestamp
441endef
442
443
444###########################################################
445## Convert "framework framework-res ext" to "out/.../javalib.jar ..."
446## This lets us treat framework-res as a normal library.
447## $(1): library list
448## $(2): Non-empty if IS_HOST_MODULE
449###########################################################
450
451# $(1): library name
452# $(2): Non-empty if IS_HOST_MODULE
453define _java-lib-dir
454$(call intermediates-dir-for, \
455	$(if $(filter framework-res,$(1)),APPS,JAVA_LIBRARIES),$(1),$(2))
456endef
457
458# $(1): library name
459define _java-lib-classes.jar
460$(if $(filter framework-res,$(1)),package$(COMMON_ANDROID_PACKAGE_SUFFIX),classes$(COMMON_JAVA_PACKAGE_SUFFIX))
461endef
462
463# $(1): library name
464# $(2): Non-empty if IS_HOST_MODULE
465define _java-lib-full-classes.jar
466$(call _java-lib-dir,$(1),$(2))/$(call _java-lib-classes.jar,$(1))
467endef
468
469# $(1): library name list
470# $(2): Non-empty if IS_HOST_MODULE
471define java-lib-files
472$(foreach lib,$(1),$(call _java-lib-full-classes.jar,$(lib),$(2)))
473endef
474
475# $(1): library name
476define _java-lib-dep
477$(if $(filter framework-res,$(1)),package$(COMMON_ANDROID_PACKAGE_SUFFIX),javalib$(COMMON_JAVA_PACKAGE_SUFFIX))
478endef
479
480# $(1): library name
481# $(2): Non-empty if IS_HOST_MODULE
482define _java-lib-full-dep
483$(call _java-lib-dir,$(1),$(2))/$(call _java-lib-dep,$(1))
484endef
485
486# $(1): library name list
487# $(2): Non-empty if IS_HOST_MODULE
488define java-lib-deps
489$(foreach lib,$(1),$(call _java-lib-full-dep,$(lib),$(2)))
490endef
491
492###########################################################
493## Convert "a b c" into "a:b:c"
494###########################################################
495
496empty :=
497space := $(empty) $(empty)
498
499define normalize-path-list
500$(subst $(space),:,$(strip $(1)))
501endef
502
503###########################################################
504## Read the word out of a colon-separated list of words.
505## This has the same behavior as the built-in function
506## $(word n,str).
507##
508## The individual words may not contain spaces.
509##
510## $(1): 1 based index
511## $(2): value of the form a:b:c...
512###########################################################
513
514define word-colon
515$(word $(1),$(subst :,$(space),$(2)))
516endef
517
518###########################################################
519## Convert "a=b c= d e = f" into "a=b c=d e=f"
520##
521## $(1): list to collapse
522## $(2): if set, separator word; usually "=", ":", or ":="
523##       Defaults to "=" if not set.
524###########################################################
525
526define collapse-pairs
527$(eval _cpSEP := $(strip $(if $(2),$(2),=)))\
528$(subst $(space)$(_cpSEP)$(space),$(_cpSEP),$(strip \
529    $(subst $(_cpSEP), $(_cpSEP) ,$(1))))
530endef
531
532###########################################################
533## MODULE_TAG set operations
534###########################################################
535
536# Given a list of tags, return the targets that specify
537# any of those tags.
538# $(1): tag list
539define modules-for-tag-list
540$(sort $(foreach tag,$(1),$(ALL_MODULE_TAGS.$(tag))))
541endef
542
543# Same as modules-for-tag-list, but operates on
544# ALL_MODULE_NAME_TAGS.
545# $(1): tag list
546define module-names-for-tag-list
547$(sort $(foreach tag,$(1),$(ALL_MODULE_NAME_TAGS.$(tag))))
548endef
549
550# Given an accept and reject list, find the matching
551# set of targets.  If a target has multiple tags and
552# any of them are rejected, the target is rejected.
553# Reject overrides accept.
554# $(1): list of tags to accept
555# $(2): list of tags to reject
556#TODO(dbort): do $(if $(strip $(1)),$(1),$(ALL_MODULE_TAGS))
557define get-tagged-modules
558$(filter-out \
559	$(call modules-for-tag-list,$(2)), \
560	    $(call modules-for-tag-list,$(1)))
561endef
562
563###########################################################
564## Append a leaf to a base path.  Properly deals with
565## base paths ending in /.
566##
567## $(1): base path
568## $(2): leaf path
569###########################################################
570
571define append-path
572$(subst //,/,$(1)/$(2))
573endef
574
575
576###########################################################
577## Package filtering
578###########################################################
579
580# Given a list of installed modules (short or long names)
581# return a list of the packages (yes, .apk packages, not
582# modules in general) that are overridden by this list and,
583# therefore, should not be installed.
584# $(1): mixed list of installed modules
585# TODO: This is fragile; find a reliable way to get this information.
586define _get-package-overrides
587 $(eval ### Discard any words containing slashes, unless they end in .apk, \
588        ### in which case trim off the directory component and the suffix. \
589        ### If there are no slashes, keep the entire word.)
590 $(eval _gpo_names := $(subst /,@@@ @@@,$(1)))
591 $(eval _gpo_names := \
592     $(filter %.apk,$(_gpo_names)) \
593     $(filter-out %@@@ @@@%,$(_gpo_names)))
594 $(eval _gpo_names := $(patsubst %.apk,%,$(_gpo_names)))
595 $(eval _gpo_names := $(patsubst @@@%,%,$(_gpo_names)))
596
597 $(eval ### Remove any remaining words that contain dots.)
598 $(eval _gpo_names := $(subst .,@@@ @@@,$(_gpo_names)))
599 $(eval _gpo_names := $(filter-out %@@@ @@@%,$(_gpo_names)))
600
601 $(eval ### Now we have a list of any words that could possibly refer to \
602        ### packages, although there may be words that do not.  Only \
603        ### real packages will be present under PACKAGES.*, though.)
604 $(foreach _gpo_name,$(_gpo_names),$(PACKAGES.$(_gpo_name).OVERRIDES))
605endef
606
607define get-package-overrides
608$(strip $(sort $(call _get-package-overrides,$(1))))
609endef
610
611###########################################################
612## Output the command lines, or not
613###########################################################
614
615ifeq ($(strip $(SHOW_COMMANDS)),)
616define pretty
617@echo $1
618endef
619hide := @
620else
621define pretty
622endef
623hide :=
624endif
625
626###########################################################
627## Dump the variables that are associated with targets
628###########################################################
629
630define dump-module-variables
631@echo all_dependencies=$^
632@echo PRIVATE_YACCFLAGS=$(PRIVATE_YACCFLAGS);
633@echo PRIVATE_CFLAGS=$(PRIVATE_CFLAGS);
634@echo PRIVATE_CPPFLAGS=$(PRIVATE_CPPFLAGS);
635@echo PRIVATE_DEBUG_CFLAGS=$(PRIVATE_DEBUG_CFLAGS);
636@echo PRIVATE_C_INCLUDES=$(PRIVATE_C_INCLUDES);
637@echo PRIVATE_LDFLAGS=$(PRIVATE_LDFLAGS);
638@echo PRIVATE_LDLIBS=$(PRIVATE_LDLIBS);
639@echo PRIVATE_ARFLAGS=$(PRIVATE_ARFLAGS);
640@echo PRIVATE_AAPT_FLAGS=$(PRIVATE_AAPT_FLAGS);
641@echo PRIVATE_DX_FLAGS=$(PRIVATE_DX_FLAGS);
642@echo PRIVATE_JAVA_LIBRARIES=$(PRIVATE_JAVA_LIBRARIES);
643@echo PRIVATE_ALL_SHARED_LIBRARIES=$(PRIVATE_ALL_SHARED_LIBRARIES);
644@echo PRIVATE_ALL_STATIC_LIBRARIES=$(PRIVATE_ALL_STATIC_LIBRARIES);
645@echo PRIVATE_ALL_WHOLE_STATIC_LIBRARIES=$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES);
646@echo PRIVATE_ALL_OBJECTS=$(PRIVATE_ALL_OBJECTS);
647endef
648
649###########################################################
650## Commands for using sed to replace given variable values
651###########################################################
652
653define transform-variables
654@mkdir -p $(dir $@)
655@echo "Sed: $(if $(PRIVATE_MODULE),$(PRIVATE_MODULE),$@) <= $<"
656$(hide) sed $(foreach var,$(REPLACE_VARS),-e "s/{{$(var)}}/$(subst /,\/,$(PWD)/$($(var)))/g") $< >$@
657$(hide) if [ "$(suffix $@)" = ".sh" ]; then chmod a+rx $@; fi
658endef
659
660
661###########################################################
662## Commands for munging the dependency files GCC generates
663###########################################################
664
665define transform-d-to-p
666@cp $(@:%.o=%.d) $(@:%.o=%.P); \
667	sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
668		-e '/^$$/ d' -e 's/$$/ :/' < $(@:%.o=%.d) >> $(@:%.o=%.P); \
669	rm -f $(@:%.o=%.d)
670endef
671
672###########################################################
673## Commands for running lex
674###########################################################
675
676define transform-l-to-cpp
677@mkdir -p $(dir $@)
678@echo "Lex: $(PRIVATE_MODULE) <= $<"
679$(hide) $(LEX) -o$@ $<
680endef
681
682###########################################################
683## Commands for running yacc
684##
685## Because the extension of c++ files can change, the
686## extension must be specified in $1.
687## E.g, "$(call transform-y-to-cpp,.cpp)"
688###########################################################
689
690define transform-y-to-cpp
691@mkdir -p $(dir $@)
692@echo "Yacc: $(PRIVATE_MODULE) <= $<"
693$(YACC) $(PRIVATE_YACCFLAGS) -o $@ $<
694touch $(@:$1=$(YACC_HEADER_SUFFIX))
695echo '#ifndef '$(@F:$1=_h) > $(@:$1=.h)
696echo '#define '$(@F:$1=_h) >> $(@:$1=.h)
697cat $(@:$1=$(YACC_HEADER_SUFFIX)) >> $(@:$1=.h)
698echo '#endif' >> $(@:$1=.h)
699rm -f $(@:$1=$(YACC_HEADER_SUFFIX))
700endef
701
702
703###########################################################
704## Commands for running aidl
705###########################################################
706
707define transform-aidl-to-java
708@mkdir -p $(dir $@)
709@echo "Aidl: $(PRIVATE_MODULE) <= $<"
710$(hide) $(AIDL) -d$(patsubst %.java,%.P,$@) $(PRIVATE_AIDL_FLAGS) $< $@
711endef
712#$(AIDL) $(PRIVATE_AIDL_FLAGS) $< - | indent -nut -br -npcs -l1000 > $@
713
714
715
716###########################################################
717## Commands for running gcc to compile a C++ file
718###########################################################
719
720define transform-cpp-to-o
721@mkdir -p $(dir $@)
722@echo "target $(PRIVATE_ARM_MODE) C++: $(PRIVATE_MODULE) <= $<"
723$(hide) $(PRIVATE_CXX) \
724	$(foreach incdir, \
725	    $(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
726		$(TARGET_PROJECT_INCLUDES) \
727		$(TARGET_C_INCLUDES) \
728	     ) \
729	    $(PRIVATE_C_INCLUDES) \
730	  , \
731	    -I $(incdir) \
732	 ) \
733	-c \
734	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
735	    $(TARGET_GLOBAL_CFLAGS) \
736	    $(TARGET_GLOBAL_CPPFLAGS) \
737	    $(PRIVATE_ARM_CFLAGS) \
738	 ) \
739	-fno-rtti \
740	$(PRIVATE_CFLAGS) \
741	$(PRIVATE_CPPFLAGS) \
742	$(PRIVATE_DEBUG_CFLAGS) \
743	-MD -o $@ $<
744$(hide) $(transform-d-to-p)
745endef
746
747
748###########################################################
749## Commands for running gcc to compile a C file
750###########################################################
751
752# $(1): extra flags
753define transform-c-or-s-to-o-no-deps
754@mkdir -p $(dir $@)
755$(hide) $(PRIVATE_CC) \
756	$(foreach incdir, \
757	    $(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
758		$(TARGET_PROJECT_INCLUDES) \
759		$(TARGET_C_INCLUDES) \
760	     ) \
761	    $(PRIVATE_C_INCLUDES) \
762	  , \
763	    -I $(incdir) \
764	 ) \
765	-c \
766	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
767	    $(TARGET_GLOBAL_CFLAGS) \
768	    $(PRIVATE_ARM_CFLAGS) \
769	 ) \
770	$(PRIVATE_CFLAGS) \
771	$(1) \
772	$(PRIVATE_DEBUG_CFLAGS) \
773	-MD -o $@ $<
774endef
775
776define transform-c-to-o-no-deps
777@echo "target $(PRIVATE_ARM_MODE) C: $(PRIVATE_MODULE) <= $<"
778$(call transform-c-or-s-to-o-no-deps, )
779endef
780
781define transform-s-to-o-no-deps
782@echo "target asm: $(PRIVATE_MODULE) <= $<"
783$(call transform-c-or-s-to-o-no-deps, $(PRIVATE_ASFLAGS))
784endef
785
786define transform-c-to-o
787$(transform-c-to-o-no-deps)
788$(hide) $(transform-d-to-p)
789endef
790
791define transform-s-to-o
792$(transform-s-to-o-no-deps)
793$(hide) $(transform-d-to-p)
794endef
795
796###########################################################
797## Commands for running gcc to compile an Objective-C file
798## This should never happen for target builds but this
799## will error at build time.
800###########################################################
801
802define transform-m-to-o-no-deps
803@echo "target ObjC: $(PRIVATE_MODULE) <= $<"
804$(call transform-c-or-s-to-o-no-deps)
805endef
806
807define transform-m-to-o
808$(transform-m-to-o-no-deps)
809$(hide) $(transform-d-to-p)
810endef
811
812###########################################################
813## Commands for running gcc to compile a host C++ file
814###########################################################
815
816define transform-host-cpp-to-o
817@mkdir -p $(dir $@)
818@echo "host C++: $(PRIVATE_MODULE) <= $<"
819$(hide) $(PRIVATE_CXX) \
820	$(foreach incdir, \
821	    $(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
822		$(HOST_PROJECT_INCLUDES) \
823		$(HOST_C_INCLUDES) \
824	     ) \
825	    $(PRIVATE_C_INCLUDES) \
826	  , \
827	    -I $(incdir) \
828	 ) \
829	-c \
830	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
831	    $(HOST_GLOBAL_CFLAGS) \
832	    $(HOST_GLOBAL_CPPFLAGS) \
833	 ) \
834	$(PRIVATE_CFLAGS) \
835	$(PRIVATE_CPPFLAGS) \
836	$(PRIVATE_DEBUG_CFLAGS) \
837	-MD -o $@ $<
838$(transform-d-to-p)
839endef
840
841
842###########################################################
843## Commands for running gcc to compile a host C file
844###########################################################
845
846# $(1): extra flags
847define transform-host-c-or-s-to-o-no-deps
848@mkdir -p $(dir $@)
849$(hide) $(PRIVATE_CC) \
850	$(foreach incdir, \
851	    $(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
852		$(HOST_PROJECT_INCLUDES) \
853		$(HOST_C_INCLUDES) \
854	     ) \
855	    $(PRIVATE_C_INCLUDES) \
856	  , \
857	    -I $(incdir) \
858	 ) \
859	-c \
860	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
861	    $(HOST_GLOBAL_CFLAGS) \
862	 ) \
863	$(PRIVATE_CFLAGS) \
864	$(1) \
865	$(PRIVATE_DEBUG_CFLAGS) \
866	-MD -o $@ $<
867endef
868
869define transform-host-c-to-o-no-deps
870@echo "host C: $(PRIVATE_MODULE) <= $<"
871$(call transform-host-c-or-s-to-o-no-deps, )
872endef
873
874define transform-host-s-to-o-no-deps
875@echo "host asm: $(PRIVATE_MODULE) <= $<"
876$(call transform-host-c-or-s-to-o-no-deps, $(PRIVATE_ASFLAGS))
877endef
878
879define transform-host-c-to-o
880$(transform-host-c-to-o-no-deps)
881$(transform-d-to-p)
882endef
883
884define transform-host-s-to-o
885$(transform-host-s-to-o-no-deps)
886$(transform-d-to-p)
887endef
888
889###########################################################
890## Commands for running gcc to compile a host Objective-C file
891###########################################################
892
893define transform-host-m-to-o-no-deps
894@echo "host ObjC: $(PRIVATE_MODULE) <= $<"
895$(call transform-host-c-or-s-to-o-no-deps)
896endef
897
898define tranform-host-m-to-o
899$(transform-host-m-to-o-no-deps)
900$(transform-d-to-p)
901endef
902
903###########################################################
904## Commands for running ar
905###########################################################
906
907# Explicitly delete the archive first so that ar doesn't
908# try to add to an existing archive.
909define transform-o-to-static-lib
910@mkdir -p $(dir $@)
911@echo "target StaticLib: $(PRIVATE_MODULE) ($@)"
912@rm -f $@
913$(hide) $(TARGET_AR) $(TARGET_GLOBAL_ARFLAGS) $(PRIVATE_ARFLAGS) $@ $^
914endef
915
916###########################################################
917## Commands for running host ar
918###########################################################
919
920# Explicitly delete the archive first so that ar doesn't
921# try to add to an existing archive.
922define transform-host-o-to-static-lib
923@mkdir -p $(dir $@)
924@echo "host StaticLib: $(PRIVATE_MODULE) ($@)"
925@rm -f $@
926$(HOST_AR) $(HOST_GLOBAL_ARFLAGS) $(PRIVATE_ARFLAGS) $@ $^
927endef
928
929
930###########################################################
931## Commands for running gcc to link a shared library or package
932###########################################################
933
934# ld just seems to be so finicky with command order that we allow
935# it to be overriden en-masse see combo/linux-arm.make for an example.
936ifneq ($(HOST_CUSTOM_LD_COMMAND),true)
937define transform-host-o-to-shared-lib-inner
938$(HOST_CXX) \
939	-Wl,-rpath-link=$(TARGET_OUT_INTERMEDIATE_LIBRARIES) \
940	-Wl,-rpath,\$$ORIGIN/../lib \
941	-shared -Wl,-soname,$(notdir $@) \
942	$(PRIVATE_LDFLAGS) \
943	$(HOST_GLOBAL_LD_DIRS) \
944	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
945	   $(HOST_GLOBAL_LDFLAGS) \
946	) \
947	$(PRIVATE_ALL_OBJECTS) \
948	-Wl,--whole-archive \
949	$(call normalize-host-libraries,$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)) \
950	-Wl,--no-whole-archive \
951	$(call normalize-host-libraries,$(PRIVATE_ALL_STATIC_LIBRARIES)) \
952	$(call normalize-host-libraries,$(PRIVATE_ALL_SHARED_LIBRARIES)) \
953	-o $@ \
954	$(PRIVATE_LDLIBS)
955endef
956endif
957
958define transform-host-o-to-shared-lib
959@mkdir -p $(dir $@)
960@echo "host SharedLib: $(PRIVATE_MODULE) ($@)"
961$(hide) $(transform-host-o-to-shared-lib-inner)
962endef
963
964define transform-host-o-to-package
965@mkdir -p $(dir $@)
966@echo "host Package: $(PRIVATE_MODULE) ($@)"
967$(hide) $(transform-host-o-to-shared-lib-inner)
968endef
969
970
971###########################################################
972## Commands for running gcc to link a shared library or package
973###########################################################
974
975#echo >$@.vers "{"; \
976#echo >>$@.vers " global:"; \
977#$(BUILD_SYSTEM)/filter_symbols.sh $(TARGET_NM) "  " ";" $(filter %.o,$^) | sort -u >>$@.vers; \
978#echo >>$@.vers " local:"; \
979#echo >>$@.vers "  *;"; \
980#echo >>$@.vers "};"; \
981
982#	-Wl,--version-script=$@.vers \
983
984# ld just seems to be so finicky with command order that we allow
985# it to be overriden en-masse see combo/linux-arm.make for an example.
986ifneq ($(TARGET_CUSTOM_LD_COMMAND),true)
987define transform-o-to-shared-lib-inner
988$(TARGET_CXX) \
989	$(TARGET_GLOBAL_LDFLAGS) \
990	-Wl,-rpath-link=$(TARGET_OUT_INTERMEDIATE_LIBRARIES) \
991	-Wl,-rpath,\$$ORIGIN/../lib \
992	-shared -Wl,-soname,$(notdir $@) \
993	$(PRIVATE_LDFLAGS) \
994	$(TARGET_GLOBAL_LD_DIRS) \
995	$(PRIVATE_ALL_OBJECTS) \
996	-Wl,--whole-archive \
997	$(call normalize-host-libraries,$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)) \
998	-Wl,--no-whole-archive \
999	$(call normalize-target-libraries,$(PRIVATE_ALL_STATIC_LIBRARIES)) \
1000	$(call normalize-target-libraries,$(PRIVATE_ALL_SHARED_LIBRARIES)) \
1001	-o $@ \
1002	$(PRIVATE_LDLIBS)
1003endef
1004endif
1005
1006define transform-o-to-shared-lib
1007@mkdir -p $(dir $@)
1008@echo "target SharedLib: $(PRIVATE_MODULE) ($@)"
1009$(hide) $(transform-o-to-shared-lib-inner)
1010endef
1011
1012define transform-o-to-package
1013@mkdir -p $(dir $@)
1014@echo "target Package: $(PRIVATE_MODULE) ($@)"
1015$(hide) $(transform-o-to-shared-lib-inner)
1016endef
1017
1018
1019###########################################################
1020## Commands for filtering a target executable or library
1021###########################################################
1022
1023# Because of bug 743462 ("Prelinked image magic gets stripped
1024# by arm-elf-objcopy"), we have to use soslim to strip target
1025# binaries.
1026define transform-to-stripped
1027@mkdir -p $(dir $@)
1028@echo "target Strip: $(PRIVATE_MODULE) ($@)"
1029$(hide) $(SOSLIM) --strip --shady --quiet $< --outfile $@
1030endef
1031
1032define transform-to-prelinked
1033@mkdir -p $(dir $@)
1034@echo "target Prelink: $(PRIVATE_MODULE) ($@)"
1035$(hide) $(APRIORI) \
1036		--prelinkmap $(TARGET_PRELINKER_MAP) \
1037		--locals-only \
1038		--quiet \
1039		$< \
1040		--output $@
1041endef
1042
1043
1044###########################################################
1045## Commands for running gcc to link an executable
1046###########################################################
1047
1048ifneq ($(TARGET_CUSTOM_LD_COMMAND),true)
1049define transform-o-to-executable-inner
1050$(TARGET_CXX) \
1051	$(TARGET_GLOBAL_LDFLAGS) \
1052	-Wl,-rpath-link=$(TARGET_OUT_INTERMEDIATE_LIBRARIES) \
1053	$(TARGET_GLOBAL_LD_DIRS) \
1054	-Wl,-rpath-link=$(TARGET_OUT_INTERMEDIATE_LIBRARIES) \
1055	-Wl,-rpath,\$$ORIGIN/../lib \
1056	$(PRIVATE_LDFLAGS) \
1057	$(TARGET_GLOBAL_LD_DIRS) \
1058	$(PRIVATE_ALL_OBJECTS) \
1059	-Wl,--whole-archive \
1060	$(call normalize-target-libraries,$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)) \
1061	-Wl,--no-whole-archive \
1062	$(call normalize-target-libraries,$(PRIVATE_ALL_STATIC_LIBRARIES)) \
1063	$(call normalize-target-libraries,$(PRIVATE_ALL_SHARED_LIBRARIES)) \
1064	-o $@ \
1065	$(PRIVATE_LDLIBS)
1066endef
1067endif
1068
1069define transform-o-to-executable
1070@mkdir -p $(dir $@)
1071@echo "target Executable: $(PRIVATE_MODULE) ($@)"
1072$(hide) $(transform-o-to-executable-inner)
1073endef
1074
1075
1076###########################################################
1077## Commands for running gcc to link a statically linked
1078## executable.  In practice, we only use this on arm, so
1079## the other platforms don't have the
1080## transform-o-to-static-executable defined
1081###########################################################
1082
1083ifneq ($(TARGET_CUSTOM_LD_COMMAND),true)
1084define transform-o-to-static-executable-inner
1085endef
1086endif
1087
1088define transform-o-to-static-executable
1089@mkdir -p $(dir $@)
1090@echo "target StaticExecutable: $(PRIVATE_MODULE) ($@)"
1091$(hide) $(transform-o-to-static-executable-inner)
1092endef
1093
1094
1095###########################################################
1096## Commands for running gcc to link a host executable
1097###########################################################
1098
1099ifneq ($(HOST_CUSTOM_LD_COMMAND),true)
1100define transform-host-o-to-executable-inner
1101$(HOST_CXX) \
1102	-Wl,-rpath-link=$(TARGET_OUT_INTERMEDIATE_LIBRARIES) \
1103	-Wl,-rpath,\$$ORIGIN/../lib \
1104	$(HOST_GLOBAL_LD_DIRS) \
1105	$(PRIVATE_LDFLAGS) \
1106	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
1107		$(HOST_GLOBAL_LDFLAGS) \
1108	) \
1109	$(PRIVATE_ALL_OBJECTS) \
1110	-Wl,--whole-archive \
1111	$(call normalize-host-libraries,$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)) \
1112	-Wl,--no-whole-archive \
1113	$(call normalize-host-libraries,$(PRIVATE_ALL_STATIC_LIBRARIES)) \
1114	$(call normalize-host-libraries,$(PRIVATE_ALL_SHARED_LIBRARIES)) \
1115	-o $@ \
1116	$(PRIVATE_LDLIBS)
1117endef
1118endif
1119
1120define transform-host-o-to-executable
1121@mkdir -p $(dir $@)
1122@echo "host Executable: $(PRIVATE_MODULE) ($@)"
1123$(hide) $(transform-host-o-to-executable-inner)
1124endef
1125
1126
1127###########################################################
1128## Commands for running javac to make .class files
1129###########################################################
1130
1131#@echo "Source intermediates dir: $(PRIVATE_SOURCE_INTERMEDIATES_DIR)"
1132#@echo "Source intermediates: $$(find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) -name '*.java')"
1133
1134# TODO: Right now we generate the asset resources twice, first as part
1135# of generating the Java classes, then at the end when packaging the final
1136# assets.  This should be changed to do one of two things: (1) Don't generate
1137# any resource files the first time, only create classes during that stage;
1138# or (2) Don't use the -c flag with the second stage, instead taking the
1139# resource files from the first stage as additional input.  My original intent
1140# was to use approach (2), but this requires a little more work in the tool.
1141# Maybe we should just use approach (1).
1142
1143# This rule creates the R.java and Manifest.java files, both of which
1144# are PRODUCT-neutral.  Don't pass PRODUCT_AAPT_CONFIG to this invocation.
1145define create-resource-java-files
1146@mkdir -p $(PRIVATE_SOURCE_INTERMEDIATES_DIR)
1147@mkdir -p $(dir $(PRIVATE_RESOURCE_PUBLICS_OUTPUT))
1148$(hide) $(AAPT) package $(PRIVATE_AAPT_FLAGS) -m -z \
1149    $(eval # PRODUCT_AAPT_CONFIG is intentionally missing-- see comment.) \
1150    $(addprefix -J , $(PRIVATE_SOURCE_INTERMEDIATES_DIR)) \
1151    $(addprefix -M , $(PRIVATE_ANDROID_MANIFEST)) \
1152    $(addprefix -P , $(PRIVATE_RESOURCE_PUBLICS_OUTPUT)) \
1153    $(addprefix -S , $(PRIVATE_RESOURCE_DIR)) \
1154    $(addprefix -A , $(PRIVATE_ASSET_DIR)) \
1155    $(addprefix -I , $(PRIVATE_AAPT_INCLUDES)) \
1156    $(addprefix --min-sdk-version , $(DEFAULT_APP_TARGET_SDK)) \
1157    $(addprefix --target-sdk-version , $(DEFAULT_APP_TARGET_SDK)) \
1158    $(addprefix --version-code , $(PLATFORM_SDK_VERSION)) \
1159    $(addprefix --version-name , $(PLATFORM_VERSION))
1160endef
1161
1162ifeq ($(HOST_OS),windows)
1163xlint_unchecked :=
1164else
1165#xlint_unchecked := -Xlint:unchecked
1166endif
1167
1168# emit-line, <word list>, <output file>
1169define emit-line
1170   $(if $(1),echo -n '$(strip $(1)) ' >> $(2))
1171endef
1172
1173# dump-words-to-file, <word list>, <output file>
1174define dump-words-to-file
1175        @rm -f $(2)
1176        @$(call emit-line,$(wordlist 1,200,$(1)),$(2))
1177        @$(call emit-line,$(wordlist 201,400,$(1)),$(2))
1178        @$(call emit-line,$(wordlist 401,600,$(1)),$(2))
1179        @$(call emit-line,$(wordlist 601,800,$(1)),$(2))
1180        @$(call emit-line,$(wordlist 801,1000,$(1)),$(2))
1181        @$(call emit-line,$(wordlist 1001,1200,$(1)),$(2))
1182        @$(call emit-line,$(wordlist 1201,1400,$(1)),$(2))
1183        @$(call emit-line,$(wordlist 1401,1600,$(1)),$(2))
1184        @$(call emit-line,$(wordlist 1601,1800,$(1)),$(2))
1185        @$(call emit-line,$(wordlist 1801,2000,$(1)),$(2))
1186        @$(call emit-line,$(wordlist 2001,2200,$(1)),$(2))
1187        @$(call emit-line,$(wordlist 2201,2400,$(1)),$(2))
1188        @$(call emit-line,$(wordlist 2401,2600,$(1)),$(2))
1189        @$(call emit-line,$(wordlist 2601,2800,$(1)),$(2))
1190        @$(call emit-line,$(wordlist 2801,3000,$(1)),$(2))
1191        @$(call emit-line,$(wordlist 3001,3200,$(1)),$(2))
1192        @$(call emit-line,$(wordlist 3201,3400,$(1)),$(2))
1193        @$(call emit-line,$(wordlist 3401,3600,$(1)),$(2))
1194        @$(call emit-line,$(wordlist 3601,3800,$(1)),$(2))
1195        @$(call emit-line,$(wordlist 3801,4000,$(1)),$(2))
1196        @$(if $(wordlist 4001,4002,$(1)),$(error Too many words ($(words $(1)))))
1197endef
1198
1199# For a list of jar files, unzip them to a specified directory,
1200# but make sure that no META-INF files come along for the ride.
1201#
1202# $(1): files to unzip
1203# $(2): destination directory
1204define unzip-jar-files
1205  $(hide) for f in $(1); \
1206  do \
1207    if [ ! -f $$f ]; then \
1208      echo Missing file $$f; \
1209      exit 1; \
1210    fi; \
1211    unzip -q $$f -d $(2); \
1212    (cd $(2) && rm -rf META-INF); \
1213  done
1214endef
1215
1216# below we write the list of java files to java-source-list to avoid argument
1217# list length problems with Cygwin we filter out duplicate java file names
1218# because eclipse's compiler doesn't like them.
1219define transform-java-to-classes.jar
1220@echo "target Java: $(PRIVATE_MODULE) ($(PRIVATE_CLASS_INTERMEDIATES_DIR))"
1221$(hide) rm -f $@
1222$(hide) rm -rf $(PRIVATE_CLASS_INTERMEDIATES_DIR)
1223$(hide) mkdir -p $(PRIVATE_CLASS_INTERMEDIATES_DIR)
1224$(call unzip-jar-files,$(PRIVATE_STATIC_JAVA_LIBRARIES), \
1225    $(PRIVATE_CLASS_INTERMEDIATES_DIR))
1226$(call dump-words-to-file,$(PRIVATE_JAVA_SOURCES),$(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list)
1227$(hide) if [ -d "$(PRIVATE_SOURCE_INTERMEDIATES_DIR)" ]; then \
1228	    find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list; \
1229fi
1230$(hide) tr ' ' '\n' < $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list \
1231    | sort -u > $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq
1232$(hide) $(TARGET_JAVAC) -encoding ascii $(PRIVATE_BOOTCLASSPATH) \
1233    $(addprefix -classpath ,$(strip \
1234        $(call normalize-path-list,$(PRIVATE_ALL_JAVA_LIBRARIES)))) \
1235    $(strip $(PRIVATE_JAVAC_DEBUG_FLAGS)) $(xlint_unchecked) \
1236    -extdirs "" -d $(PRIVATE_CLASS_INTERMEDIATES_DIR) \
1237    \@$(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq \
1238    || ( rm -rf $(PRIVATE_CLASS_INTERMEDIATES_DIR) ; exit 41 )
1239$(hide) rm -f $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list
1240$(hide) rm -f $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq
1241$(hide) mkdir -p $(dir $@)
1242$(hide) jar $(if $(strip $(PRIVATE_JAR_MANIFEST)),-cfm,-cf) \
1243    $@ $(PRIVATE_JAR_MANIFEST) -C $(PRIVATE_CLASS_INTERMEDIATES_DIR) .
1244$(hide) rm -rf $(PRIVATE_CLASS_INTERMEDIATES_DIR)
1245endef
1246
1247define transform-classes.jar-to-emma
1248$(hide) java -classpath $(EMMA_JAR) emma instr -outmode fullcopy -outfile \
1249    $(PRIVATE_EMMA_COVERAGE_FILE) -ip $< -d $(PRIVATE_EMMA_INTERMEDIATES_DIR)
1250endef
1251
1252#TODO: use a smaller -Xmx value for most libraries;
1253#      only core.jar and framework.jar need a heap this big.
1254define transform-classes.jar-to-dex
1255@echo "target Dex: $(PRIVATE_MODULE)"
1256@mkdir -p $(dir $@)
1257$(hide) $(DX) -JXms16M \
1258    -JXmx1536M \
1259    --dex --output=$@ \
1260    $(if $(NO_OPTIMIZE_DX), \
1261        --no-optimize) \
1262    $(if $(GENERATE_DEX_DEBUG), \
1263	    --debug --verbose \
1264	    --dump-to=$(@:.dex=.lst) \
1265	    --dump-width=1000) \
1266    $(PRIVATE_DX_FLAGS) \
1267    $<
1268endef
1269
1270# Create a mostly-empty .jar file that we'll add to later.
1271# The MacOS jar tool doesn't like creating empty jar files,
1272# so we need to give it something.
1273define create-empty-package
1274@mkdir -p $(dir $@)
1275$(hide) touch $(dir $@)/dummy
1276$(hide) (cd $(dir $@) && jar cf $(notdir $@) dummy)
1277$(hide) zip -qd $@ dummy
1278$(hide) rm $(dir $@)/dummy
1279endef
1280
1281#TODO: we kinda want to build different asset packages for
1282#      different configurations, then combine them later (or something).
1283#      Per-locale, etc.
1284#      A list of dynamic and static parameters;  build layers for
1285#      dynamic params that lay over the static ones.
1286#TODO: update the manifest to point to the package file
1287#Note that the version numbers are given to aapt as simple default
1288#values; applications can override these by explicitly stating
1289#them in their manifest.
1290define add-assets-to-package
1291$(hide) $(AAPT) package -z -u $(PRIVATE_AAPT_FLAGS) \
1292    $(addprefix -c , $(PRODUCT_AAPT_CONFIG)) \
1293    $(addprefix -M , $(PRIVATE_ANDROID_MANIFEST)) \
1294    $(addprefix -S , $(PRIVATE_RESOURCE_DIR)) \
1295    $(addprefix -A , $(PRIVATE_ASSET_DIR)) \
1296    $(addprefix -I , $(PRIVATE_AAPT_INCLUDES)) \
1297    $(addprefix --min-sdk-version , $(DEFAULT_APP_TARGET_SDK)) \
1298    $(addprefix --target-sdk-version , $(DEFAULT_APP_TARGET_SDK)) \
1299    $(addprefix --version-code , $(PLATFORM_SDK_VERSION)) \
1300    $(addprefix --version-name , $(PLATFORM_VERSION)) \
1301    -F $@
1302endef
1303
1304#TODO: Allow library directory to be specified based on the target
1305#      CPU and ABI instead of being hard coded as armeabi.
1306define add-jni-shared-libs-to-package
1307$(hide) rm -rf $(dir $@)lib
1308$(hide) mkdir -p $(dir $@)lib/armeabi
1309$(hide) cp $(PRIVATE_JNI_SHARED_LIBRARIES) $(dir $@)lib/armeabi
1310$(hide) (cd $(dir $@) && zip -r $(notdir $@) lib)
1311$(hide) rm -rf $(dir $@)lib
1312endef
1313
1314#TODO: use aapt instead of zip, once it supports junking the path
1315#      (so adding "xxx/yyy/classes.dex" appears as "classes.dex")
1316#TODO: update the manifest to point to the dex file
1317define add-dex-to-package
1318$(hide) zip -qj $@ $(PRIVATE_DEX_FILE)
1319endef
1320
1321define add-java-resources-to-package
1322$(hide) jar uf $@ $(PRIVATE_EXTRA_JAR_ARGS)
1323endef
1324
1325# Sign a package using the specified key/cert.
1326#
1327define sign-package
1328$(hide) mv $@ $@.unsigned
1329$(hide) java -jar $(SIGNAPK_JAR) \
1330	$(PRIVATE_CERTIFICATE) $(PRIVATE_PRIVATE_KEY) $@.unsigned $@.signed
1331$(hide) mv $@.signed $@
1332endef
1333
1334# Align STORED entries of a package on 4-byte boundaries
1335# to make them easier to mmap.
1336#
1337define align-package
1338$(hide) mv $@ $@.unaligned
1339$(hide) $(ZIPALIGN) -f 4 $@.unaligned $@.aligned
1340$(hide) mv $@.aligned $@
1341endef
1342
1343define install-dex-debug
1344$(hide) if [ -f "$(PRIVATE_INTERMEDIATES_DIR)/classes.dex" ]; then \
1345	    mkdir -p $(TOP)/dalvik/DEBUG-FILES; \
1346	    $(ACP) $(PRIVATE_INTERMEDIATES_DIR)/classes.dex \
1347		$(TOP)/dalvik/DEBUG-FILES/$(PRIVATE_MODULE).dex; \
1348	fi
1349$(hide) if [ -f "$(PRIVATE_INTERMEDIATES_DIR)/classes.lst" ]; then \
1350	    mkdir -p $(TOP)/dalvik/DEBUG-FILES; \
1351	    $(ACP) $(PRIVATE_INTERMEDIATES_DIR)/classes.lst \
1352		$(TOP)/dalvik/DEBUG-FILES/$(PRIVATE_MODULE).lst; \
1353	fi
1354endef
1355
1356# TODO(joeo): If we can ever upgrade to post 3.81 make and get the
1357# new prebuilt rules to work, we should change this to copy the
1358# resources to the out directory and then copy the resources.
1359
1360# Note: not using aapt tool for this because we aren't making
1361# an android package for the host.
1362define transform-host-java-to-package
1363@echo "host Java: $(PRIVATE_MODULE) ($(PRIVATE_CLASS_INTERMEDIATES_DIR))"
1364@rm -f $@
1365@rm -rf $(PRIVATE_CLASS_INTERMEDIATES_DIR)
1366@mkdir -p $(dir $@)
1367@mkdir -p $(PRIVATE_CLASS_INTERMEDIATES_DIR)
1368$(call unzip-jar-files,$(PRIVATE_STATIC_JAVA_LIBRARIES), \
1369    $(PRIVATE_CLASS_INTERMEDIATES_DIR))
1370$(call dump-words-to-file,$(sort\
1371	$(PRIVATE_JAVA_SOURCES)),\
1372	$(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq)
1373$(hide) $(HOST_JAVAC) -encoding ascii -g \
1374	$(xlint_unchecked) \
1375	$(addprefix -classpath ,$(strip \
1376		$(call normalize-path-list,$(PRIVATE_ALL_JAVA_LIBRARIES)))) \
1377	-extdirs "" -d $(PRIVATE_CLASS_INTERMEDIATES_DIR)\
1378        \@$(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq || \
1379	( rm -rf $(PRIVATE_CLASS_INTERMEDIATES_DIR) ; exit 41 )
1380$(hide) jar $(if $(strip $(PRIVATE_JAR_MANIFEST)),-cfm,-cf) \
1381    $@ $(PRIVATE_JAR_MANIFEST) $(PRIVATE_EXTRA_JAR_ARGS) \
1382    -C $(PRIVATE_CLASS_INTERMEDIATES_DIR) .
1383endef
1384
1385###########################################################
1386## Obfuscate a jar file
1387###########################################################
1388
1389# PRIVATE_KEEP_FILE is a file containing a list of classes
1390# PRIVATE_INTERMEDIATES_DIR is a directory we can use for temporary files
1391# The module using this must depend on
1392#        $(HOST_OUT_JAVA_LIBRARIES)/proguard-4.0.1.jar
1393define obfuscate-jar
1394@echo "Obfuscate jar: $(notdir $@) ($@)"
1395@mkdir -p $(dir $@)
1396@rm -f $@
1397@mkdir -p $(PRIVATE_INTERMEDIATES_DIR)
1398$(hide) sed -e 's/^/-keep class /' < $(PRIVATE_KEEP_FILE) > \
1399		$(PRIVATE_INTERMEDIATES_DIR)/keep.pro
1400$(hide) java -Xmx512M -jar $(HOST_OUT_JAVA_LIBRARIES)/proguard-4.0.1.jar \
1401		-injars $< \
1402		-outjars $@ \
1403		-target 1.5 \
1404		-dontnote -dontwarn \
1405		-printmapping $(PRIVATE_INTERMEDIATES_DIR)/out.map \
1406		-forceprocessing \
1407		-renamesourcefileattribute SourceFile \
1408		-keepattributes Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,*Annotation*,EnclosingMethod \
1409		-repackageclasses \
1410		-keepclassmembers "class * { public protected *; }" \
1411		@$(PRIVATE_INTERMEDIATES_DIR)/keep.pro
1412endef
1413
1414###########################################################
1415## Commands for copying files
1416###########################################################
1417
1418# Define a rule to copy a header.  Used via $(eval) by copy_headers.make.
1419# $(1): source header
1420# $(2): destination header
1421define copy-one-header
1422$(2): $(1)
1423	@echo "Header: $$@"
1424	$$(copy-file-to-new-target-with-cp)
1425endef
1426
1427# Define a rule to copy a file.  For use via $(eval).
1428# $(1): source file
1429# $(2): destination file
1430define copy-one-file
1431$(2): $(1) | $(ACP)
1432	@echo "Copy: $$@"
1433	$$(copy-file-to-target)
1434endef
1435
1436# The -t option to acp and the -p option to cp is
1437# required for OSX.  OSX has a ridiculous restriction
1438# where it's an error for a .a file's modification time
1439# to disagree with an internal timestamp, and this
1440# macro is used to install .a files (among other things).
1441
1442# Copy a single file from one place to another,
1443# preserving permissions and overwriting any existing
1444# file.
1445define copy-file-to-target
1446@mkdir -p $(dir $@)
1447$(hide) $(ACP) -fpt $< $@
1448endef
1449
1450# The same as copy-file-to-target, but use the local
1451# cp command instead of acp.
1452define copy-file-to-target-with-cp
1453@mkdir -p $(dir $@)
1454$(hide) cp -fp $< $@
1455endef
1456
1457# The same as copy-file-to-target, but don't preserve
1458# the old modification time.
1459define copy-file-to-new-target
1460@mkdir -p $(dir $@)
1461$(hide) $(ACP) -fp $< $@
1462endef
1463
1464# The same as copy-file-to-new-target, but use the local
1465# cp command instead of acp.
1466define copy-file-to-new-target-with-cp
1467@mkdir -p $(dir $@)
1468$(hide) cp -f $< $@
1469endef
1470
1471# Copy a prebuilt file to a target location.
1472define transform-prebuilt-to-target
1473@echo "$(if $(PRIVATE_IS_HOST_MODULE),host,target) Prebuilt: $(PRIVATE_MODULE) ($@)"
1474$(copy-file-to-target)
1475endef
1476
1477
1478###########################################################
1479## On some platforms (MacOS), after copying a static
1480## library, ranlib must be run to update an internal
1481## timestamp!?!?!
1482###########################################################
1483
1484ifeq ($(HOST_RUN_RANLIB_AFTER_COPYING),true)
1485define transform-host-ranlib-copy-hack
1486    $(hide) ranlib $@ || true
1487endef
1488else
1489define transform-host-ranlib-copy-hack
1490true
1491endef
1492endif
1493
1494ifeq ($(TARGET_RUN_RANLIB_AFTER_COPYING),true)
1495define transform-ranlib-copy-hack
1496    $(hide) ranlib $@
1497endef
1498else
1499define transform-ranlib-copy-hack
1500true
1501endef
1502endif
1503
1504
1505###########################################################
1506## Stuff source generated from one-off tools
1507###########################################################
1508
1509define transform-generated-source
1510@echo "target Generated: $(PRIVATE_MODULE) <= $<"
1511@mkdir -p $(dir $@)
1512$(hide) $(PRIVATE_CUSTOM_TOOL)
1513endef
1514
1515
1516###########################################################
1517## Assertions about attributes of the target
1518###########################################################
1519
1520# $(1): The file to check
1521ifndef get-file-size
1522$(error HOST_OS must define get-file-size)
1523endif
1524
1525# $(1): The file to check (often $@)
1526# $(2): The maximum size, in decimal bytes
1527#
1528# If $(2) is empty, evaluates to "true"
1529#
1530# Reserve bad blocks.  Make sure that MAX(1% of partition size, 2 blocks)
1531# is left over after the image has been flashed.  Round the 1% up to the
1532# next whole flash block size.
1533define assert-max-file-size
1534$(if $(2), \
1535  fileSize=`$(call get-file-size,$(1))`; \
1536  maxSize=$(2); \
1537  onePct=`expr "(" $$maxSize + 99 ")" / 100`; \
1538  onePct=`expr "(" "(" $$onePct + $(BOARD_FLASH_BLOCK_SIZE) - 1 ")" / \
1539          $(BOARD_FLASH_BLOCK_SIZE) ")" "*" $(BOARD_FLASH_BLOCK_SIZE)`; \
1540  reserve=`expr 2 "*" $(BOARD_FLASH_BLOCK_SIZE)`; \
1541  if [ "$$onePct" -gt "$$reserve" ]; then \
1542      reserve="$$onePct"; \
1543  fi; \
1544  maxSize=`expr $$maxSize - $$reserve`; \
1545  if [ "$$fileSize" -gt "$$maxSize" ]; then \
1546      echo "error: $(1) too large ($$fileSize > [$(2) - $$reserve])"; \
1547      false; \
1548  fi \
1549 , \
1550  true \
1551 )
1552endef
1553
1554###########################################################
1555## Other includes
1556###########################################################
1557
1558# -----------------------------------------------------------------
1559# Rules and functions to help copy important files to DIST_DIR
1560# when requested.
1561include $(BUILD_SYSTEM)/distdir.mk
1562
1563
1564# broken:
1565#	$(foreach file,$^,$(if $(findstring,.a,$(suffix $file)),-l$(file),$(file)))
1566
1567###########################################################
1568## Misc notes
1569###########################################################
1570
1571#DEPDIR = .deps
1572#df = $(DEPDIR)/$(*F)
1573
1574#SRCS = foo.c bar.c ...
1575
1576#%.o : %.c
1577#	@$(MAKEDEPEND); \
1578#	  cp $(df).d $(df).P; \
1579#	  sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
1580#	      -e '/^$$/ d' -e 's/$$/ :/' < $(df).d >> $(df).P; \
1581#	  rm -f $(df).d
1582#	$(COMPILE.c) -o $@ $<
1583
1584#-include $(SRCS:%.c=$(DEPDIR)/%.P)
1585
1586
1587#%.o : %.c
1588#	$(COMPILE.c) -MD -o $@ $<
1589#	@cp $*.d $*.P; \
1590#	  sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
1591#	      -e '/^$$/ d' -e 's/$$/ :/' < $*.d >> $*.P; \
1592#	  rm -f $*.d
1593