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 # Generic functions
     19 # TODO: Move these to definitions.make once we're able to include
     20 # definitions.make before config.make.
     21 
     22 ###########################################################
     23 ## Return non-empty if $(1) is a C identifier; i.e., if it
     24 ## matches /^[a-zA-Z_][a-zA-Z0-9_]*$/.  We do this by first
     25 ## making sure that it isn't empty and doesn't start with
     26 ## a digit, then by removing each valid character.  If the
     27 ## final result is empty, then it was a valid C identifier.
     28 ##
     29 ## $(1): word to check
     30 ###########################################################
     31 
     32 _ici_digits := 0 1 2 3 4 5 6 7 8 9
     33 _ici_alphaunderscore := \
     34     a b c d e f g h i j k l m n o p q r s t u v w x y z \
     35     A B C D E F G H I J K L M N O P Q R S T U V W X Y Z _
     36 define is-c-identifier
     37 $(strip \
     38   $(if $(1), \
     39     $(if $(filter $(addsuffix %,$(_ici_digits)),$(1)), \
     40      , \
     41       $(eval w := $(1)) \
     42       $(foreach c,$(_ici_digits) $(_ici_alphaunderscore), \
     43         $(eval w := $(subst $(c),,$(w))) \
     44        ) \
     45       $(if $(w),,TRUE) \
     46       $(eval w :=) \
     47      ) \
     48    ) \
     49  )
     50 endef
     51 
     52 # TODO: push this into the combo files; unfortunately, we don't even
     53 # know HOST_OS at this point.
     54 trysed := $(shell echo a | sed -E -e 's/a/b/' 2>/dev/null)
     55 ifeq ($(trysed),b)
     56   SED_EXTENDED := sed -E
     57 else
     58   trysed := $(shell echo c | sed -r -e 's/c/d/' 2>/dev/null)
     59   ifeq ($(trysed),d)
     60     SED_EXTENDED := sed -r
     61   else
     62     $(error Unknown sed version)
     63   endif
     64 endif
     65 
     66 ###########################################################
     67 ## List all of the files in a subdirectory in a format
     68 ## suitable for PRODUCT_COPY_FILES and
     69 ## PRODUCT_SDK_ADDON_COPY_FILES
     70 ##
     71 ## $(1): Glob to match file name
     72 ## $(2): Source directory
     73 ## $(3): Target base directory
     74 ###########################################################
     75 
     76 define find-copy-subdir-files
     77 $(sort $(shell find $(2) -name "$(1)" -type f | $(SED_EXTENDED) "s:($(2)/?(.*)):\\1\\:$(3)/\\2:" | sed "s://:/:g"))
     78 endef
     79 
     80 # ---------------------------------------------------------------
     81 
     82 # These are the valid values of TARGET_BUILD_VARIANT.  Also, if anything else is passed
     83 # as the variant in the PRODUCT-$TARGET_BUILD_PRODUCT-$TARGET_BUILD_VARIANT form,
     84 # it will be treated as a goal, and the eng variant will be used.
     85 INTERNAL_VALID_VARIANTS := user userdebug eng
     86 
     87 # ---------------------------------------------------------------
     88 # Provide "PRODUCT-<prodname>-<goal>" targets, which lets you build
     89 # a particular configuration without needing to set up the environment.
     90 #
     91 product_goals := $(strip $(filter PRODUCT-%,$(MAKECMDGOALS)))
     92 ifdef product_goals
     93   # Scrape the product and build names out of the goal,
     94   # which should be of the form PRODUCT-<productname>-<buildname>.
     95   #
     96   ifneq ($(words $(product_goals)),1)
     97     $(error Only one PRODUCT-* goal may be specified; saw "$(product_goals)")
     98   endif
     99   goal_name := $(product_goals)
    100   product_goals := $(patsubst PRODUCT-%,%,$(product_goals))
    101   product_goals := $(subst -, ,$(product_goals))
    102   ifneq ($(words $(product_goals)),2)
    103     $(error Bad PRODUCT-* goal "$(goal_name)")
    104   endif
    105 
    106   # The product they want
    107   TARGET_PRODUCT := $(word 1,$(product_goals))
    108 
    109   # The variant they want
    110   TARGET_BUILD_VARIANT := $(word 2,$(product_goals))
    111 
    112   ifeq ($(TARGET_BUILD_VARIANT),tests)
    113     $(error "tests" has been deprecated as a build variant. Use it as a build goal instead.)
    114   endif
    115 
    116   # The build server wants to do make PRODUCT-dream-installclean
    117   # which really means TARGET_PRODUCT=dream make installclean.
    118   ifneq ($(filter-out $(INTERNAL_VALID_VARIANTS),$(TARGET_BUILD_VARIANT)),)
    119     MAKECMDGOALS := $(MAKECMDGOALS) $(TARGET_BUILD_VARIANT)
    120     TARGET_BUILD_VARIANT := userdebug
    121     default_goal_substitution :=
    122   else
    123     default_goal_substitution := $(DEFAULT_GOAL)
    124   endif
    125 
    126   # Replace the PRODUCT-* goal with the build goal that it refers to.
    127   # Note that this will ensure that it appears in the same relative
    128   # position, in case it matters.
    129   #
    130   # Note that modifying this will not affect the goals that make will
    131   # attempt to build, but it's important because we inspect this value
    132   # in certain situations (like for "make sdk").
    133   #
    134   MAKECMDGOALS := $(patsubst $(goal_name),$(default_goal_substitution),$(MAKECMDGOALS))
    135 
    136   # Define a rule for the PRODUCT-* goal, and make it depend on the
    137   # patched-up command-line goals as well as any other goals that we
    138   # want to force.
    139   #
    140 .PHONY: $(goal_name)
    141 $(goal_name): $(MAKECMDGOALS)
    142 endif
    143 # else: Use the value set in the environment or buildspec.mk.
    144 
    145 # ---------------------------------------------------------------
    146 # Provide "APP-<appname>" targets, which lets you build
    147 # an unbundled app.
    148 #
    149 unbundled_goals := $(strip $(filter APP-%,$(MAKECMDGOALS)))
    150 ifdef unbundled_goals
    151   ifneq ($(words $(unbundled_goals)),1)
    152     $(error Only one APP-* goal may be specified; saw "$(unbundled_goals)")
    153   endif
    154   TARGET_BUILD_APPS := $(strip $(subst -, ,$(patsubst APP-%,%,$(unbundled_goals))))
    155   ifneq ($(filter $(DEFAULT_GOAL),$(MAKECMDGOALS)),)
    156     MAKECMDGOALS := $(patsubst $(unbundled_goals),,$(MAKECMDGOALS))
    157   else
    158     MAKECMDGOALS := $(patsubst $(unbundled_goals),$(DEFAULT_GOAL),$(MAKECMDGOALS))
    159   endif
    160 
    161 .PHONY: $(unbundled_goals)
    162 $(unbundled_goals): $(MAKECMDGOALS)
    163 endif # unbundled_goals
    164 
    165 # Default to building dalvikvm on hosts that support it...
    166 ifeq ($(HOST_OS),linux)
    167 # ... or if the if the option is already set
    168 ifeq ($(WITH_HOST_DALVIK),)
    169   WITH_HOST_DALVIK := true
    170 endif
    171 endif
    172 
    173 # ---------------------------------------------------------------
    174 # Include the product definitions.
    175 # We need to do this to translate TARGET_PRODUCT into its
    176 # underlying TARGET_DEVICE before we start defining any rules.
    177 #
    178 include $(BUILD_SYSTEM)/node_fns.mk
    179 include $(BUILD_SYSTEM)/product.mk
    180 include $(BUILD_SYSTEM)/device.mk
    181 
    182 ifneq ($(strip $(TARGET_BUILD_APPS)),)
    183 # An unbundled app build needs only the core product makefiles.
    184 all_product_configs := $(call get-product-makefiles,\
    185     $(SRC_TARGET_DIR)/product/AndroidProducts.mk)
    186 else
    187 # Read in all of the product definitions specified by the AndroidProducts.mk
    188 # files in the tree.
    189 all_product_configs := $(get-all-product-makefiles)
    190 endif
    191 
    192 all_named_products :=
    193 
    194 # Find the product config makefile for the current product.
    195 # all_product_configs consists items like:
    196 # <product_name>:<path_to_the_product_makefile>
    197 # or just <path_to_the_product_makefile> in case the product name is the
    198 # same as the base filename of the product config makefile.
    199 current_product_makefile :=
    200 all_product_makefiles :=
    201 $(foreach f, $(all_product_configs),\
    202     $(eval _cpm_words := $(subst :,$(space),$(f)))\
    203     $(eval _cpm_word1 := $(word 1,$(_cpm_words)))\
    204     $(eval _cpm_word2 := $(word 2,$(_cpm_words)))\
    205     $(if $(_cpm_word2),\
    206         $(eval all_product_makefiles += $(_cpm_word2))\
    207         $(eval all_named_products += $(_cpm_word1))\
    208         $(if $(filter $(TARGET_PRODUCT),$(_cpm_word1)),\
    209             $(eval current_product_makefile += $(_cpm_word2)),),\
    210         $(eval all_product_makefiles += $(f))\
    211         $(eval all_named_products += $(basename $(notdir $(f))))\
    212         $(if $(filter $(TARGET_PRODUCT),$(basename $(notdir $(f)))),\
    213             $(eval current_product_makefile += $(f)),)))
    214 _cpm_words :=
    215 _cpm_word1 :=
    216 _cpm_word2 :=
    217 current_product_makefile := $(strip $(current_product_makefile))
    218 all_product_makefiles := $(strip $(all_product_makefiles))
    219 
    220 load_all_product_makefiles :=
    221 ifneq (,$(filter product-graph, $(MAKECMDGOALS)))
    222 ifeq ($(ANDROID_PRODUCT_GRAPH),--all)
    223 load_all_product_makefiles := true
    224 endif
    225 endif
    226 ifneq (,$(filter dump-products,$(MAKECMDGOALS)))
    227 ifeq ($(ANDROID_DUMP_PRODUCTS),all)
    228 load_all_product_makefiles := true
    229 endif
    230 endif
    231 
    232 ifeq ($(load_all_product_makefiles),true)
    233 # Import all product makefiles.
    234 $(call import-products, $(all_product_makefiles))
    235 else
    236 # Import just the current product.
    237 ifndef current_product_makefile
    238 $(error Can not locate config makefile for product "$(TARGET_PRODUCT)")
    239 endif
    240 ifneq (1,$(words $(current_product_makefile)))
    241 $(error Product "$(TARGET_PRODUCT)" ambiguous: matches $(current_product_makefile))
    242 endif
    243 $(call import-products, $(current_product_makefile))
    244 endif  # Import all or just the current product makefile
    245 
    246 # Sanity check
    247 $(check-all-products)
    248 
    249 ifneq ($(filter dump-products, $(MAKECMDGOALS)),)
    250 $(dump-products)
    251 $(error done)
    252 endif
    253 
    254 # Convert a short name like "sooner" into the path to the product
    255 # file defining that product.
    256 #
    257 INTERNAL_PRODUCT := $(call resolve-short-product-name, $(TARGET_PRODUCT))
    258 ifneq ($(current_product_makefile),$(INTERNAL_PRODUCT))
    259 $(error PRODUCT_NAME inconsistent in $(current_product_makefile) and $(INTERNAL_PRODUCT))
    260 endif
    261 current_product_makefile :=
    262 all_product_makefiles :=
    263 all_product_configs :=
    264 
    265 
    266 #############################################################################
    267 
    268 # A list of module names of BOOTCLASSPATH (jar files)
    269 PRODUCT_BOOT_JARS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_BOOT_JARS))
    270 PRODUCT_SYSTEM_SERVER_JARS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_SYSTEM_SERVER_JARS))
    271 PRODUCT_SYSTEM_SERVER_APPS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_SYSTEM_SERVER_APPS))
    272 PRODUCT_DEXPREOPT_SPEED_APPS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEXPREOPT_SPEED_APPS))
    273 
    274 # Find the device that this product maps to.
    275 TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
    276 
    277 # Figure out which resoure configuration options to use for this
    278 # product.
    279 PRODUCT_LOCALES := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_LOCALES))
    280 # TODO: also keep track of things like "port", "land" in product files.
    281 
    282 # If CUSTOM_LOCALES contains any locales not already included
    283 # in PRODUCT_LOCALES, add them to PRODUCT_LOCALES.
    284 extra_locales := $(filter-out $(PRODUCT_LOCALES),$(CUSTOM_LOCALES))
    285 ifneq (,$(extra_locales))
    286   ifneq ($(CALLED_FROM_SETUP),true)
    287     # Don't spam stdout, because envsetup.sh may be scraping values from it.
    288     $(info Adding CUSTOM_LOCALES [$(extra_locales)] to PRODUCT_LOCALES [$(PRODUCT_LOCALES)])
    289   endif
    290   PRODUCT_LOCALES += $(extra_locales)
    291   extra_locales :=
    292 endif
    293 
    294 # Add PRODUCT_LOCALES to PRODUCT_AAPT_CONFIG
    295 PRODUCT_AAPT_CONFIG := $(strip $(PRODUCT_LOCALES) $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_AAPT_CONFIG))
    296 PRODUCT_AAPT_PREF_CONFIG := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_AAPT_PREF_CONFIG))
    297 PRODUCT_AAPT_PREBUILT_DPI := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_AAPT_PREBUILT_DPI))
    298 
    299 # Keep a copy of the space-separated config
    300 PRODUCT_AAPT_CONFIG_SP := $(PRODUCT_AAPT_CONFIG)
    301 
    302 # Convert spaces to commas.
    303 PRODUCT_AAPT_CONFIG := \
    304     $(subst $(space),$(comma),$(strip $(PRODUCT_AAPT_CONFIG)))
    305 
    306 # product-scoped aapt flags
    307 PRODUCT_AAPT_FLAGS :=
    308 PRODUCT_AAPT2_CFLAGS :=
    309 ifneq ($(filter en_XA ar_XB,$(PRODUCT_LOCALES)),)
    310   # Force generating resources for pseudo-locales.
    311   PRODUCT_AAPT2_CFLAGS += --pseudo-localize
    312   PRODUCT_AAPT_FLAGS += --pseudo-localize
    313 endif
    314 
    315 PRODUCT_BRAND := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_BRAND))
    316 
    317 PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MODEL))
    318 ifndef PRODUCT_MODEL
    319   PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_NAME))
    320 endif
    321 
    322 PRODUCT_MANUFACTURER := \
    323     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MANUFACTURER))
    324 ifndef PRODUCT_MANUFACTURER
    325   PRODUCT_MANUFACTURER := unknown
    326 endif
    327 
    328 ifeq ($(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS),)
    329   TARGET_AAPT_CHARACTERISTICS := default
    330 else
    331   TARGET_AAPT_CHARACTERISTICS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS))
    332 endif
    333 
    334 PRODUCT_DEFAULT_WIFI_CHANNELS := \
    335     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_WIFI_CHANNELS))
    336 
    337 PRODUCT_DEFAULT_DEV_CERTIFICATE := \
    338     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_DEV_CERTIFICATE))
    339 ifdef PRODUCT_DEFAULT_DEV_CERTIFICATE
    340 ifneq (1,$(words $(PRODUCT_DEFAULT_DEV_CERTIFICATE)))
    341     $(error PRODUCT_DEFAULT_DEV_CERTIFICATE='$(PRODUCT_DEFAULT_DEV_CERTIFICATE)', \
    342       only 1 certificate is allowed.)
    343 endif
    344 endif
    345 
    346 # A list of words like <source path>:<destination path>[:<owner>].
    347 # The file at the source path should be copied to the destination path
    348 # when building  this product.  <destination path> is relative to
    349 # $(PRODUCT_OUT), so it should look like, e.g., "system/etc/file.xml".
    350 # The rules for these copy steps are defined in build/core/Makefile.
    351 # The optional :<owner> is used to indicate the owner of a vendor file.
    352 PRODUCT_COPY_FILES := \
    353     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_COPY_FILES))
    354 
    355 # A list of property assignments, like "key = value", with zero or more
    356 # whitespace characters on either side of the '='.
    357 PRODUCT_PROPERTY_OVERRIDES := \
    358     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PROPERTY_OVERRIDES))
    359 .KATI_READONLY := PRODUCT_PROPERTY_OVERRIDES
    360 
    361 PRODUCT_SHIPPING_API_LEVEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_SHIPPING_API_LEVEL))
    362 
    363 # A list of property assignments, like "key = value", with zero or more
    364 # whitespace characters on either side of the '='.
    365 # used for adding properties to default.prop
    366 PRODUCT_DEFAULT_PROPERTY_OVERRIDES := \
    367     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_PROPERTY_OVERRIDES))
    368 .KATI_READONLY := PRODUCT_DEFAULT_PROPERTY_OVERRIDES
    369 
    370 # Should we use the default resources or add any product specific overlays
    371 PRODUCT_PACKAGE_OVERLAYS := \
    372     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGE_OVERLAYS))
    373 DEVICE_PACKAGE_OVERLAYS := \
    374         $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).DEVICE_PACKAGE_OVERLAYS))
    375 
    376 # The list of product-specific kernel header dirs
    377 PRODUCT_VENDOR_KERNEL_HEADERS := \
    378     $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_VENDOR_KERNEL_HEADERS)
    379 
    380 # The OTA key(s) specified by the product config, if any.  The names
    381 # of these keys are stored in the target-files zip so that post-build
    382 # signing tools can substitute them for the test key embedded by
    383 # default.
    384 PRODUCT_OTA_PUBLIC_KEYS := $(sort \
    385     $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_OTA_PUBLIC_KEYS))
    386 
    387 PRODUCT_EXTRA_RECOVERY_KEYS := $(sort \
    388     $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_EXTRA_RECOVERY_KEYS))
    389 
    390 PRODUCT_DEX_PREOPT_DEFAULT_FLAGS := \
    391     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEX_PREOPT_DEFAULT_FLAGS))
    392 PRODUCT_DEX_PREOPT_BOOT_FLAGS := \
    393     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEX_PREOPT_BOOT_FLAGS))
    394 # Resolve and setup per-module dex-preopt configs.
    395 PRODUCT_DEX_PREOPT_MODULE_CONFIGS := \
    396     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEX_PREOPT_MODULE_CONFIGS))
    397 # If a module has multiple setups, the first takes precedence.
    398 _pdpmc_modules :=
    399 $(foreach c,$(PRODUCT_DEX_PREOPT_MODULE_CONFIGS),\
    400   $(eval m := $(firstword $(subst =,$(space),$(c))))\
    401   $(if $(filter $(_pdpmc_modules),$(m)),,\
    402     $(eval _pdpmc_modules += $(m))\
    403     $(eval cf := $(patsubst $(m)=%,%,$(c)))\
    404     $(eval cf := $(subst $(_PDPMC_SP_PLACE_HOLDER),$(space),$(cf)))\
    405     $(eval DEXPREOPT.$(TARGET_PRODUCT).$(m).CONFIG := $(cf))))
    406 _pdpmc_modules :=
    407 
    408 # Resolve and setup per-module sanitizer configs.
    409 PRODUCT_SANITIZER_MODULE_CONFIGS := \
    410     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_SANITIZER_MODULE_CONFIGS))
    411 # If a module has multiple setups, the first takes precedence.
    412 _psmc_modules :=
    413 $(foreach c,$(PRODUCT_SANITIZER_MODULE_CONFIGS),\
    414   $(eval m := $(firstword $(subst =,$(space),$(c))))\
    415   $(if $(filter $(_psmc_modules),$(m)),,\
    416     $(eval _psmc_modules += $(m))\
    417     $(eval cf := $(patsubst $(m)=%,%,$(c)))\
    418     $(eval cf := $(subst $(_PSMC_SP_PLACE_HOLDER),$(space),$(cf)))\
    419     $(eval SANITIZER.$(TARGET_PRODUCT).$(m).CONFIG := $(cf))))
    420 _psmc_modules :=
    421 
    422 # Make this art variable visible to soong_config.mk.
    423 PRODUCT_ART_USE_READ_BARRIER := \
    424     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_ART_USE_READ_BARRIER))
    425 
    426 # Whether the product is an Android Things variant.
    427 PRODUCT_IOT := \
    428     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_IOT))
    429 
    430 # Package list to apply enforcing RRO.
    431 PRODUCT_ENFORCE_RRO_TARGETS := \
    432     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_ENFORCE_RRO_TARGETS))
    433 
    434 # Add reserved headroom to a system image.
    435 PRODUCT_SYSTEM_HEADROOM := \
    436     $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_SYSTEM_HEADROOM))
    437