Home | History | Annotate | Download | only in core
      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
     27 ALL_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.
     38 ALL_MODULES:=
     39 
     40 # Full paths to targets that should be added to the "make droid"
     41 # set of installed targets.
     42 ALL_DEFAULT_INSTALLED_MODULES:=
     43 
     44 # The list of tags that have been defined by
     45 # LOCAL_MODULE_TAGS.  Each word in this variable maps
     46 # to a corresponding ALL_MODULE_TAGS.<tagname> variable
     47 # that contains all of the INSTALLED_MODULEs with that tag.
     48 ALL_MODULE_TAGS:=
     49 
     50 # Similar to ALL_MODULE_TAGS, but contains the short names
     51 # of all targets for a particular tag.  The top-level variable
     52 # won't have the list of tags;  ust ALL_MODULE_TAGS to get
     53 # the list of all known tags.  (This means that this variable
     54 # will always be empty; it's just here as a placeholder for
     55 # its sub-variables.)
     56 ALL_MODULE_NAME_TAGS:=
     57 
     58 # Full path to all files that are made by some tool
     59 ALL_GENERATED_SOURCES:=
     60 
     61 # Full path to all asm, C, C++, lex and yacc generated C files.
     62 # These all have an order-only dependency on the copied headers
     63 ALL_C_CPP_ETC_OBJECTS:=
     64 
     65 # The list of dynamic binaries that haven't been stripped/compressed/etc.
     66 ALL_ORIGINAL_DYNAMIC_BINARIES:=
     67 
     68 # These files go into the SDK
     69 ALL_SDK_FILES:=
     70 
     71 # Files for dalvik.  This is often build without building the rest of the OS.
     72 INTERNAL_DALVIK_MODULES:=
     73 
     74 # All findbugs xml files
     75 ALL_FINDBUGS_FILES:=
     76 
     77 # GPL module license files
     78 ALL_GPL_MODULE_LICENSE_FILES:=
     79 
     80 # Target and host installed module's dependencies on shared libraries.
     81 # They are list of "<module_name>:<installed_file>:lib1,lib2...".
     82 TARGET_DEPENDENCIES_ON_SHARED_LIBRARIES :=
     83 $(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_DEPENDENCIES_ON_SHARED_LIBRARIES :=
     84 HOST_DEPENDENCIES_ON_SHARED_LIBRARIES :=
     85 $(HOST_2ND_ARCH_VAR_PREFIX)HOST_DEPENDENCIES_ON_SHARED_LIBRARIES :=
     86 HOST_CROSS_DEPENDENCIES_ON_SHARED_LIBRARIES :=
     87 $(HOST_CROSS_2ND_ARCH_VAR_PREFIX)HOST_CROSS_DEPENDENCIES_ON_SHARED_LIBRARIES :=
     88 
     89 # Generated class file names for Android resource.
     90 # They are escaped and quoted so can be passed safely to a bash command.
     91 ANDROID_RESOURCE_GENERATED_CLASSES := 'R.class' 'R$$*.class' 'Manifest.class' 'Manifest$$*.class'
     92 
     93 # Display names for various build targets
     94 TARGET_DISPLAY := target
     95 AUX_DISPLAY := aux
     96 HOST_DISPLAY := host
     97 HOST_CROSS_DISPLAY := host cross
     98 
     99 # All installed initrc files
    100 ALL_INIT_RC_INSTALLED_PAIRS :=
    101 
    102 ###########################################################
    103 ## Debugging; prints a variable list to stdout
    104 ###########################################################
    105 
    106 # $(1): variable name list, not variable values
    107 define print-vars
    108 $(foreach var,$(1), \
    109   $(info $(var):) \
    110   $(foreach word,$($(var)), \
    111     $(info $(space)$(space)$(word)) \
    112    ) \
    113  )
    114 endef
    115 
    116 ###########################################################
    117 ## Evaluates to true if the string contains the word true,
    118 ## and empty otherwise
    119 ## $(1): a var to test
    120 ###########################################################
    121 
    122 define true-or-empty
    123 $(filter true, $(1))
    124 endef
    125 
    126 ###########################################################
    127 ## Rule for touching GCNO files.
    128 ###########################################################
    129 define gcno-touch-rule
    130 $(2): $(1)
    131 	touch -c $$@
    132 endef
    133 
    134 ###########################################################
    135 
    136 ###########################################################
    137 ## Retrieve the directory of the current makefile
    138 ## Must be called before including any other makefile!!
    139 ###########################################################
    140 
    141 # Figure out where we are.
    142 define my-dir
    143 $(strip \
    144   $(eval LOCAL_MODULE_MAKEFILE := $$(lastword $$(MAKEFILE_LIST))) \
    145   $(if $(filter $(BUILD_SYSTEM)/% $(OUT_DIR)/%,$(LOCAL_MODULE_MAKEFILE)), \
    146     $(error my-dir must be called before including any other makefile.) \
    147    , \
    148     $(patsubst %/,%,$(dir $(LOCAL_MODULE_MAKEFILE))) \
    149    ) \
    150  )
    151 endef
    152 
    153 
    154 ###########################################################
    155 ## Retrieve a list of all makefiles immediately below some directory
    156 ###########################################################
    157 
    158 define all-makefiles-under
    159 $(wildcard $(1)/*/Android.mk)
    160 endef
    161 
    162 ###########################################################
    163 ## Look under a directory for makefiles that don't have parent
    164 ## makefiles.
    165 ###########################################################
    166 
    167 # $(1): directory to search under
    168 # Ignores $(1)/Android.mk
    169 define first-makefiles-under
    170 $(shell build/tools/findleaves.py $(FIND_LEAVES_EXCLUDES) \
    171         --mindepth=2 $(addprefix --dir=,$(1)) Android.mk)
    172 endef
    173 
    174 ###########################################################
    175 ## Retrieve a list of all makefiles immediately below your directory
    176 ## Must be called before including any other makefile!!
    177 ###########################################################
    178 
    179 define all-subdir-makefiles
    180 $(call all-makefiles-under,$(call my-dir))
    181 endef
    182 
    183 ###########################################################
    184 ## Look in the named list of directories for makefiles,
    185 ## relative to the current directory.
    186 ## Must be called before including any other makefile!!
    187 ###########################################################
    188 
    189 # $(1): List of directories to look for under this directory
    190 define all-named-subdir-makefiles
    191 $(wildcard $(addsuffix /Android.mk, $(addprefix $(call my-dir)/,$(1))))
    192 endef
    193 
    194 ###########################################################
    195 ## Find all of the directories under the named directories with
    196 ## the specified name.
    197 ## Meant to be used like:
    198 ##    INC_DIRS := $(call all-named-dirs-under,inc,.)
    199 ###########################################################
    200 
    201 define all-named-dirs-under
    202 $(call find-subdir-files,$(2) -type d -name "$(1)")
    203 endef
    204 
    205 ###########################################################
    206 ## Find all the directories under the current directory that
    207 ## haves name that match $(1)
    208 ###########################################################
    209 
    210 define all-subdir-named-dirs
    211 $(call all-named-dirs-under,$(1),.)
    212 endef
    213 
    214 ###########################################################
    215 ## Find all of the files under the named directories with
    216 ## the specified name.
    217 ## Meant to be used like:
    218 ##    SRC_FILES := $(call all-named-files-under,*.h,src tests)
    219 ###########################################################
    220 
    221 define all-named-files-under
    222 $(call find-files-in-subdirs,$(LOCAL_PATH),"$(1)",$(2))
    223 endef
    224 
    225 ###########################################################
    226 ## Find all of the files under the current directory with
    227 ## the specified name.
    228 ###########################################################
    229 
    230 define all-subdir-named-files
    231 $(call all-named-files-under,$(1),.)
    232 endef
    233 
    234 ###########################################################
    235 ## Find all of the java files under the named directories.
    236 ## Meant to be used like:
    237 ##    SRC_FILES := $(call all-java-files-under,src tests)
    238 ###########################################################
    239 
    240 define all-java-files-under
    241 $(call all-named-files-under,*.java,$(1))
    242 endef
    243 
    244 ###########################################################
    245 ## Find all of the java files from here.  Meant to be used like:
    246 ##    SRC_FILES := $(call all-subdir-java-files)
    247 ###########################################################
    248 
    249 define all-subdir-java-files
    250 $(call all-java-files-under,.)
    251 endef
    252 
    253 ###########################################################
    254 ## Find all of the c files under the named directories.
    255 ## Meant to be used like:
    256 ##    SRC_FILES := $(call all-c-files-under,src tests)
    257 ###########################################################
    258 
    259 define all-c-files-under
    260 $(call all-named-files-under,*.c,$(1))
    261 endef
    262 
    263 ###########################################################
    264 ## Find all of the c files from here.  Meant to be used like:
    265 ##    SRC_FILES := $(call all-subdir-c-files)
    266 ###########################################################
    267 
    268 define all-subdir-c-files
    269 $(call all-c-files-under,.)
    270 endef
    271 
    272 ###########################################################
    273 ## Find all of the cpp files under the named directories.
    274 ## LOCAL_CPP_EXTENSION is respected if set.
    275 ## Meant to be used like:
    276 ##    SRC_FILES := $(call all-cpp-files-under,src tests)
    277 ###########################################################
    278 
    279 define all-cpp-files-under
    280 $(sort $(patsubst ./%,%, \
    281   $(shell cd $(LOCAL_PATH) ; \
    282           find -L $(1) -name "*$(or $(LOCAL_CPP_EXTENSION),.cpp)" -and -not -name ".*") \
    283  ))
    284 endef
    285 
    286 ###########################################################
    287 ## Find all of the cpp files from here.  Meant to be used like:
    288 ##    SRC_FILES := $(call all-subdir-cpp-files)
    289 ###########################################################
    290 
    291 define all-subdir-cpp-files
    292 $(call all-cpp-files-under,.)
    293 endef
    294 
    295 ###########################################################
    296 ## Find all files named "I*.aidl" under the named directories,
    297 ## which must be relative to $(LOCAL_PATH).  The returned list
    298 ## is relative to $(LOCAL_PATH).
    299 ###########################################################
    300 
    301 define all-Iaidl-files-under
    302 $(call all-named-files-under,I*.aidl,$(1))
    303 endef
    304 
    305 ###########################################################
    306 ## Find all of the "I*.aidl" files under $(LOCAL_PATH).
    307 ###########################################################
    308 
    309 define all-subdir-Iaidl-files
    310 $(call all-Iaidl-files-under,.)
    311 endef
    312 
    313 ###########################################################
    314 ## Find all files named "*.vts" under the named directories,
    315 ## which must be relative to $(LOCAL_PATH).  The returned list
    316 ## is relative to $(LOCAL_PATH).
    317 ###########################################################
    318 
    319 define all-vts-files-under
    320 $(call all-named-files-under,*.vts,$(1))
    321 endef
    322 
    323 ###########################################################
    324 ## Find all of the "*.vts" files under $(LOCAL_PATH).
    325 ###########################################################
    326 
    327 define all-subdir-vts-files
    328 $(call all-vts-files-under,.)
    329 endef
    330 
    331 ###########################################################
    332 ## Find all of the logtags files under the named directories.
    333 ## Meant to be used like:
    334 ##    SRC_FILES := $(call all-logtags-files-under,src)
    335 ###########################################################
    336 
    337 define all-logtags-files-under
    338 $(call all-named-files-under,*.logtags,$(1))
    339 endef
    340 
    341 ###########################################################
    342 ## Find all of the .proto files under the named directories.
    343 ## Meant to be used like:
    344 ##    SRC_FILES := $(call all-proto-files-under,src)
    345 ###########################################################
    346 
    347 define all-proto-files-under
    348 $(call all-named-files-under,*.proto,$(1))
    349 endef
    350 
    351 ###########################################################
    352 ## Find all of the RenderScript files under the named directories.
    353 ##  Meant to be used like:
    354 ##    SRC_FILES := $(call all-renderscript-files-under,src)
    355 ###########################################################
    356 
    357 define all-renderscript-files-under
    358 $(call find-subdir-files,$(1) \( -name "*.rs" -or -name "*.fs" \) -and -not -name ".*")
    359 endef
    360 
    361 ###########################################################
    362 ## Find all of the S files under the named directories.
    363 ## Meant to be used like:
    364 ##    SRC_FILES := $(call all-c-files-under,src tests)
    365 ###########################################################
    366 
    367 define all-S-files-under
    368 $(call all-named-files-under,*.S,$(1))
    369 endef
    370 
    371 ###########################################################
    372 ## Find all of the html files under the named directories.
    373 ## Meant to be used like:
    374 ##    SRC_FILES := $(call all-html-files-under,src tests)
    375 ###########################################################
    376 
    377 define all-html-files-under
    378 $(call all-named-files-under,*.html,$(1))
    379 endef
    380 
    381 ###########################################################
    382 ## Find all of the html files from here.  Meant to be used like:
    383 ##    SRC_FILES := $(call all-subdir-html-files)
    384 ###########################################################
    385 
    386 define all-subdir-html-files
    387 $(call all-html-files-under,.)
    388 endef
    389 
    390 ###########################################################
    391 ## Find all of the files matching pattern
    392 ##    SRC_FILES := $(call find-subdir-files, <pattern>)
    393 ###########################################################
    394 
    395 define find-subdir-files
    396 $(sort $(patsubst ./%,%,$(shell cd $(LOCAL_PATH) ; find -L $(1))))
    397 endef
    398 
    399 ###########################################################
    400 # find the files in the subdirectory $1 of LOCAL_DIR
    401 # matching pattern $2, filtering out files $3
    402 # e.g.
    403 #     SRC_FILES += $(call find-subdir-subdir-files, \
    404 #                         css, *.cpp, DontWantThis.cpp)
    405 ###########################################################
    406 
    407 define find-subdir-subdir-files
    408 $(sort $(filter-out $(patsubst %,$(1)/%,$(3)),$(patsubst ./%,%,$(shell cd \
    409             $(LOCAL_PATH) ; find -L $(1) -maxdepth 1 -name $(2)))))
    410 endef
    411 
    412 ###########################################################
    413 ## Find all of the files matching pattern
    414 ##    SRC_FILES := $(call all-subdir-java-files)
    415 ###########################################################
    416 
    417 define find-subdir-assets
    418 $(sort $(if $(1),$(patsubst ./%,%, \
    419 	$(shell if [ -d $(1) ] ; then cd $(1) ; find -L ./ -not -name '.*' -and -type f ; fi)), \
    420 	$(warning Empty argument supplied to find-subdir-assets in $(LOCAL_PATH)) \
    421 ))
    422 endef
    423 
    424 ###########################################################
    425 ## Find various file types in a list of directories relative to $(LOCAL_PATH)
    426 ###########################################################
    427 
    428 define find-other-java-files
    429 $(call all-java-files-under,$(1))
    430 endef
    431 
    432 define find-other-html-files
    433 $(call all-html-files-under,$(1))
    434 endef
    435 
    436 ###########################################################
    437 # Use utility find to find given files in the given subdirs.
    438 # This function uses $(1), instead of LOCAL_PATH as the base.
    439 # $(1): the base dir, relative to the root of the source tree.
    440 # $(2): the file name pattern to be passed to find as "-name".
    441 # $(3): a list of subdirs of the base dir.
    442 # Returns: a list of paths relative to the base dir.
    443 ###########################################################
    444 
    445 define find-files-in-subdirs
    446 $(sort $(patsubst ./%,%, \
    447   $(shell cd $(1) ; \
    448           find -L $(3) -name $(2) -and -not -name ".*") \
    449  ))
    450 endef
    451 
    452 ###########################################################
    453 ## Scan through each directory of $(1) looking for files
    454 ## that match $(2) using $(wildcard).  Useful for seeing if
    455 ## a given directory or one of its parents contains
    456 ## a particular file.  Returns the first match found,
    457 ## starting furthest from the root.
    458 ###########################################################
    459 
    460 define find-parent-file
    461 $(strip \
    462   $(eval _fpf := $(sort $(wildcard $(foreach f, $(2), $(strip $(1))/$(f))))) \
    463   $(if $(_fpf),$(_fpf), \
    464        $(if $(filter-out ./ .,$(1)), \
    465              $(call find-parent-file,$(patsubst %/,%,$(dir $(1))),$(2)) \
    466         ) \
    467    ) \
    468 )
    469 endef
    470 
    471 ###########################################################
    472 ## Find test data in a form required by LOCAL_TEST_DATA
    473 ## $(1): the base dir, relative to the root of the source tree.
    474 ## $(3): the file name pattern to be passed to find as "-name"
    475 ## $(2): a list of subdirs of the base dir
    476 ###########################################################
    477 
    478 define find-test-data-in-subdirs
    479 $(foreach f,$(sort $(patsubst ./%,%, \
    480   $(shell cd $(1) ; \
    481           find -L $(3) -type f -and -name $(2) -and -not -name ".*") \
    482 )),$(1):$(f))
    483 endef
    484 
    485 ###########################################################
    486 ## Function we can evaluate to introduce a dynamic dependency
    487 ###########################################################
    488 
    489 define add-dependency
    490 $(1): $(2)
    491 endef
    492 
    493 ###########################################################
    494 ## Reverse order of a list
    495 ###########################################################
    496 
    497 define reverse-list
    498 $(if $(1),$(call reverse-list,$(wordlist 2,$(words $(1)),$(1)))) $(firstword $(1))
    499 endef
    500 
    501 define def-host-aux-target
    502 $(eval _idf_val_:=$(if $(strip $(LOCAL_IS_HOST_MODULE)),HOST,$(if $(strip $(LOCAL_IS_AUX_MODULE)),AUX,))) \
    503 $(_idf_val_)
    504 endef
    505 
    506 ###########################################################
    507 ## Returns correct _idfPrefix from the list:
    508 ##   { HOST, HOST_CROSS, AUX, TARGET }
    509 ###########################################################
    510 # the following rules checked in order:
    511 # ($1 is in {AUX, HOST_CROSS} => $1;
    512 # ($1 is empty) => TARGET;
    513 # ($2 is not empty) => HOST_CROSS;
    514 # => HOST;
    515 define find-idf-prefix
    516 $(strip \
    517     $(eval _idf_pfx_:=$(strip $(filter AUX HOST_CROSS,$(1)))) \
    518     $(eval _idf_pfx_:=$(if $(strip $(1)),$(if $(_idf_pfx_),$(_idf_pfx_),$(if $(strip $(2)),HOST_CROSS,HOST)),TARGET)) \
    519     $(_idf_pfx_)
    520 )
    521 endef
    522 
    523 ###########################################################
    524 ## The intermediates directory.  Where object files go for
    525 ## a given target.  We could technically get away without
    526 ## the "_intermediates" suffix on the directory, but it's
    527 ## nice to be able to grep for that string to find out if
    528 ## anyone's abusing the system.
    529 ###########################################################
    530 
    531 # $(1): target class, like "APPS"
    532 # $(2): target name, like "NotePad"
    533 # $(3): { HOST, HOST_CROSS, AUX, <empty (TARGET)>, <other non-empty (HOST)> }
    534 # $(4): if non-empty, force the intermediates to be COMMON
    535 # $(5): if non-empty, force the intermediates to be for the 2nd arch
    536 # $(6): if non-empty, force the intermediates to be for the host cross os
    537 define intermediates-dir-for
    538 $(strip \
    539     $(eval _idfClass := $(strip $(1))) \
    540     $(if $(_idfClass),, \
    541         $(error $(LOCAL_PATH): Class not defined in call to intermediates-dir-for)) \
    542     $(eval _idfName := $(strip $(2))) \
    543     $(if $(_idfName),, \
    544         $(error $(LOCAL_PATH): Name not defined in call to intermediates-dir-for)) \
    545     $(eval _idfPrefix := $(call find-idf-prefix,$(3),$(6))) \
    546     $(eval _idf2ndArchPrefix := $(if $(strip $(5)),$(TARGET_2ND_ARCH_VAR_PREFIX))) \
    547     $(if $(filter $(_idfPrefix)-$(_idfClass),$(COMMON_MODULE_CLASSES))$(4), \
    548         $(eval _idfIntBase := $($(_idfPrefix)_OUT_COMMON_INTERMEDIATES)) \
    549       ,$(if $(filter $(_idfClass),$(PER_ARCH_MODULE_CLASSES)),\
    550           $(eval _idfIntBase := $($(_idf2ndArchPrefix)$(_idfPrefix)_OUT_INTERMEDIATES)) \
    551        ,$(eval _idfIntBase := $($(_idfPrefix)_OUT_INTERMEDIATES)) \
    552        ) \
    553      ) \
    554     $(_idfIntBase)/$(_idfClass)/$(_idfName)_intermediates \
    555 )
    556 endef
    557 
    558 # Uses LOCAL_MODULE_CLASS, LOCAL_MODULE, and LOCAL_IS_HOST_MODULE
    559 # to determine the intermediates directory.
    560 #
    561 # $(1): if non-empty, force the intermediates to be COMMON
    562 # $(2): if non-empty, force the intermediates to be for the 2nd arch
    563 # $(3): if non-empty, force the intermediates to be for the host cross os
    564 define local-intermediates-dir
    565 $(strip \
    566     $(if $(strip $(LOCAL_MODULE_CLASS)),, \
    567         $(error $(LOCAL_PATH): LOCAL_MODULE_CLASS not defined before call to local-intermediates-dir)) \
    568     $(if $(strip $(LOCAL_MODULE)),, \
    569         $(error $(LOCAL_PATH): LOCAL_MODULE not defined before call to local-intermediates-dir)) \
    570     $(call intermediates-dir-for,$(LOCAL_MODULE_CLASS),$(LOCAL_MODULE),$(call def-host-aux-target),$(1),$(2),$(3)) \
    571 )
    572 endef
    573 
    574 ###########################################################
    575 ## The generated sources directory.  Placing generated
    576 ## source files directly in the intermediates directory
    577 ## causes problems for multiarch builds, where there are
    578 ## two intermediates directories for a single target. Put
    579 ## them in a separate directory, and they will be copied to
    580 ## each intermediates directory automatically.
    581 ###########################################################
    582 
    583 # $(1): target class, like "APPS"
    584 # $(2): target name, like "NotePad"
    585 # $(3): { HOST, HOST_CROSS, AUX, <empty (TARGET)>, <other non-empty (HOST)> }
    586 # $(4): if non-empty, force the generated sources to be COMMON
    587 define generated-sources-dir-for
    588 $(strip \
    589     $(eval _idfClass := $(strip $(1))) \
    590     $(if $(_idfClass),, \
    591         $(error $(LOCAL_PATH): Class not defined in call to generated-sources-dir-for)) \
    592     $(eval _idfName := $(strip $(2))) \
    593     $(if $(_idfName),, \
    594         $(error $(LOCAL_PATH): Name not defined in call to generated-sources-dir-for)) \
    595     $(eval _idfPrefix := $(call find-idf-prefix,$(3),)) \
    596     $(if $(filter $(_idfPrefix)-$(_idfClass),$(COMMON_MODULE_CLASSES))$(4), \
    597         $(eval _idfIntBase := $($(_idfPrefix)_OUT_COMMON_GEN)) \
    598       , \
    599         $(eval _idfIntBase := $($(_idfPrefix)_OUT_GEN)) \
    600      ) \
    601     $(_idfIntBase)/$(_idfClass)/$(_idfName)_intermediates \
    602 )
    603 endef
    604 
    605 # Uses LOCAL_MODULE_CLASS, LOCAL_MODULE, and LOCAL_IS_HOST_MODULE
    606 # to determine the generated sources directory.
    607 #
    608 # $(1): if non-empty, force the intermediates to be COMMON
    609 define local-generated-sources-dir
    610 $(strip \
    611     $(if $(strip $(LOCAL_MODULE_CLASS)),, \
    612         $(error $(LOCAL_PATH): LOCAL_MODULE_CLASS not defined before call to local-generated-sources-dir)) \
    613     $(if $(strip $(LOCAL_MODULE)),, \
    614         $(error $(LOCAL_PATH): LOCAL_MODULE not defined before call to local-generated-sources-dir)) \
    615     $(call generated-sources-dir-for,$(LOCAL_MODULE_CLASS),$(LOCAL_MODULE),$(call def-host-aux-target),$(1)) \
    616 )
    617 endef
    618 
    619 ###########################################################
    620 ## Convert a list of short module names (e.g., "framework", "Browser")
    621 ## into the list of files that are built for those modules.
    622 ## NOTE: this won't return reliable results until after all
    623 ## sub-makefiles have been included.
    624 ## $(1): target list
    625 ###########################################################
    626 
    627 define module-built-files
    628 $(foreach module,$(1),$(ALL_MODULES.$(module).BUILT))
    629 endef
    630 
    631 ###########################################################
    632 ## Convert a list of short modules names (e.g., "framework", "Browser")
    633 ## into the list of files that are installed for those modules.
    634 ## NOTE: this won't return reliable results until after all
    635 ## sub-makefiles have been included.
    636 ## $(1): target list
    637 ###########################################################
    638 
    639 define module-installed-files
    640 $(foreach module,$(1),$(ALL_MODULES.$(module).INSTALLED))
    641 endef
    642 
    643 ###########################################################
    644 ## Convert a list of short modules names (e.g., "framework", "Browser")
    645 ## into the list of files that should be used when linking
    646 ## against that module as a public API.
    647 ## TODO: Allow this for more than JAVA_LIBRARIES modules
    648 ## NOTE: this won't return reliable results until after all
    649 ## sub-makefiles have been included.
    650 ## $(1): target list
    651 ###########################################################
    652 
    653 define module-stubs-files
    654 $(foreach module,$(1),$(ALL_MODULES.$(module).STUBS))
    655 endef
    656 
    657 ###########################################################
    658 ## Evaluates to the timestamp file for a doc module, which
    659 ## is the dependency that should be used.
    660 ## $(1): doc module
    661 ###########################################################
    662 
    663 define doc-timestamp-for
    664 $(OUT_DOCS)/$(strip $(1))-timestamp
    665 endef
    666 
    667 
    668 ###########################################################
    669 ## Convert "core ext framework" to "out/.../javalib.jar ..."
    670 ## $(1): library list
    671 ## $(2): Non-empty if IS_HOST_MODULE
    672 ###########################################################
    673 
    674 # $(1): library name
    675 # $(2): Non-empty if IS_HOST_MODULE
    676 define _java-lib-dir
    677 $(call intermediates-dir-for, \
    678 	JAVA_LIBRARIES,$(1),$(2),COMMON)
    679 endef
    680 
    681 # $(1): library name
    682 # $(2): Non-empty if IS_HOST_MODULE
    683 define _java-lib-full-classes.jar
    684 $(call _java-lib-dir,$(1),$(2))/classes.jar
    685 endef
    686 
    687 # Get the jar files (you can pass to "javac -classpath") of static or shared
    688 # Java libraries that you want to link against.
    689 # $(1): library name list
    690 # $(2): Non-empty if IS_HOST_MODULE
    691 define java-lib-files
    692 $(foreach lib,$(1),$(call _java-lib-full-classes.jar,$(lib),$(2)))
    693 endef
    694 
    695 # Get the dependency files (you can put on the right side of "|" of a build rule)
    696 # of the Java libraries.
    697 # $(1): library name list
    698 # $(2): Non-empty if IS_HOST_MODULE
    699 # Historically for target Java libraries we used a different file (javalib.jar)
    700 # as the dependency.
    701 # Now we can use classes.jar as dependency, so java-lib-deps is the same
    702 # as java-lib-files.
    703 define java-lib-deps
    704 $(call java-lib-files,$(1),$(2))
    705 endef
    706 
    707 
    708 ###########################################################
    709 ## Convert "core ext framework" to "out/.../classes.jack ..."
    710 ## $(1): library list
    711 ## $(2): Non-empty if IS_HOST_MODULE
    712 ###########################################################
    713 
    714 # $(1): library name
    715 # $(2): Non-empty if IS_HOST_MODULE
    716 define _jack-lib-full-classes
    717 $(call _java-lib-dir,$(1),$(2))/classes.jack
    718 endef
    719 
    720 # $(1): library name list
    721 # $(2): Non-empty if IS_HOST_MODULE
    722 define jack-lib-files
    723 $(foreach lib,$(1),$(call _jack-lib-full-classes,$(lib),$(2)))
    724 endef
    725 
    726 ###########################################################
    727 ## Returns true if $(1) and $(2) are equal.  Returns
    728 ## the empty string if they are not equal.
    729 ###########################################################
    730 define streq
    731 $(strip $(if $(strip $(1)),\
    732   $(if $(strip $(2)),\
    733     $(if $(filter-out __,_$(subst $(strip $(1)),,$(strip $(2)))$(subst $(strip $(2)),,$(strip $(1)))_),,true), \
    734     ),\
    735   $(if $(strip $(2)),\
    736     ,\
    737     true)\
    738  ))
    739 endef
    740 
    741 ###########################################################
    742 ## Convert "a b c" into "a:b:c"
    743 ###########################################################
    744 define normalize-path-list
    745 $(subst $(space),:,$(strip $(1)))
    746 endef
    747 
    748 ###########################################################
    749 ## Convert "a b c" into "a,b,c"
    750 ###########################################################
    751 define normalize-comma-list
    752 $(subst $(space),$(comma),$(strip $(1)))
    753 endef
    754 
    755 ###########################################################
    756 ## Read the word out of a colon-separated list of words.
    757 ## This has the same behavior as the built-in function
    758 ## $(word n,str).
    759 ##
    760 ## The individual words may not contain spaces.
    761 ##
    762 ## $(1): 1 based index
    763 ## $(2): value of the form a:b:c...
    764 ###########################################################
    765 
    766 define word-colon
    767 $(word $(1),$(subst :,$(space),$(2)))
    768 endef
    769 
    770 ###########################################################
    771 ## Convert "a=b c= d e = f" into "a=b c=d e=f"
    772 ##
    773 ## $(1): list to collapse
    774 ## $(2): if set, separator word; usually "=", ":", or ":="
    775 ##       Defaults to "=" if not set.
    776 ###########################################################
    777 
    778 define collapse-pairs
    779 $(eval _cpSEP := $(strip $(if $(2),$(2),=)))\
    780 $(subst $(space)$(_cpSEP)$(space),$(_cpSEP),$(strip \
    781     $(subst $(_cpSEP), $(_cpSEP) ,$(1))))
    782 endef
    783 
    784 ###########################################################
    785 ## Given a list of pairs, if multiple pairs have the same
    786 ## first components, keep only the first pair.
    787 ##
    788 ## $(1): list of pairs
    789 ## $(2): the separator word, such as ":", "=", etc.
    790 define uniq-pairs-by-first-component
    791 $(eval _upbfc_fc_set :=)\
    792 $(strip $(foreach w,$(1), $(eval _first := $(word 1,$(subst $(2),$(space),$(w))))\
    793     $(if $(filter $(_upbfc_fc_set),$(_first)),,$(w)\
    794         $(eval _upbfc_fc_set += $(_first)))))\
    795 $(eval _upbfc_fc_set :=)\
    796 $(eval _first:=)
    797 endef
    798 
    799 ###########################################################
    800 ## MODULE_TAG set operations
    801 ###########################################################
    802 
    803 # Given a list of tags, return the targets that specify
    804 # any of those tags.
    805 # $(1): tag list
    806 define modules-for-tag-list
    807 $(sort $(foreach tag,$(1),$(foreach m,$(ALL_MODULE_NAME_TAGS.$(tag)),$(ALL_MODULES.$(m).INSTALLED))))
    808 endef
    809 
    810 # Same as modules-for-tag-list, but operates on
    811 # ALL_MODULE_NAME_TAGS.
    812 # $(1): tag list
    813 define module-names-for-tag-list
    814 $(sort $(foreach tag,$(1),$(ALL_MODULE_NAME_TAGS.$(tag))))
    815 endef
    816 
    817 # Given an accept and reject list, find the matching
    818 # set of targets.  If a target has multiple tags and
    819 # any of them are rejected, the target is rejected.
    820 # Reject overrides accept.
    821 # $(1): list of tags to accept
    822 # $(2): list of tags to reject
    823 #TODO(dbort): do $(if $(strip $(1)),$(1),$(ALL_MODULE_TAGS))
    824 #TODO(jbq): as of 20100106 nobody uses the second parameter
    825 define get-tagged-modules
    826 $(filter-out \
    827 	$(call modules-for-tag-list,$(2)), \
    828 	    $(call modules-for-tag-list,$(1)))
    829 endef
    830 
    831 ###########################################################
    832 ## Append a leaf to a base path.  Properly deals with
    833 ## base paths ending in /.
    834 ##
    835 ## $(1): base path
    836 ## $(2): leaf path
    837 ###########################################################
    838 
    839 define append-path
    840 $(subst //,/,$(1)/$(2))
    841 endef
    842 
    843 
    844 ###########################################################
    845 ## Color-coded warnings and errors
    846 ## Use echo-(warning|error) in a build rule
    847 ## Use pretty-(warning|error) instead of $(warning)/$(error)
    848 ###########################################################
    849 ESC_BOLD := \033[1m
    850 ESC_WARNING := \033[35m
    851 ESC_ERROR := \033[31m
    852 ESC_RESET := \033[0m
    853 
    854 # $(1): path (and optionally line) information
    855 # $(2): message to print
    856 define echo-warning
    857 echo -e "$(ESC_BOLD)$(1): $(ESC_WARNING)warning:$(ESC_RESET)$(ESC_BOLD)" $(2) "$(ESC_RESET)" >&2
    858 endef
    859 
    860 # $(1): path (and optionally line) information
    861 # $(2): message to print
    862 define echo-error
    863 echo -e "$(ESC_BOLD)$(1): $(ESC_ERROR)error:$(ESC_RESET)$(ESC_BOLD)" $(2) "$(ESC_RESET)" >&2
    864 endef
    865 
    866 # $(1): message to print
    867 define pretty-warning
    868 $(shell $(call echo-warning,$(LOCAL_MODULE_MAKEFILE),$(LOCAL_MODULE): $(1)))
    869 endef
    870 
    871 # $(1): message to print
    872 define pretty-error
    873 $(shell $(call echo-error,$(LOCAL_MODULE_MAKEFILE),$(LOCAL_MODULE): $(1)))
    874 $(error done)
    875 endef
    876 
    877 ###########################################################
    878 ## Package filtering
    879 ###########################################################
    880 
    881 # Given a list of installed modules (short or long names)
    882 # return a list of the packages (yes, .apk packages, not
    883 # modules in general) that are overridden by this list and,
    884 # therefore, should not be installed.
    885 # $(1): mixed list of installed modules
    886 # TODO: This is fragile; find a reliable way to get this information.
    887 define _get-package-overrides
    888  $(eval ### Discard any words containing slashes, unless they end in .apk, \
    889         ### in which case trim off the directory component and the suffix. \
    890         ### If there are no slashes, keep the entire word.)
    891  $(eval _gpo_names := $(subst /,@@@ @@@,$(1)))
    892  $(eval _gpo_names := \
    893      $(filter %.apk,$(_gpo_names)) \
    894      $(filter-out %@@@ @@@%,$(_gpo_names)))
    895  $(eval _gpo_names := $(patsubst %.apk,%,$(_gpo_names)))
    896  $(eval _gpo_names := $(patsubst @@@%,%,$(_gpo_names)))
    897 
    898  $(eval ### Remove any remaining words that contain dots.)
    899  $(eval _gpo_names := $(subst .,@@@ @@@,$(_gpo_names)))
    900  $(eval _gpo_names := $(filter-out %@@@ @@@%,$(_gpo_names)))
    901 
    902  $(eval ### Now we have a list of any words that could possibly refer to \
    903         ### packages, although there may be words that do not.  Only \
    904         ### real packages will be present under PACKAGES.*, though.)
    905  $(foreach _gpo_name,$(_gpo_names),$(PACKAGES.$(_gpo_name).OVERRIDES))
    906 endef
    907 
    908 define get-package-overrides
    909 $(sort $(strip $(call _get-package-overrides,$(1))))
    910 endef
    911 
    912 ###########################################################
    913 ## Output the command lines, or not
    914 ###########################################################
    915 
    916 ifeq ($(strip $(SHOW_COMMANDS)),)
    917 define pretty
    918 @echo $1
    919 endef
    920 else
    921 define pretty
    922 endef
    923 endif
    924 
    925 ###########################################################
    926 ## Commands for including the dependency files the compiler generates
    927 ###########################################################
    928 # $(1): the .P file
    929 # $(2): the main build target
    930 define include-depfile
    931 $(eval $(2) : .KATI_DEPFILE := $1)
    932 endef
    933 
    934 # $(1): object files
    935 define include-depfiles-for-objs
    936 $(foreach obj, $(1), $(call include-depfile, $(obj:%.o=%.d), $(obj)))
    937 endef
    938 
    939 ###########################################################
    940 ## Track source files compiled to objects
    941 ###########################################################
    942 # $(1): list of sources
    943 # $(2): list of matching objects
    944 define track-src-file-obj
    945 $(eval $(call _track-src-file-obj,$(1)))
    946 endef
    947 define _track-src-file-obj
    948 i := w
    949 $(foreach s,$(1),
    950 my_tracked_src_files += $(s)
    951 my_src_file_obj_$(s) := $$(word $$(words $$(i)),$$(2))
    952 i += w)
    953 endef
    954 
    955 # $(1): list of sources
    956 # $(2): list of matching generated sources
    957 define track-src-file-gen
    958 $(eval $(call _track-src-file-gen,$(2)))
    959 endef
    960 define _track-src-file-gen
    961 i := w
    962 $(foreach s,$(1),
    963 my_tracked_gen_files += $(s)
    964 my_src_file_gen_$(s) := $$(word $$(words $$(i)),$$(1))
    965 i += w)
    966 endef
    967 
    968 # $(1): list of generated sources
    969 # $(2): list of matching objects
    970 define track-gen-file-obj
    971 $(call track-src-file-obj,$(foreach f,$(1),\
    972   $(or $(my_src_file_gen_$(f)),$(f))),$(2))
    973 endef
    974 
    975 ###########################################################
    976 ## Commands for running lex
    977 ###########################################################
    978 
    979 define transform-l-to-c-or-cpp
    980 @echo "Lex: $(PRIVATE_MODULE) <= $<"
    981 @mkdir -p $(dir $@)
    982 $(hide) $(LEX) -o$@ $<
    983 endef
    984 
    985 ###########################################################
    986 ## Commands for running yacc
    987 ##
    988 ###########################################################
    989 
    990 define transform-y-to-c-or-cpp
    991 @echo "Yacc: $(PRIVATE_MODULE) <= $<"
    992 @mkdir -p $(dir $@)
    993 $(YACC) $(PRIVATE_YACCFLAGS) \
    994   --defines=$(basename $@).h \
    995   -o $@ $<
    996 endef
    997 
    998 ###########################################################
    999 ## Commands to compile RenderScript to Java
   1000 ###########################################################
   1001 
   1002 ## Merge multiple .d files generated by llvm-rs-cc. This is necessary
   1003 ## because ninja can handle only a single depfile per build target.
   1004 ## .d files generated by llvm-rs-cc define .stamp, .bc, and optionally
   1005 ## .java as build targets. However, there's no way to let ninja know
   1006 ## dependencies to .bc files and .java files, so we give up build
   1007 ## targets for them. As we write the .stamp file as the target by
   1008 ## ourselves, the awk script removes the first lines before the colon
   1009 ## and append a backslash to the last line to concatenate contents of
   1010 ## multiple files.
   1011 # $(1): .d files to be merged
   1012 # $(2): merged .d file
   1013 define _merge-renderscript-d
   1014 $(hide) echo '$@: $(backslash)' > $2
   1015 $(foreach d,$1, \
   1016   $(hide) awk 'start { sub(/( \\)?$$/, " \\"); print } /:/ { start=1 }' < $d >> $2$(newline))
   1017 $(hide) echo >> $2
   1018 endef
   1019 
   1020 # b/37755219
   1021 RS_CC_ASAN_OPTIONS := ASAN_OPTIONS=detect_leaks=0:detect_container_overflow=0
   1022 
   1023 define transform-renderscripts-to-java-and-bc
   1024 @echo "RenderScript: $(PRIVATE_MODULE) <= $(PRIVATE_RS_SOURCE_FILES)"
   1025 $(hide) rm -rf $(PRIVATE_RS_OUTPUT_DIR)
   1026 $(hide) mkdir -p $(PRIVATE_RS_OUTPUT_DIR)/res/raw
   1027 $(hide) mkdir -p $(PRIVATE_RS_OUTPUT_DIR)/src
   1028 $(hide) $(RS_CC_ASAN_OPTIONS) $(PRIVATE_RS_CC) \
   1029   -o $(PRIVATE_RS_OUTPUT_DIR)/res/raw \
   1030   -p $(PRIVATE_RS_OUTPUT_DIR)/src \
   1031   -d $(PRIVATE_RS_OUTPUT_DIR) \
   1032   -a $@ -MD \
   1033   $(addprefix -target-api , $(PRIVATE_RS_TARGET_API)) \
   1034   $(PRIVATE_RS_FLAGS) \
   1035   $(foreach inc,$(PRIVATE_RS_INCLUDES),$(addprefix -I , $(inc))) \
   1036   $(PRIVATE_RS_SOURCE_FILES)
   1037 $(call _merge-renderscript-d,$(PRIVATE_DEP_FILES),$@.d)
   1038 $(hide) mkdir -p $(dir $@)
   1039 $(hide) touch $@
   1040 endef
   1041 
   1042 define transform-bc-to-so
   1043 @echo "Renderscript compatibility: $(notdir $@) <= $(notdir $<)"
   1044 $(hide) mkdir -p $(dir $@)
   1045 $(hide) $(BCC_COMPAT) -O3 -o $(dir $@)/$(notdir $(<:.bc=.o)) -fPIC -shared \
   1046 	-rt-path $(RS_PREBUILT_CLCORE) -mtriple $(RS_COMPAT_TRIPLE) $<
   1047 $(hide) $(PRIVATE_CXX) -shared -Wl,-soname,$(notdir $@) -nostdlib \
   1048 	-Wl,-rpath,\$$ORIGIN/../lib \
   1049 	$(dir $@)/$(notdir $(<:.bc=.o)) \
   1050 	$(RS_PREBUILT_COMPILER_RT) \
   1051 	-o $@ $(TARGET_GLOBAL_LDFLAGS) -Wl,--hash-style=sysv -L prebuilts/gcc/ \
   1052 	$(RS_PREBUILT_LIBPATH) \
   1053 	$(call intermediates-dir-for,SHARED_LIBRARIES,libRSSupport)/libRSSupport.so \
   1054 	-lm -lc
   1055 endef
   1056 
   1057 ###########################################################
   1058 ## Commands to compile RenderScript to C++
   1059 ###########################################################
   1060 
   1061 define transform-renderscripts-to-cpp-and-bc
   1062 @echo "RenderScript: $(PRIVATE_MODULE) <= $(PRIVATE_RS_SOURCE_FILES)"
   1063 $(hide) rm -rf $(PRIVATE_RS_OUTPUT_DIR)
   1064 $(hide) mkdir -p $(PRIVATE_RS_OUTPUT_DIR)/
   1065 $(hide) $(RS_CC_ASAN_OPTIONS) $(PRIVATE_RS_CC) \
   1066   -o $(PRIVATE_RS_OUTPUT_DIR)/ \
   1067   -d $(PRIVATE_RS_OUTPUT_DIR) \
   1068   -a $@ -MD \
   1069   -reflect-c++ \
   1070   $(addprefix -target-api , $(PRIVATE_RS_TARGET_API)) \
   1071   $(PRIVATE_RS_FLAGS) \
   1072   $(addprefix -I , $(PRIVATE_RS_INCLUDES)) \
   1073   $(PRIVATE_RS_SOURCE_FILES)
   1074 $(call _merge-renderscript-d,$(PRIVATE_DEP_FILES),$@.d)
   1075 $(hide) mkdir -p $(dir $@)
   1076 $(hide) touch $@
   1077 endef
   1078 
   1079 
   1080 ###########################################################
   1081 ## Commands for running aidl
   1082 ###########################################################
   1083 
   1084 define transform-aidl-to-java
   1085 @mkdir -p $(dir $@)
   1086 @echo "Aidl: $(PRIVATE_MODULE) <= $<"
   1087 $(hide) $(AIDL) -d$(patsubst %.java,%.P,$@) $(PRIVATE_AIDL_FLAGS) $< $@
   1088 endef
   1089 #$(AIDL) $(PRIVATE_AIDL_FLAGS) $< - | indent -nut -br -npcs -l1000 > $@
   1090 
   1091 define transform-aidl-to-cpp
   1092 @mkdir -p $(dir $@)
   1093 @mkdir -p $(PRIVATE_HEADER_OUTPUT_DIR)
   1094 @echo "Generating C++ from AIDL: $(PRIVATE_MODULE) <= $<"
   1095 $(hide) $(AIDL_CPP) -d$(basename $@).aidl.d -ninja $(PRIVATE_AIDL_FLAGS) \
   1096     $< $(PRIVATE_HEADER_OUTPUT_DIR) $@
   1097 endef
   1098 
   1099 ## Given a .aidl file path, generate the rule to compile it a .java file
   1100 # $(1): a .aidl source file
   1101 # $(2): a directory to place the generated .java files in
   1102 # $(3): name of a variable to add the path to the generated source file to
   1103 #
   1104 # You must call this with $(eval).
   1105 define define-aidl-java-rule
   1106 define-aidl-java-rule-src := $(patsubst %.aidl,%.java,$(subst ../,dotdot/,$(addprefix $(2)/,$(1))))
   1107 $$(define-aidl-java-rule-src) : $(LOCAL_PATH)/$(1) $(AIDL)
   1108 	$$(transform-aidl-to-java)
   1109 $(3) += $$(define-aidl-java-rule-src)
   1110 endef
   1111 
   1112 ## Given a .aidl file path generate the rule to compile it a .cpp file.
   1113 # $(1): a .aidl source file
   1114 # $(2): a directory to place the generated .cpp files in
   1115 # $(3): name of a variable to add the path to the generated source file to
   1116 #
   1117 # You must call this with $(eval).
   1118 define define-aidl-cpp-rule
   1119 define-aidl-cpp-rule-src := $(patsubst %.aidl,%$(LOCAL_CPP_EXTENSION),$(subst ../,dotdot/,$(addprefix $(2)/,$(1))))
   1120 $$(define-aidl-cpp-rule-src) : $(LOCAL_PATH)/$(1) $(AIDL_CPP)
   1121 	$$(transform-aidl-to-cpp)
   1122 $(3) += $$(define-aidl-cpp-rule-src)
   1123 endef
   1124 
   1125 ###########################################################
   1126 ## Commands for running vts
   1127 ###########################################################
   1128 
   1129 define transform-vts-to-cpp
   1130 @mkdir -p $(dir $@)
   1131 @mkdir -p $(PRIVATE_HEADER_OUTPUT_DIR)
   1132 @echo "Generating C++ from VTS: $(PRIVATE_MODULE) <= $<"
   1133 $(hide) $(VTSC) -d$(basename $@).vts.P $(PRIVATE_VTS_FLAGS) \
   1134     $< $(PRIVATE_HEADER_OUTPUT_DIR) $@
   1135 endef
   1136 
   1137 ## Given a .vts file path generate the rule to compile it a .cpp file.
   1138 # $(1): a .vts source file
   1139 # $(2): a directory to place the generated .cpp files in
   1140 # $(3): name of a variable to add the path to the generated source file to
   1141 #
   1142 # You must call this with $(eval).
   1143 define define-vts-cpp-rule
   1144 define-vts-cpp-rule-src := $(patsubst %.vts,%$(LOCAL_CPP_EXTENSION),$(subst ../,dotdot/,$(addprefix $(2)/,$(1))))
   1145 $$(define-vts-cpp-rule-src) : $(LOCAL_PATH)/$(1) $(VTSC)
   1146 	$$(transform-vts-to-cpp)
   1147 $(3) += $$(define-vts-cpp-rule-src)
   1148 endef
   1149 
   1150 ###########################################################
   1151 ## Commands for running java-event-log-tags.py
   1152 ###########################################################
   1153 
   1154 define transform-logtags-to-java
   1155 @mkdir -p $(dir $@)
   1156 @echo "logtags: $@ <= $<"
   1157 $(hide) $(JAVATAGS) -o $@ $< $(PRIVATE_MERGED_TAG)
   1158 endef
   1159 
   1160 
   1161 ###########################################################
   1162 ## Commands for running protoc to compile .proto into .java
   1163 ###########################################################
   1164 # PATH contains HOST_OUT_EXECUTABLES to allow protoc-gen-* plugins
   1165 
   1166 define transform-proto-to-java
   1167 @mkdir -p $(dir $@)
   1168 @echo "Protoc: $@ <= $(PRIVATE_PROTO_SRC_FILES)"
   1169 @rm -rf $(PRIVATE_PROTO_JAVA_OUTPUT_DIR)
   1170 @mkdir -p $(PRIVATE_PROTO_JAVA_OUTPUT_DIR)
   1171 $(hide) for f in $(PRIVATE_PROTO_SRC_FILES); do \
   1172         PATH=$$PATH:$(HOST_OUT_EXECUTABLES) \
   1173         $(PROTOC) \
   1174         $(addprefix --proto_path=, $(PRIVATE_PROTO_INCLUDES)) \
   1175         $(PRIVATE_PROTO_JAVA_OUTPUT_OPTION)="$(PRIVATE_PROTO_JAVA_OUTPUT_PARAMS):$(PRIVATE_PROTO_JAVA_OUTPUT_DIR)" \
   1176         $(PRIVATE_PROTOC_FLAGS) \
   1177         $$f || exit 33; \
   1178         done
   1179 $(hide) touch $@
   1180 endef
   1181 
   1182 ######################################################################
   1183 ## Commands for running protoc to compile .proto into .pb.cc (or.pb.c) and .pb.h
   1184 ######################################################################
   1185 # PATH contains HOST_OUT_EXECUTABLES to allow protoc-gen-* plugins
   1186 
   1187 define transform-proto-to-cc
   1188 @echo "Protoc: $@ <= $<"
   1189 @mkdir -p $(dir $@)
   1190 $(hide) \
   1191 	PATH=$$PATH:$(HOST_OUT_EXECUTABLES) \
   1192 	$(PROTOC) \
   1193 	$(addprefix --proto_path=, $(PRIVATE_PROTO_INCLUDES)) \
   1194 	$(PRIVATE_PROTOC_FLAGS) \
   1195 	$<
   1196 @# aprotoc outputs only .cc. Rename it to .cpp if necessary.
   1197 $(if $(PRIVATE_RENAME_CPP_EXT),\
   1198   $(hide) mv $(basename $@).cc $@)
   1199 endef
   1200 
   1201 ###########################################################
   1202 ## Helper to set include paths form transform-*-to-o
   1203 ###########################################################
   1204 define c-includes
   1205 $(addprefix -I , $(PRIVATE_C_INCLUDES)) \
   1206 $$(cat $(PRIVATE_IMPORT_INCLUDES))\
   1207 $(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),,\
   1208     $(addprefix -I ,\
   1209         $(filter-out $(PRIVATE_C_INCLUDES), \
   1210             $(PRIVATE_GLOBAL_C_INCLUDES))) \
   1211     $(addprefix -isystem ,\
   1212         $(filter-out $(PRIVATE_C_INCLUDES), \
   1213             $(PRIVATE_GLOBAL_C_SYSTEM_INCLUDES))))
   1214 endef
   1215 
   1216 ###########################################################
   1217 ## Commands for running gcc to compile a C++ file
   1218 ###########################################################
   1219 
   1220 define transform-cpp-to-o-compiler-args
   1221 	$(c-includes) \
   1222 	-c \
   1223 	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
   1224 	    $(PRIVATE_TARGET_GLOBAL_CFLAGS) \
   1225 	    $(PRIVATE_TARGET_GLOBAL_CPPFLAGS) \
   1226 	    $(PRIVATE_ARM_CFLAGS) \
   1227 	 ) \
   1228 	$(PRIVATE_RTTI_FLAG) \
   1229 	$(PRIVATE_CFLAGS) \
   1230 	$(PRIVATE_CPPFLAGS) \
   1231 	$(PRIVATE_DEBUG_CFLAGS) \
   1232 	$(PRIVATE_CFLAGS_NO_OVERRIDE) \
   1233 	$(PRIVATE_CPPFLAGS_NO_OVERRIDE)
   1234 endef
   1235 
   1236 define clang-tidy-cpp
   1237 $(hide) $(PATH_TO_CLANG_TIDY) $(PRIVATE_TIDY_FLAGS) \
   1238   -checks=$(PRIVATE_TIDY_CHECKS) \
   1239   $< -- $(transform-cpp-to-o-compiler-args)
   1240 endef
   1241 
   1242 ifneq (,$(filter 1 true,$(WITH_TIDY_ONLY)))
   1243 define transform-cpp-to-o
   1244 $(if $(PRIVATE_TIDY_CHECKS),
   1245   @echo "$($(PRIVATE_PREFIX)DISPLAY) tidy $(PRIVATE_ARM_MODE) C++: $<"
   1246   $(clang-tidy-cpp))
   1247 endef
   1248 else
   1249 define transform-cpp-to-o
   1250 @echo "$($(PRIVATE_PREFIX)DISPLAY) $(PRIVATE_ARM_MODE) C++: $(PRIVATE_MODULE) <= $<"
   1251 @mkdir -p $(dir $@)
   1252 $(if $(PRIVATE_TIDY_CHECKS),$(clang-tidy-cpp))
   1253 $(hide) $(RELATIVE_PWD) $(PRIVATE_CXX) \
   1254   $(transform-cpp-to-o-compiler-args) \
   1255   -MD -MF $(patsubst %.o,%.d,$@) -o $@ $<
   1256 endef
   1257 endif
   1258 
   1259 
   1260 ###########################################################
   1261 ## Commands for running gcc to compile a C file
   1262 ###########################################################
   1263 
   1264 # $(1): extra flags
   1265 define transform-c-or-s-to-o-compiler-args
   1266 	$(c-includes) \
   1267 	-c \
   1268 	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
   1269 	    $(PRIVATE_TARGET_GLOBAL_CFLAGS) \
   1270 	    $(PRIVATE_TARGET_GLOBAL_CONLYFLAGS) \
   1271 	    $(PRIVATE_ARM_CFLAGS) \
   1272 	 ) \
   1273 	 $(1)
   1274 endef
   1275 
   1276 define transform-c-to-o-compiler-args
   1277 $(call transform-c-or-s-to-o-compiler-args, \
   1278   $(PRIVATE_CFLAGS) \
   1279   $(PRIVATE_CONLYFLAGS) \
   1280   $(PRIVATE_DEBUG_CFLAGS) \
   1281   $(PRIVATE_CFLAGS_NO_OVERRIDE))
   1282 endef
   1283 
   1284 define clang-tidy-c
   1285 $(hide) $(PATH_TO_CLANG_TIDY) $(PRIVATE_TIDY_FLAGS) \
   1286   -checks=$(PRIVATE_TIDY_CHECKS) \
   1287   $< -- $(transform-c-to-o-compiler-args)
   1288 endef
   1289 
   1290 ifneq (,$(filter 1 true,$(WITH_TIDY_ONLY)))
   1291 define transform-c-to-o
   1292 $(if $(PRIVATE_TIDY_CHECKS),
   1293   @echo "$($(PRIVATE_PREFIX)DISPLAY) tidy $(PRIVATE_ARM_MODE) C: $<"
   1294   $(clang-tidy-c))
   1295 endef
   1296 else
   1297 define transform-c-to-o
   1298 @echo "$($(PRIVATE_PREFIX)DISPLAY) $(PRIVATE_ARM_MODE) C: $(PRIVATE_MODULE) <= $<"
   1299 @mkdir -p $(dir $@)
   1300 $(if $(PRIVATE_TIDY_CHECKS),$(clang-tidy-c))
   1301 $(hide) $(RELATIVE_PWD) $(PRIVATE_CC) \
   1302   $(transform-c-to-o-compiler-args) \
   1303   -MD -MF $(patsubst %.o,%.d,$@) -o $@ $<
   1304 endef
   1305 endif
   1306 
   1307 define transform-s-to-o
   1308 @echo "$($(PRIVATE_PREFIX)DISPLAY) asm: $(PRIVATE_MODULE) <= $<"
   1309 @mkdir -p $(dir $@)
   1310 $(RELATIVE_PWD) $(PRIVATE_CC) \
   1311   $(call transform-c-or-s-to-o-compiler-args, $(PRIVATE_ASFLAGS)) \
   1312   -MD -MF $(patsubst %.o,%.d,$@) -o $@ $<
   1313 endef
   1314 
   1315 # YASM compilation
   1316 define transform-asm-to-o
   1317 @mkdir -p $(dir $@)
   1318 $(hide) $(YASM) \
   1319     $(addprefix -I , $(PRIVATE_C_INCLUDES)) \
   1320     $($(PRIVATE_2ND_ARCH_VAR_PREFIX)TARGET_GLOBAL_YASM_FLAGS) \
   1321     $(PRIVATE_ASFLAGS) \
   1322     -o $@ $<
   1323 endef
   1324 
   1325 ###########################################################
   1326 ## Commands for running gcc to compile an Objective-C file
   1327 ## This should never happen for target builds but this
   1328 ## will error at build time.
   1329 ###########################################################
   1330 
   1331 define transform-m-to-o
   1332 @echo "$($(PRIVATE_PREFIX)DISPLAY) ObjC: $(PRIVATE_MODULE) <= $<"
   1333 $(call transform-c-or-s-to-o, $(PRIVATE_CFLAGS) $(PRIVATE_DEBUG_CFLAGS))
   1334 endef
   1335 
   1336 ###########################################################
   1337 ## Commands for running gcc to compile a host C++ file
   1338 ###########################################################
   1339 
   1340 define transform-host-cpp-to-o-compiler-args
   1341 	$(c-includes) \
   1342 	-c \
   1343 	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
   1344 	    $(PRIVATE_HOST_GLOBAL_CFLAGS) \
   1345 	    $(PRIVATE_HOST_GLOBAL_CPPFLAGS) \
   1346 	 ) \
   1347 	$(PRIVATE_CFLAGS) \
   1348 	$(PRIVATE_CPPFLAGS) \
   1349 	$(PRIVATE_DEBUG_CFLAGS) \
   1350 	$(PRIVATE_CFLAGS_NO_OVERRIDE) \
   1351 	$(PRIVATE_CPPFLAGS_NO_OVERRIDE)
   1352 endef
   1353 
   1354 define clang-tidy-host-cpp
   1355 $(hide) $(PATH_TO_CLANG_TIDY) $(PRIVATE_TIDY_FLAGS) \
   1356   -checks=$(PRIVATE_TIDY_CHECKS) \
   1357   $< -- $(transform-host-cpp-to-o-compiler-args)
   1358 endef
   1359 
   1360 ifneq (,$(filter 1 true,$(WITH_TIDY_ONLY)))
   1361 define transform-host-cpp-to-o
   1362 $(if $(PRIVATE_TIDY_CHECKS),
   1363   @echo "tidy $($(PRIVATE_PREFIX)DISPLAY) C++: $<"
   1364   $(clang-tidy-host-cpp))
   1365 endef
   1366 else
   1367 define transform-host-cpp-to-o
   1368 @echo "$($(PRIVATE_PREFIX)DISPLAY) C++: $(PRIVATE_MODULE) <= $<"
   1369 @mkdir -p $(dir $@)
   1370 $(if $(PRIVATE_TIDY_CHECKS),$(clang-tidy-host-cpp))
   1371 $(hide) $(RELATIVE_PWD) $(PRIVATE_CXX) \
   1372   $(transform-host-cpp-to-o-compiler-args) \
   1373   -MD -MF $(patsubst %.o,%.d,$@) -o $@ $<
   1374 endef
   1375 endif
   1376 
   1377 
   1378 ###########################################################
   1379 ## Commands for running gcc to compile a host C file
   1380 ###########################################################
   1381 
   1382 define transform-host-c-or-s-to-o-common-args
   1383 	$(c-includes) \
   1384 	-c \
   1385 	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
   1386 	    $(PRIVATE_HOST_GLOBAL_CFLAGS) \
   1387 	    $(PRIVATE_HOST_GLOBAL_CONLYFLAGS) \
   1388 	 )
   1389 endef
   1390 
   1391 # $(1): extra flags
   1392 define transform-host-c-or-s-to-o
   1393 @mkdir -p $(dir $@)
   1394 $(hide) $(RELATIVE_PWD) $(PRIVATE_CC) \
   1395   $(transform-host-c-or-s-to-o-common-args) \
   1396   $(1) \
   1397   -MD -MF $(patsubst %.o,%.d,$@) -o $@ $<
   1398 endef
   1399 
   1400 define transform-host-c-to-o-compiler-args
   1401   $(transform-host-c-or-s-to-o-common-args) \
   1402   $(PRIVATE_CFLAGS) $(PRIVATE_CONLYFLAGS) \
   1403   $(PRIVATE_DEBUG_CFLAGS) $(PRIVATE_CFLAGS_NO_OVERRIDE)
   1404 endef
   1405 
   1406 define clang-tidy-host-c
   1407 $(hide) $(PATH_TO_CLANG_TIDY) $(PRIVATE_TIDY_FLAGS) \
   1408   -checks=$(PRIVATE_TIDY_CHECKS) \
   1409   $< -- $(transform-host-c-to-o-compiler-args)
   1410 endef
   1411 
   1412 ifneq (,$(filter 1 true,$(WITH_TIDY_ONLY)))
   1413 define transform-host-c-to-o
   1414 $(if $(PRIVATE_TIDY_CHECKS),
   1415   @echo "tidy $($(PRIVATE_PREFIX)DISPLAY) C: $<"
   1416   $(clang-tidy-host-c))
   1417 endef
   1418 else
   1419 define transform-host-c-to-o
   1420 @echo "$($(PRIVATE_PREFIX)DISPLAY) C: $(PRIVATE_MODULE) <= $<"
   1421 @mkdir -p $(dir $@)
   1422 $(if $(PRIVATE_TIDY_CHECKS), $(clang-tidy-host-c))
   1423 $(hide) $(RELATIVE_PWD) $(PRIVATE_CC) \
   1424   $(transform-host-c-to-o-compiler-args) \
   1425   -MD -MF $(patsubst %.o,%.d,$@) -o $@ $<
   1426 endef
   1427 endif
   1428 
   1429 define transform-host-s-to-o
   1430 @echo "$($(PRIVATE_PREFIX)DISPLAY) asm: $(PRIVATE_MODULE) <= $<"
   1431 $(call transform-host-c-or-s-to-o, $(PRIVATE_ASFLAGS))
   1432 endef
   1433 
   1434 ###########################################################
   1435 ## Commands for running gcc to compile a host Objective-C file
   1436 ###########################################################
   1437 
   1438 define transform-host-m-to-o
   1439 @echo "$($(PRIVATE_PREFIX)DISPLAY) ObjC: $(PRIVATE_MODULE) <= $<"
   1440 $(call transform-host-c-or-s-to-o, $(PRIVATE_CFLAGS) $(PRIVATE_DEBUG_CFLAGS) $(PRIVATE_CFLAGS_NO_OVERRIDE))
   1441 endef
   1442 
   1443 ###########################################################
   1444 ## Commands for running gcc to compile a host Objective-C++ file
   1445 ###########################################################
   1446 
   1447 define transform-host-mm-to-o
   1448 $(transform-host-cpp-to-o)
   1449 endef
   1450 
   1451 
   1452 ###########################################################
   1453 ## Rules to compile a single C/C++ source with ../ in the path
   1454 ###########################################################
   1455 # Replace "../" in object paths with $(DOTDOT_REPLACEMENT).
   1456 DOTDOT_REPLACEMENT := dotdot/
   1457 
   1458 ## Rule to compile a C++ source file with ../ in the path.
   1459 ## Must be called with $(eval).
   1460 # $(1): the C++ source file in LOCAL_SRC_FILES.
   1461 # $(2): the additional dependencies.
   1462 # $(3): the variable name to collect the output object file.
   1463 define compile-dotdot-cpp-file
   1464 o := $(intermediates)/$(patsubst %$(LOCAL_CPP_EXTENSION),%.o,$(subst ../,$(DOTDOT_REPLACEMENT),$(1)))
   1465 $$(o) : $(TOPDIR)$(LOCAL_PATH)/$(1) $(2)
   1466 	$$(transform-$$(PRIVATE_HOST)cpp-to-o)
   1467 $$(call include-depfiles-for-objs, $$(o))
   1468 $(3) += $$(o)
   1469 endef
   1470 
   1471 ## Rule to compile a C source file with ../ in the path.
   1472 ## Must be called with $(eval).
   1473 # $(1): the C source file in LOCAL_SRC_FILES.
   1474 # $(2): the additional dependencies.
   1475 # $(3): the variable name to collect the output object file.
   1476 define compile-dotdot-c-file
   1477 o := $(intermediates)/$(patsubst %.c,%.o,$(subst ../,$(DOTDOT_REPLACEMENT),$(1)))
   1478 $$(o) : $(TOPDIR)$(LOCAL_PATH)/$(1) $(2)
   1479 	$$(transform-$$(PRIVATE_HOST)c-to-o)
   1480 $$(call include-depfiles-for-objs, $$(o))
   1481 $(3) += $$(o)
   1482 endef
   1483 
   1484 ## Rule to compile a .S source file with ../ in the path.
   1485 ## Must be called with $(eval).
   1486 # $(1): the .S source file in LOCAL_SRC_FILES.
   1487 # $(2): the additional dependencies.
   1488 # $(3): the variable name to collect the output object file.
   1489 define compile-dotdot-s-file
   1490 o := $(intermediates)/$(patsubst %.S,%.o,$(subst ../,$(DOTDOT_REPLACEMENT),$(1)))
   1491 $$(o) : $(TOPDIR)$(LOCAL_PATH)/$(1) $(2)
   1492 	$$(transform-$$(PRIVATE_HOST)s-to-o)
   1493 $$(call include-depfiles-for-objs, $$(o))
   1494 $(3) += $$(o)
   1495 endef
   1496 
   1497 ## Rule to compile a .s source file with ../ in the path.
   1498 ## Must be called with $(eval).
   1499 # $(1): the .s source file in LOCAL_SRC_FILES.
   1500 # $(2): the additional dependencies.
   1501 # $(3): the variable name to collect the output object file.
   1502 define compile-dotdot-s-file-no-deps
   1503 o := $(intermediates)/$(patsubst %.s,%.o,$(subst ../,$(DOTDOT_REPLACEMENT),$(1)))
   1504 $$(o) : $(TOPDIR)$(LOCAL_PATH)/$(1) $(2)
   1505 	$$(transform-$$(PRIVATE_HOST)s-to-o)
   1506 $(3) += $$(o)
   1507 endef
   1508 
   1509 ###########################################################
   1510 ## Commands for running ar
   1511 ###########################################################
   1512 
   1513 define _concat-if-arg2-not-empty
   1514 $(if $(2),$(hide) $(1) $(2))
   1515 endef
   1516 
   1517 # Split long argument list into smaller groups and call the command repeatedly
   1518 # Call the command at least once even if there are no arguments, as otherwise
   1519 # the output file won't be created.
   1520 #
   1521 # $(1): the command without arguments
   1522 # $(2): the arguments
   1523 define split-long-arguments
   1524 $(hide) $(1) $(wordlist 1,500,$(2))
   1525 $(call _concat-if-arg2-not-empty,$(1),$(wordlist 501,1000,$(2)))
   1526 $(call _concat-if-arg2-not-empty,$(1),$(wordlist 1001,1500,$(2)))
   1527 $(call _concat-if-arg2-not-empty,$(1),$(wordlist 1501,2000,$(2)))
   1528 $(call _concat-if-arg2-not-empty,$(1),$(wordlist 2001,2500,$(2)))
   1529 $(call _concat-if-arg2-not-empty,$(1),$(wordlist 2501,3000,$(2)))
   1530 $(call _concat-if-arg2-not-empty,$(1),$(wordlist 3001,99999,$(2)))
   1531 endef
   1532 
   1533 # $(1): the full path of the source static library.
   1534 # $(2): the full path of the destination static library.
   1535 define _extract-and-include-single-target-whole-static-lib
   1536 $(hide) ldir=$(PRIVATE_INTERMEDIATES_DIR)/WHOLE/$(basename $(notdir $(1)))_objs;\
   1537     rm -rf $$ldir; \
   1538     mkdir -p $$ldir; \
   1539     cp $(1) $$ldir; \
   1540     lib_to_include=$$ldir/$(notdir $(1)); \
   1541     filelist=; \
   1542     subdir=0; \
   1543     for f in `$($(PRIVATE_2ND_ARCH_VAR_PREFIX)TARGET_AR) t $(1)`; do \
   1544         if [ -e $$ldir/$$f ]; then \
   1545             mkdir $$ldir/$$subdir; \
   1546             ext=$$subdir/; \
   1547             subdir=$$((subdir+1)); \
   1548             $($(PRIVATE_2ND_ARCH_VAR_PREFIX)TARGET_AR) m $$lib_to_include $$f; \
   1549         else \
   1550             ext=; \
   1551         fi; \
   1552         $($(PRIVATE_2ND_ARCH_VAR_PREFIX)TARGET_AR) p $$lib_to_include $$f > $$ldir/$$ext$$f; \
   1553         filelist="$$filelist $$ldir/$$ext$$f"; \
   1554     done ; \
   1555     $($(PRIVATE_2ND_ARCH_VAR_PREFIX)TARGET_AR) $($(PRIVATE_2ND_ARCH_VAR_PREFIX)TARGET_GLOBAL_ARFLAGS) \
   1556         $(2) $$filelist
   1557 
   1558 endef
   1559 
   1560 # $(1): the full path of the source static library.
   1561 # $(2): the full path of the destination static library.
   1562 define extract-and-include-whole-static-libs-first
   1563 $(if $(strip $(1)),
   1564 $(hide) cp $(1) $(2))
   1565 endef
   1566 
   1567 # $(1): the full path of the destination static library.
   1568 define extract-and-include-target-whole-static-libs
   1569 $(call extract-and-include-whole-static-libs-first, $(firstword $(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)),$(1))
   1570 $(foreach lib,$(wordlist 2,999,$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)), \
   1571     $(call _extract-and-include-single-target-whole-static-lib, $(lib), $(1)))
   1572 endef
   1573 
   1574 # Explicitly delete the archive first so that ar doesn't
   1575 # try to add to an existing archive.
   1576 define transform-o-to-static-lib
   1577 @echo "$($(PRIVATE_PREFIX)DISPLAY) StaticLib: $(PRIVATE_MODULE) ($@)"
   1578 @mkdir -p $(dir $@)
   1579 @rm -f $@ $@.tmp
   1580 $(call extract-and-include-target-whole-static-libs,$@.tmp)
   1581 $(call split-long-arguments,$($(PRIVATE_2ND_ARCH_VAR_PREFIX)TARGET_AR) \
   1582     $($(PRIVATE_2ND_ARCH_VAR_PREFIX)TARGET_GLOBAL_ARFLAGS) \
   1583     $(PRIVATE_ARFLAGS) \
   1584     $@.tmp,$(PRIVATE_ALL_OBJECTS))
   1585 $(hide) mv -f $@.tmp $@
   1586 endef
   1587 
   1588 # $(1): the full path of the source static library.
   1589 # $(2): the full path of the destination static library.
   1590 define _extract-and-include-single-aux-whole-static-lib
   1591 $(hide) ldir=$(PRIVATE_INTERMEDIATES_DIR)/WHOLE/$(basename $(notdir $(1)))_objs;\
   1592     rm -rf $$ldir; \
   1593     mkdir -p $$ldir; \
   1594     cp $(1) $$ldir; \
   1595     lib_to_include=$$ldir/$(notdir $(1)); \
   1596     filelist=; \
   1597     subdir=0; \
   1598     for f in `$(PRIVATE_AR) t $(1)`; do \
   1599         if [ -e $$ldir/$$f ]; then \
   1600             mkdir $$ldir/$$subdir; \
   1601             ext=$$subdir/; \
   1602             subdir=$$((subdir+1)); \
   1603             $(PRIVATE_AR) m $$lib_to_include $$f; \
   1604         else \
   1605             ext=; \
   1606         fi; \
   1607         $(PRIVATE_AR) p $$lib_to_include $$f > $$ldir/$$ext$$f; \
   1608         filelist="$$filelist $$ldir/$$ext$$f"; \
   1609     done ; \
   1610     $(PRIVATE_AR) $(AUX_GLOBAL_ARFLAGS) $(2) $$filelist
   1611 
   1612 endef
   1613 
   1614 define extract-and-include-aux-whole-static-libs
   1615 $(call extract-and-include-whole-static-libs-first, $(firstword $(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)),$(1))
   1616 $(foreach lib,$(wordlist 2,999,$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)), \
   1617     $(call _extract-and-include-single-aux-whole-static-lib, $(lib), $(1)))
   1618 endef
   1619 
   1620 # Explicitly delete the archive first so that ar doesn't
   1621 # try to add to an existing archive.
   1622 define transform-o-to-aux-static-lib
   1623 @echo "$($(PRIVATE_PREFIX)DISPLAY) StaticLib: $(PRIVATE_MODULE) ($@)"
   1624 @mkdir -p $(dir $@)
   1625 @rm -f $@ $@.tmp
   1626 $(call extract-and-include-aux-whole-static-libs,$@.tmp)
   1627 $(call split-long-arguments,$(PRIVATE_AR) \
   1628     $(AUX_GLOBAL_ARFLAGS) $@.tmp,$(PRIVATE_ALL_OBJECTS))
   1629 $(hide) mv -f $@.tmp $@
   1630 endef
   1631 
   1632 define transform-o-to-aux-executable-inner
   1633 $(hide) $(PRIVATE_CXX) -pie \
   1634 	-Bdynamic \
   1635 	-Wl,--gc-sections \
   1636 	$(PRIVATE_ALL_OBJECTS) \
   1637 	-Wl,--whole-archive \
   1638 	$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES) \
   1639 	-Wl,--no-whole-archive \
   1640 	$(PRIVATE_ALL_STATIC_LIBRARIES) \
   1641 	$(PRIVATE_LDFLAGS) \
   1642 	-o $@
   1643 endef
   1644 
   1645 define transform-o-to-aux-executable
   1646 @echo "$(AUX_DISPLAY) Executable: $(PRIVATE_MODULE) ($@)"
   1647 @mkdir -p $(dir $@)
   1648 $(transform-o-to-aux-executable-inner)
   1649 endef
   1650 
   1651 define transform-o-to-aux-static-executable-inner
   1652 $(hide) $(PRIVATE_CXX) \
   1653 	-Bstatic \
   1654 	-Wl,--gc-sections \
   1655 	$(PRIVATE_ALL_OBJECTS) \
   1656 	-Wl,--whole-archive \
   1657 	$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES) \
   1658 	-Wl,--no-whole-archive \
   1659 	$(PRIVATE_ALL_STATIC_LIBRARIES) \
   1660 	$(PRIVATE_LDFLAGS) \
   1661 	-Wl,-Map=$(@).map \
   1662 	-o $@
   1663 endef
   1664 
   1665 define transform-o-to-aux-static-executable
   1666 @echo "$(AUX_DISPLAY) StaticExecutable: $(PRIVATE_MODULE) ($@)"
   1667 @mkdir -p $(dir $@)
   1668 $(transform-o-to-aux-static-executable-inner)
   1669 endef
   1670 
   1671 ###########################################################
   1672 ## Commands for running host ar
   1673 ###########################################################
   1674 
   1675 # $(1): the full path of the source static library.
   1676 # $(2): the full path of the destination static library.
   1677 define _extract-and-include-single-host-whole-static-lib
   1678 $(hide) ldir=$(PRIVATE_INTERMEDIATES_DIR)/WHOLE/$(basename $(notdir $(1)))_objs;\
   1679     rm -rf $$ldir; \
   1680     mkdir -p $$ldir; \
   1681     cp $(1) $$ldir; \
   1682     lib_to_include=$$ldir/$(notdir $(1)); \
   1683     filelist=; \
   1684     subdir=0; \
   1685     for f in `$($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)AR) t $(1) | \grep '\.o$$'`; do \
   1686         if [ -e $$ldir/$$f ]; then \
   1687            mkdir $$ldir/$$subdir; \
   1688            ext=$$subdir/; \
   1689            subdir=$$((subdir+1)); \
   1690            $($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)AR) m $$lib_to_include $$f; \
   1691         else \
   1692            ext=; \
   1693         fi; \
   1694         $($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)AR) p $$lib_to_include $$f > $$ldir/$$ext$$f; \
   1695         filelist="$$filelist $$ldir/$$ext$$f"; \
   1696     done ; \
   1697     $($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)AR) $($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)GLOBAL_ARFLAGS) \
   1698         $(2) $$filelist
   1699 
   1700 endef
   1701 
   1702 define extract-and-include-host-whole-static-libs
   1703 $(call extract-and-include-whole-static-libs-first, $(firstword $(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)),$(1))
   1704 $(foreach lib,$(wordlist 2,999,$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES)), \
   1705     $(call _extract-and-include-single-host-whole-static-lib, $(lib),$(1)))
   1706 endef
   1707 
   1708 ifeq ($(HOST_OS),darwin)
   1709 # On Darwin the host ar fails if there is nothing to add to .a at all.
   1710 # We work around by adding a dummy.o and then deleting it.
   1711 define create-dummy.o-if-no-objs
   1712 $(if $(PRIVATE_ALL_OBJECTS),,$(hide) touch $(dir $(1))dummy.o)
   1713 endef
   1714 
   1715 define get-dummy.o-if-no-objs
   1716 $(if $(PRIVATE_ALL_OBJECTS),,$(dir $(1))dummy.o)
   1717 endef
   1718 
   1719 define delete-dummy.o-if-no-objs
   1720 $(if $(PRIVATE_ALL_OBJECTS),,$(hide) $($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)AR) d $(1) $(dir $(1))dummy.o \
   1721   && rm -f $(dir $(1))dummy.o)
   1722 endef
   1723 endif  # HOST_OS is darwin
   1724 
   1725 # Explicitly delete the archive first so that ar doesn't
   1726 # try to add to an existing archive.
   1727 define transform-host-o-to-static-lib
   1728 @echo "$($(PRIVATE_PREFIX)DISPLAY) StaticLib: $(PRIVATE_MODULE) ($@)"
   1729 @mkdir -p $(dir $@)
   1730 @rm -f $@ $@.tmp
   1731 $(call extract-and-include-host-whole-static-libs,$@.tmp)
   1732 $(call create-dummy.o-if-no-objs,$@.tmp)
   1733 $(call split-long-arguments,$($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)AR) \
   1734     $($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)GLOBAL_ARFLAGS) $@.tmp,\
   1735     $(PRIVATE_ALL_OBJECTS) $(call get-dummy.o-if-no-objs,$@.tmp))
   1736 $(call delete-dummy.o-if-no-objs,$@.tmp)
   1737 $(hide) mv -f $@.tmp $@
   1738 endef
   1739 
   1740 
   1741 ###########################################################
   1742 ## Commands for running gcc to link a shared library or package
   1743 ###########################################################
   1744 
   1745 # ld just seems to be so finicky with command order that we allow
   1746 # it to be overriden en-masse see combo/linux-arm.make for an example.
   1747 ifneq ($(HOST_CUSTOM_LD_COMMAND),true)
   1748 define transform-host-o-to-shared-lib-inner
   1749 $(hide) $(PRIVATE_CXX) \
   1750 	-Wl,-rpath-link=$($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)OUT_INTERMEDIATE_LIBRARIES) \
   1751 	-Wl,-rpath,\$$ORIGIN/../$(notdir $($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)OUT_SHARED_LIBRARIES)) \
   1752 	-Wl,-rpath,\$$ORIGIN/$(notdir $($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)OUT_SHARED_LIBRARIES)) \
   1753 	-shared -Wl,-soname,$(notdir $@) \
   1754 	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
   1755 	   $(PRIVATE_HOST_GLOBAL_LDFLAGS) \
   1756 	) \
   1757 	$(PRIVATE_LDFLAGS) \
   1758 	$(PRIVATE_ALL_OBJECTS) \
   1759 	-Wl,--whole-archive \
   1760 	$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES) \
   1761 	-Wl,--no-whole-archive \
   1762 	$(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--start-group) \
   1763 	$(PRIVATE_ALL_STATIC_LIBRARIES) \
   1764 	$(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--end-group) \
   1765 	$(if $(filter true,$(NATIVE_COVERAGE)),-lgcov) \
   1766 	$(if $(filter true,$(NATIVE_COVERAGE)),$(PRIVATE_HOST_LIBPROFILE_RT)) \
   1767 	$(PRIVATE_ALL_SHARED_LIBRARIES) \
   1768 	-o $@ \
   1769 	$(PRIVATE_LDLIBS)
   1770 endef
   1771 endif
   1772 
   1773 define transform-host-o-to-shared-lib
   1774 @echo "$($(PRIVATE_PREFIX)DISPLAY) SharedLib: $(PRIVATE_MODULE) ($@)"
   1775 @mkdir -p $(dir $@)
   1776 $(transform-host-o-to-shared-lib-inner)
   1777 endef
   1778 
   1779 define transform-host-o-to-package
   1780 @echo "$($(PRIVATE_PREFIX)DISPLAY) Package: $(PRIVATE_MODULE) ($@)"
   1781 @mkdir -p $(dir $@)
   1782 $(transform-host-o-to-shared-lib-inner)
   1783 endef
   1784 
   1785 
   1786 ###########################################################
   1787 ## Commands for running gcc to link a shared library or package
   1788 ###########################################################
   1789 
   1790 define transform-o-to-shared-lib-inner
   1791 $(hide) $(PRIVATE_CXX) \
   1792 	-nostdlib -Wl,-soname,$(notdir $@) \
   1793 	-Wl,--gc-sections \
   1794 	$(if $(filter true,$(PRIVATE_CLANG)),-shared,-Wl$(comma)-shared) \
   1795 	$(PRIVATE_TARGET_CRTBEGIN_SO_O) \
   1796 	$(PRIVATE_ALL_OBJECTS) \
   1797 	-Wl,--whole-archive \
   1798 	$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES) \
   1799 	-Wl,--no-whole-archive \
   1800 	$(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--start-group) \
   1801 	$(PRIVATE_ALL_STATIC_LIBRARIES) \
   1802 	$(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--end-group) \
   1803 	$(if $(filter true,$(NATIVE_COVERAGE)),$(PRIVATE_TARGET_COVERAGE_LIB)) \
   1804 	$(PRIVATE_TARGET_LIBATOMIC) \
   1805 	$(PRIVATE_TARGET_LIBGCC) \
   1806 	$(PRIVATE_TARGET_GLOBAL_LDFLAGS) \
   1807 	$(PRIVATE_LDFLAGS) \
   1808 	$(PRIVATE_ALL_SHARED_LIBRARIES) \
   1809 	-o $@ \
   1810 	$(PRIVATE_TARGET_CRTEND_SO_O) \
   1811 	$(PRIVATE_LDLIBS)
   1812 endef
   1813 
   1814 define transform-o-to-shared-lib
   1815 @echo "$($(PRIVATE_PREFIX)DISPLAY) SharedLib: $(PRIVATE_MODULE) ($@)"
   1816 @mkdir -p $(dir $@)
   1817 $(transform-o-to-shared-lib-inner)
   1818 endef
   1819 
   1820 ###########################################################
   1821 ## Commands for filtering a target executable or library
   1822 ###########################################################
   1823 
   1824 ifneq ($(TARGET_BUILD_VARIANT),user)
   1825   TARGET_STRIP_EXTRA = && $(PRIVATE_OBJCOPY) --add-gnu-debuglink=$< $@
   1826   TARGET_STRIP_KEEP_SYMBOLS_EXTRA = --add-gnu-debuglink=$<
   1827 endif
   1828 
   1829 define transform-to-stripped
   1830 @echo "$($(PRIVATE_PREFIX)DISPLAY) Strip: $(PRIVATE_MODULE) ($@)"
   1831 @mkdir -p $(dir $@)
   1832 $(hide) $(PRIVATE_STRIP) --strip-all $< -o $@ \
   1833   $(if $(PRIVATE_NO_DEBUGLINK),,$(TARGET_STRIP_EXTRA))
   1834 endef
   1835 
   1836 define transform-to-stripped-keep-mini-debug-info
   1837 @echo "$($(PRIVATE_PREFIX)DISPLAY) Strip (mini debug info): $(PRIVATE_MODULE) ($@)"
   1838 @mkdir -p $(dir $@)
   1839 $(hide) rm -f $@ $@.dynsyms $@.funcsyms $@.keep_symbols $@.debug $@.mini_debuginfo.xz
   1840 if $(PRIVATE_STRIP) --strip-all -R .comment $< -o $@; then \
   1841   $(PRIVATE_OBJCOPY) --only-keep-debug $< $@.debug && \
   1842   $(PRIVATE_NM) -D $< --format=posix --defined-only | awk '{ print $$1 }' | sort >$@.dynsyms && \
   1843   $(PRIVATE_NM) $< --format=posix --defined-only | awk '{ if ($$2 == "T" || $$2 == "t" || $$2 == "D") print $$1 }' | sort >$@.funcsyms && \
   1844   comm -13 $@.dynsyms $@.funcsyms >$@.keep_symbols && \
   1845   $(PRIVATE_OBJCOPY) --rename-section .debug_frame=saved_debug_frame $@.debug $@.mini_debuginfo && \
   1846   $(PRIVATE_OBJCOPY) -S --remove-section .gdb_index --remove-section .comment --keep-symbols=$@.keep_symbols $@.mini_debuginfo && \
   1847   $(PRIVATE_OBJCOPY) --rename-section saved_debug_frame=.debug_frame $@.mini_debuginfo && \
   1848   rm -f $@.mini_debuginfo.xz && \
   1849   xz $@.mini_debuginfo && \
   1850   $(PRIVATE_OBJCOPY) --add-section .gnu_debugdata=$@.mini_debuginfo.xz $@; \
   1851 else \
   1852   cp -f $< $@; \
   1853 fi
   1854 endef
   1855 
   1856 define transform-to-stripped-keep-symbols
   1857 @echo "$($(PRIVATE_PREFIX)DISPLAY) Strip (keep symbols): $(PRIVATE_MODULE) ($@)"
   1858 @mkdir -p $(dir $@)
   1859 $(hide) $(PRIVATE_OBJCOPY) \
   1860     `$(PRIVATE_READELF) -S $< | awk '/.debug_/ {print "-R " $$2}' | xargs` \
   1861     $(TARGET_STRIP_KEEP_SYMBOLS_EXTRA) $< $@
   1862 endef
   1863 
   1864 ###########################################################
   1865 ## Commands for packing a target executable or library
   1866 ###########################################################
   1867 
   1868 define pack-elf-relocations
   1869 @echo "$($(PRIVATE_PREFIX)DISPLAY) Pack Relocations: $(PRIVATE_MODULE) ($@)"
   1870 $(copy-file-to-target)
   1871 $(hide) $(RELOCATION_PACKER) $@
   1872 endef
   1873 
   1874 ###########################################################
   1875 ## Commands for running gcc to link an executable
   1876 ###########################################################
   1877 
   1878 define transform-o-to-executable-inner
   1879 $(hide) $(PRIVATE_CXX) -pie \
   1880 	-nostdlib -Bdynamic \
   1881 	-Wl,-dynamic-linker,$(PRIVATE_LINKER) \
   1882 	-Wl,--gc-sections \
   1883 	-Wl,-z,nocopyreloc \
   1884 	-Wl,-rpath-link=$(PRIVATE_TARGET_OUT_INTERMEDIATE_LIBRARIES) \
   1885 	$(PRIVATE_TARGET_CRTBEGIN_DYNAMIC_O) \
   1886 	$(PRIVATE_ALL_OBJECTS) \
   1887 	-Wl,--whole-archive \
   1888 	$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES) \
   1889 	-Wl,--no-whole-archive \
   1890 	$(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--start-group) \
   1891 	$(PRIVATE_ALL_STATIC_LIBRARIES) \
   1892 	$(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--end-group) \
   1893 	$(if $(filter true,$(NATIVE_COVERAGE)),$(PRIVATE_TARGET_COVERAGE_LIB)) \
   1894 	$(PRIVATE_TARGET_LIBATOMIC) \
   1895 	$(PRIVATE_TARGET_LIBGCC) \
   1896 	$(PRIVATE_TARGET_GLOBAL_LDFLAGS) \
   1897 	$(PRIVATE_LDFLAGS) \
   1898 	$(PRIVATE_ALL_SHARED_LIBRARIES) \
   1899 	-o $@ \
   1900 	$(PRIVATE_TARGET_CRTEND_O) \
   1901 	$(PRIVATE_LDLIBS)
   1902 endef
   1903 
   1904 define transform-o-to-executable
   1905 @echo "$($(PRIVATE_PREFIX)DISPLAY) Executable: $(PRIVATE_MODULE) ($@)"
   1906 @mkdir -p $(dir $@)
   1907 $(transform-o-to-executable-inner)
   1908 endef
   1909 
   1910 
   1911 ###########################################################
   1912 ## Commands for linking a static executable. In practice,
   1913 ## we only use this on arm, so the other platforms don't
   1914 ## have transform-o-to-static-executable defined.
   1915 ## Clang driver needs -static to create static executable.
   1916 ## However, bionic/linker uses -shared to overwrite.
   1917 ## Linker for x86 targets does not allow coexistance of -static and -shared,
   1918 ## so we add -static only if -shared is not used.
   1919 ###########################################################
   1920 
   1921 define transform-o-to-static-executable-inner
   1922 $(hide) $(PRIVATE_CXX) \
   1923 	-nostdlib -Bstatic \
   1924 	$(if $(filter $(PRIVATE_LDFLAGS),-shared),,-static) \
   1925 	-Wl,--gc-sections \
   1926 	-o $@ \
   1927 	$(PRIVATE_TARGET_CRTBEGIN_STATIC_O) \
   1928 	$(PRIVATE_TARGET_GLOBAL_LDFLAGS) \
   1929 	$(PRIVATE_LDFLAGS) \
   1930 	$(PRIVATE_ALL_OBJECTS) \
   1931 	-Wl,--whole-archive \
   1932 	$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES) \
   1933 	-Wl,--no-whole-archive \
   1934 	$(filter-out %libcompiler_rt.a,$(filter-out %libc_nomalloc.a,$(filter-out %libc.a,$(PRIVATE_ALL_STATIC_LIBRARIES)))) \
   1935 	-Wl,--start-group \
   1936 	$(filter %libc.a,$(PRIVATE_ALL_STATIC_LIBRARIES)) \
   1937 	$(filter %libc_nomalloc.a,$(PRIVATE_ALL_STATIC_LIBRARIES)) \
   1938 	$(if $(filter true,$(NATIVE_COVERAGE)),$(PRIVATE_TARGET_COVERAGE_LIB)) \
   1939 	$(PRIVATE_TARGET_LIBATOMIC) \
   1940 	$(filter %libcompiler_rt.a,$(PRIVATE_ALL_STATIC_LIBRARIES)) \
   1941 	$(PRIVATE_TARGET_LIBGCC) \
   1942 	-Wl,--end-group \
   1943 	$(PRIVATE_TARGET_CRTEND_O)
   1944 endef
   1945 
   1946 define transform-o-to-static-executable
   1947 @echo "$($(PRIVATE_PREFIX)DISPLAY) StaticExecutable: $(PRIVATE_MODULE) ($@)"
   1948 @mkdir -p $(dir $@)
   1949 $(transform-o-to-static-executable-inner)
   1950 endef
   1951 
   1952 
   1953 ###########################################################
   1954 ## Commands for running gcc to link a host executable
   1955 ###########################################################
   1956 ifdef BUILD_HOST_static
   1957 HOST_FPIE_FLAGS :=
   1958 else
   1959 HOST_FPIE_FLAGS := -pie
   1960 # Force the correct entry point to workaround a bug in binutils that manifests with -pie
   1961 ifeq ($(HOST_CROSS_OS),windows)
   1962 HOST_CROSS_FPIE_FLAGS += -Wl,-e_mainCRTStartup
   1963 endif
   1964 endif
   1965 
   1966 ifneq ($(HOST_CUSTOM_LD_COMMAND),true)
   1967 define transform-host-o-to-executable-inner
   1968 $(hide) $(PRIVATE_CXX) \
   1969 	$(PRIVATE_ALL_OBJECTS) \
   1970 	-Wl,--whole-archive \
   1971 	$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES) \
   1972 	-Wl,--no-whole-archive \
   1973 	$(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--start-group) \
   1974 	$(PRIVATE_ALL_STATIC_LIBRARIES) \
   1975 	$(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--end-group) \
   1976 	$(if $(filter true,$(NATIVE_COVERAGE)),-lgcov) \
   1977 	$(if $(filter true,$(NATIVE_COVERAGE)),$(PRIVATE_HOST_LIBPROFILE_RT)) \
   1978 	$(PRIVATE_ALL_SHARED_LIBRARIES) \
   1979 	-Wl,-rpath-link=$($(PRIVATE_2ND_ARCH_VAR_PREFIX)$(PRIVATE_PREFIX)OUT_INTERMEDIATE_LIBRARIES) \
   1980 	$(foreach path,$(PRIVATE_RPATHS), \
   1981 	  -Wl,-rpath,\$$ORIGIN/$(path)) \
   1982 	$(if $(PRIVATE_NO_DEFAULT_COMPILER_FLAGS),, \
   1983 		$(PRIVATE_HOST_GLOBAL_LDFLAGS) \
   1984 	) \
   1985 	$(PRIVATE_LDFLAGS) \
   1986 	-o $@ \
   1987 	$(PRIVATE_LDLIBS)
   1988 endef
   1989 endif
   1990 
   1991 define transform-host-o-to-executable
   1992 @echo "$($(PRIVATE_PREFIX)DISPLAY) Executable: $(PRIVATE_MODULE) ($@)"
   1993 @mkdir -p $(dir $@)
   1994 $(transform-host-o-to-executable-inner)
   1995 endef
   1996 
   1997 
   1998 ###########################################################
   1999 ## Commands for running javac to make .class files
   2000 ###########################################################
   2001 
   2002 # Add BUILD_NUMBER to apps default version name if it's unbundled build.
   2003 ifdef TARGET_BUILD_APPS
   2004 TARGET_BUILD_WITH_APPS_VERSION_NAME := true
   2005 endif
   2006 
   2007 ifdef TARGET_BUILD_WITH_APPS_VERSION_NAME
   2008 APPS_DEFAULT_VERSION_NAME := $(PLATFORM_VERSION)-$(BUILD_NUMBER_FROM_FILE)
   2009 else
   2010 APPS_DEFAULT_VERSION_NAME := $(PLATFORM_VERSION)
   2011 endif
   2012 
   2013 # b/37750224
   2014 AAPT_ASAN_OPTIONS := ASAN_OPTIONS=detect_leaks=0
   2015 
   2016 # TODO: Right now we generate the asset resources twice, first as part
   2017 # of generating the Java classes, then at the end when packaging the final
   2018 # assets.  This should be changed to do one of two things: (1) Don't generate
   2019 # any resource files the first time, only create classes during that stage;
   2020 # or (2) Don't use the -c flag with the second stage, instead taking the
   2021 # resource files from the first stage as additional input.  My original intent
   2022 # was to use approach (2), but this requires a little more work in the tool.
   2023 # Maybe we should just use approach (1).
   2024 
   2025 # This rule creates the R.java and Manifest.java files, both of which
   2026 # are PRODUCT-neutral.  Don't pass PRIVATE_PRODUCT_AAPT_CONFIG to this invocation.
   2027 define create-resource-java-files
   2028 @mkdir -p $(PRIVATE_SOURCE_INTERMEDIATES_DIR)
   2029 @mkdir -p $(dir $(PRIVATE_RESOURCE_PUBLICS_OUTPUT))
   2030 $(hide) $(AAPT_ASAN_OPTIONS) $(AAPT) package $(PRIVATE_AAPT_FLAGS) -m \
   2031     $(eval # PRIVATE_PRODUCT_AAPT_CONFIG is intentionally missing-- see comment.) \
   2032     $(addprefix -J , $(PRIVATE_SOURCE_INTERMEDIATES_DIR)) \
   2033     $(addprefix -M , $(PRIVATE_ANDROID_MANIFEST)) \
   2034     $(addprefix -P , $(PRIVATE_RESOURCE_PUBLICS_OUTPUT)) \
   2035     $(addprefix -S , $(PRIVATE_RESOURCE_DIR)) \
   2036     $(addprefix -A , $(PRIVATE_ASSET_DIR)) \
   2037     $(addprefix -I , $(PRIVATE_AAPT_INCLUDES)) \
   2038     $(addprefix -G , $(PRIVATE_PROGUARD_OPTIONS_FILE)) \
   2039     $(addprefix --min-sdk-version , $(PRIVATE_DEFAULT_APP_TARGET_SDK)) \
   2040     $(addprefix --target-sdk-version , $(PRIVATE_DEFAULT_APP_TARGET_SDK)) \
   2041     $(if $(filter --version-code,$(PRIVATE_AAPT_FLAGS)),,--version-code $(PLATFORM_SDK_VERSION)) \
   2042     $(if $(filter --version-name,$(PRIVATE_AAPT_FLAGS)),,--version-name $(APPS_DEFAULT_VERSION_NAME)) \
   2043     $(addprefix --rename-manifest-package , $(PRIVATE_MANIFEST_PACKAGE_NAME)) \
   2044     $(addprefix --rename-instrumentation-target-package , $(PRIVATE_MANIFEST_INSTRUMENTATION_FOR)) \
   2045     --skip-symbols-without-default-localization
   2046 endef
   2047 
   2048 # Search for generated R.java/Manifest.java, copy the found R.java as $@.
   2049 # Also copy them to a central 'R' directory to make it easier to add the files to an IDE.
   2050 define find-generated-R.java
   2051 $(hide) for GENERATED_MANIFEST_FILE in `find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) \
   2052   -name Manifest.java 2> /dev/null`; do \
   2053     dir=`awk '/package/{gsub(/\./,"/",$$2);gsub(/;/,"",$$2);print $$2;exit}' $$GENERATED_MANIFEST_FILE`; \
   2054     mkdir -p $(TARGET_COMMON_OUT_ROOT)/R/$$dir; \
   2055     $(ACP) -fp $$GENERATED_MANIFEST_FILE $(TARGET_COMMON_OUT_ROOT)/R/$$dir; \
   2056   done;
   2057 $(hide) for GENERATED_R_FILE in `find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) \
   2058   -name R.java 2> /dev/null`; do \
   2059     dir=`awk '/package/{gsub(/\./,"/",$$2);gsub(/;/,"",$$2);print $$2;exit}' $$GENERATED_R_FILE`; \
   2060     mkdir -p $(TARGET_COMMON_OUT_ROOT)/R/$$dir; \
   2061     $(ACP) -fp $$GENERATED_R_FILE $(TARGET_COMMON_OUT_ROOT)/R/$$dir \
   2062       || exit 31; \
   2063     $(ACP) -fp $$GENERATED_R_FILE $@ || exit 32; \
   2064   done;
   2065 @# Ensure that the target file is always created, i.e. also in case we did not
   2066 @# enter the GENERATED_R_FILE-loop above. This avoids unnecessary rebuilding.
   2067 $(hide) touch $@
   2068 endef
   2069 
   2070 ###########################################################
   2071 # AAPT2 compilation and link
   2072 ###########################################################
   2073 define aapt2-compile-one-resource-file
   2074 @mkdir -p $(dir $@)
   2075 $(hide) $(AAPT2) compile -o $(dir $@) $(PRIVATE_AAPT2_CFLAGS) --legacy $<
   2076 endef
   2077 
   2078 define aapt2-compile-resource-dirs
   2079 @mkdir -p $(dir $@)
   2080 $(hide) $(AAPT2) compile -o $@ $(addprefix --dir ,$(PRIVATE_SOURCE_RES_DIRS)) \
   2081   $(PRIVATE_AAPT2_CFLAGS) --legacy
   2082 endef
   2083 
   2084 # Set up rule to compile one resource file with aapt2.
   2085 # Must be called with $(eval).
   2086 # $(1): the source file
   2087 # $(2): the output file
   2088 define aapt2-compile-one-resource-file-rule
   2089 $(2) : $(1) $(AAPT2)
   2090 	@echo "AAPT2 compile $$@ <- $$<"
   2091 	$$(call aapt2-compile-one-resource-file)
   2092 endef
   2093 
   2094 # Convert input resource file path to output file path.
   2095 # values-[config]/<file>.xml -> values-[config]_<file>.arsc.flat;
   2096 # For other resource file, just replace the last "/" with "_" and
   2097 # add .flat extension.
   2098 #
   2099 # $(1): the input resource file path
   2100 # $(2): the base dir of the output file path
   2101 # Returns: the compiled output file path
   2102 define aapt2-compiled-resource-out-file
   2103 $(eval _p_w := $(strip $(subst /,$(space),$(dir $(1)))))$(2)/$(subst $(space),/,$(_p_w))_$(if $(filter values%,$(lastword $(_p_w))),$(patsubst %.xml,%.arsc,$(notdir $(1))),$(notdir $(1))).flat
   2104 endef
   2105 
   2106 define aapt2-link
   2107 @mkdir -p $(dir $@)
   2108 $(call dump-words-to-file,$(PRIVATE_RES_FLAT),$(dir $@)aapt2-flat-list)
   2109 $(call dump-words-to-file,$(PRIVATE_OVERLAY_FLAT),$(dir $@)aapt2-flat-overlay-list)
   2110 $(hide) $(AAPT2) link -o $@ \
   2111   $(PRIVATE_AAPT_FLAGS) \
   2112   $(addprefix --manifest ,$(PRIVATE_ANDROID_MANIFEST)) \
   2113   $(addprefix -I ,$(PRIVATE_AAPT_INCLUDES)) \
   2114   $(addprefix -I ,$(PRIVATE_SHARED_ANDROID_LIBRARIES)) \
   2115   $(addprefix -A ,$(PRIVATE_ASSET_DIR)) \
   2116   $(addprefix --java ,$(PRIVATE_SOURCE_INTERMEDIATES_DIR)) \
   2117   $(addprefix --proguard ,$(PRIVATE_PROGUARD_OPTIONS_FILE)) \
   2118   $(addprefix --min-sdk-version ,$(PRIVATE_DEFAULT_APP_TARGET_SDK)) \
   2119   $(addprefix --target-sdk-version ,$(PRIVATE_DEFAULT_APP_TARGET_SDK)) \
   2120   $(if $(filter --product,$(PRIVATE_AAPT_FLAGS)),,$(addprefix --product ,$(PRIVATE_TARGET_AAPT_CHARACTERISTICS))) \
   2121   $(addprefix -c ,$(PRIVATE_PRODUCT_AAPT_CONFIG)) \
   2122   $(addprefix --preferred-density ,$(PRIVATE_PRODUCT_AAPT_PREF_CONFIG)) \
   2123   $(if $(filter --version-code,$(PRIVATE_AAPT_FLAGS)),,--version-code $(PLATFORM_SDK_VERSION)) \
   2124   $(if $(filter --version-name,$(PRIVATE_AAPT_FLAGS)),,--version-name $(APPS_DEFAULT_VERSION_NAME)) \
   2125   $(addprefix --rename-manifest-package ,$(PRIVATE_MANIFEST_PACKAGE_NAME)) \
   2126   $(addprefix --rename-instrumentation-target-package ,$(PRIVATE_MANIFEST_INSTRUMENTATION_FOR)) \
   2127   -R \@$(dir $@)aapt2-flat-overlay-list \
   2128   \@$(dir $@)aapt2-flat-list
   2129 endef
   2130 
   2131 ###########################################################
   2132 xlint_unchecked := -Xlint:unchecked
   2133 
   2134 # emit-line, <word list>, <output file>
   2135 define emit-line
   2136    $(if $(1),echo -n '$(strip $(1)) ' >> $(2))
   2137 endef
   2138 
   2139 # dump-words-to-file, <word list>, <output file>
   2140 define dump-words-to-file
   2141         @rm -f $(2)
   2142         @touch $(2)
   2143         @$(call emit-line,$(wordlist 1,500,$(1)),$(2))
   2144         @$(call emit-line,$(wordlist 501,1000,$(1)),$(2))
   2145         @$(call emit-line,$(wordlist 1001,1500,$(1)),$(2))
   2146         @$(call emit-line,$(wordlist 1501,2000,$(1)),$(2))
   2147         @$(call emit-line,$(wordlist 2001,2500,$(1)),$(2))
   2148         @$(call emit-line,$(wordlist 2501,3000,$(1)),$(2))
   2149         @$(call emit-line,$(wordlist 3001,3500,$(1)),$(2))
   2150         @$(call emit-line,$(wordlist 3501,4000,$(1)),$(2))
   2151         @$(call emit-line,$(wordlist 4001,4500,$(1)),$(2))
   2152         @$(call emit-line,$(wordlist 4501,5000,$(1)),$(2))
   2153         @$(call emit-line,$(wordlist 5001,5500,$(1)),$(2))
   2154         @$(call emit-line,$(wordlist 5501,6000,$(1)),$(2))
   2155         @$(call emit-line,$(wordlist 6001,6500,$(1)),$(2))
   2156         @$(call emit-line,$(wordlist 6501,7000,$(1)),$(2))
   2157         @$(call emit-line,$(wordlist 7001,7500,$(1)),$(2))
   2158         @$(call emit-line,$(wordlist 7501,8000,$(1)),$(2))
   2159         @$(call emit-line,$(wordlist 8001,8500,$(1)),$(2))
   2160         @$(call emit-line,$(wordlist 8501,9000,$(1)),$(2))
   2161         @$(call emit-line,$(wordlist 9001,9500,$(1)),$(2))
   2162         @$(call emit-line,$(wordlist 9501,10000,$(1)),$(2))
   2163         @$(call emit-line,$(wordlist 10001,10500,$(1)),$(2))
   2164         @$(call emit-line,$(wordlist 10501,11000,$(1)),$(2))
   2165         @$(call emit-line,$(wordlist 11001,11500,$(1)),$(2))
   2166         @$(call emit-line,$(wordlist 11501,12000,$(1)),$(2))
   2167         @$(call emit-line,$(wordlist 12001,12500,$(1)),$(2))
   2168         @$(call emit-line,$(wordlist 12501,13000,$(1)),$(2))
   2169         @$(call emit-line,$(wordlist 13001,13500,$(1)),$(2))
   2170         @$(if $(wordlist 13501,13502,$(1)),$(error Too many words ($(words $(1)))))
   2171 endef
   2172 
   2173 # For a list of jar files, unzip them to a specified directory,
   2174 # but make sure that no META-INF files come along for the ride,
   2175 # unless PRIVATE_DONT_DELETE_JAR_META_INF is set.
   2176 #
   2177 # $(1): files to unzip
   2178 # $(2): destination directory
   2179 define unzip-jar-files
   2180   $(hide) for f in $(1); \
   2181   do \
   2182     if [ ! -f $$f ]; then \
   2183       echo Missing file $$f; \
   2184       exit 1; \
   2185     fi; \
   2186     unzip -qo $$f -d $(2); \
   2187   done
   2188   $(if $(PRIVATE_DONT_DELETE_JAR_META_INF),,$(hide) rm -rf $(2)/META-INF)
   2189 endef
   2190 
   2191 # Call jack
   2192 #
   2193 define call-jack
   2194  JACK_VERSION=$(PRIVATE_JACK_VERSION) $(JACK) $(DEFAULT_JACK_EXTRA_ARGS)
   2195 endef
   2196 
   2197 # Common definition to invoke javac on the host and target.
   2198 #
   2199 # Some historical notes:
   2200 # - below we write the list of java files to java-source-list to avoid argument
   2201 #   list length problems with Cygwin
   2202 # - we filter out duplicate java file names because eclipse's compiler
   2203 #   doesn't like them.
   2204 #
   2205 # $(1): javac
   2206 # $(2): bootclasspath
   2207 define compile-java
   2208 $(hide) rm -f $@
   2209 $(hide) rm -rf $(PRIVATE_CLASS_INTERMEDIATES_DIR) $(PRIVATE_ANNO_INTERMEDIATES_DIR)
   2210 $(hide) mkdir -p $(dir $@)
   2211 $(hide) mkdir -p $(PRIVATE_CLASS_INTERMEDIATES_DIR) $(PRIVATE_ANNO_INTERMEDIATES_DIR)
   2212 $(call unzip-jar-files,$(PRIVATE_STATIC_JAVA_LIBRARIES),$(PRIVATE_CLASS_INTERMEDIATES_DIR))
   2213 $(call dump-words-to-file,$(PRIVATE_JAVA_SOURCES),$(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list)
   2214 $(hide) if [ -d "$(PRIVATE_SOURCE_INTERMEDIATES_DIR)" ]; then \
   2215           find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) -name '*.java' -and -not -name '.*' >> $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list; \
   2216 fi
   2217 $(if $(PRIVATE_HAS_PROTO_SOURCES), \
   2218     $(hide) find $(PRIVATE_PROTO_SOURCE_INTERMEDIATES_DIR) -name '*.java' -and -not -name '.*' >> $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list )
   2219 $(if $(PRIVATE_HAS_RS_SOURCES), \
   2220     $(hide) find $(PRIVATE_RS_SOURCE_INTERMEDIATES_DIR) -name '*.java' -and -not -name '.*' >> $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list )
   2221 $(hide) tr ' ' '\n' < $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list \
   2222     | $(NORMALIZE_PATH) | sort -u > $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq
   2223 $(hide) if [ -s $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq ] ; then \
   2224     $(SOONG_JAVAC_WRAPPER) $(1) -encoding UTF-8 \
   2225     $(if $(findstring true,$(PRIVATE_WARNINGS_ENABLE)),$(xlint_unchecked),) \
   2226     $(2) \
   2227     $(addprefix -classpath ,$(strip \
   2228         $(call normalize-path-list,$(PRIVATE_ALL_JAVA_LIBRARIES)))) \
   2229     $(if $(findstring true,$(PRIVATE_WARNINGS_ENABLE)),$(xlint_unchecked),) \
   2230     -extdirs "" -d $(PRIVATE_CLASS_INTERMEDIATES_DIR) -s $(PRIVATE_ANNO_INTERMEDIATES_DIR) \
   2231     $(PRIVATE_JAVACFLAGS) \
   2232     \@$(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq \
   2233     || ( rm -rf $(PRIVATE_CLASS_INTERMEDIATES_DIR) ; exit 41 ) \
   2234 fi
   2235 $(if $(PRIVATE_JAVA_LAYERS_FILE), $(hide) build/tools/java-layers.py \
   2236     $(PRIVATE_JAVA_LAYERS_FILE) \@$(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq,)
   2237 $(hide) rm -f $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list
   2238 $(hide) rm -f $(PRIVATE_CLASS_INTERMEDIATES_DIR)/java-source-list-uniq
   2239 $(if $(PRIVATE_JAR_EXCLUDE_FILES), $(hide) find $(PRIVATE_CLASS_INTERMEDIATES_DIR) \
   2240     -name $(word 1, $(PRIVATE_JAR_EXCLUDE_FILES)) \
   2241     $(addprefix -o -name , $(wordlist 2, 999, $(PRIVATE_JAR_EXCLUDE_FILES))) \
   2242     | xargs rm -rf)
   2243 $(if $(PRIVATE_JAR_PACKAGES), \
   2244     $(hide) find $(PRIVATE_CLASS_INTERMEDIATES_DIR) -mindepth 1 -type f \
   2245         $(foreach pkg, $(PRIVATE_JAR_PACKAGES), \
   2246             -not -path $(PRIVATE_CLASS_INTERMEDIATES_DIR)/$(subst .,/,$(pkg))/\*) -delete ; \
   2247         find $(PRIVATE_CLASS_INTERMEDIATES_DIR) -empty -delete)
   2248 $(if $(PRIVATE_JAR_EXCLUDE_PACKAGES), $(hide) rm -rf \
   2249     $(foreach pkg, $(PRIVATE_JAR_EXCLUDE_PACKAGES), \
   2250         $(PRIVATE_CLASS_INTERMEDIATES_DIR)/$(subst .,/,$(pkg))))
   2251 $(if $(PRIVATE_JAR_MANIFEST), \
   2252     $(hide) sed -e "s/%BUILD_NUMBER%/$(BUILD_NUMBER_FROM_FILE)/" \
   2253             $(PRIVATE_JAR_MANIFEST) > $(dir $@)/manifest.mf && \
   2254         $(JAR) -cfm $@ $(dir $@)/manifest.mf \
   2255             -C $(PRIVATE_CLASS_INTERMEDIATES_DIR) ., \
   2256     $(hide) $(JAR) -cf $@ -C $(PRIVATE_CLASS_INTERMEDIATES_DIR) .)
   2257 $(if $(PRIVATE_EXTRA_JAR_ARGS),$(call add-java-resources-to,$@))
   2258 endef
   2259 
   2260 define transform-java-to-classes.jar
   2261 @echo "$($(PRIVATE_PREFIX)DISPLAY) Java: $(PRIVATE_MODULE) ($(PRIVATE_CLASS_INTERMEDIATES_DIR))"
   2262 $(call compile-java,$(TARGET_JAVAC),$(PRIVATE_BOOTCLASSPATH))
   2263 endef
   2264 
   2265 # Invoke Jack to compile java from source to dex and jack files.
   2266 #
   2267 # Some historical notes:
   2268 # - below we write the list of java files to java-source-list to avoid argument
   2269 #   list length problems with Cygwin
   2270 # - we filter out duplicate java file names because Jack doesn't like them.
   2271 define jack-java-to-dex
   2272 $(hide) rm -f $@
   2273 $(hide) rm -f $(PRIVATE_CLASSES_JACK)
   2274 $(hide) rm -rf $(PRIVATE_JACK_INTERMEDIATES_DIR)
   2275 $(hide) mkdir -p $(dir $@)
   2276 $(hide) mkdir -p $(dir $(PRIVATE_CLASSES_JACK))
   2277 $(hide) mkdir -p $(PRIVATE_JACK_INTERMEDIATES_DIR)
   2278 $(if $(PRIVATE_JACK_INCREMENTAL_DIR),$(hide) mkdir -p $(PRIVATE_JACK_INCREMENTAL_DIR))
   2279 $(call dump-words-to-file,$(PRIVATE_JAVA_SOURCES),$(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list)
   2280 $(if $(PRIVATE_SOURCE_INTERMEDIATES_DIR), \
   2281     $(hide) if [ -d "$(PRIVATE_SOURCE_INTERMEDIATES_DIR)" ]; then \
   2282             find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list; \
   2283     fi)
   2284 $(if $(PRIVATE_HAS_PROTO_SOURCES), \
   2285     $(hide) find $(PRIVATE_PROTO_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list )
   2286 $(if $(PRIVATE_HAS_RS_SOURCES), \
   2287     $(hide) find $(PRIVATE_RS_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list )
   2288 $(hide) tr ' ' '\n' < $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list \
   2289     | $(NORMALIZE_PATH) | sort -u > $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list-uniq
   2290 $(if $(PRIVATE_JACK_PROGUARD_FLAGS), \
   2291     $(hide) echo -basedirectory $(CURDIR) > $@.flags; \
   2292     echo $(PRIVATE_JACK_PROGUARD_FLAGS) >> $@.flags; \
   2293 )
   2294 $(if $(PRIVATE_EXTRA_JAR_ARGS),
   2295     $(hide) mkdir -p $@.res.tmp
   2296     $(hide) $(call create-empty-package-at,$@.res.tmp.zip)
   2297     $(hide) $(call add-java-resources-to,$@.res.tmp.zip)
   2298     $(hide) unzip -qo $@.res.tmp.zip -d $@.res.tmp
   2299     $(hide) rm $@.res.tmp.zip)
   2300 $(if $(PRIVATE_JACK_IMPORT_JAR),
   2301     $(hide) mkdir -p $@.tmpjill.res
   2302     $(hide) unzip -qo $(PRIVATE_JACK_IMPORT_JAR) -d $@.tmpjill.res
   2303     $(hide) find $@.tmpjill.res -iname "*.class" -delete)
   2304 $(hide) if [ -s $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list-uniq ] ; then \
   2305     export tmpEcjArg="@$(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list-uniq"; \
   2306 else \
   2307     export tmpEcjArg=""; \
   2308 fi; \
   2309 $(call call-jack) \
   2310     $(strip $(PRIVATE_JACK_FLAGS)) \
   2311     $(strip $(PRIVATE_JACK_COVERAGE_OPTIONS)) \
   2312     $(if $(NO_OPTIMIZE_DX), \
   2313         -D jack.dex.optimize="false") \
   2314     $(if $(PRIVATE_RMTYPEDEFS), \
   2315         -D jack.android.remove-typedef="true") \
   2316     $(if $(PRIVATE_JACK_IMPORT_JAR), \
   2317         --import $(PRIVATE_JACK_IMPORT_JAR) --import-resource $@.tmpjill.res) \
   2318     $(addprefix --classpath ,$(strip \
   2319         $(call normalize-path-list,$(PRIVATE_JACK_SHARED_LIBRARIES)))) \
   2320     $(addprefix --import ,$(call reverse-list,$(PRIVATE_STATIC_JACK_LIBRARIES))) \
   2321     $(addprefix --pluginpath ,$(strip \
   2322          $(call normalize-path-list,$(PRIVATE_JACK_PLUGIN_PATH)))) \
   2323     $(if $(PRIVATE_JACK_PLUGIN),--plugin $(call normalize-comma-list,$(PRIVATE_JACK_PLUGIN))) \
   2324     $(if $(PRIVATE_EXTRA_JAR_ARGS),--import-resource $@.res.tmp) \
   2325     -D jack.android.min-api-level=$(PRIVATE_JACK_MIN_SDK_VERSION) \
   2326     -D jack.import.resource.policy=keep-first \
   2327     -D jack.import.type.policy=keep-first \
   2328     --output-jack $(PRIVATE_CLASSES_JACK) \
   2329     $(if $(PRIVATE_JACK_INCREMENTAL_DIR),--incremental-folder $(PRIVATE_JACK_INCREMENTAL_DIR)) \
   2330     --output-dex $(PRIVATE_JACK_INTERMEDIATES_DIR) \
   2331     $(addprefix --config-jarjar ,$(strip $(PRIVATE_JARJAR_RULES))) \
   2332     $(if $(PRIVATE_JACK_PROGUARD_FLAGS),--config-proguard $@.flags) \
   2333     $$tmpEcjArg \
   2334     || ( rm -rf $(PRIVATE_CLASSES_JACK); exit 41 )
   2335 $(hide) mv $(PRIVATE_JACK_INTERMEDIATES_DIR)/classes*.dex $(dir $@)
   2336 $(hide) rm -f $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list
   2337 $(if $(PRIVATE_EXTRA_JAR_ARGS),$(hide) rm -rf $@.res.tmp)
   2338 $(hide) mv $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list-uniq $(PRIVATE_JACK_INTERMEDIATES_DIR).java-source-list
   2339 $(if $(PRIVATE_JAR_PACKAGES), $(hide) echo unsupported options PRIVATE_JAR_PACKAGES in $@; exit 53)
   2340 $(if $(PRIVATE_JAR_EXCLUDE_PACKAGES), $(hide) echo unsupported options JAR_EXCLUDE_PACKAGES in $@; exit 53)
   2341 $(if $(PRIVATE_JAR_MANIFEST), $(hide) echo unsupported options JAR_MANIFEST in $@; exit 53)
   2342 endef
   2343 
   2344 # Invoke Jack to compile java source just to check it compiles correctly.
   2345 #
   2346 # Some historical notes:
   2347 # - below we write the list of java files to java-source-list to avoid argument
   2348 #   list length problems with Cygwin
   2349 # - we filter out duplicate java file names because Jack doesn't like them.
   2350 define jack-check-java
   2351 $(hide) rm -f $@
   2352 $(hide) rm -f $@.java-source-list
   2353 $(hide) rm -f $@.java-source-list-uniq
   2354 $(hide) mkdir -p $(dir $@)
   2355 $(if $(PRIVATE_JACK_INCREMENTAL_DIR),$(hide) mkdir -p $(PRIVATE_JACK_INCREMENTAL_DIR))
   2356 $(call dump-words-to-file,$(PRIVATE_JAVA_SOURCES),$@.java-source-list)
   2357 $(hide) if [ -d "$(PRIVATE_SOURCE_INTERMEDIATES_DIR)" ]; then \
   2358           find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $@.java-source-list; \
   2359 fi
   2360 $(if $(PRIVATE_HAS_PROTO_SOURCES), \
   2361     $(hide) find $(PRIVATE_PROTO_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $@.java-source-list )
   2362 $(if $(PRIVATE_HAS_RS_SOURCES), \
   2363     $(hide) find $(PRIVATE_RS_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $@.java-source-list )
   2364 $(hide) tr ' ' '\n' < $@.java-source-list \
   2365     | sort -u > $@.java-source-list-uniq
   2366 $(hide) if [ -s $@.java-source-list-uniq ] ; then \
   2367 	$(call call-jack,$(PRIVATE_JACK_EXTRA_ARGS)) \
   2368 	    $(strip $(PRIVATE_JACK_FLAGS)) \
   2369 	    $(strip $(PRIVATE_JACK_DEBUG_FLAGS)) \
   2370 	    $(addprefix --classpath ,$(strip \
   2371 	        $(call normalize-path-list,$(call reverse-list,$(PRIVATE_STATIC_JACK_LIBRARIES)) $(PRIVATE_JACK_SHARED_LIBRARIES)))) \
   2372 	    -D jack.import.resource.policy=keep-first \
   2373 	    -D jack.android.min-api-level=$(PRIVATE_JACK_MIN_SDK_VERSION) \
   2374 	    -D jack.import.type.policy=keep-first \
   2375 	    $(if $(PRIVATE_JACK_INCREMENTAL_DIR),--incremental-folder $(PRIVATE_JACK_INCREMENTAL_DIR)) \
   2376 	    @$@.java-source-list-uniq; \
   2377 fi
   2378 touch $@
   2379 endef
   2380 
   2381 define transform-jar-to-jack
   2382 	$(hide) mkdir -p $(dir $@)
   2383 	$(hide) mkdir -p $@.tmpjill.res
   2384 	$(hide) unzip -qo $< -d $@.tmpjill.res
   2385 	$(hide) find $@.tmpjill.res -iname "*.class" -delete
   2386 	$(hide) $(call call-jack) \
   2387 	    $(PRIVATE_JACK_FLAGS) \
   2388 	    $(addprefix --pluginpath ,$(strip \
   2389                 $(call normalize-path-list,$(PRIVATE_JACK_PLUGIN_PATH)))) \
   2390 	    $(if $(PRIVATE_JACK_PLUGIN),--plugin $(call normalize-comma-list,$(PRIVATE_JACK_PLUGIN))) \
   2391         -D jack.import.resource.policy=keep-first \
   2392         -D jack.import.type.policy=keep-first \
   2393         -D jack.android.min-api-level=$(PRIVATE_JACK_MIN_SDK_VERSION) \
   2394 	    --import $< \
   2395 	    --import-resource $@.tmpjill.res \
   2396 	    --output-jack $@
   2397 	$(hide) rm -rf $@.tmpjill.res
   2398 endef
   2399 
   2400 # Moves $1.tmp to $1 if necessary. This is designed to be used with
   2401 # .KATI_RESTAT. For kati, this function doesn't update the timestamp
   2402 # of $1 when $1.tmp is identical to $1 so that ninja won't rebuild
   2403 # targets which depend on $1.
   2404 define commit-change-for-toc
   2405 $(hide) if cmp -s $1.tmp $1 ; then \
   2406  rm $1.tmp ; \
   2407 else \
   2408  mv $1.tmp $1 ; \
   2409 fi
   2410 endef
   2411 
   2412 # b/37756495
   2413 IJAR_ASAN_OPTIONS := ASAN_OPTIONS=detect_leaks=0
   2414 
   2415 ## Rule to create a table of contents from a .jar file.
   2416 ## Must be called with $(eval).
   2417 # $(1): A .jar file
   2418 define _transform-jar-to-toc
   2419 $1.toc: $1 | $(IJAR)
   2420 	@echo Generating TOC: $$@
   2421 	$(hide) $(IJAR_ASAN_OPTIONS) $(IJAR) $$< $$@.tmp
   2422 	$$(call commit-change-for-toc,$$@)
   2423 endef
   2424 
   2425 ## Define a rule which generates .jar.toc and mark it as .KATI_RESTAT.
   2426 # $(1): A .jar file
   2427 define define-jar-to-toc-rule
   2428 $(eval $(call _transform-jar-to-toc,$1))\
   2429 $(eval .KATI_RESTAT: $1.toc)
   2430 endef
   2431 
   2432 ifeq (,$(TARGET_BUILD_APPS))
   2433 
   2434 ## Rule to create a table of contents from a .dex file.
   2435 ## Must be called with $(eval).
   2436 # $(1): The directory which contains classes*.dex files
   2437 define _transform-dex-to-toc
   2438 $1/classes.dex.toc: PRIVATE_INPUT_DEX_FILES := $1/classes*.dex
   2439 $1/classes.dex.toc: $1/classes.dex $(DEXDUMP)
   2440 	@echo Generating TOC: $$@
   2441 	$(hide) ANDROID_LOG_TAGS="*:e" $(DEXDUMP) -l xml $$(PRIVATE_INPUT_DEX_FILES) > $$@.tmp
   2442 	$$(call commit-change-for-toc,$$@)
   2443 endef
   2444 
   2445 ## Define a rule which generates .dex.toc and mark it as .KATI_RESTAT.
   2446 # $(1): The directory which contains classes*.dex files
   2447 define define-dex-to-toc-rule
   2448 $(eval $(call _transform-dex-to-toc,$1))\
   2449 $(eval .KATI_RESTAT: $1/classes.dex.toc)
   2450 endef
   2451 
   2452 else
   2453 
   2454 # Turn off .toc optimization for apps build as we cannot build dexdump.
   2455 define define-dex-to-toc-rule
   2456 endef
   2457 
   2458 endif  # TARGET_BUILD_APPS
   2459 
   2460 
   2461 # Invoke Jack to compile java from source to jack files without shrink or obfuscation.
   2462 #
   2463 # Some historical notes:
   2464 # - below we write the list of java files to java-source-list to avoid argument
   2465 #   list length problems with Cygwin
   2466 # - we filter out duplicate java file names because Jack doesn't like them.
   2467 define java-to-jack
   2468 $(hide) rm -f $@
   2469 $(hide) rm -rf $(PRIVATE_JACK_INTERMEDIATES_DIR)
   2470 $(hide) mkdir -p $(dir $@)
   2471 $(hide) mkdir -p $(PRIVATE_JACK_INTERMEDIATES_DIR)
   2472 $(if $(PRIVATE_JACK_INCREMENTAL_DIR),$(hide) mkdir -p $(PRIVATE_JACK_INCREMENTAL_DIR))
   2473 $(call dump-words-to-file,$(PRIVATE_JAVA_SOURCES),$(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list)
   2474 $(hide) if [ -d "$(PRIVATE_SOURCE_INTERMEDIATES_DIR)" ]; then \
   2475           find $(PRIVATE_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list; \
   2476 fi
   2477 $(if $(PRIVATE_HAS_PROTO_SOURCES), \
   2478     $(hide) find $(PRIVATE_PROTO_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list )
   2479 $(if $(PRIVATE_HAS_RS_SOURCES), \
   2480     $(hide) find $(PRIVATE_RS_SOURCE_INTERMEDIATES_DIR) -name '*.java' >> $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list )
   2481 $(hide) tr ' ' '\n' < $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list \
   2482     | $(NORMALIZE_PATH) | sort -u > $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list-uniq
   2483 $(if $(PRIVATE_JACK_PROGUARD_FLAGS), \
   2484     $(hide) echo -basedirectory $(CURDIR) > $@.flags; \
   2485     echo $(PRIVATE_JACK_PROGUARD_FLAGS) >> $@.flags; \
   2486 )
   2487 $(if $(PRIVATE_EXTRA_JAR_ARGS),
   2488 	$(hide) mkdir -p $@.res.tmp
   2489 	$(hide) $(call create-empty-package-at,$@.res.tmp.zip)
   2490 	$(hide) $(call add-java-resources-to,$@.res.tmp.zip)
   2491 	$(hide) unzip -qo $@.res.tmp.zip -d $@.res.tmp
   2492 	$(hide) rm $@.res.tmp.zip)
   2493 $(hide) if [ -s $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list-uniq ] ; then \
   2494     export tmpEcjArg="@$(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list-uniq"; \
   2495 else \
   2496     export tmpEcjArg=""; \
   2497 fi; \
   2498 $(call call-jack) \
   2499     $(strip $(PRIVATE_JACK_FLAGS)) \
   2500     $(if $(NO_OPTIMIZE_DX), \
   2501         -D jack.dex.optimize="false") \
   2502     $(addprefix --classpath ,$(strip \
   2503         $(call normalize-path-list,$(PRIVATE_JACK_SHARED_LIBRARIES)))) \
   2504     $(addprefix --import ,$(call reverse-list,$(PRIVATE_STATIC_JACK_LIBRARIES))) \
   2505     $(addprefix --pluginpath ,$(strip \
   2506         $(call normalize-path-list,$(PRIVATE_JACK_PLUGIN_PATH)))) \
   2507     $(if $(PRIVATE_JACK_PLUGIN),--plugin $(call normalize-comma-list,$(PRIVATE_JACK_PLUGIN))) \
   2508     $(if $(PRIVATE_EXTRA_JAR_ARGS),--import-resource $@.res.tmp) \
   2509     -D jack.import.resource.policy=keep-first \
   2510     -D jack.import.type.policy=keep-first \
   2511     -D jack.android.min-api-level=$(PRIVATE_JACK_MIN_SDK_VERSION) \
   2512     $(if $(PRIVATE_JACK_INCREMENTAL_DIR),--incremental-folder $(PRIVATE_JACK_INCREMENTAL_DIR)) \
   2513     --output-jack $@ \
   2514     $(addprefix --config-jarjar ,$(strip $(PRIVATE_JARJAR_RULES))) \
   2515     $(if $(PRIVATE_JACK_PROGUARD_FLAGS),--config-proguard $@.flags) \
   2516     $$tmpEcjArg \
   2517     || ( rm -f $@ ; exit 41 )
   2518 $(hide) rm -f $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list
   2519 $(if $(PRIVATE_EXTRA_JAR_ARGS),$(hide) rm -rf $@.res.tmp)
   2520 $(hide) mv $(PRIVATE_JACK_INTERMEDIATES_DIR)/java-source-list-uniq $(PRIVATE_JACK_INTERMEDIATES_DIR).java-source-list
   2521 $(if $(PRIVATE_JAR_PACKAGES), $(hide) echo unsupported options PRIVATE_JAR_PACKAGES in $@; exit 53)
   2522 $(if $(PRIVATE_JAR_EXCLUDE_PACKAGES), $(hide) echo unsupported options JAR_EXCLUDE_PACKAGES in $@; exit 53)
   2523 $(if $(PRIVATE_JAR_MANIFEST), $(hide) echo unsupported options JAR_MANIFEST in $@; exit 53)
   2524 endef
   2525 
   2526 define desugar-classpath
   2527 $(filter-out -classpath -bootclasspath "",$(subst :,$(space),$(1)))
   2528 endef
   2529 
   2530 # Takes an sdk version that might be PLATFORM_VERSION_CODENAME (for example P),
   2531 # returns a number greater than the highest existing sdk version if it is, or
   2532 # the input if it is not.
   2533 define codename-or-sdk-to-sdk
   2534 $(if $(filter $(1),$(PLATFORM_VERSION_CODENAME)),10000,$(1))
   2535 endef
   2536 
   2537 # --add-opens is required because desugar reflects via java.lang.invoke.MethodHandles.Lookup
   2538 define desugar-classes-jar
   2539 @echo Desugar: $@
   2540 @mkdir -p $(dir $@)
   2541 $(hide) rm -f $@ $@.tmp
   2542 @rm -rf $(dir $@)/desugar_dumped_classes
   2543 @mkdir $(dir $@)/desugar_dumped_classes
   2544 $(hide) $(JAVA) \
   2545     $(if $(EXPERIMENTAL_USE_OPENJDK9),--add-opens java.base/java.lang.invoke=ALL-UNNAMED,) \
   2546     -Djdk.internal.lambda.dumpProxyClasses=$(abspath $(dir $@))/desugar_dumped_classes \
   2547     -jar $(DESUGAR) \
   2548     $(addprefix --bootclasspath_entry ,$(call desugar-bootclasspath,$(PRIVATE_BOOTCLASSPATH))) \
   2549     $(addprefix --classpath_entry ,$(PRIVATE_ALL_JAVA_LIBRARIES)) \
   2550     --min_sdk_version $(call codename-or-sdk-to-sdk,$(PRIVATE_DEFAULT_APP_TARGET_SDK)) \
   2551     --allow_empty_bootclasspath \
   2552     $(if $(filter --core-library,$(PRIVATE_DX_FLAGS)),--core_library) \
   2553     -i $< -o $@.tmp
   2554     mv $@.tmp $@
   2555 endef
   2556 
   2557 
   2558 define transform-classes.jar-to-dex
   2559 @echo "target Dex: $(PRIVATE_MODULE)"
   2560 @mkdir -p $(dir $@)
   2561 $(hide) rm -f $(dir $@)classes*.dex
   2562 $(hide) $(DX_COMMAND) \
   2563     --dex --output=$(dir $@) \
   2564     --min-sdk-version=$(call codename-or-sdk-to-sdk,$(PRIVATE_DEFAULT_APP_TARGET_SDK)) \
   2565     $(if $(NO_OPTIMIZE_DX), \
   2566         --no-optimize) \
   2567     $(if $(GENERATE_DEX_DEBUG), \
   2568 	    --debug --verbose \
   2569 	    --dump-to=$(@:.dex=.lst) \
   2570 	    --dump-width=1000) \
   2571     $(PRIVATE_DX_FLAGS) \
   2572     $<
   2573 endef
   2574 
   2575 # Create a mostly-empty .jar file that we'll add to later.
   2576 # The MacOS jar tool doesn't like creating empty jar files,
   2577 # so we need to give it something.
   2578 # $(1) package to create
   2579 define create-empty-package-at
   2580 @mkdir -p $(dir $(1))
   2581 $(hide) touch $(dir $(1))zipdummy
   2582 $(hide) $(JAR) cf $(1) -C $(dir $(1)) zipdummy
   2583 $(hide) zip -qd $(1) zipdummy
   2584 $(hide) rm $(dir $(1))zipdummy
   2585 endef
   2586 
   2587 # Create a mostly-empty .jar file that we'll add to later.
   2588 # The MacOS jar tool doesn't like creating empty jar files,
   2589 # so we need to give it something.
   2590 define create-empty-package
   2591 $(call create-empty-package-at,$@)
   2592 endef
   2593 
   2594 # Copy an arhchive file and delete any class files and empty folders inside.
   2595 # $(1): the source archive file.
   2596 # $(2): the destination archive file.
   2597 define initialize-package-file
   2598 @mkdir -p $(dir $(2))
   2599 $(hide) cp -f $(1) $(2)
   2600 $(hide) zip -qd $(2) "*.class" \
   2601     $(if $(strip $(PRIVATE_DONT_DELETE_JAR_DIRS)),,"*/") \
   2602     || true # Ignore the error when nothing to delete.
   2603 endef
   2604 
   2605 #TODO: we kinda want to build different asset packages for
   2606 #      different configurations, then combine them later (or something).
   2607 #      Per-locale, etc.
   2608 #      A list of dynamic and static parameters;  build layers for
   2609 #      dynamic params that lay over the static ones.
   2610 #TODO: update the manifest to point to the package file
   2611 #Note that the version numbers are given to aapt as simple default
   2612 #values; applications can override these by explicitly stating
   2613 #them in their manifest.
   2614 define add-assets-to-package
   2615 $(hide) $(AAPT_ASAN_OPTIONS) $(AAPT) package -u $(PRIVATE_AAPT_FLAGS) \
   2616     $(addprefix -c , $(PRIVATE_PRODUCT_AAPT_CONFIG)) \
   2617     $(addprefix --preferred-density , $(PRIVATE_PRODUCT_AAPT_PREF_CONFIG)) \
   2618     $(addprefix -M , $(PRIVATE_ANDROID_MANIFEST)) \
   2619     $(addprefix -S , $(PRIVATE_RESOURCE_DIR)) \
   2620     $(addprefix -A , $(PRIVATE_ASSET_DIR)) \
   2621     $(addprefix -I , $(PRIVATE_AAPT_INCLUDES)) \
   2622     $(addprefix --min-sdk-version , $(PRIVATE_DEFAULT_APP_TARGET_SDK)) \
   2623     $(addprefix --target-sdk-version , $(PRIVATE_DEFAULT_APP_TARGET_SDK)) \
   2624     $(if $(filter --product,$(PRIVATE_AAPT_FLAGS)),,$(addprefix --product , $(PRIVATE_TARGET_AAPT_CHARACTERISTICS))) \
   2625     $(if $(filter --version-code,$(PRIVATE_AAPT_FLAGS)),,--version-code $(PLATFORM_SDK_VERSION)) \
   2626     $(if $(filter --version-name,$(PRIVATE_AAPT_FLAGS)),,--version-name $(APPS_DEFAULT_VERSION_NAME)) \
   2627     $(addprefix --rename-manifest-package , $(PRIVATE_MANIFEST_PACKAGE_NAME)) \
   2628     $(addprefix --rename-instrumentation-target-package , $(PRIVATE_MANIFEST_INSTRUMENTATION_FOR)) \
   2629     --skip-symbols-without-default-localization \
   2630     -F $@
   2631 endef
   2632 
   2633 # We need the extra blank line, so that the command will be on a separate line.
   2634 # $(1): the ABI name
   2635 # $(2): the list of shared libraies
   2636 define _add-jni-shared-libs-to-package-per-abi
   2637 $(hide) cp $(2) $(dir $@)lib/$(1)
   2638 
   2639 endef
   2640 
   2641 # For apps_only build, don't uncompress/page-align the jni libraries,
   2642 # because the apk may be run on older platforms that don't support loading jni directly from apk.
   2643 ifdef TARGET_BUILD_APPS
   2644 JNI_COMPRESS_FLAGS :=
   2645 ZIPALIGN_PAGE_ALIGN_FLAGS :=
   2646 else
   2647 JNI_COMPRESS_FLAGS := -0
   2648 ZIPALIGN_PAGE_ALIGN_FLAGS := -p
   2649 endif
   2650 
   2651 define add-jni-shared-libs-to-package
   2652 $(hide) rm -rf $(dir $@)lib
   2653 $(hide) mkdir -p $(addprefix $(dir $@)lib/,$(PRIVATE_JNI_SHARED_LIBRARIES_ABI))
   2654 $(foreach abi,$(PRIVATE_JNI_SHARED_LIBRARIES_ABI),\
   2655   $(call _add-jni-shared-libs-to-package-per-abi,$(abi),\
   2656     $(patsubst $(abi):%,%,$(filter $(abi):%,$(PRIVATE_JNI_SHARED_LIBRARIES)))))
   2657 $(hide) (cd $(dir $@) && zip -qrX $(JNI_COMPRESS_FLAGS) $(notdir $@) lib)
   2658 $(hide) rm -rf $(dir $@)lib
   2659 endef
   2660 
   2661 #TODO: update the manifest to point to the dex file
   2662 define add-dex-to-package
   2663 $(call add-dex-to-package-arg,$@)
   2664 endef
   2665 
   2666 # $(1): the package file.
   2667 define add-dex-to-package-arg
   2668 $(hide) find $(dir $(PRIVATE_DEX_FILE)) -maxdepth 1 -name "classes*.dex" | sort | xargs zip -qjX $(1)
   2669 endef
   2670 
   2671 # Add java resources added by the current module.
   2672 # $(1) destination package
   2673 #
   2674 define add-java-resources-to
   2675 $(call dump-words-to-file, $(PRIVATE_EXTRA_JAR_ARGS), $(1).jar-arg-list)
   2676 $(hide) $(JAR) uf $(1) @$(1).jar-arg-list
   2677 @rm -f $(1).jar-arg-list
   2678 endef
   2679 
   2680 # Add resources carried by static Jack libraries.
   2681 #
   2682 define add-carried-jack-resources
   2683  $(hide) if [ -d $(PRIVATE_JACK_INTERMEDIATES_DIR) ] ; then \
   2684     find $(PRIVATE_JACK_INTERMEDIATES_DIR) -type f | sort \
   2685         | sed -e "s?^$(PRIVATE_JACK_INTERMEDIATES_DIR)/? -C \"$(PRIVATE_JACK_INTERMEDIATES_DIR)\" \"?" -e "s/$$/\"/" \
   2686         > $(dir $@)jack_res_jar_flags; \
   2687     if [ -s $(dir $@)jack_res_jar_flags ] ; then \
   2688         $(JAR) uf $@ @$(dir $@)jack_res_jar_flags; \
   2689     fi; \
   2690 fi
   2691 endef
   2692 
   2693 # Sign a package using the specified key/cert.
   2694 #
   2695 define sign-package
   2696 $(call sign-package-arg,$@)
   2697 endef
   2698 
   2699 # signapk uses internal APIs from sun.security.{pkcs,x509}; see http://b/37137869
   2700 # $(1): the package file we are signing.
   2701 define sign-package-arg
   2702 $(hide) mv $(1) $(1).unsigned
   2703 $(hide) $(JAVA) -Djava.library.path=$(SIGNAPK_JNI_LIBRARY_PATH) \
   2704     $(if $(EXPERIMENTAL_USE_OPENJDK9),--add-exports java.base/sun.security.pkcs=ALL-UNNAMED,) \
   2705     $(if $(EXPERIMENTAL_USE_OPENJDK9),--add-exports java.base/sun.security.x509=ALL-UNNAMED,) \
   2706     -jar $(SIGNAPK_JAR) \
   2707     $(PRIVATE_CERTIFICATE) $(PRIVATE_PRIVATE_KEY) \
   2708     $(PRIVATE_ADDITIONAL_CERTIFICATES) $(1).unsigned $(1).signed
   2709 $(hide) mv $(1).signed $(1)
   2710 endef
   2711 
   2712 # Align STORED entries of a package on 4-byte boundaries to make them easier to mmap.
   2713 #
   2714 define align-package
   2715 $(hide) if ! $(ZIPALIGN) -c $(ZIPALIGN_PAGE_ALIGN_FLAGS) 4 $@ >/dev/null ; then \
   2716   mv $@ $@.unaligned; \
   2717   $(ZIPALIGN) \
   2718     -f \
   2719     $(ZIPALIGN_PAGE_ALIGN_FLAGS) \
   2720     4 \
   2721     $@.unaligned $@.aligned; \
   2722   mv $@.aligned $@; \
   2723   fi
   2724 endef
   2725 
   2726 # Compress a package using the standard gzip algorithm.
   2727 define compress-package
   2728 $(hide) \
   2729   mv $@ $@.uncompressed; \
   2730   $(MINIGZIP) -c $@.uncompressed > $@.compressed; \
   2731   rm -f $@.uncompressed; \
   2732   mv $@.compressed $@;
   2733 endef
   2734 
   2735 # Remove dynamic timestamps from packages
   2736 #
   2737 define remove-timestamps-from-package
   2738 $(hide) $(ZIPTIME) $@
   2739 endef
   2740 
   2741 # Uncompress shared libraries embedded in an apk.
   2742 #
   2743 define uncompress-shared-libs
   2744 $(hide) if (zipinfo $@ $(PRIVATE_EMBEDDED_JNI_LIBS) 2>/dev/null | grep -v ' stor ' >/dev/null) ; then \
   2745   rm -rf $(dir $@)uncompressedlibs && mkdir $(dir $@)uncompressedlibs; \
   2746   unzip $@ $(PRIVATE_EMBEDDED_JNI_LIBS) -d $(dir $@)uncompressedlibs && \
   2747   zip -d $@ 'lib/*.so' && \
   2748   ( cd $(dir $@)uncompressedlibs && find lib -type f | sort | zip -D -X -0 ../$(notdir $@) -@ ) && \
   2749   rm -rf $(dir $@)uncompressedlibs; \
   2750   fi
   2751 endef
   2752 
   2753 # TODO(joeo): If we can ever upgrade to post 3.81 make and get the
   2754 # new prebuilt rules to work, we should change this to copy the
   2755 # resources to the out directory and then copy the resources.
   2756 
   2757 # Note: we intentionally don't clean PRIVATE_CLASS_INTERMEDIATES_DIR
   2758 # in transform-java-to-classes for the sake of vm-tests.
   2759 define transform-host-java-to-package
   2760 @echo "$($(PRIVATE_PREFIX)DISPLAY) Java: $(PRIVATE_MODULE) ($(PRIVATE_CLASS_INTERMEDIATES_DIR))"
   2761 $(call compile-java,$(HOST_JAVAC),$(PRIVATE_BOOTCLASSPATH))
   2762 endef
   2763 
   2764 ###########################################################
   2765 ## Commands for copying files
   2766 ###########################################################
   2767 
   2768 # Define a rule to copy a header.  Used via $(eval) by copy_headers.make.
   2769 # $(1): source header
   2770 # $(2): destination header
   2771 define copy-one-header
   2772 $(2): $(1)
   2773 	@echo "Header: $$@"
   2774 	$$(copy-file-to-new-target-with-cp)
   2775 endef
   2776 
   2777 # Define a rule to copy a file.  For use via $(eval).
   2778 # $(1): source file
   2779 # $(2): destination file
   2780 define copy-one-file
   2781 $(2): $(1)
   2782 	@echo "Copy: $$@"
   2783 	$$(copy-file-to-target)
   2784 endef
   2785 
   2786 # Copies many files.
   2787 # $(1): The files to copy.  Each entry is a ':' separated src:dst pair
   2788 # Evaluates to the list of the dst files (ie suitable for a dependency list)
   2789 define copy-many-files
   2790 $(foreach f, $(1), $(strip \
   2791     $(eval _cmf_tuple := $(subst :, ,$(f))) \
   2792     $(eval _cmf_src := $(word 1,$(_cmf_tuple))) \
   2793     $(eval _cmf_dest := $(word 2,$(_cmf_tuple))) \
   2794     $(eval $(call copy-one-file,$(_cmf_src),$(_cmf_dest))) \
   2795     $(_cmf_dest)))
   2796 endef
   2797 
   2798 # Copy the file only if it's a well-formed xml file. For use via $(eval).
   2799 # $(1): source file
   2800 # $(2): destination file, must end with .xml.
   2801 define copy-xml-file-checked
   2802 $(2): $(1)
   2803 	@echo "Copy xml: $$@"
   2804 	$(hide) xmllint $$< >/dev/null  # Don't print the xml file to stdout.
   2805 	$$(copy-file-to-target)
   2806 endef
   2807 
   2808 # The -t option to acp and the -p option to cp is
   2809 # required for OSX.  OSX has a ridiculous restriction
   2810 # where it's an error for a .a file's modification time
   2811 # to disagree with an internal timestamp, and this
   2812 # macro is used to install .a files (among other things).
   2813 
   2814 # Copy a single file from one place to another,
   2815 # preserving permissions and overwriting any existing
   2816 # file.
   2817 # When we used acp, it could not handle high resolution timestamps
   2818 # on file systems like ext4. Because of that, '-t' option was disabled
   2819 # and copy-file-to-target was identical to copy-file-to-new-target.
   2820 # Keep the behavior until we audit and ensure that switching this back
   2821 # won't break anything.
   2822 define copy-file-to-target
   2823 @mkdir -p $(dir $@)
   2824 $(hide) rm -f $@
   2825 $(hide) cp $< $@
   2826 endef
   2827 
   2828 # The same as copy-file-to-target, but use the local
   2829 # cp command instead of acp.
   2830 define copy-file-to-target-with-cp
   2831 @mkdir -p $(dir $@)
   2832 $(hide) rm -f $@
   2833 $(hide) cp -p $< $@
   2834 endef
   2835 
   2836 # The same as copy-file-to-target, but strip out "# comment"-style
   2837 # comments (for config files and such).
   2838 define copy-file-to-target-strip-comments
   2839 @mkdir -p $(dir $@)
   2840 $(hide) rm -f $@
   2841 $(hide) sed -e 's/#.*$$//' -e 's/[ \t]*$$//' -e '/^$$/d' < $< > $@
   2842 endef
   2843 
   2844 # The same as copy-file-to-target, but don't preserve
   2845 # the old modification time.
   2846 define copy-file-to-new-target
   2847 @mkdir -p $(dir $@)
   2848 $(hide) rm -f $@
   2849 $(hide) cp $< $@
   2850 endef
   2851 
   2852 # The same as copy-file-to-new-target, but use the local
   2853 # cp command instead of acp.
   2854 define copy-file-to-new-target-with-cp
   2855 @mkdir -p $(dir $@)
   2856 $(hide) rm -f $@
   2857 $(hide) cp $< $@
   2858 endef
   2859 
   2860 # Copy a prebuilt file to a target location.
   2861 define transform-prebuilt-to-target
   2862 @echo "$($(PRIVATE_PREFIX)DISPLAY) Prebuilt: $(PRIVATE_MODULE) ($@)"
   2863 $(copy-file-to-target)
   2864 endef
   2865 
   2866 # Copy a prebuilt file to a target location, stripping "# comment" comments.
   2867 define transform-prebuilt-to-target-strip-comments
   2868 @echo "$($(PRIVATE_PREFIX)DISPLAY) Prebuilt: $(PRIVATE_MODULE) ($@)"
   2869 $(copy-file-to-target-strip-comments)
   2870 endef
   2871 
   2872 # Copy a list of files/directories to target location, with sub dir structure preserved.
   2873 # For example $(HOST_OUT_EXECUTABLES)/aapt -> $(staging)/bin/aapt .
   2874 # $(1): the source list of files/directories.
   2875 # $(2): the path prefix to strip. In the above example it would be $(HOST_OUT).
   2876 # $(3): the target location.
   2877 define copy-files-with-structure
   2878 $(foreach t,$(1),\
   2879   $(eval s := $(patsubst $(2)%,%,$(t)))\
   2880   $(hide) mkdir -p $(dir $(3)/$(s)); cp -Rf $(t) $(3)/$(s)$(newline))
   2881 endef
   2882 
   2883 # Define a rule to create a symlink to a file.
   2884 # $(1): full path to source
   2885 # $(2): source (may be relative)
   2886 # $(3): full path to destination
   2887 define symlink-file
   2888 $(eval $(_symlink-file))
   2889 endef
   2890 
   2891 # Order-only dependency because make/ninja will follow the link when checking
   2892 # the timestamp, so the file must exist
   2893 define _symlink-file
   2894 $(3): | $(1)
   2895 	@echo "Symlink: $$@ -> $(2)"
   2896 	@mkdir -p $(dir $$@)
   2897 	@rm -rf $$@
   2898 	$(hide) ln -sf $(2) $$@
   2899 endef
   2900 
   2901 ###########################################################
   2902 ## Commands to call Proguard
   2903 ###########################################################
   2904 define transform-jar-to-proguard
   2905 @echo Proguard: $@
   2906 $(hide) $(PROGUARD) -injars '$<$(PRIVATE_PROGUARD_INJAR_FILTERS)' \
   2907     -outjars $@ $(PRIVATE_PROGUARD_FLAGS) \
   2908     $(addprefix -injars , $(PRIVATE_EXTRA_INPUT_JAR))
   2909 endef
   2910 
   2911 ###########################################################
   2912 ## Stuff source generated from one-off tools
   2913 ###########################################################
   2914 
   2915 define transform-generated-source
   2916 @echo "$($(PRIVATE_PREFIX)DISPLAY) Generated: $(PRIVATE_MODULE) <= $<"
   2917 @mkdir -p $(dir $@)
   2918 $(hide) $(PRIVATE_CUSTOM_TOOL)
   2919 endef
   2920 
   2921 
   2922 ###########################################################
   2923 ## Assertions about attributes of the target
   2924 ###########################################################
   2925 
   2926 # $(1): The file to check
   2927 ifndef get-file-size
   2928 $(error HOST_OS must define get-file-size)
   2929 endif
   2930 
   2931 # Convert a partition data size (eg, as reported in /proc/mtd) to the
   2932 # size of the image used to flash that partition (which includes a
   2933 # spare area for each page).
   2934 # $(1): the partition data size
   2935 define image-size-from-data-size
   2936 $(strip $(eval _isfds_value := $$(shell echo $$$$(($(1) / $(BOARD_NAND_PAGE_SIZE) * \
   2937   ($(BOARD_NAND_PAGE_SIZE)+$(BOARD_NAND_SPARE_SIZE))))))\
   2938 $(if $(filter 0, $(_isfds_value)),$(shell echo $$(($(BOARD_NAND_PAGE_SIZE)+$(BOARD_NAND_SPARE_SIZE)))),$(_isfds_value))\
   2939 $(eval _isfds_value :=))
   2940 endef
   2941 
   2942 # $(1): The file(s) to check (often $@)
   2943 # $(2): The maximum total image size, in decimal bytes.
   2944 #    Make sure to take into account any reserved space needed for the FS.
   2945 #
   2946 # If $(2) is empty, evaluates to "true"
   2947 #
   2948 # Reserve bad blocks.  Make sure that MAX(1% of partition size, 2 blocks)
   2949 # is left over after the image has been flashed.  Round the 1% up to the
   2950 # next whole flash block size.
   2951 define assert-max-file-size
   2952 $(if $(2), \
   2953   size=$$(for i in $(1); do $(call get-file-size,$$i); echo +; done; echo 0); \
   2954   total=$$(( $$( echo "$$size" ) )); \
   2955   printname=$$(echo -n "$(1)" | tr " " +); \
   2956   img_blocksize=$(call image-size-from-data-size,$(BOARD_FLASH_BLOCK_SIZE)); \
   2957   twoblocks=$$((img_blocksize * 2)); \
   2958   onepct=$$((((($(2) / 100) - 1) / img_blocksize + 1) * img_blocksize)); \
   2959   reserve=$$((twoblocks > onepct ? twoblocks : onepct)); \
   2960   maxsize=$$(($(2) - reserve)); \
   2961   echo "$$printname maxsize=$$maxsize blocksize=$$img_blocksize total=$$total reserve=$$reserve"; \
   2962   if [ "$$total" -gt "$$maxsize" ]; then \
   2963     echo "error: $$printname too large ($$total > [$(2) - $$reserve])"; \
   2964     false; \
   2965   elif [ "$$total" -gt $$((maxsize - 32768)) ]; then \
   2966     echo "WARNING: $$printname approaching size limit ($$total now; limit $$maxsize)"; \
   2967   fi \
   2968  , \
   2969   true \
   2970  )
   2971 endef
   2972 
   2973 # Like assert-max-file-size, but the second argument is a partition
   2974 # size, which we'll convert to a max image size before checking it
   2975 # against the files.
   2976 #
   2977 # $(1): The file(s) to check (often $@)
   2978 # $(2): The partition size.
   2979 define assert-max-image-size
   2980 $(if $(2), \
   2981   $(call assert-max-file-size,$(1),$(call image-size-from-data-size,$(2))))
   2982 endef
   2983 
   2984 
   2985 ###########################################################
   2986 ## Define device-specific radio files
   2987 ###########################################################
   2988 INSTALLED_RADIOIMAGE_TARGET :=
   2989 
   2990 # Copy a radio image file to the output location, and add it to
   2991 # INSTALLED_RADIOIMAGE_TARGET.
   2992 # $(1): filename
   2993 define add-radio-file
   2994   $(eval $(call add-radio-file-internal,$(1),$(notdir $(1))))
   2995 endef
   2996 define add-radio-file-internal
   2997 INSTALLED_RADIOIMAGE_TARGET += $$(PRODUCT_OUT)/$(2)
   2998 $$(PRODUCT_OUT)/$(2) : $$(LOCAL_PATH)/$(1)
   2999 	$$(transform-prebuilt-to-target)
   3000 endef
   3001 
   3002 # Version of add-radio-file that also arranges for the version of the
   3003 # file to be checked against the contents of
   3004 # $(TARGET_BOARD_INFO_FILE).
   3005 # $(1): filename
   3006 # $(2): name of version variable in board-info (eg, "version-baseband")
   3007 define add-radio-file-checked
   3008   $(eval $(call add-radio-file-checked-internal,$(1),$(notdir $(1)),$(2)))
   3009 endef
   3010 define add-radio-file-checked-internal
   3011 INSTALLED_RADIOIMAGE_TARGET += $$(PRODUCT_OUT)/$(2)
   3012 BOARD_INFO_CHECK += $(3):$(LOCAL_PATH)/$(1)
   3013 $$(PRODUCT_OUT)/$(2) : $$(LOCAL_PATH)/$(1)
   3014 	$$(transform-prebuilt-to-target)
   3015 endef
   3016 
   3017 
   3018 ###########################################################
   3019 # Override the package defined in $(1), setting the
   3020 # variables listed below differently.
   3021 #
   3022 #  $(1): The makefile to override (relative to the source
   3023 #        tree root)
   3024 #  $(2): Old LOCAL_PACKAGE_NAME value.
   3025 #  $(3): New LOCAL_PACKAGE_NAME value.
   3026 #  $(4): New LOCAL_MANIFEST_PACKAGE_NAME value.
   3027 #  $(5): New LOCAL_CERTIFICATE value.
   3028 #  $(6): New LOCAL_INSTRUMENTATION_FOR value.
   3029 #  $(7): New LOCAL_MANIFEST_INSTRUMENTATION_FOR value.
   3030 #
   3031 # Note that LOCAL_PACKAGE_OVERRIDES is NOT cleared in
   3032 # clear_vars.mk.
   3033 ###########################################################
   3034 define inherit-package
   3035   $(eval $(call inherit-package-internal,$(1),$(2),$(3),$(4),$(5),$(6),$(7)))
   3036 endef
   3037 
   3038 define inherit-package-internal
   3039   LOCAL_PACKAGE_OVERRIDES \
   3040       := $(strip $(1))||$(strip $(2))||$(strip $(3))||$(strip $(4))||&&$(strip $(5))||&&$(strip $(6))||&&$(strip $(7)) $(LOCAL_PACKAGE_OVERRIDES)
   3041   include $(1)
   3042   LOCAL_PACKAGE_OVERRIDES \
   3043       := $(wordlist 1,$(words $(LOCAL_PACKAGE_OVERRIDES)), $(LOCAL_PACKAGE_OVERRIDES))
   3044 endef
   3045 
   3046 # To be used with inherit-package above
   3047 # Evalutes to true if the package was overridden
   3048 define set-inherited-package-variables
   3049 $(strip $(call set-inherited-package-variables-internal))
   3050 endef
   3051 
   3052 define keep-or-override
   3053 $(eval $(1) := $(if $(2),$(2),$($(1))))
   3054 endef
   3055 
   3056 define set-inherited-package-variables-internal
   3057   $(eval _o := $(subst ||, ,$(lastword $(LOCAL_PACKAGE_OVERRIDES))))
   3058   $(eval _n := $(subst ||, ,$(firstword $(LOCAL_PACKAGE_OVERRIDES))))
   3059   $(if $(filter $(word 2,$(_n)),$(LOCAL_PACKAGE_NAME)), \
   3060     $(eval LOCAL_PACKAGE_NAME := $(word 3,$(_o))) \
   3061     $(eval LOCAL_MANIFEST_PACKAGE_NAME := $(word 4,$(_o))) \
   3062     $(call keep-or-override,LOCAL_CERTIFICATE,$(patsubst &&%,%,$(word 5,$(_o)))) \
   3063     $(call keep-or-override,LOCAL_INSTRUMENTATION_FOR,$(patsubst &&%,%,$(word 6,$(_o)))) \
   3064     $(call keep-or-override,LOCAL_MANIFEST_INSTRUMENTATION_FOR,$(patsubst &&%,%,$(word 7,$(_o)))) \
   3065     $(eval LOCAL_OVERRIDES_PACKAGES := $(sort $(LOCAL_OVERRIDES_PACKAGES) $(word 2,$(_o)))) \
   3066     true \
   3067   ,)
   3068 endef
   3069 
   3070 ###########################################################
   3071 ## API Check
   3072 ###########################################################
   3073 
   3074 # eval this to define a rule that runs apicheck.
   3075 #
   3076 # Args:
   3077 #    $(1)  target
   3078 #    $(2)  stable api file
   3079 #    $(3)  api file to be tested
   3080 #    $(4)  stable removed api file
   3081 #    $(5)  removed api file to be tested
   3082 #    $(6)  arguments for apicheck
   3083 #    $(7)  command to run if apicheck failed
   3084 #    $(8)  target dependent on this api check
   3085 #    $(9)  additional dependencies
   3086 define check-api
   3087 $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/$(strip $(1))-timestamp: $(2) $(3) $(4) $(APICHECK) $(9)
   3088 	@echo "Checking API:" $(1)
   3089 	$(hide) ( $(APICHECK_COMMAND) $(6) $(2) $(3) $(4) $(5) || ( $(7) ; exit 38 ) )
   3090 	$(hide) mkdir -p $$(dir $$@)
   3091 	$(hide) touch $$@
   3092 $(8): $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/$(strip $(1))-timestamp
   3093 endef
   3094 
   3095 ## Whether to build from source if prebuilt alternative exists
   3096 ###########################################################
   3097 # $(1): module name
   3098 # $(2): LOCAL_PATH
   3099 # Expands to empty string if not from source.
   3100 ifeq (true,$(ANDROID_BUILD_FROM_SOURCE))
   3101 define if-build-from-source
   3102 true
   3103 endef
   3104 else
   3105 define if-build-from-source
   3106 $(if $(filter $(ANDROID_NO_PREBUILT_MODULES),$(1))$(filter \
   3107     $(addsuffix %,$(ANDROID_NO_PREBUILT_PATHS)),$(2)),true)
   3108 endef
   3109 endif
   3110 
   3111 # Include makefile $(1) if build from source for module $(2)
   3112 # $(1): the makefile to include
   3113 # $(2): module name
   3114 # $(3): LOCAL_PATH
   3115 define include-if-build-from-source
   3116 $(if $(call if-build-from-source,$(2),$(3)),$(eval include $(1)))
   3117 endef
   3118 
   3119 # Return the arch for the source file of a prebuilt
   3120 # Return "none" if no matching arch found and return empty
   3121 # if the input is empty, so the result can be passed to
   3122 # LOCAL_MODULE_TARGET_ARCH.
   3123 # $(1) the list of archs supported by the prebuilt
   3124 define get-prebuilt-src-arch
   3125 $(strip $(if $(filter $(TARGET_ARCH),$(1)),$(TARGET_ARCH),\
   3126   $(if $(filter $(TARGET_2ND_ARCH),$(1)),$(TARGET_2ND_ARCH),$(if $(1),none))))
   3127 endef
   3128 
   3129 # ###############################################################
   3130 # Set up statistics gathering
   3131 # ###############################################################
   3132 STATS.MODULE_TYPE := \
   3133   HOST_STATIC_LIBRARY \
   3134   HOST_SHARED_LIBRARY \
   3135   STATIC_LIBRARY \
   3136   SHARED_LIBRARY \
   3137   EXECUTABLE \
   3138   HOST_EXECUTABLE \
   3139   PACKAGE \
   3140   PHONY_PACKAGE \
   3141   HOST_PREBUILT \
   3142   PREBUILT \
   3143   MULTI_PREBUILT \
   3144   JAVA_LIBRARY \
   3145   STATIC_JAVA_LIBRARY \
   3146   HOST_JAVA_LIBRARY \
   3147   DROIDDOC \
   3148   COPY_HEADERS \
   3149   NATIVE_TEST \
   3150   NATIVE_BENCHMARK \
   3151   HOST_NATIVE_TEST \
   3152   FUZZ_TEST \
   3153   HOST_FUZZ_TEST \
   3154   STATIC_TEST_LIBRARY \
   3155   HOST_STATIC_TEST_LIBRARY \
   3156   NOTICE_FILE \
   3157   HOST_DALVIK_JAVA_LIBRARY \
   3158   HOST_DALVIK_STATIC_JAVA_LIBRARY \
   3159   base_rules \
   3160   HEADER_LIBRARY
   3161 
   3162 $(foreach $(s),$(STATS.MODULE_TYPE),$(eval STATS.MODULE_TYPE.$(s) :=))
   3163 define record-module-type
   3164 $(strip $(if $(LOCAL_RECORDED_MODULE_TYPE),,
   3165   $(if $(filter-out $(SOONG_ANDROID_MK),$(LOCAL_MODULE_MAKEFILE)),
   3166     $(if $(filter $(1),$(STATS.MODULE_TYPE)),
   3167       $(eval LOCAL_RECORDED_MODULE_TYPE := true)
   3168         $(eval STATS.MODULE_TYPE.$(1) += 1),
   3169       $(error Invalid module type: $(1))))))
   3170 endef
   3171 
   3172 ###########################################################
   3173 ## Compatibility suite tools
   3174 ###########################################################
   3175 
   3176 # Return a list of output directories for a given suite and the current LOCAL_MODULE.
   3177 # Can be passed a subdirectory to use for the common testcase directory.
   3178 define compatibility_suite_dirs
   3179   $(strip \
   3180     $(COMPATIBILITY_TESTCASES_OUT_$(1)) \
   3181     $($(my_prefix)OUT_TESTCASES)/$(LOCAL_MODULE)$(2))
   3182 endef
   3183 
   3184 # For each suite:
   3185 # 1. Copy the files to the many suite output directories.
   3186 # 2. Add all the files to each suite's dependent files list.
   3187 # 3. Do the dependency addition to my_all_targets
   3188 # Requires for each suite: my_compat_dist_$(suite) to be defined.
   3189 define create-suite-dependencies
   3190 $(foreach suite, $(LOCAL_COMPATIBILITY_SUITE), \
   3191   $(eval COMPATIBILITY.$(suite).FILES := \
   3192     $(COMPATIBILITY.$(suite).FILES) $(foreach f,$(my_compat_dist_$(suite)),$(call word-colon,2,$(f))))) \
   3193 $(eval $(my_all_targets) : $(call copy-many-files, \
   3194   $(sort $(foreach suite,$(LOCAL_COMPATIBILITY_SUITE),$(my_compat_dist_$(suite))))))
   3195 endef
   3196 
   3197 ###########################################################
   3198 ## Path Cleaning
   3199 ###########################################################
   3200 
   3201 # Remove "dir .." combinations (but keep ".. ..")
   3202 #
   3203 # $(1): The expanded path, where / is converted to ' ' to work with $(word)
   3204 define _clean-path-strip-dotdot
   3205 $(strip \
   3206   $(if $(word 2,$(1)),
   3207     $(if $(call streq,$(word 2,$(1)),..),
   3208       $(if $(call streq,$(word 1,$(1)),..),
   3209         $(word 1,$(1)) $(call _clean-path-strip-dotdot,$(wordlist 2,$(words $(1)),$(1)))
   3210       ,
   3211         $(call _clean-path-strip-dotdot,$(wordlist 3,$(words $(1)),$(1)))
   3212       )
   3213     ,
   3214       $(word 1,$(1)) $(call _clean-path-strip-dotdot,$(wordlist 2,$(words $(1)),$(1)))
   3215     )
   3216   ,
   3217     $(1)
   3218   )
   3219 )
   3220 endef
   3221 
   3222 # Remove any leading .. from the path (in case of /..)
   3223 #
   3224 # Should only be called if the original path started with /
   3225 # $(1): The expanded path, where / is converted to ' ' to work with $(word)
   3226 define _clean-path-strip-root-dotdots
   3227 $(strip $(if $(call streq,$(firstword $(1)),..),
   3228   $(call _clean-path-strip-root-dotdots,$(wordlist 2,$(words $(1)),$(1))),
   3229   $(1)))
   3230 endef
   3231 
   3232 # Call _clean-path-strip-dotdot until the path stops changing
   3233 # $(1): Non-empty if this path started with a /
   3234 # $(2): The expanded path, where / is converted to ' ' to work with $(word)
   3235 define _clean-path-expanded
   3236 $(strip \
   3237   $(eval _ep := $(call _clean-path-strip-dotdot,$(2)))
   3238   $(if $(1),$(eval _ep := $(call _clean-path-strip-root-dotdots,$(_ep))))
   3239   $(if $(call streq,$(2),$(_ep)),
   3240     $(_ep),
   3241     $(call _clean-path-expanded,$(1),$(_ep))))
   3242 endef
   3243 
   3244 # Clean the file path -- remove //, dir/.., extra .
   3245 #
   3246 # This should be the same semantics as golang's filepath.Clean
   3247 #
   3248 # $(1): The file path to clean
   3249 define clean-path
   3250 $(strip \
   3251   $(if $(call streq,$(words $(1)),1),
   3252     $(eval _rooted := $(filter /%,$(1)))
   3253     $(eval _expanded_path := $(filter-out .,$(subst /,$(space),$(1))))
   3254     $(eval _path := $(if $(_rooted),/)$(subst $(space),/,$(call _clean-path-expanded,$(_rooted),$(_expanded_path))))
   3255     $(if $(_path),
   3256       $(_path),
   3257       .
   3258      )
   3259   ,
   3260     $(if $(call streq,$(words $(1)),0),
   3261       .,
   3262       $(error Call clean-path with only one path (without spaces))
   3263     )
   3264   )
   3265 )
   3266 endef
   3267 
   3268 ifeq ($(TEST_MAKE_clean_path),true)
   3269   define my_test
   3270     $(if $(call streq,$(call clean-path,$(1)),$(2)),,
   3271       $(eval my_failed := true)
   3272       $(warning clean-path test '$(1)': expected '$(2)', got '$(call clean-path,$(1))'))
   3273   endef
   3274   my_failed :=
   3275 
   3276   # Already clean
   3277   $(call my_test,abc,abc)
   3278   $(call my_test,abc/def,abc/def)
   3279   $(call my_test,a/b/c,a/b/c)
   3280   $(call my_test,.,.)
   3281   $(call my_test,..,..)
   3282   $(call my_test,../..,../..)
   3283   $(call my_test,../../abc,../../abc)
   3284   $(call my_test,/abc,/abc)
   3285   $(call my_test,/,/)
   3286 
   3287   # Empty is current dir
   3288   $(call my_test,,.)
   3289 
   3290   # Remove trailing slash
   3291   $(call my_test,abc/,abc)
   3292   $(call my_test,abc/def/,abc/def)
   3293   $(call my_test,a/b/c/,a/b/c)
   3294   $(call my_test,./,.)
   3295   $(call my_test,../,..)
   3296   $(call my_test,../../,../..)
   3297   $(call my_test,/abc/,/abc)
   3298 
   3299   # Remove doubled slash
   3300   $(call my_test,abc//def//ghi,abc/def/ghi)
   3301   $(call my_test,//abc,/abc)
   3302   $(call my_test,///abc,/abc)
   3303   $(call my_test,//abc//,/abc)
   3304   $(call my_test,abc//,abc)
   3305 
   3306   # Remove . elements
   3307   $(call my_test,abc/./def,abc/def)
   3308   $(call my_test,/./abc/def,/abc/def)
   3309   $(call my_test,abc/.,abc)
   3310 
   3311   # Remove .. elements
   3312   $(call my_test,abc/def/ghi/../jkl,abc/def/jkl)
   3313   $(call my_test,abc/def/../ghi/../jkl,abc/jkl)
   3314   $(call my_test,abc/def/..,abc)
   3315   $(call my_test,abc/def/../..,.)
   3316   $(call my_test,/abc/def/../..,/)
   3317   $(call my_test,abc/def/../../..,..)
   3318   $(call my_test,/abc/def/../../..,/)
   3319   $(call my_test,abc/def/../../../ghi/jkl/../../../mno,../../mno)
   3320   $(call my_test,/../abc,/abc)
   3321 
   3322   # Combinations
   3323   $(call my_test,abc/./../def,def)
   3324   $(call my_test,abc//./../def,def)
   3325   $(call my_test,abc/../../././../def,../../def)
   3326 
   3327   ifdef my_failed
   3328     $(error failed clean-path test)
   3329   endif
   3330 endif
   3331 
   3332 ###########################################################
   3333 ## Other includes
   3334 ###########################################################
   3335 
   3336 # -----------------------------------------------------------------
   3337 # Rules and functions to help copy important files to DIST_DIR
   3338 # when requested.
   3339 include $(BUILD_SYSTEM)/distdir.mk
   3340 
   3341 # Include any vendor specific definitions.mk file
   3342 -include $(TOPDIR)vendor/*/build/core/definitions.mk
   3343 -include $(TOPDIR)device/*/build/core/definitions.mk
   3344 -include $(TOPDIR)product/*/build/core/definitions.mk
   3345 
   3346 # broken:
   3347 #	$(foreach file,$^,$(if $(findstring,.a,$(suffix $file)),-l$(file),$(file)))
   3348 
   3349 ###########################################################
   3350 ## Misc notes
   3351 ###########################################################
   3352 
   3353 #DEPDIR = .deps
   3354 #df = $(DEPDIR)/$(*F)
   3355 
   3356 #SRCS = foo.c bar.c ...
   3357 
   3358 #%.o : %.c
   3359 #	@$(MAKEDEPEND); \
   3360 #	  cp $(df).d $(df).P; \
   3361 #	  sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
   3362 #	      -e '/^$$/ d' -e 's/$$/ :/' < $(df).d >> $(df).P; \
   3363 #	  rm -f $(df).d
   3364 #	$(COMPILE.c) -o $@ $<
   3365 
   3366 #-include $(SRCS:%.c=$(DEPDIR)/%.P)
   3367 
   3368 
   3369 #%.o : %.c
   3370 #	$(COMPILE.c) -MD -o $@ $<
   3371 #	@cp $*.d $*.P; \
   3372 #	  sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
   3373 #	      -e '/^$$/ d' -e 's/$$/ :/' < $*.d >> $*.P; \
   3374 #	  rm -f $*.d
   3375 
   3376 
   3377 ###########################################################
   3378 # Append the information to generate a RRO package for the
   3379 # source module.
   3380 #
   3381 #  $(1): Source module name.
   3382 #  $(2): Whether $(3) is a manifest package name or not.
   3383 #  $(3): Manifest package name if $(2) is true.
   3384 #        Otherwise, android manifest file path of the
   3385 #        source module.
   3386 #  $(4): Whether LOCAL_EXPORT_PACKAGE_RESOURCES is set or
   3387 #        not for the source module.
   3388 #  $(5): Resource overlay list.
   3389 ###########################################################
   3390 define append_enforce_rro_sources
   3391   $(eval ENFORCE_RRO_SOURCES += \
   3392       $(strip $(1))||$(strip $(2))||$(strip $(3))||$(strip $(4))||$(call normalize-path-list, $(strip $(5))))
   3393 endef
   3394 
   3395 ###########################################################
   3396 # Generate all RRO packages for source modules stored in
   3397 # ENFORCE_RRO_SOURCES
   3398 ###########################################################
   3399 define generate_all_enforce_rro_packages
   3400 $(foreach source,$(ENFORCE_RRO_SOURCES), \
   3401   $(eval _o := $(subst ||,$(space),$(source))) \
   3402   $(eval enforce_rro_source_module := $(word 1,$(_o))) \
   3403   $(eval enforce_rro_source_is_manifest_package_name := $(word 2,$(_o))) \
   3404   $(eval enforce_rro_source_manifest_package_info := $(word 3,$(_o))) \
   3405   $(eval enforce_rro_use_res_lib := $(word 4,$(_o))) \
   3406   $(eval enforce_rro_source_overlays := $(subst :, ,$(word 5,$(_o)))) \
   3407   $(eval enforce_rro_module := $(enforce_rro_source_module)__auto_generated_rro) \
   3408   $(eval include $(BUILD_SYSTEM)/generate_enforce_rro.mk) \
   3409   $(eval ALL_MODULES.$(enforce_rro_source_module).REQUIRED += $(enforce_rro_module)) \
   3410 )
   3411 endef
   3412