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 PRODUCT_RUNTIMES \ 100 PRODUCT_BOOT_JARS 101 102 103 define dump-product 104 $(info ==== $(1) ====)\ 105 $(foreach v,$(_product_var_list),\ 106 $(info PRODUCTS.$(1).$(v) := $(PRODUCTS.$(1).$(v))))\ 107 $(info --------) 108 endef 109 110 define dump-products 111 $(foreach p,$(PRODUCTS),$(call dump-product,$(p))) 112 endef 113 114 # 115 # $(1): product to inherit 116 # 117 # Does three things: 118 # 1. Inherits all of the variables from $1. 119 # 2. Records the inheritance in the .INHERITS_FROM variable 120 # 3. Records that we've visited this node, in ALL_PRODUCTS 121 # 122 define inherit-product 123 $(foreach v,$(_product_var_list), \ 124 $(eval $(v) := $($(v)) $(INHERIT_TAG)$(strip $(1)))) \ 125 $(eval inherit_var := \ 126 PRODUCTS.$(strip $(word 1,$(_include_stack))).INHERITS_FROM) \ 127 $(eval $(inherit_var) := $(sort $($(inherit_var)) $(strip $(1)))) \ 128 $(eval inherit_var:=) \ 129 $(eval ALL_PRODUCTS := $(sort $(ALL_PRODUCTS) $(word 1,$(_include_stack)))) 130 endef 131 132 133 # 134 # Do inherit-product only if $(1) exists 135 # 136 define inherit-product-if-exists 137 $(if $(wildcard $(1)),$(call inherit-product,$(1)),) 138 endef 139 140 # 141 # $(1): product makefile list 142 # 143 #TODO: check to make sure that products have all the necessary vars defined 144 define import-products 145 $(call import-nodes,PRODUCTS,$(1),$(_product_var_list)) 146 endef 147 148 149 # 150 # Does various consistency checks on all of the known products. 151 # Takes no parameters, so $(call ) is not necessary. 152 # 153 define check-all-products 154 $(if ,, \ 155 $(eval _cap_names :=) \ 156 $(foreach p,$(PRODUCTS), \ 157 $(eval pn := $(strip $(PRODUCTS.$(p).PRODUCT_NAME))) \ 158 $(if $(pn),,$(error $(p): PRODUCT_NAME must be defined.)) \ 159 $(if $(filter $(pn),$(_cap_names)), \ 160 $(error $(p): PRODUCT_NAME must be unique; "$(pn)" already used by $(strip \ 161 $(foreach \ 162 pp,$(PRODUCTS), 163 $(if $(filter $(pn),$(PRODUCTS.$(pp).PRODUCT_NAME)), \ 164 $(pp) \ 165 ))) \ 166 ) \ 167 ) \ 168 $(eval _cap_names += $(pn)) \ 169 $(if $(call is-c-identifier,$(pn)),, \ 170 $(error $(p): PRODUCT_NAME must be a valid C identifier, not "$(pn)") \ 171 ) \ 172 $(eval pb := $(strip $(PRODUCTS.$(p).PRODUCT_BRAND))) \ 173 $(if $(pb),,$(error $(p): PRODUCT_BRAND must be defined.)) \ 174 $(foreach cf,$(strip $(PRODUCTS.$(p).PRODUCT_COPY_FILES)), \ 175 $(if $(filter 2 3,$(words $(subst :,$(space),$(cf)))),, \ 176 $(error $(p): malformed COPY_FILE "$(cf)") \ 177 ) \ 178 ) \ 179 ) \ 180 ) 181 endef 182 183 184 # 185 # Returns the product makefile path for the product with the provided name 186 # 187 # $(1): short product name like "generic" 188 # 189 define _resolve-short-product-name 190 $(eval pn := $(strip $(1))) 191 $(eval p := \ 192 $(foreach p,$(PRODUCTS), \ 193 $(if $(filter $(pn),$(PRODUCTS.$(p).PRODUCT_NAME)), \ 194 $(p) \ 195 )) \ 196 ) 197 $(eval p := $(sort $(p))) 198 $(if $(filter 1,$(words $(p))), \ 199 $(p), \ 200 $(if $(filter 0,$(words $(p))), \ 201 $(error No matches for product "$(pn)"), \ 202 $(error Product "$(pn)" ambiguous: matches $(p)) \ 203 ) \ 204 ) 205 endef 206 define resolve-short-product-name 207 $(strip $(call _resolve-short-product-name,$(1))) 208 endef 209 210 211 _product_stash_var_list := $(_product_var_list) \ 212 PRODUCT_BOOTCLASSPATH \ 213 TARGET_ARCH \ 214 TARGET_ARCH_VARIANT \ 215 TARGET_CPU_VARIANT \ 216 TARGET_BOARD_PLATFORM \ 217 TARGET_BOARD_PLATFORM_GPU \ 218 TARGET_BOARD_KERNEL_HEADERS \ 219 TARGET_DEVICE_KERNEL_HEADERS \ 220 TARGET_PRODUCT_KERNEL_HEADERS \ 221 TARGET_BOOTLOADER_BOARD_NAME \ 222 TARGET_COMPRESS_MODULE_SYMBOLS \ 223 TARGET_NO_BOOTLOADER \ 224 TARGET_NO_KERNEL \ 225 TARGET_NO_RECOVERY \ 226 TARGET_NO_RADIOIMAGE \ 227 TARGET_HARDWARE_3D \ 228 TARGET_PROVIDES_INIT_RC \ 229 TARGET_CPU_ABI \ 230 TARGET_CPU_ABI2 \ 231 TARGET_CPU_SMP \ 232 233 234 _product_stash_var_list += \ 235 BOARD_WPA_SUPPLICANT_DRIVER \ 236 BOARD_WLAN_DEVICE \ 237 BOARD_USES_GENERIC_AUDIO \ 238 BOARD_KERNEL_CMDLINE \ 239 BOARD_KERNEL_BASE \ 240 BOARD_HAVE_BLUETOOTH \ 241 BOARD_VENDOR_USE_AKMD \ 242 BOARD_EGL_CFG \ 243 BOARD_BOOTIMAGE_PARTITION_SIZE \ 244 BOARD_RECOVERYIMAGE_PARTITION_SIZE \ 245 BOARD_SYSTEMIMAGE_PARTITION_SIZE \ 246 BOARD_USERDATAIMAGE_PARTITION_SIZE \ 247 BOARD_CACHEIMAGE_FILE_SYSTEM_TYPE \ 248 BOARD_CACHEIMAGE_PARTITION_SIZE \ 249 BOARD_FLASH_BLOCK_SIZE \ 250 BOARD_SYSTEMIMAGE_PARTITION_SIZE \ 251 BOARD_INSTALLER_CMDLINE \ 252 253 254 _product_stash_var_list += \ 255 DEFAULT_SYSTEM_DEV_CERTIFICATE 256 257 # 258 # Stash vaues of the variables in _product_stash_var_list. 259 # $(1): Renamed prefix 260 # 261 define stash-product-vars 262 $(foreach v,$(_product_stash_var_list), \ 263 $(eval $(strip $(1))_$(call rot13,$(v)):=$$($$(v))) \ 264 ) 265 endef 266 267 # 268 # Assert that the the variable stashed by stash-product-vars remains untouched. 269 # $(1): The prefix as supplied to stash-product-vars 270 # 271 define assert-product-vars 272 $(strip \ 273 $(eval changed_variables:=) 274 $(foreach v,$(_product_stash_var_list), \ 275 $(if $(call streq,$($(v)),$($(strip $(1))_$(call rot13,$(v)))),, \ 276 $(eval $(warning $(v) has been modified: $($(v)))) \ 277 $(eval $(warning previous value: $($(strip $(1))_$(call rot13,$(v))))) \ 278 $(eval changed_variables := $(changed_variables) $(v))) \ 279 ) \ 280 $(if $(changed_variables),\ 281 $(eval $(error The following variables have been changed: $(changed_variables))),) 282 ) 283 endef 284 285 define add-to-product-copy-files-if-exists 286 $(if $(wildcard $(word 1,$(subst :, ,$(1)))),$(1)) 287 endef 288