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