product_config.mk revision 5d4808db1630048f6eb0610b75af01c9fc877412 
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 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#
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  # 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)
152endif
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#
159unbundled_goals := $(strip $(filter APP-%,$(MAKECMDGOALS)))
160ifdef 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)
173endif # 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#
180include $(BUILD_SYSTEM)/node_fns.mk
181include $(BUILD_SYSTEM)/product.mk
182include $(BUILD_SYSTEM)/device.mk
183
184ifneq ($(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))
188else
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))
195endif # TARGET_BUILD_APPS
196$(check-all-products)
197
198ifneq ($(filter dump-products, $(MAKECMDGOALS)),)
199$(dump-products)
200$(error done)
201endif
202
203# Convert a short name like "sooner" into the path to the product
204# file defining that product.
205#
206INTERNAL_PRODUCT := $(call resolve-short-product-name, $(TARGET_PRODUCT))
207#$(error TARGET_PRODUCT $(TARGET_PRODUCT) --> $(INTERNAL_PRODUCT))
208
209# Find the device that this product maps to.
210TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
211
212# Figure out which resoure configuration options to use for this
213# product.
214PRODUCT_LOCALES := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_LOCALES))
215# TODO: also keep track of things like "port", "land" in product files.
216
217# If CUSTOM_LOCALES contains any locales not already included
218# in PRODUCT_LOCALES, add them to PRODUCT_LOCALES.
219extra_locales := $(filter-out $(PRODUCT_LOCALES),$(CUSTOM_LOCALES))
220ifneq (,$(extra_locales))
221  ifneq ($(CALLED_FROM_SETUP),true)
222    # Don't spam stdout, because envsetup.sh may be scraping values from it.
223    $(info Adding CUSTOM_LOCALES [$(extra_locales)] to PRODUCT_LOCALES [$(PRODUCT_LOCALES)])
224  endif
225  PRODUCT_LOCALES += $(extra_locales)
226  extra_locales :=
227endif
228
229# Default to medium-density assets.
230# (Can be overridden in the device config, e.g.: PRODUCT_LOCALES += hdpi)
231PRODUCT_LOCALES := $(strip \
232	$(PRODUCT_LOCALES) \
233	$(if $(filter %dpi,$(PRODUCT_LOCALES)),,mdpi))
234
235# Everyone gets nodpi assets which are density-independent.
236PRODUCT_LOCALES += nodpi
237
238# Assemble the list of options.
239PRODUCT_AAPT_CONFIG := $(PRODUCT_LOCALES)
240
241# Convert spaces to commas.
242comma := ,
243PRODUCT_AAPT_CONFIG := \
244	$(subst $(space),$(comma),$(strip $(PRODUCT_AAPT_CONFIG)))
245
246PRODUCT_BRAND := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_BRAND))
247
248PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MODEL))
249ifndef PRODUCT_MODEL
250  PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_NAME))
251endif
252
253PRODUCT_MANUFACTURER := \
254	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MANUFACTURER))
255ifndef PRODUCT_MANUFACTURER
256  PRODUCT_MANUFACTURER := unknown
257endif
258
259ifeq ($(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS),)
260  TARGET_AAPT_CHARACTERISTICS := default
261else
262  TARGET_AAPT_CHARACTERISTICS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS))
263endif
264
265PRODUCT_DEFAULT_WIFI_CHANNELS := \
266	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_WIFI_CHANNELS))
267
268# A list of words like <source path>:<destination path>.  The file at
269# the source path should be copied to the destination path when building
270# this product.  <destination path> is relative to $(PRODUCT_OUT), so
271# it should look like, e.g., "system/etc/file.xml".  The rules
272# for these copy steps are defined in config/Makefile.
273PRODUCT_COPY_FILES := \
274	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_COPY_FILES))
275
276# The HTML file containing the contributors to the project.
277PRODUCT_CONTRIBUTORS_FILE := \
278	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CONTRIBUTORS_FILE))
279
280# A list of property assignments, like "key = value", with zero or more
281# whitespace characters on either side of the '='.
282PRODUCT_PROPERTY_OVERRIDES := \
283	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PROPERTY_OVERRIDES))
284
285# Should we use the default resources or add any product specific overlays
286PRODUCT_PACKAGE_OVERLAYS := \
287	$(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGE_OVERLAYS))
288DEVICE_PACKAGE_OVERLAYS := \
289        $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).DEVICE_PACKAGE_OVERLAYS))
290
291# An list of whitespace-separated words.
292PRODUCT_TAGS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_TAGS))
293
294# Add the product-defined properties to the build properties.
295ADDITIONAL_BUILD_PROPERTIES := \
296	$(ADDITIONAL_BUILD_PROPERTIES) \
297	$(PRODUCT_PROPERTY_OVERRIDES)
298
299# The OTA key(s) specified by the product config, if any.  The names
300# of these keys are stored in the target-files zip so that post-build
301# signing tools can substitute them for the test key embedded by
302# default.
303PRODUCT_OTA_PUBLIC_KEYS := $(sort \
304    $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_OTA_PUBLIC_KEYS))
305
306PRODUCT_EXTRA_RECOVERY_KEYS := $(sort \
307    $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_EXTRA_RECOVERY_KEYS))
308
309
310# ---------------------------------------------------------------
311# Simulator overrides
312ifeq ($(TARGET_PRODUCT),sim)
313  # Tell the build system to turn on some special cases
314  # to deal with the simulator product.
315  TARGET_SIMULATOR := true
316  # dexpreopt doesn't work when building the simulator
317  DISABLE_DEXPREOPT := true
318endif
319