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 $(shell find $(2) -name "$(1)" | $(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 tests
     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   # The build server wants to do make PRODUCT-dream-installclean
    113   # which really means TARGET_PRODUCT=dream make installclean.
    114   ifneq ($(filter-out $(INTERNAL_VALID_VARIANTS),$(TARGET_BUILD_VARIANT)),)
    115 	MAKECMDGOALS := $(MAKECMDGOALS) $(TARGET_BUILD_VARIANT)
    116 	TARGET_BUILD_VARIANT := eng
    117     default_goal_substitution :=
    118   else
    119     default_goal_substitution := $(DEFAULT_GOAL)
    120   endif
    121 
    122   # For tests build, only build tests-build-target
    123   ifeq (tests,$(TARGET_BUILD_VARIANT))
    124     default_goal_substitution := tests-build-target
    125   endif
    126 
    127   # Hack to make the linux build servers use dexpreopt (emulator-based
    128   # preoptimization). Most engineers don't use this type of target
    129   # ("make PRODUCT-blah-user"), so this should only tend to happen when
    130   # using buildbot.
    131   # TODO: Remove this once host Dalvik preoptimization is working.
    132   ifeq ($(TARGET_BUILD_VARIANT),user)
    133     WITH_DEXPREOPT_buildbot := true
    134   endif
    135 
    136   # Replace the PRODUCT-* goal with the build goal that it refers to.
    137   # Note that this will ensure that it appears in the same relative
    138   # position, in case it matters.
    139   #
    140   # Note that modifying this will not affect the goals that make will
    141   # attempt to build, but it's important because we inspect this value
    142   # in certain situations (like for "make sdk").
    143   #
    144   MAKECMDGOALS := $(patsubst $(goal_name),$(default_goal_substitution),$(MAKECMDGOALS))
    145 
    146   # Define a rule for the PRODUCT-* goal, and make it depend on the
    147   # patched-up command-line goals as well as any other goals that we
    148   # want to force.
    149   #
    150 .PHONY: $(goal_name)
    151 $(goal_name): $(MAKECMDGOALS)
    152 endif
    153 # else: Use the value set in the environment or buildspec.mk.
    154 
    155 # ---------------------------------------------------------------
    156 # Provide "APP-<appname>" targets, which lets you build
    157 # an unbundled app.
    158 #
    159 unbundled_goals := $(strip $(filter APP-%,$(MAKECMDGOALS)))
    160 ifdef unbundled_goals
    161   ifneq ($(words $(unbundled_goals)),1)
    162     $(error Only one APP-* goal may be specified; saw "$(unbundled_goals)"))
    163   endif
    164   TARGET_BUILD_APPS := $(strip $(subst -, ,$(patsubst APP-%,%,$(unbundled_goals))))
    165   ifneq ($(filter $(DEFAULT_GOAL),$(MAKECMDGOALS)),)
    166     MAKECMDGOALS := $(patsubst $(unbundled_goals),,$(MAKECMDGOALS))
    167   else
    168     MAKECMDGOALS := $(patsubst $(unbundled_goals),$(DEFAULT_GOAL),$(MAKECMDGOALS))
    169   endif
    170 
    171 .PHONY: $(unbundled_goals)
    172 $(unbundled_goals): $(MAKECMDGOALS)
    173 endif # unbundled_goals
    174 
    175 # ---------------------------------------------------------------
    176 # Include the product definitions.
    177 # We need to do this to translate TARGET_PRODUCT into its
    178 # underlying TARGET_DEVICE before we start defining any rules.
    179 #
    180 include $(BUILD_SYSTEM)/node_fns.mk
    181 include $(BUILD_SYSTEM)/product.mk
    182 include $(BUILD_SYSTEM)/device.mk
    183 
    184 ifneq ($(strip $(TARGET_BUILD_APPS)),)
    185   # An unbundled app build needs only the core product makefiles.
    186   $(call import-products,$(call get-product-makefiles,\
    187       $(SRC_TARGET_DIR)/product/AndroidProducts.mk))
    188 else
    189   # Read in all of the product definitions specified by the AndroidProducts.mk
    190   # files in the tree.
    191   #
    192   #TODO: when we start allowing direct pointers to product files,
    193   #    guarantee that they're in this list.
    194   $(call import-products, $(get-all-product-makefiles))
    195 endif # TARGET_BUILD_APPS
    196 $(check-all-products)
    197 #$(dump-products)
    198 #$(error done)
    199 
    200 # Convert a short name like "sooner" into the path to the product
    201 # file defining that product.
    202 #
    203 INTERNAL_PRODUCT := $(call resolve-short-product-name, $(TARGET_PRODUCT))
    204 #$(error TARGET_PRODUCT $(TARGET_PRODUCT) --> $(INTERNAL_PRODUCT))
    205 
    206 # Find the device that this product maps to.
    207 TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
    208 
    209 # Figure out which resoure configuration options to use for this
    210 # product.
    211 PRODUCT_LOCALES := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_LOCALES))
    212 # TODO: also keep track of things like "port", "land" in product files.
    213 
    214 # If CUSTOM_LOCALES contains any locales not already included
    215 # in PRODUCT_LOCALES, add them to PRODUCT_LOCALES.
    216 extra_locales := $(filter-out $(PRODUCT_LOCALES),$(CUSTOM_LOCALES))
    217 ifneq (,$(extra_locales))
    218   ifneq ($(CALLED_FROM_SETUP),true)
    219     # Don't spam stdout, because envsetup.sh may be scraping values from it.
    220     $(info Adding CUSTOM_LOCALES [$(extra_locales)] to PRODUCT_LOCALES [$(PRODUCT_LOCALES)])
    221   endif
    222   PRODUCT_LOCALES += $(extra_locales)
    223   extra_locales :=
    224 endif
    225 
    226 # Default to medium-density assets.
    227 # (Can be overridden in the device config, e.g.: PRODUCT_LOCALES += hdpi)
    228 PRODUCT_LOCALES := $(strip \
    229 	$(PRODUCT_LOCALES) \
    230 	$(if $(filter %dpi,$(PRODUCT_LOCALES)),,mdpi))
    231 
    232 # Everyone gets nodpi assets which are density-independent.
    233 PRODUCT_LOCALES += nodpi
    234 
    235 # Assemble the list of options.
    236 PRODUCT_AAPT_CONFIG := $(PRODUCT_LOCALES)
    237 
    238 # Convert spaces to commas.
    239 comma := ,
    240 PRODUCT_AAPT_CONFIG := \
    241 	$(subst $(space),$(comma),$(strip $(PRODUCT_AAPT_CONFIG)))
    242 
    243 PRODUCT_BRAND := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_BRAND))
    244 
    245 PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MODEL))
    246 ifndef PRODUCT_MODEL
    247   PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_NAME))
    248 endif
    249 
    250 PRODUCT_MANUFACTURER := \
    251 	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MANUFACTURER))
    252 ifndef PRODUCT_MANUFACTURER
    253   PRODUCT_MANUFACTURER := unknown
    254 endif
    255 
    256 ifeq ($(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS),)
    257   TARGET_AAPT_CHARACTERISTICS := default
    258 else
    259   TARGET_AAPT_CHARACTERISTICS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS))
    260 endif
    261 
    262 PRODUCT_DEFAULT_WIFI_CHANNELS := \
    263 	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_WIFI_CHANNELS))
    264 
    265 # A list of words like <source path>:<destination path>.  The file at
    266 # the source path should be copied to the destination path when building
    267 # this product.  <destination path> is relative to $(PRODUCT_OUT), so
    268 # it should look like, e.g., "system/etc/file.xml".  The rules
    269 # for these copy steps are defined in config/Makefile.
    270 PRODUCT_COPY_FILES := \
    271 	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_COPY_FILES))
    272 
    273 # The HTML file containing the contributors to the project.
    274 PRODUCT_CONTRIBUTORS_FILE := \
    275 	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CONTRIBUTORS_FILE))
    276 
    277 # A list of property assignments, like "key = value", with zero or more
    278 # whitespace characters on either side of the '='.
    279 PRODUCT_PROPERTY_OVERRIDES := \
    280 	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PROPERTY_OVERRIDES))
    281 
    282 # Should we use the default resources or add any product specific overlays
    283 PRODUCT_PACKAGE_OVERLAYS := \
    284 	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGE_OVERLAYS))
    285 DEVICE_PACKAGE_OVERLAYS := \
    286         $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).DEVICE_PACKAGE_OVERLAYS))
    287 
    288 # An list of whitespace-separated words.
    289 PRODUCT_TAGS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_TAGS))
    290 
    291 # Add the product-defined properties to the build properties.
    292 ADDITIONAL_BUILD_PROPERTIES := \
    293 	$(ADDITIONAL_BUILD_PROPERTIES) \
    294 	$(PRODUCT_PROPERTY_OVERRIDES)
    295 
    296 # The OTA key(s) specified by the product config, if any.  The names
    297 # of these keys are stored in the target-files zip so that post-build
    298 # signing tools can substitute them for the test key embedded by
    299 # default.
    300 PRODUCT_OTA_PUBLIC_KEYS := $(sort \
    301     $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_OTA_PUBLIC_KEYS))
    302 
    303 # ---------------------------------------------------------------
    304 # Simulator overrides
    305 ifeq ($(TARGET_PRODUCT),sim)
    306   # Tell the build system to turn on some special cases
    307   # to deal with the simulator product.
    308   TARGET_SIMULATOR := true
    309   # dexpreopt doesn't work when building the simulator
    310   DISABLE_DEXPREOPT := true
    311 endif
    312