envsetup.mk revision 9ca1628e3f565607e1fdef71b570d3ddb5ec09df
1# Variables we check:
2#     HOST_BUILD_TYPE = { release debug }
3#     TARGET_SIMULATOR = { true <null> }
4#     TARGET_BUILD_TYPE = { release debug }
5# and we output a bunch of variables, see the case statement at
6# the bottom for the full list
7#     OUT_DIR is also set to "out" if it's not already set.
8#         this allows you to set it to somewhere else if you like
9
10# Set up version information.
11include $(BUILD_SYSTEM)/version_defaults.mk
12
13# ---------------------------------------------------------------
14# If you update the build system such that the environment setup
15# or buildspec.mk need to be updated, increment this number, and
16# people who haven't re-run those will have to do so before they
17# can build.  Make sure to also update the corresponding value in
18# buildspec.mk.default and envsetup.sh.
19CORRECT_BUILD_ENV_SEQUENCE_NUMBER := 9
20
21# ---------------------------------------------------------------
22# The product defaults to generic on hardware and sim on sim
23# NOTE: This will be overridden in product_config.mk if make
24# was invoked with a PRODUCT-xxx-yyy goal.
25ifeq ($(TARGET_PRODUCT),)
26ifeq ($(TARGET_SIMULATOR),true)
27TARGET_PRODUCT := sim
28else
29TARGET_PRODUCT := generic
30endif
31endif
32
33
34# the variant -- the set of files that are included for a build
35ifeq ($(strip $(TARGET_BUILD_VARIANT)),)
36TARGET_BUILD_VARIANT := eng
37endif
38
39# Read the product specs so we an get TARGET_DEVICE and other
40# variables that we need in order to locate the output files.
41include $(BUILD_SYSTEM)/product_config.mk
42
43build_variant := $(filter-out eng user userdebug tests,$(TARGET_BUILD_VARIANT))
44ifneq ($(build_variant)-$(words $(TARGET_BUILD_VARIANT)),-1)
45$(warning bad TARGET_BUILD_VARIANT: $(TARGET_BUILD_VARIANT))
46$(error must be empty or one of: eng user userdebug tests)
47endif
48
49
50
51# ---------------------------------------------------------------
52# Set up configuration for host machine.  We don't do cross-
53# compiles except for arm, so the HOST is whatever we are
54# running on
55
56UNAME := $(shell uname -sm)
57
58# HOST_OS
59ifneq (,$(findstring Linux,$(UNAME)))
60	HOST_OS := linux
61endif
62ifneq (,$(findstring Darwin,$(UNAME)))
63	HOST_OS := darwin
64endif
65ifneq (,$(findstring Macintosh,$(UNAME)))
66	HOST_OS := darwin
67endif
68ifneq (,$(findstring CYGWIN,$(UNAME)))
69	HOST_OS := windows
70endif
71
72# BUILD_OS is the real host doing the build.
73BUILD_OS := $(HOST_OS)
74
75# Under Linux, if USE_MINGW is set, we change HOST_OS to Windows to build the
76# Windows SDK. Only a subset of tools and SDK will manage to build properly.
77ifeq ($(HOST_OS),linux)
78ifneq ($(USE_MINGW),)
79	HOST_OS := windows
80endif
81endif
82
83ifeq ($(HOST_OS),)
84$(error Unable to determine HOST_OS from uname -sm: $(UNAME)!)
85endif
86
87
88# HOST_ARCH
89ifneq (,$(findstring 86,$(UNAME)))
90	HOST_ARCH := x86
91endif
92
93ifneq (,$(findstring Power,$(UNAME)))
94	HOST_ARCH := ppc
95endif
96
97BUILD_ARCH := $(HOST_ARCH)
98
99ifeq ($(HOST_ARCH),)
100$(error Unable to determine HOST_ARCH from uname -sm: $(UNAME)!)
101endif
102
103# the host build defaults to release, and it must be release or debug
104ifeq ($(HOST_BUILD_TYPE),)
105HOST_BUILD_TYPE := release
106endif
107
108ifneq ($(HOST_BUILD_TYPE),release)
109ifneq ($(HOST_BUILD_TYPE),debug)
110$(error HOST_BUILD_TYPE must be either release or debug, not '$(HOST_BUILD_TYPE)')
111endif
112endif
113
114# This is the standard way to name a directory containing prebuilt host
115# objects. E.g., prebuilt/$(HOST_PREBUILT_TAG)/cc
116ifeq ($(HOST_OS),windows)
117  HOST_PREBUILT_TAG := windows
118else
119  HOST_PREBUILT_TAG := $(HOST_OS)-$(HOST_ARCH)
120endif
121
122
123# ---------------------------------------------------------------
124# Set up configuration for target machine.
125# The following must be set:
126# 		TARGET_OS = { linux }
127# 		TARGET_ARCH = { arm | x86 }
128
129
130# if we're build the simulator, HOST_* is TARGET_* (except for BUILD_TYPE)
131# otherwise  it's <arch>-linux
132ifeq ($(TARGET_SIMULATOR),true)
133ifneq ($(HOST_OS),linux)
134$(error TARGET_SIMULATOR=true is only supported under Linux)
135endif
136TARGET_ARCH := $(HOST_ARCH)
137TARGET_OS := $(HOST_OS)
138else
139ifeq ($(TARGET_ARCH),)
140TARGET_ARCH := arm
141endif
142TARGET_OS := linux
143endif
144
145# the target build type defaults to release
146ifneq ($(TARGET_BUILD_TYPE),debug)
147TARGET_BUILD_TYPE := release
148endif
149
150# This is the standard way to name a directory containing prebuilt target
151# objects. E.g., prebuilt/$(TARGET_PREBUILT_TAG)/libc.so
152ifeq ($(TARGET_SIMULATOR),true)
153  TARGET_PREBUILT_TAG := $(TARGET_OS)-$(TARGET_ARCH)
154else
155  TARGET_PREBUILT_TAG := android-$(TARGET_ARCH)
156endif
157
158# ---------------------------------------------------------------
159# figure out the output directories
160
161ifeq (,$(strip $(OUT_DIR)))
162OUT_DIR := $(TOPDIR)out
163endif
164
165DEBUG_OUT_DIR := $(OUT_DIR)/debug
166
167# Move the host or target under the debug/ directory
168# if necessary.
169TARGET_OUT_ROOT_release := $(OUT_DIR)/target
170TARGET_OUT_ROOT_debug := $(DEBUG_OUT_DIR)/target
171TARGET_OUT_ROOT := $(TARGET_OUT_ROOT_$(TARGET_BUILD_TYPE))
172
173HOST_OUT_ROOT_release := $(OUT_DIR)/host
174HOST_OUT_ROOT_debug := $(DEBUG_OUT_DIR)/host
175HOST_OUT_ROOT := $(HOST_OUT_ROOT_$(HOST_BUILD_TYPE))
176
177HOST_OUT_release := $(HOST_OUT_ROOT_release)/$(HOST_OS)-$(HOST_ARCH)
178HOST_OUT_debug := $(HOST_OUT_ROOT_debug)/$(HOST_OS)-$(HOST_ARCH)
179HOST_OUT := $(HOST_OUT_$(HOST_BUILD_TYPE))
180
181BUILD_OUT := $(OUT_DIR)/host/$(BUILD_OS)-$(BUILD_ARCH)
182
183ifeq ($(TARGET_SIMULATOR),true)
184  # Any arch- or os-specific parts of the simulator (everything
185  # under product/) are actually host-dependent.
186  # But, the debug type is controlled by TARGET_BUILD_TYPE and not
187  # HOST_BUILD_TYPE.
188  TARGET_PRODUCT_OUT_ROOT := $(HOST_OUT_$(TARGET_BUILD_TYPE))/pr
189else
190  TARGET_PRODUCT_OUT_ROOT := $(TARGET_OUT_ROOT)/product
191endif
192
193TARGET_COMMON_OUT_ROOT := $(TARGET_OUT_ROOT)/common
194HOST_COMMON_OUT_ROOT := $(HOST_OUT_ROOT)/common
195
196PRODUCT_OUT := $(TARGET_PRODUCT_OUT_ROOT)/$(TARGET_DEVICE)
197
198OUT_DOCS := $(TARGET_COMMON_OUT_ROOT)/docs
199
200BUILD_OUT_EXECUTABLES:= $(BUILD_OUT)/bin
201
202HOST_OUT_EXECUTABLES:= $(HOST_OUT)/bin
203HOST_OUT_SHARED_LIBRARIES:= $(HOST_OUT)/lib
204HOST_OUT_JAVA_LIBRARIES:= $(HOST_OUT)/framework
205HOST_OUT_SDK_ADDON := $(HOST_OUT)/sdk_addon
206
207HOST_OUT_INTERMEDIATES := $(HOST_OUT)/obj
208HOST_OUT_HEADERS:= $(HOST_OUT_INTERMEDIATES)/include
209HOST_OUT_INTERMEDIATE_LIBRARIES := $(HOST_OUT_INTERMEDIATES)/lib
210HOST_OUT_STATIC_LIBRARIES := $(HOST_OUT_INTERMEDIATE_LIBRARIES)
211HOST_OUT_NOTICE_FILES:=$(HOST_OUT_INTERMEDIATES)/NOTICE_FILES
212HOST_OUT_COMMON_INTERMEDIATES := $(HOST_COMMON_OUT_ROOT)/obj
213
214TARGET_OUT_INTERMEDIATES := $(PRODUCT_OUT)/obj
215TARGET_OUT_HEADERS:= $(TARGET_OUT_INTERMEDIATES)/include
216TARGET_OUT_INTERMEDIATE_LIBRARIES := $(TARGET_OUT_INTERMEDIATES)/lib
217TARGET_OUT_COMMON_INTERMEDIATES := $(TARGET_COMMON_OUT_ROOT)/obj
218
219TARGET_OUT := $(PRODUCT_OUT)/system
220TARGET_OUT_EXECUTABLES:= $(TARGET_OUT)/bin
221TARGET_OUT_OPTIONAL_EXECUTABLES:= $(TARGET_OUT)/xbin
222TARGET_OUT_SHARED_LIBRARIES:= $(TARGET_OUT)/lib
223TARGET_OUT_JAVA_LIBRARIES:= $(TARGET_OUT)/framework
224TARGET_OUT_APPS:= $(TARGET_OUT)/app
225TARGET_OUT_KEYLAYOUT := $(TARGET_OUT)/usr/keylayout
226TARGET_OUT_KEYCHARS := $(TARGET_OUT)/usr/keychars
227TARGET_OUT_ETC := $(TARGET_OUT)/etc
228TARGET_OUT_STATIC_LIBRARIES:= $(TARGET_OUT_INTERMEDIATES)/lib
229TARGET_OUT_NOTICE_FILES:=$(TARGET_OUT_INTERMEDIATES)/NOTICE_FILES
230
231TARGET_OUT_DATA := $(PRODUCT_OUT)/data
232TARGET_OUT_DATA_EXECUTABLES:= $(TARGET_OUT_EXECUTABLES)
233TARGET_OUT_DATA_SHARED_LIBRARIES:= $(TARGET_OUT_SHARED_LIBRARIES)
234TARGET_OUT_DATA_JAVA_LIBRARIES:= $(TARGET_OUT_JAVA_LIBRARIES)
235TARGET_OUT_DATA_APPS:= $(TARGET_OUT_DATA)/app
236TARGET_OUT_DATA_KEYLAYOUT := $(TARGET_OUT_KEYLAYOUT)
237TARGET_OUT_DATA_KEYCHARS := $(TARGET_OUT_KEYCHARS)
238TARGET_OUT_DATA_ETC := $(TARGET_OUT_ETC)
239TARGET_OUT_DATA_STATIC_LIBRARIES:= $(TARGET_OUT_STATIC_LIBRARIES)
240
241TARGET_OUT_UNSTRIPPED := $(PRODUCT_OUT)/symbols
242TARGET_OUT_EXECUTABLES_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/system/bin
243TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/system/lib
244TARGET_ROOT_OUT_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)
245TARGET_ROOT_OUT_SBIN_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/sbin
246TARGET_ROOT_OUT_BIN_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/bin
247
248TARGET_ROOT_OUT := $(PRODUCT_OUT)/root
249TARGET_ROOT_OUT_BIN := $(TARGET_ROOT_OUT)/bin
250TARGET_ROOT_OUT_SBIN := $(TARGET_ROOT_OUT)/sbin
251TARGET_ROOT_OUT_ETC := $(TARGET_ROOT_OUT)/etc
252TARGET_ROOT_OUT_USR := $(TARGET_ROOT_OUT)/usr
253
254TARGET_RECOVERY_OUT := $(PRODUCT_OUT)/recovery
255TARGET_RECOVERY_ROOT_OUT := $(TARGET_RECOVERY_OUT)/root
256
257TARGET_SYSLOADER_OUT := $(PRODUCT_OUT)/sysloader
258TARGET_SYSLOADER_ROOT_OUT := $(TARGET_SYSLOADER_OUT)/root
259TARGET_SYSLOADER_SYSTEM_OUT := $(TARGET_SYSLOADER_OUT)/root/system
260
261TARGET_INSTALLER_OUT := $(PRODUCT_OUT)/installer
262TARGET_INSTALLER_DATA_OUT := $(TARGET_INSTALLER_OUT)/data
263TARGET_INSTALLER_ROOT_OUT := $(TARGET_INSTALLER_OUT)/root
264TARGET_INSTALLER_SYSTEM_OUT := $(TARGET_INSTALLER_OUT)/root/system
265
266COMMON_MODULE_CLASSES := JAVA_LIBRARIES NOTICE_FILES
267
268ifeq (,$(strip $(DIST_DIR)))
269  DIST_DIR := $(OUT_DIR)/dist
270endif
271
272ifeq ($(PRINT_BUILD_CONFIG),)
273PRINT_BUILD_CONFIG := true
274endif
275
276# ---------------------------------------------------------------
277# the setpath shell function in envsetup.sh uses this to figure out
278# what to add to the path given the config we have chosen.
279ifeq ($(CALLED_FROM_SETUP),true)
280
281ABP:=$(PWD)/$(HOST_OUT_EXECUTABLES)
282
283ifeq ($(TARGET_SIMULATOR),true)
284	ABP:=$(ABP):$(TARGET_OUT_EXECUTABLES)
285else
286	# this should be copied to HOST_OUT_EXECUTABLES instead
287	ABP:=$(ABP):$(PWD)/prebuilt/$(HOST_PREBUILT_TAG)/toolchain/arm-eabi-4.4.0/bin
288endif
289ANDROID_BUILD_PATHS := $(ABP)
290ANDROID_PREBUILTS := prebuilt/$(HOST_PREBUILT_TAG)
291
292# The "dumpvar" stuff lets you say something like
293#
294#     CALLED_FROM_SETUP=true \
295#       make -f config/envsetup.make dumpvar-TARGET_OUT
296# or
297#     CALLED_FROM_SETUP=true \
298#       make -f config/envsetup.make dumpvar-abs-HOST_OUT_EXECUTABLES
299#
300# The plain (non-abs) version just dumps the value of the named variable.
301# The "abs" version will treat the variable as a path, and dumps an
302# absolute path to it.
303#
304dumpvar_goals := \
305	$(strip $(patsubst dumpvar-%,%,$(filter dumpvar-%,$(MAKECMDGOALS))))
306ifdef dumpvar_goals
307
308  ifneq ($(words $(dumpvar_goals)),1)
309    $(error Only one "dumpvar-" goal allowed. Saw "$(MAKECMDGOALS)")
310  endif
311
312  # If the goal is of the form "dumpvar-abs-VARNAME", then
313  # treat VARNAME as a path and return the absolute path to it.
314  absolute_dumpvar := $(strip $(filter abs-%,$(dumpvar_goals)))
315  ifdef absolute_dumpvar
316    dumpvar_goals := $(patsubst abs-%,%,$(dumpvar_goals))
317    DUMPVAR_VALUE := $(PWD)/$($(dumpvar_goals))
318    dumpvar_target := dumpvar-abs-$(dumpvar_goals)
319  else
320    DUMPVAR_VALUE := $($(dumpvar_goals))
321    dumpvar_target := dumpvar-$(dumpvar_goals)
322  endif
323
324.PHONY: $(dumpvar_target)
325$(dumpvar_target):
326	@echo $(DUMPVAR_VALUE)
327
328endif # dumpvar_goals
329
330ifneq ($(dumpvar_goals),report_config)
331PRINT_BUILD_CONFIG:=
332endif
333
334endif # CALLED_FROM_SETUP
335
336
337ifneq ($(PRINT_BUILD_CONFIG),)
338$(info ============================================)
339$(info   PLATFORM_VERSION_CODENAME=$(PLATFORM_VERSION_CODENAME))
340$(info   PLATFORM_VERSION=$(PLATFORM_VERSION))
341$(info   TARGET_PRODUCT=$(TARGET_PRODUCT))
342$(info   TARGET_BUILD_VARIANT=$(TARGET_BUILD_VARIANT))
343$(info   TARGET_SIMULATOR=$(TARGET_SIMULATOR))
344$(info   TARGET_BUILD_TYPE=$(TARGET_BUILD_TYPE))
345$(info   TARGET_ARCH=$(TARGET_ARCH))
346$(info   HOST_ARCH=$(HOST_ARCH))
347$(info   HOST_OS=$(HOST_OS))
348$(info   HOST_BUILD_TYPE=$(HOST_BUILD_TYPE))
349$(info   BUILD_ID=$(BUILD_ID))
350$(info ============================================)
351endif
352