envsetup.mk revision 6474811d646153aeab111c1c0586b6ee53dcb0d2 
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 := 10
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# Build dalvikvm on hosts that support it, but not if we're building the sim
123ifeq ($(HOST_OS),linux)
124ifneq ($(TARGET_SIMULATOR),true)
125	WITH_HOST_DALVIK := true
126endif
127endif
128
129
130# ---------------------------------------------------------------
131# Set up configuration for target machine.
132# The following must be set:
133# 		TARGET_OS = { linux }
134# 		TARGET_ARCH = { arm | x86 }
135
136
137# if we're build the simulator, HOST_* is TARGET_* (except for BUILD_TYPE)
138# otherwise  it's <arch>-linux
139ifeq ($(TARGET_SIMULATOR),true)
140ifneq ($(HOST_OS),linux)
141$(error TARGET_SIMULATOR=true is only supported under Linux)
142endif
143TARGET_ARCH := $(HOST_ARCH)
144TARGET_OS := $(HOST_OS)
145else
146ifeq ($(TARGET_ARCH),)
147TARGET_ARCH := arm
148endif
149TARGET_OS := linux
150endif
151
152# the target build type defaults to release
153ifneq ($(TARGET_BUILD_TYPE),debug)
154TARGET_BUILD_TYPE := release
155endif
156
157# This is the standard way to name a directory containing prebuilt target
158# objects. E.g., prebuilt/$(TARGET_PREBUILT_TAG)/libc.so
159ifeq ($(TARGET_SIMULATOR),true)
160  TARGET_PREBUILT_TAG := $(TARGET_OS)-$(TARGET_ARCH)
161else
162  TARGET_PREBUILT_TAG := android-$(TARGET_ARCH)
163endif
164
165# ---------------------------------------------------------------
166# figure out the output directories
167
168ifeq (,$(strip $(OUT_DIR)))
169OUT_DIR := $(TOPDIR)out
170endif
171
172DEBUG_OUT_DIR := $(OUT_DIR)/debug
173
174# Move the host or target under the debug/ directory
175# if necessary.
176TARGET_OUT_ROOT_release := $(OUT_DIR)/target
177TARGET_OUT_ROOT_debug := $(DEBUG_OUT_DIR)/target
178TARGET_OUT_ROOT := $(TARGET_OUT_ROOT_$(TARGET_BUILD_TYPE))
179
180HOST_OUT_ROOT_release := $(OUT_DIR)/host
181HOST_OUT_ROOT_debug := $(DEBUG_OUT_DIR)/host
182HOST_OUT_ROOT := $(HOST_OUT_ROOT_$(HOST_BUILD_TYPE))
183
184HOST_OUT_release := $(HOST_OUT_ROOT_release)/$(HOST_OS)-$(HOST_ARCH)
185HOST_OUT_debug := $(HOST_OUT_ROOT_debug)/$(HOST_OS)-$(HOST_ARCH)
186HOST_OUT := $(HOST_OUT_$(HOST_BUILD_TYPE))
187
188BUILD_OUT := $(OUT_DIR)/host/$(BUILD_OS)-$(BUILD_ARCH)
189
190ifeq ($(TARGET_SIMULATOR),true)
191  # Any arch- or os-specific parts of the simulator (everything
192  # under product/) are actually host-dependent.
193  # But, the debug type is controlled by TARGET_BUILD_TYPE and not
194  # HOST_BUILD_TYPE.
195  TARGET_PRODUCT_OUT_ROOT := $(HOST_OUT_$(TARGET_BUILD_TYPE))/pr
196else
197  TARGET_PRODUCT_OUT_ROOT := $(TARGET_OUT_ROOT)/product
198endif
199
200TARGET_COMMON_OUT_ROOT := $(TARGET_OUT_ROOT)/common
201HOST_COMMON_OUT_ROOT := $(HOST_OUT_ROOT)/common
202
203PRODUCT_OUT := $(TARGET_PRODUCT_OUT_ROOT)/$(TARGET_DEVICE)
204
205OUT_DOCS := $(TARGET_COMMON_OUT_ROOT)/docs
206
207BUILD_OUT_EXECUTABLES:= $(BUILD_OUT)/bin
208
209HOST_OUT_EXECUTABLES:= $(HOST_OUT)/bin
210HOST_OUT_SHARED_LIBRARIES:= $(HOST_OUT)/lib
211HOST_OUT_JAVA_LIBRARIES:= $(HOST_OUT)/framework
212HOST_OUT_SDK_ADDON := $(HOST_OUT)/sdk_addon
213
214HOST_OUT_INTERMEDIATES := $(HOST_OUT)/obj
215HOST_OUT_HEADERS:= $(HOST_OUT_INTERMEDIATES)/include
216HOST_OUT_INTERMEDIATE_LIBRARIES := $(HOST_OUT_INTERMEDIATES)/lib
217HOST_OUT_STATIC_LIBRARIES := $(HOST_OUT_INTERMEDIATE_LIBRARIES)
218HOST_OUT_NOTICE_FILES:=$(HOST_OUT_INTERMEDIATES)/NOTICE_FILES
219HOST_OUT_COMMON_INTERMEDIATES := $(HOST_COMMON_OUT_ROOT)/obj
220
221TARGET_OUT_INTERMEDIATES := $(PRODUCT_OUT)/obj
222TARGET_OUT_HEADERS:= $(TARGET_OUT_INTERMEDIATES)/include
223TARGET_OUT_INTERMEDIATE_LIBRARIES := $(TARGET_OUT_INTERMEDIATES)/lib
224TARGET_OUT_COMMON_INTERMEDIATES := $(TARGET_COMMON_OUT_ROOT)/obj
225
226TARGET_OUT := $(PRODUCT_OUT)/system
227TARGET_OUT_EXECUTABLES:= $(TARGET_OUT)/bin
228TARGET_OUT_OPTIONAL_EXECUTABLES:= $(TARGET_OUT)/xbin
229TARGET_OUT_SHARED_LIBRARIES:= $(TARGET_OUT)/lib
230TARGET_OUT_JAVA_LIBRARIES:= $(TARGET_OUT)/framework
231TARGET_OUT_APPS:= $(TARGET_OUT)/app
232TARGET_OUT_KEYLAYOUT := $(TARGET_OUT)/usr/keylayout
233TARGET_OUT_KEYCHARS := $(TARGET_OUT)/usr/keychars
234TARGET_OUT_ETC := $(TARGET_OUT)/etc
235TARGET_OUT_STATIC_LIBRARIES:= $(TARGET_OUT_INTERMEDIATES)/lib
236TARGET_OUT_NOTICE_FILES:=$(TARGET_OUT_INTERMEDIATES)/NOTICE_FILES
237
238TARGET_OUT_DATA := $(PRODUCT_OUT)/data
239TARGET_OUT_DATA_EXECUTABLES:= $(TARGET_OUT_EXECUTABLES)
240TARGET_OUT_DATA_SHARED_LIBRARIES:= $(TARGET_OUT_SHARED_LIBRARIES)
241TARGET_OUT_DATA_JAVA_LIBRARIES:= $(TARGET_OUT_JAVA_LIBRARIES)
242TARGET_OUT_DATA_APPS:= $(TARGET_OUT_DATA)/app
243TARGET_OUT_DATA_KEYLAYOUT := $(TARGET_OUT_KEYLAYOUT)
244TARGET_OUT_DATA_KEYCHARS := $(TARGET_OUT_KEYCHARS)
245TARGET_OUT_DATA_ETC := $(TARGET_OUT_ETC)
246TARGET_OUT_DATA_STATIC_LIBRARIES:= $(TARGET_OUT_STATIC_LIBRARIES)
247
248TARGET_OUT_UNSTRIPPED := $(PRODUCT_OUT)/symbols
249TARGET_OUT_EXECUTABLES_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/system/bin
250TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/system/lib
251TARGET_ROOT_OUT_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)
252TARGET_ROOT_OUT_SBIN_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/sbin
253TARGET_ROOT_OUT_BIN_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/bin
254
255TARGET_ROOT_OUT := $(PRODUCT_OUT)/root
256TARGET_ROOT_OUT_BIN := $(TARGET_ROOT_OUT)/bin
257TARGET_ROOT_OUT_SBIN := $(TARGET_ROOT_OUT)/sbin
258TARGET_ROOT_OUT_ETC := $(TARGET_ROOT_OUT)/etc
259TARGET_ROOT_OUT_USR := $(TARGET_ROOT_OUT)/usr
260
261TARGET_RECOVERY_OUT := $(PRODUCT_OUT)/recovery
262TARGET_RECOVERY_ROOT_OUT := $(TARGET_RECOVERY_OUT)/root
263
264TARGET_SYSLOADER_OUT := $(PRODUCT_OUT)/sysloader
265TARGET_SYSLOADER_ROOT_OUT := $(TARGET_SYSLOADER_OUT)/root
266TARGET_SYSLOADER_SYSTEM_OUT := $(TARGET_SYSLOADER_OUT)/root/system
267
268TARGET_INSTALLER_OUT := $(PRODUCT_OUT)/installer
269TARGET_INSTALLER_DATA_OUT := $(TARGET_INSTALLER_OUT)/data
270TARGET_INSTALLER_ROOT_OUT := $(TARGET_INSTALLER_OUT)/root
271TARGET_INSTALLER_SYSTEM_OUT := $(TARGET_INSTALLER_OUT)/root/system
272
273COMMON_MODULE_CLASSES := JAVA_LIBRARIES NOTICE_FILES
274
275ifeq (,$(strip $(DIST_DIR)))
276  DIST_DIR := $(OUT_DIR)/dist
277endif
278
279ifeq ($(PRINT_BUILD_CONFIG),)
280PRINT_BUILD_CONFIG := true
281endif
282
283# ---------------------------------------------------------------
284# the setpath shell function in envsetup.sh uses this to figure out
285# what to add to the path given the config we have chosen.
286ifeq ($(CALLED_FROM_SETUP),true)
287
288ABP:=$(PWD)/$(HOST_OUT_EXECUTABLES)
289
290ifeq ($(TARGET_SIMULATOR),true)
291	ABP:=$(ABP):$(TARGET_OUT_EXECUTABLES)
292else
293	# this should be copied to HOST_OUT_EXECUTABLES instead
294	ABP:=$(ABP):$(PWD)/prebuilt/$(HOST_PREBUILT_TAG)/toolchain/arm-eabi-4.4.3/bin
295endif
296ANDROID_BUILD_PATHS := $(ABP)
297ANDROID_PREBUILTS := prebuilt/$(HOST_PREBUILT_TAG)
298
299# The "dumpvar" stuff lets you say something like
300#
301#     CALLED_FROM_SETUP=true \
302#       make -f config/envsetup.make dumpvar-TARGET_OUT
303# or
304#     CALLED_FROM_SETUP=true \
305#       make -f config/envsetup.make dumpvar-abs-HOST_OUT_EXECUTABLES
306#
307# The plain (non-abs) version just dumps the value of the named variable.
308# The "abs" version will treat the variable as a path, and dumps an
309# absolute path to it.
310#
311dumpvar_goals := \
312	$(strip $(patsubst dumpvar-%,%,$(filter dumpvar-%,$(MAKECMDGOALS))))
313ifdef dumpvar_goals
314
315  ifneq ($(words $(dumpvar_goals)),1)
316    $(error Only one "dumpvar-" goal allowed. Saw "$(MAKECMDGOALS)")
317  endif
318
319  # If the goal is of the form "dumpvar-abs-VARNAME", then
320  # treat VARNAME as a path and return the absolute path to it.
321  absolute_dumpvar := $(strip $(filter abs-%,$(dumpvar_goals)))
322  ifdef absolute_dumpvar
323    dumpvar_goals := $(patsubst abs-%,%,$(dumpvar_goals))
324    DUMPVAR_VALUE := $(PWD)/$($(dumpvar_goals))
325    dumpvar_target := dumpvar-abs-$(dumpvar_goals)
326  else
327    DUMPVAR_VALUE := $($(dumpvar_goals))
328    dumpvar_target := dumpvar-$(dumpvar_goals)
329  endif
330
331.PHONY: $(dumpvar_target)
332$(dumpvar_target):
333	@echo $(DUMPVAR_VALUE)
334
335endif # dumpvar_goals
336
337ifneq ($(dumpvar_goals),report_config)
338PRINT_BUILD_CONFIG:=
339endif
340
341endif # CALLED_FROM_SETUP
342
343
344ifneq ($(PRINT_BUILD_CONFIG),)
345$(info ============================================)
346$(info   PLATFORM_VERSION_CODENAME=$(PLATFORM_VERSION_CODENAME))
347$(info   PLATFORM_VERSION=$(PLATFORM_VERSION))
348$(info   TARGET_PRODUCT=$(TARGET_PRODUCT))
349$(info   TARGET_BUILD_VARIANT=$(TARGET_BUILD_VARIANT))
350$(info   TARGET_SIMULATOR=$(TARGET_SIMULATOR))
351$(info   TARGET_BUILD_TYPE=$(TARGET_BUILD_TYPE))
352$(info   TARGET_BUILD_APPS=$(TARGET_BUILD_APPS))
353$(info   TARGET_ARCH=$(TARGET_ARCH))
354$(info   HOST_ARCH=$(HOST_ARCH))
355$(info   HOST_OS=$(HOST_OS))
356$(info   HOST_BUILD_TYPE=$(HOST_BUILD_TYPE))
357$(info   BUILD_ID=$(BUILD_ID))
358$(info ============================================)
359endif
360