Home | History | Annotate | Download | only in core
      1 #
      2 # Copyright (C) 2007 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 # Functions for including AndroidProducts.mk files
     19 # PRODUCT_MAKEFILES is set up in AndroidProducts.mks.
     20 # Format of PRODUCT_MAKEFILES:
     21 # <product_name>:<path_to_the_product_makefile>
     22 # If the <product_name> is the same as the base file name (without dir
     23 # and the .mk suffix) of the product makefile, "<product_name>:" can be
     24 # omitted.
     25 
     26 #
     27 # Returns the list of all AndroidProducts.mk files.
     28 # $(call ) isn't necessary.
     29 #
     30 define _find-android-products-files
     31 $(shell test -d device && find device -maxdepth 6 -name AndroidProducts.mk) \
     32   $(shell test -d vendor && find vendor -maxdepth 6 -name AndroidProducts.mk) \
     33   $(SRC_TARGET_DIR)/product/AndroidProducts.mk
     34 endef
     35 
     36 #
     37 # Returns the sorted concatenation of PRODUCT_MAKEFILES
     38 # variables set in the given AndroidProducts.mk files.
     39 # $(1): the list of AndroidProducts.mk files.
     40 #
     41 define get-product-makefiles
     42 $(sort \
     43   $(foreach f,$(1), \
     44     $(eval PRODUCT_MAKEFILES :=) \
     45     $(eval LOCAL_DIR := $(patsubst %/,%,$(dir $(f)))) \
     46     $(eval include $(f)) \
     47     $(PRODUCT_MAKEFILES) \
     48    ) \
     49   $(eval PRODUCT_MAKEFILES :=) \
     50   $(eval LOCAL_DIR :=) \
     51  )
     52 endef
     53 
     54 #
     55 # Returns the sorted concatenation of all PRODUCT_MAKEFILES
     56 # variables set in all AndroidProducts.mk files.
     57 # $(call ) isn't necessary.
     58 #
     59 define get-all-product-makefiles
     60 $(call get-product-makefiles,$(_find-android-products-files))
     61 endef
     62 
     63 #
     64 # Functions for including product makefiles
     65 #
     66 
     67 _product_var_list := \
     68     PRODUCT_NAME \
     69     PRODUCT_MODEL \
     70     PRODUCT_LOCALES \
     71     PRODUCT_AAPT_CONFIG \
     72     PRODUCT_AAPT_PREF_CONFIG \
     73     PRODUCT_PACKAGES \
     74     PRODUCT_PACKAGES_DEBUG \
     75     PRODUCT_PACKAGES_ENG \
     76     PRODUCT_PACKAGES_TESTS \
     77     PRODUCT_DEVICE \
     78     PRODUCT_MANUFACTURER \
     79     PRODUCT_BRAND \
     80     PRODUCT_PROPERTY_OVERRIDES \
     81     PRODUCT_DEFAULT_PROPERTY_OVERRIDES \
     82     PRODUCT_CHARACTERISTICS \
     83     PRODUCT_COPY_FILES \
     84     PRODUCT_OTA_PUBLIC_KEYS \
     85     PRODUCT_EXTRA_RECOVERY_KEYS \
     86     PRODUCT_PACKAGE_OVERLAYS \
     87     DEVICE_PACKAGE_OVERLAYS \
     88     PRODUCT_TAGS \
     89     PRODUCT_SDK_ADDON_NAME \
     90     PRODUCT_SDK_ADDON_COPY_FILES \
     91     PRODUCT_SDK_ADDON_COPY_MODULES \
     92     PRODUCT_SDK_ADDON_DOC_MODULES \
     93     PRODUCT_DEFAULT_WIFI_CHANNELS \
     94     PRODUCT_DEFAULT_DEV_CERTIFICATE \
     95     PRODUCT_RESTRICT_VENDOR_FILES \
     96     PRODUCT_VENDOR_KERNEL_HEADERS \
     97     PRODUCT_FACTORY_RAMDISK_MODULES \
     98     PRODUCT_FACTORY_BUNDLE_MODULES
     99 
    100 
    101 define dump-product
    102 $(info ==== $(1) ====)\
    103 $(foreach v,$(_product_var_list),\
    104 $(info PRODUCTS.$(1).$(v) := $(PRODUCTS.$(1).$(v))))\
    105 $(info --------)
    106 endef
    107 
    108 define dump-products
    109 $(foreach p,$(PRODUCTS),$(call dump-product,$(p)))
    110 endef
    111 
    112 #
    113 # $(1): product to inherit
    114 #
    115 # Does three things:
    116 #  1. Inherits all of the variables from $1.
    117 #  2. Records the inheritance in the .INHERITS_FROM variable
    118 #  3. Records that we've visited this node, in ALL_PRODUCTS
    119 #
    120 define inherit-product
    121   $(foreach v,$(_product_var_list), \
    122       $(eval $(v) := $($(v)) $(INHERIT_TAG)$(strip $(1)))) \
    123   $(eval inherit_var := \
    124       PRODUCTS.$(strip $(word 1,$(_include_stack))).INHERITS_FROM) \
    125   $(eval $(inherit_var) := $(sort $($(inherit_var)) $(strip $(1)))) \
    126   $(eval inherit_var:=) \
    127   $(eval ALL_PRODUCTS := $(sort $(ALL_PRODUCTS) $(word 1,$(_include_stack))))
    128 endef
    129 
    130 
    131 #
    132 # Do inherit-product only if $(1) exists
    133 #
    134 define inherit-product-if-exists
    135   $(if $(wildcard $(1)),$(call inherit-product,$(1)),)
    136 endef
    137 
    138 #
    139 # $(1): product makefile list
    140 #
    141 #TODO: check to make sure that products have all the necessary vars defined
    142 define import-products
    143 $(call import-nodes,PRODUCTS,$(1),$(_product_var_list))
    144 endef
    145 
    146 
    147 #
    148 # Does various consistency checks on all of the known products.
    149 # Takes no parameters, so $(call ) is not necessary.
    150 #
    151 define check-all-products
    152 $(if ,, \
    153   $(eval _cap_names :=) \
    154   $(foreach p,$(PRODUCTS), \
    155     $(eval pn := $(strip $(PRODUCTS.$(p).PRODUCT_NAME))) \
    156     $(if $(pn),,$(error $(p): PRODUCT_NAME must be defined.)) \
    157     $(if $(filter $(pn),$(_cap_names)), \
    158       $(error $(p): PRODUCT_NAME must be unique; "$(pn)" already used by $(strip \
    159           $(foreach \
    160             pp,$(PRODUCTS),
    161               $(if $(filter $(pn),$(PRODUCTS.$(pp).PRODUCT_NAME)), \
    162                 $(pp) \
    163                ))) \
    164        ) \
    165      ) \
    166     $(eval _cap_names += $(pn)) \
    167     $(if $(call is-c-identifier,$(pn)),, \
    168       $(error $(p): PRODUCT_NAME must be a valid C identifier, not "$(pn)") \
    169      ) \
    170     $(eval pb := $(strip $(PRODUCTS.$(p).PRODUCT_BRAND))) \
    171     $(if $(pb),,$(error $(p): PRODUCT_BRAND must be defined.)) \
    172     $(foreach cf,$(strip $(PRODUCTS.$(p).PRODUCT_COPY_FILES)), \
    173       $(if $(filter 2 3,$(words $(subst :,$(space),$(cf)))),, \
    174         $(error $(p): malformed COPY_FILE "$(cf)") \
    175        ) \
    176      ) \
    177    ) \
    178 )
    179 endef
    180 
    181 
    182 #
    183 # Returns the product makefile path for the product with the provided name
    184 #
    185 # $(1): short product name like "generic"
    186 #
    187 define _resolve-short-product-name
    188   $(eval pn := $(strip $(1)))
    189   $(eval p := \
    190       $(foreach p,$(PRODUCTS), \
    191           $(if $(filter $(pn),$(PRODUCTS.$(p).PRODUCT_NAME)), \
    192             $(p) \
    193        )) \
    194    )
    195   $(eval p := $(sort $(p)))
    196   $(if $(filter 1,$(words $(p))), \
    197     $(p), \
    198     $(if $(filter 0,$(words $(p))), \
    199       $(error No matches for product "$(pn)"), \
    200       $(error Product "$(pn)" ambiguous: matches $(p)) \
    201     ) \
    202   )
    203 endef
    204 define resolve-short-product-name
    205 $(strip $(call _resolve-short-product-name,$(1)))
    206 endef
    207 
    208 
    209 _product_stash_var_list := $(_product_var_list) \
    210 	TARGET_ARCH \
    211 	TARGET_ARCH_VARIANT \
    212 	TARGET_BOARD_PLATFORM \
    213 	TARGET_BOARD_PLATFORM_GPU \
    214 	TARGET_BOARD_KERNEL_HEADERS \
    215 	TARGET_DEVICE_KERNEL_HEADERS \
    216 	TARGET_PRODUCT_KERNEL_HEADERS \
    217 	TARGET_BOOTLOADER_BOARD_NAME \
    218 	TARGET_COMPRESS_MODULE_SYMBOLS \
    219 	TARGET_NO_BOOTLOADER \
    220 	TARGET_NO_KERNEL \
    221 	TARGET_NO_RECOVERY \
    222 	TARGET_NO_RADIOIMAGE \
    223 	TARGET_HARDWARE_3D \
    224 	TARGET_PROVIDES_INIT_RC \
    225 	TARGET_CPU_ABI \
    226 	TARGET_CPU_ABI2 \
    227 	TARGET_CPU_SMP \
    228 
    229 
    230 _product_stash_var_list += \
    231 	BOARD_WPA_SUPPLICANT_DRIVER \
    232 	BOARD_WLAN_DEVICE \
    233 	BOARD_USES_GENERIC_AUDIO \
    234 	BOARD_KERNEL_CMDLINE \
    235 	BOARD_KERNEL_BASE \
    236 	BOARD_HAVE_BLUETOOTH \
    237 	BOARD_HAVE_BLUETOOTH_BCM \
    238 	BOARD_HAVE_BLUETOOTH_QCOM \
    239 	BOARD_VENDOR_QCOM_AMSS_VERSION \
    240 	BOARD_VENDOR_USE_AKMD \
    241 	BOARD_EGL_CFG \
    242 	BOARD_BOOTIMAGE_PARTITION_SIZE \
    243 	BOARD_RECOVERYIMAGE_PARTITION_SIZE \
    244 	BOARD_SYSTEMIMAGE_PARTITION_SIZE \
    245 	BOARD_USERDATAIMAGE_PARTITION_SIZE \
    246 	BOARD_CACHEIMAGE_FILE_SYSTEM_TYPE \
    247 	BOARD_CACHEIMAGE_PARTITION_SIZE \
    248 	BOARD_FLASH_BLOCK_SIZE \
    249 	BOARD_SYSTEMIMAGE_PARTITION_SIZE \
    250 	BOARD_VENDOR_QCOM_GPS_LOC_API_HARDWARE \
    251 	BOARD_VENDOR_QCOM_GPS_LOC_API_AMSS_VERSION \
    252 	BOARD_INSTALLER_CMDLINE \
    253 
    254 
    255 _product_stash_var_list += \
    256 	DEFAULT_SYSTEM_DEV_CERTIFICATE
    257 
    258 #
    259 # Stash vaues of the variables in _product_stash_var_list.
    260 # $(1): Renamed prefix
    261 #
    262 define stash-product-vars
    263 $(foreach v,$(_product_stash_var_list), \
    264         $(eval $(strip $(1))_$(call rot13,$(v)):=$$($$(v))) \
    265  )
    266 endef
    267 
    268 #
    269 # Assert that the the variable stashed by stash-product-vars remains untouched.
    270 # $(1): The prefix as supplied to stash-product-vars
    271 #
    272 define assert-product-vars
    273 $(strip \
    274   $(eval changed_variables:=)
    275   $(foreach v,$(_product_stash_var_list), \
    276     $(if $(call streq,$($(v)),$($(strip $(1))_$(call rot13,$(v)))),, \
    277         $(eval $(warning $(v) has been modified: $($(v)))) \
    278         $(eval $(warning previous value: $($(strip $(1))_$(call rot13,$(v))))) \
    279         $(eval changed_variables := $(changed_variables) $(v))) \
    280    ) \
    281   $(if $(changed_variables),\
    282     $(eval $(error The following variables have been changed: $(changed_variables))),)
    283 )
    284 endef
    285 
    286 define add-to-product-copy-files-if-exists
    287 $(if $(wildcard $(word 1,$(subst :, ,$(1)))),$(1))
    288 endef
    289