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 _
36define 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 )
50endef
51
52# TODO: push this into the combo files; unfortunately, we don't even
53# know HOST_OS at this point.
54trysed := $(shell echo a | sed -E -e 's/a/b/' 2>/dev/null)
55ifeq ($(trysed),b)
56  SED_EXTENDED := sed -E
57else
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
64endif
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
76define find-copy-subdir-files
77$(shell find $(2) -name "$(1)" | $(SED_EXTENDED) "s:($(2)/?(.*)):\\1\\:$(3)/\\2:" | sed "s://:/:g")
78endef
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.
85INTERNAL_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#
91product_goals := $(strip $(filter PRODUCT-%,$(MAKECMDGOALS)))
92ifdef 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 := eng
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)
142endif
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#
149unbundled_goals := $(strip $(filter APP-%,$(MAKECMDGOALS)))
150ifdef 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)
163endif # unbundled_goals
164
165# Default to building dalvikvm on hosts that support it...
166ifeq ($(HOST_OS),linux)
167# ... or if the if the option is already set
168ifeq ($(WITH_HOST_DALVIK),)
169  WITH_HOST_DALVIK := true
170endif
171endif
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#
178include $(BUILD_SYSTEM)/node_fns.mk
179include $(BUILD_SYSTEM)/product.mk
180include $(BUILD_SYSTEM)/device.mk
181
182ifneq ($(strip $(TARGET_BUILD_APPS)),)
183# An unbundled app build needs only the core product makefiles.
184all_product_configs := $(call get-product-makefiles,\
185    $(SRC_TARGET_DIR)/product/AndroidProducts.mk)
186else
187# Read in all of the product definitions specified by the AndroidProducts.mk
188# files in the tree.
189all_product_configs := $(get-all-product-makefiles)
190endif
191
192# Find the product config makefile for the current product.
193# all_product_configs consists items like:
194# <product_name>:<path_to_the_product_makefile>
195# or just <path_to_the_product_makefile> in case the product name is the
196# same as the base filename of the product config makefile.
197current_product_makefile :=
198all_product_makefiles :=
199$(foreach f, $(all_product_configs),\
200    $(eval _cpm_words := $(subst :,$(space),$(f)))\
201    $(eval _cpm_word1 := $(word 1,$(_cpm_words)))\
202    $(eval _cpm_word2 := $(word 2,$(_cpm_words)))\
203    $(if $(_cpm_word2),\
204        $(eval all_product_makefiles += $(_cpm_word2))\
205        $(if $(filter $(TARGET_PRODUCT),$(_cpm_word1)),\
206            $(eval current_product_makefile += $(_cpm_word2)),),\
207        $(eval all_product_makefiles += $(f))\
208        $(if $(filter $(TARGET_PRODUCT),$(basename $(notdir $(f)))),\
209            $(eval current_product_makefile += $(f)),)))
210_cpm_words :=
211_cpm_word1 :=
212_cpm_word2 :=
213current_product_makefile := $(strip $(current_product_makefile))
214all_product_makefiles := $(strip $(all_product_makefiles))
215
216ifneq (,$(filter product-graph dump-products, $(MAKECMDGOALS)))
217# Import all product makefiles.
218$(call import-products, $(all_product_makefiles))
219else
220# Import just the current product.
221ifndef current_product_makefile
222$(error Can not locate config makefile for product "$(TARGET_PRODUCT)")
223endif
224ifneq (1,$(words $(current_product_makefile)))
225$(error Product "$(TARGET_PRODUCT)" ambiguous: matches $(current_product_makefile))
226endif
227$(call import-products, $(current_product_makefile))
228endif  # Import all or just the current product makefile
229
230# Sanity check
231$(check-all-products)
232
233ifneq ($(filter dump-products, $(MAKECMDGOALS)),)
234$(dump-products)
235$(error done)
236endif
237
238# Convert a short name like "sooner" into the path to the product
239# file defining that product.
240#
241INTERNAL_PRODUCT := $(call resolve-short-product-name, $(TARGET_PRODUCT))
242ifneq ($(current_product_makefile),$(INTERNAL_PRODUCT))
243$(error PRODUCT_NAME inconsistent in $(current_product_makefile) and $(INTERNAL_PRODUCT))
244endif
245current_product_makefile :=
246all_product_makefiles :=
247all_product_configs :=
248
249
250#############################################################################
251
252# A list of module names of BOOTCLASSPATH (jar files)
253PRODUCT_BOOT_JARS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_BOOT_JARS))
254PRODUCT_SYSTEM_SERVER_JARS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_SYSTEM_SERVER_JARS))
255
256# Find the device that this product maps to.
257TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
258
259# Figure out which resoure configuration options to use for this
260# product.
261PRODUCT_LOCALES := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_LOCALES))
262# TODO: also keep track of things like "port", "land" in product files.
263
264# If CUSTOM_LOCALES contains any locales not already included
265# in PRODUCT_LOCALES, add them to PRODUCT_LOCALES.
266extra_locales := $(filter-out $(PRODUCT_LOCALES),$(CUSTOM_LOCALES))
267ifneq (,$(extra_locales))
268  ifneq ($(CALLED_FROM_SETUP),true)
269    # Don't spam stdout, because envsetup.sh may be scraping values from it.
270    $(info Adding CUSTOM_LOCALES [$(extra_locales)] to PRODUCT_LOCALES [$(PRODUCT_LOCALES)])
271  endif
272  PRODUCT_LOCALES += $(extra_locales)
273  extra_locales :=
274endif
275
276# Add PRODUCT_LOCALES to PRODUCT_AAPT_CONFIG
277PRODUCT_AAPT_CONFIG := $(strip $(PRODUCT_LOCALES) $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_AAPT_CONFIG))
278PRODUCT_AAPT_PREF_CONFIG := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_AAPT_PREF_CONFIG))
279PRODUCT_AAPT_PREBUILT_DPI := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_AAPT_PREBUILT_DPI))
280
281# Keep a copy of the space-separated config
282PRODUCT_AAPT_CONFIG_SP := $(PRODUCT_AAPT_CONFIG)
283
284# Convert spaces to commas.
285PRODUCT_AAPT_CONFIG := \
286    $(subst $(space),$(comma),$(strip $(PRODUCT_AAPT_CONFIG)))
287
288# product-scoped aapt flags
289PRODUCT_AAPT_FLAGS :=
290ifneq ($(filter en_XA ar_XB,$(PRODUCT_LOCALES)),)
291# Force generating resources for pseudo-locales.
292PRODUCT_AAPT_FLAGS += --pseudo-localize
293endif
294
295PRODUCT_BRAND := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_BRAND))
296
297PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MODEL))
298ifndef PRODUCT_MODEL
299  PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_NAME))
300endif
301
302PRODUCT_MANUFACTURER := \
303    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MANUFACTURER))
304ifndef PRODUCT_MANUFACTURER
305  PRODUCT_MANUFACTURER := unknown
306endif
307
308ifeq ($(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS),)
309  TARGET_AAPT_CHARACTERISTICS := default
310else
311  TARGET_AAPT_CHARACTERISTICS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS))
312endif
313
314PRODUCT_DEFAULT_WIFI_CHANNELS := \
315    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_WIFI_CHANNELS))
316
317PRODUCT_DEFAULT_DEV_CERTIFICATE := \
318    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_DEV_CERTIFICATE))
319ifdef PRODUCT_DEFAULT_DEV_CERTIFICATE
320ifneq (1,$(words $(PRODUCT_DEFAULT_DEV_CERTIFICATE)))
321    $(error PRODUCT_DEFAULT_DEV_CERTIFICATE='$(PRODUCT_DEFAULT_DEV_CERTIFICATE)', \
322      only 1 certificate is allowed.)
323endif
324endif
325
326# A list of words like <source path>:<destination path>[:<owner>].
327# The file at the source path should be copied to the destination path
328# when building  this product.  <destination path> is relative to
329# $(PRODUCT_OUT), so it should look like, e.g., "system/etc/file.xml".
330# The rules for these copy steps are defined in build/core/Makefile.
331# The optional :<owner> is used to indicate the owner of a vendor file.
332PRODUCT_COPY_FILES := \
333    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_COPY_FILES))
334
335# A list of property assignments, like "key = value", with zero or more
336# whitespace characters on either side of the '='.
337PRODUCT_PROPERTY_OVERRIDES := \
338    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PROPERTY_OVERRIDES))
339
340# A list of property assignments, like "key = value", with zero or more
341# whitespace characters on either side of the '='.
342# used for adding properties to default.prop
343PRODUCT_DEFAULT_PROPERTY_OVERRIDES := \
344    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_PROPERTY_OVERRIDES))
345
346# Should we use the default resources or add any product specific overlays
347PRODUCT_PACKAGE_OVERLAYS := \
348    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGE_OVERLAYS))
349DEVICE_PACKAGE_OVERLAYS := \
350        $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).DEVICE_PACKAGE_OVERLAYS))
351
352# The list of product-specific kernel header dirs
353PRODUCT_VENDOR_KERNEL_HEADERS := \
354    $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_VENDOR_KERNEL_HEADERS)
355
356# Add the product-defined properties to the build properties.
357ADDITIONAL_BUILD_PROPERTIES := \
358    $(ADDITIONAL_BUILD_PROPERTIES) \
359    $(PRODUCT_PROPERTY_OVERRIDES)
360
361# The OTA key(s) specified by the product config, if any.  The names
362# of these keys are stored in the target-files zip so that post-build
363# signing tools can substitute them for the test key embedded by
364# default.
365PRODUCT_OTA_PUBLIC_KEYS := $(sort \
366    $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_OTA_PUBLIC_KEYS))
367
368PRODUCT_EXTRA_RECOVERY_KEYS := $(sort \
369    $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_EXTRA_RECOVERY_KEYS))
370
371PRODUCT_DEX_PREOPT_DEFAULT_FLAGS := \
372    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEX_PREOPT_DEFAULT_FLAGS))
373PRODUCT_DEX_PREOPT_BOOT_FLAGS := \
374    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEX_PREOPT_BOOT_FLAGS))
375# Resolve and setup per-module dex-preopot configs.
376PRODUCT_DEX_PREOPT_MODULE_CONFIGS := \
377    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEX_PREOPT_MODULE_CONFIGS))
378# If a module has multiple setups, the first takes precedence.
379_pdpmc_modules :=
380$(foreach c,$(PRODUCT_DEX_PREOPT_MODULE_CONFIGS),\
381  $(eval m := $(firstword $(subst =,$(space),$(c))))\
382  $(if $(filter $(_pdpmc_modules),$(m)),,\
383    $(eval _pdpmc_modules += $(m))\
384    $(eval cf := $(patsubst $(m)=%,%,$(c)))\
385    $(eval cf := $(subst $(_PDPMC_SP_PLACE_HOLDER),$(space),$(cf)))\
386    $(eval DEXPREOPT.$(TARGET_PRODUCT).$(m).CONFIG := $(cf))))
387_pdpmc_modules :=
388