• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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  # Replace the PRODUCT-* goal with the build goal that it refers to.
128  # Note that this will ensure that it appears in the same relative
129  # position, in case it matters.
130  #
131  # Note that modifying this will not affect the goals that make will
132  # attempt to build, but it's important because we inspect this value
133  # in certain situations (like for "make sdk").
134  #
135  MAKECMDGOALS := $(patsubst $(goal_name),$(default_goal_substitution),$(MAKECMDGOALS))
136
137  # Define a rule for the PRODUCT-* goal, and make it depend on the
138  # patched-up command-line goals as well as any other goals that we
139  # want to force.
140  #
141.PHONY: $(goal_name)
142$(goal_name): $(MAKECMDGOALS)
143endif
144# else: Use the value set in the environment or buildspec.mk.
145
146# ---------------------------------------------------------------
147# Provide "APP-<appname>" targets, which lets you build
148# an unbundled app.
149#
150unbundled_goals := $(strip $(filter APP-%,$(MAKECMDGOALS)))
151ifdef unbundled_goals
152  ifneq ($(words $(unbundled_goals)),1)
153    $(error Only one APP-* goal may be specified; saw "$(unbundled_goals)"))
154  endif
155  TARGET_BUILD_APPS := $(strip $(subst -, ,$(patsubst APP-%,%,$(unbundled_goals))))
156  ifneq ($(filter $(DEFAULT_GOAL),$(MAKECMDGOALS)),)
157    MAKECMDGOALS := $(patsubst $(unbundled_goals),,$(MAKECMDGOALS))
158  else
159    MAKECMDGOALS := $(patsubst $(unbundled_goals),$(DEFAULT_GOAL),$(MAKECMDGOALS))
160  endif
161
162.PHONY: $(unbundled_goals)
163$(unbundled_goals): $(MAKECMDGOALS)
164endif # unbundled_goals
165
166# Default to building dalvikvm on hosts that support it...
167ifeq ($(HOST_OS),linux)
168# ... or if the if the option is already set
169ifeq ($(WITH_HOST_DALVIK),)
170  WITH_HOST_DALVIK := true
171endif
172endif
173
174# ---------------------------------------------------------------
175# Include the product definitions.
176# We need to do this to translate TARGET_PRODUCT into its
177# underlying TARGET_DEVICE before we start defining any rules.
178#
179include $(BUILD_SYSTEM)/node_fns.mk
180include $(BUILD_SYSTEM)/product.mk
181include $(BUILD_SYSTEM)/device.mk
182
183ifneq ($(strip $(TARGET_BUILD_APPS)),)
184  # An unbundled app build needs only the core product makefiles.
185  $(call import-products,$(call get-product-makefiles,\
186      $(SRC_TARGET_DIR)/product/AndroidProducts.mk))
187else
188  # Read in all of the product definitions specified by the AndroidProducts.mk
189  # files in the tree.
190  #
191  #TODO: when we start allowing direct pointers to product files,
192  #    guarantee that they're in this list.
193  $(call import-products, $(get-all-product-makefiles))
194endif # TARGET_BUILD_APPS
195$(check-all-products)
196
197ifneq ($(filter dump-products, $(MAKECMDGOALS)),)
198$(dump-products)
199$(error done)
200endif
201
202# Convert a short name like "sooner" into the path to the product
203# file defining that product.
204#
205INTERNAL_PRODUCT := $(call resolve-short-product-name, $(TARGET_PRODUCT))
206#$(error TARGET_PRODUCT $(TARGET_PRODUCT) --> $(INTERNAL_PRODUCT))
207
208# Find the device that this product maps to.
209TARGET_DEVICE := $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
210
211# Figure out which resoure configuration options to use for this
212# product.
213PRODUCT_LOCALES := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_LOCALES))
214# TODO: also keep track of things like "port", "land" in product files.
215
216# If CUSTOM_LOCALES contains any locales not already included
217# in PRODUCT_LOCALES, add them to PRODUCT_LOCALES.
218extra_locales := $(filter-out $(PRODUCT_LOCALES),$(CUSTOM_LOCALES))
219ifneq (,$(extra_locales))
220  ifneq ($(CALLED_FROM_SETUP),true)
221    # Don't spam stdout, because envsetup.sh may be scraping values from it.
222    $(info Adding CUSTOM_LOCALES [$(extra_locales)] to PRODUCT_LOCALES [$(PRODUCT_LOCALES)])
223  endif
224  PRODUCT_LOCALES += $(extra_locales)
225  extra_locales :=
226endif
227
228# Add PRODUCT_LOCALES to PRODUCT_AAPT_CONFIG
229PRODUCT_AAPT_CONFIG := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_AAPT_CONFIG))
230PRODUCT_AAPT_CONFIG := $(PRODUCT_LOCALES) $(PRODUCT_AAPT_CONFIG)
231PRODUCT_AAPT_PREF_CONFIG := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_AAPT_PREF_CONFIG))
232
233# Default to medium-density assets.
234# (Can be overridden in the device config, e.g.: PRODUCT_AAPT_CONFIG += hdpi)
235PRODUCT_AAPT_CONFIG := $(strip \
236    $(PRODUCT_AAPT_CONFIG) \
237    $(if $(filter %dpi,$(PRODUCT_AAPT_CONFIG)),,mdpi))
238PRODUCT_AAPT_PREF_CONFIG := $(strip $(PRODUCT_AAPT_PREF_CONFIG))
239
240# Everyone gets nodpi assets which are density-independent.
241PRODUCT_AAPT_CONFIG += nodpi
242
243# Convert spaces to commas.
244comma := ,
245PRODUCT_AAPT_CONFIG := \
246    $(subst $(space),$(comma),$(strip $(PRODUCT_AAPT_CONFIG)))
247PRODUCT_AAPT_PREF_CONFIG := \
248    $(subst $(space),$(comma),$(strip $(PRODUCT_AAPT_PREF_CONFIG)))
249
250PRODUCT_BRAND := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_BRAND))
251
252PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MODEL))
253ifndef PRODUCT_MODEL
254  PRODUCT_MODEL := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_NAME))
255endif
256
257PRODUCT_MANUFACTURER := \
258    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_MANUFACTURER))
259ifndef PRODUCT_MANUFACTURER
260  PRODUCT_MANUFACTURER := unknown
261endif
262
263ifeq ($(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS),)
264  TARGET_AAPT_CHARACTERISTICS := default
265else
266  TARGET_AAPT_CHARACTERISTICS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CHARACTERISTICS))
267endif
268
269PRODUCT_DEFAULT_WIFI_CHANNELS := \
270    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_WIFI_CHANNELS))
271
272PRODUCT_DEFAULT_DEV_CERTIFICATE := \
273    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_DEV_CERTIFICATE))
274ifdef PRODUCT_DEFAULT_DEV_CERTIFICATE
275ifneq (1,$(words $(PRODUCT_DEFAULT_DEV_CERTIFICATE)))
276    $(error PRODUCT_DEFAULT_DEV_CERTIFICATE='$(PRODUCT_DEFAULT_DEV_CERTIFICATE)', \
277      only 1 certificate is allowed.)
278endif
279endif
280
281# A list of words like <source path>:<destination path>.  The file at
282# the source path should be copied to the destination path when building
283# this product.  <destination path> is relative to $(PRODUCT_OUT), so
284# it should look like, e.g., "system/etc/file.xml".  The rules
285# for these copy steps are defined in config/Makefile.
286PRODUCT_COPY_FILES := \
287    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_COPY_FILES))
288
289# The HTML file containing the contributors to the project.
290PRODUCT_CONTRIBUTORS_FILE := \
291    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_CONTRIBUTORS_FILE))
292
293# A list of property assignments, like "key = value", with zero or more
294# whitespace characters on either side of the '='.
295PRODUCT_PROPERTY_OVERRIDES := \
296    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PROPERTY_OVERRIDES))
297
298# A list of property assignments, like "key = value", with zero or more
299# whitespace characters on either side of the '='.
300# used for adding properties to default.prop
301PRODUCT_DEFAULT_PROPERTY_OVERRIDES := \
302    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEFAULT_PROPERTY_OVERRIDES))
303
304# Should we use the default resources or add any product specific overlays
305PRODUCT_PACKAGE_OVERLAYS := \
306    $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_PACKAGE_OVERLAYS))
307DEVICE_PACKAGE_OVERLAYS := \
308        $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).DEVICE_PACKAGE_OVERLAYS))
309
310# An list of whitespace-separated words.
311PRODUCT_TAGS := $(strip $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_TAGS))
312
313# Add the product-defined properties to the build properties.
314ADDITIONAL_BUILD_PROPERTIES := \
315    $(ADDITIONAL_BUILD_PROPERTIES) \
316    $(PRODUCT_PROPERTY_OVERRIDES)
317
318# The OTA key(s) specified by the product config, if any.  The names
319# of these keys are stored in the target-files zip so that post-build
320# signing tools can substitute them for the test key embedded by
321# default.
322PRODUCT_OTA_PUBLIC_KEYS := $(sort \
323    $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_OTA_PUBLIC_KEYS))
324
325PRODUCT_EXTRA_RECOVERY_KEYS := $(sort \
326    $(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_EXTRA_RECOVERY_KEYS))
327