1 ###########################################################
2 ## Standard rules for building binary object files from
3 ## asm/c/cpp/yacc/lex source files.
5 ## The list of object files is exported in $(all_objects).
6 ###########################################################
8 #######################################
9 include $(BUILD_SYSTEM)/base_rules.mk
10 #######################################
12 ###########################################################
13 ## Define PRIVATE_ variables used by multiple module types
14 ###########################################################
15 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_NO_DEFAULT_COMPILER_FLAGS := \
16 $(strip $(LOCAL_NO_DEFAULT_COMPILER_FLAGS))
18 ifeq ($(strip $(LOCAL_CC)),)
19 LOCAL_CC := $($(my_prefix)CC)
21 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_CC := $(LOCAL_CC)
23 ifeq ($(strip $(LOCAL_CXX)),)
24 LOCAL_CXX := $($(my_prefix)CXX)
26 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_CXX := $(LOCAL_CXX)
28 # TODO: support a mix of standard extensions so that this isn't necessary
29 LOCAL_CPP_EXTENSION := $(strip $(LOCAL_CPP_EXTENSION))
30 ifeq ($(LOCAL_CPP_EXTENSION),)
31 LOCAL_CPP_EXTENSION := .cpp
33 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_CPP_EXTENSION := $(LOCAL_CPP_EXTENSION)
35 # Certain modules like libdl have to have symbols resolved at runtime and blow
36 # up if --no-undefined is passed to the linker.
37 ifeq ($(strip $(LOCAL_NO_DEFAULT_COMPILER_FLAGS)),)
38 ifeq ($(strip $(LOCAL_ALLOW_UNDEFINED_SYMBOLS)),)
39 LOCAL_LDFLAGS := $(LOCAL_LDFLAGS) $($(my_prefix)NO_UNDEFINED_LDFLAGS)
43 ###########################################################
44 ## Define arm-vs-thumb-mode flags.
45 ###########################################################
46 LOCAL_ARM_MODE := $(strip $(LOCAL_ARM_MODE))
47 arm_objects_mode := $(if $(LOCAL_ARM_MODE),$(LOCAL_ARM_MODE),arm)
48 normal_objects_mode := $(if $(LOCAL_ARM_MODE),$(LOCAL_ARM_MODE),thumb)
50 # Read the values from something like TARGET_arm_CFLAGS or
51 # TARGET_thumb_CFLAGS. HOST_(arm|thumb)_CFLAGS values aren't
52 # actually used (although they are usually empty).
53 arm_objects_cflags := $($(my_prefix)$(arm_objects_mode)_CFLAGS)
54 normal_objects_cflags := $($(my_prefix)$(normal_objects_mode)_CFLAGS)
56 ###########################################################
57 ## Define per-module debugging flags. Users can turn on
58 ## debugging for a particular module by setting DEBUG_MODULE_ModuleName
59 ## to a non-empty value in their environment or buildspec.mk,
60 ## and setting HOST_/TARGET_CUSTOM_DEBUG_CFLAGS to the
61 ## debug flags that they want to use.
62 ###########################################################
63 ifdef DEBUG_MODULE_$(strip $(LOCAL_MODULE))
64 debug_cflags := $($(my_prefix)CUSTOM_DEBUG_CFLAGS)
69 ###########################################################
70 ## Stuff source generated from one-off tools
71 ###########################################################
72 $(LOCAL_GENERATED_SOURCES): PRIVATE_MODULE := $(LOCAL_MODULE)
74 ALL_GENERATED_SOURCES += $(LOCAL_GENERATED_SOURCES)
77 ###########################################################
78 ## YACC: Compile .y files to .cpp and the to .o.
79 ###########################################################
81 yacc_sources := $(filter %.y,$(LOCAL_SRC_FILES))
82 yacc_cpps := $(addprefix \
83 $(intermediates)/,$(yacc_sources:.y=$(LOCAL_CPP_EXTENSION)))
84 yacc_headers := $(yacc_cpps:$(LOCAL_CPP_EXTENSION)=.h)
85 yacc_objects := $(yacc_cpps:$(LOCAL_CPP_EXTENSION)=.o)
87 ifneq ($(strip $(yacc_cpps)),)
88 $(yacc_cpps): $(intermediates)/%$(LOCAL_CPP_EXTENSION): \
89 $(TOPDIR)$(LOCAL_PATH)/%.y \
90 $(lex_cpps) $(PRIVATE_ADDITIONAL_DEPENDENCIES)
91 $(call transform-y-to-cpp,$(PRIVATE_CPP_EXTENSION))
92 $(yacc_headers): $(intermediates)/%.h: $(intermediates)/%$(LOCAL_CPP_EXTENSION)
94 $(yacc_objects): PRIVATE_ARM_MODE := $(normal_objects_mode)
95 $(yacc_objects): PRIVATE_ARM_CFLAGS := $(normal_objects_cflags)
96 $(yacc_objects): $(intermediates)/%.o: $(intermediates)/%$(LOCAL_CPP_EXTENSION)
97 $(transform-$(PRIVATE_HOST)cpp-to-o)
100 ###########################################################
101 ## LEX: Compile .l files to .cpp and then to .o.
102 ###########################################################
104 lex_sources := $(filter %.l,$(LOCAL_SRC_FILES))
105 lex_cpps := $(addprefix \
106 $(intermediates)/,$(lex_sources:.l=$(LOCAL_CPP_EXTENSION)))
107 lex_objects := $(lex_cpps:$(LOCAL_CPP_EXTENSION)=.o)
109 ifneq ($(strip $(lex_cpps)),)
110 $(lex_cpps): $(intermediates)/%$(LOCAL_CPP_EXTENSION): \
111 $(TOPDIR)$(LOCAL_PATH)/%.l
112 $(transform-l-to-cpp)
114 $(lex_objects): PRIVATE_ARM_MODE := $(normal_objects_mode)
115 $(lex_objects): PRIVATE_ARM_CFLAGS := $(normal_objects_cflags)
116 $(lex_objects): $(intermediates)/%.o: \
117 $(intermediates)/%$(LOCAL_CPP_EXTENSION) \
118 $(PRIVATE_ADDITIONAL_DEPENDENCIES) \
120 $(transform-$(PRIVATE_HOST)cpp-to-o)
123 ###########################################################
124 ## C++: Compile .cpp files to .o.
125 ###########################################################
127 # we also do this on host modules and sim builds, even though
128 # it's not really arm, because there are files that are shared.
129 cpp_arm_sources := $(patsubst %$(LOCAL_CPP_EXTENSION).arm,%$(LOCAL_CPP_EXTENSION),$(filter %$(LOCAL_CPP_EXTENSION).arm,$(LOCAL_SRC_FILES)))
130 cpp_arm_objects := $(addprefix $(intermediates)/,$(cpp_arm_sources:$(LOCAL_CPP_EXTENSION)=.o))
132 cpp_normal_sources := $(filter %$(LOCAL_CPP_EXTENSION),$(LOCAL_SRC_FILES))
133 cpp_normal_objects := $(addprefix $(intermediates)/,$(cpp_normal_sources:$(LOCAL_CPP_EXTENSION)=.o))
135 $(cpp_arm_objects): PRIVATE_ARM_MODE := $(arm_objects_mode)
136 $(cpp_arm_objects): PRIVATE_ARM_CFLAGS := $(arm_objects_cflags)
137 $(cpp_normal_objects): PRIVATE_ARM_MODE := $(normal_objects_mode)
138 $(cpp_normal_objects): PRIVATE_ARM_CFLAGS := $(normal_objects_cflags)
140 cpp_objects := $(cpp_arm_objects) $(cpp_normal_objects)
142 ifneq ($(strip $(cpp_objects)),)
143 $(cpp_objects): $(intermediates)/%.o: \
144 $(TOPDIR)$(LOCAL_PATH)/%$(LOCAL_CPP_EXTENSION) \
145 $(yacc_cpps) $(PRIVATE_ADDITIONAL_DEPENDENCIES)
146 $(transform-$(PRIVATE_HOST)cpp-to-o)
147 -include $(cpp_objects:%.o=%.P)
150 ###########################################################
151 ## C++: Compile generated .cpp files to .o.
152 ###########################################################
154 gen_cpp_sources := $(filter %$(LOCAL_CPP_EXTENSION),$(LOCAL_GENERATED_SOURCES))
155 gen_cpp_objects := $(gen_cpp_sources:%$(LOCAL_CPP_EXTENSION)=%.o)
157 ifneq ($(strip $(gen_cpp_objects)),)
158 # Compile all generated files as thumb.
159 # TODO: support compiling certain generated files as arm.
160 $(gen_cpp_objects): PRIVATE_ARM_MODE := $(normal_objects_mode)
161 $(gen_cpp_objects): PRIVATE_ARM_CFLAGS := $(normal_objects_cflags)
162 $(gen_cpp_objects): $(intermediates)/%.o: $(intermediates)/%$(LOCAL_CPP_EXTENSION) $(yacc_cpps) $(PRIVATE_ADDITIONAL_DEPENDENCIES)
163 $(transform-$(PRIVATE_HOST)cpp-to-o)
164 -include $(gen_cpp_objects:%.o=%.P)
167 ###########################################################
168 ## S: Compile generated .S and .s files to .o.
169 ###########################################################
171 gen_S_sources := $(filter %.S,$(LOCAL_GENERATED_SOURCES))
172 gen_S_objects := $(gen_S_sources:%.S=%.o)
174 ifneq ($(strip $(gen_S_sources)),)
175 $(gen_S_objects): $(intermediates)/%.o: $(intermediates)/%.S $(PRIVATE_ADDITIONAL_DEPENDENCIES)
176 $(transform-$(PRIVATE_HOST)s-to-o)
177 -include $(gen_S_objects:%.o=%.P)
180 gen_s_sources := $(filter %.s,$(LOCAL_GENERATED_SOURCES))
181 gen_s_objects := $(gen_s_sources:%.s=%.o)
183 ifneq ($(strip $(gen_s_objects)),)
184 $(gen_s_objects): $(intermediates)/%.o: $(intermediates)/%.s $(PRIVATE_ADDITIONAL_DEPENDENCIES)
185 $(transform-$(PRIVATE_HOST)s-to-o-no-deps)
186 -include $(gen_s_objects:%.o=%.P)
189 gen_asm_objects := $(gen_S_objects) $(gen_s_objects)
191 ###########################################################
192 ## C: Compile .c files to .o.
193 ###########################################################
195 c_arm_sources := $(patsubst %.c.arm,%.c,$(filter %.c.arm,$(LOCAL_SRC_FILES)))
196 c_arm_objects := $(addprefix $(intermediates)/,$(c_arm_sources:.c=.o))
198 c_normal_sources := $(filter %.c,$(LOCAL_SRC_FILES))
199 c_normal_objects := $(addprefix $(intermediates)/,$(c_normal_sources:.c=.o))
201 $(c_arm_objects): PRIVATE_ARM_MODE := $(arm_objects_mode)
202 $(c_arm_objects): PRIVATE_ARM_CFLAGS := $(arm_objects_cflags)
203 $(c_normal_objects): PRIVATE_ARM_MODE := $(normal_objects_mode)
204 $(c_normal_objects): PRIVATE_ARM_CFLAGS := $(normal_objects_cflags)
206 c_objects := $(c_arm_objects) $(c_normal_objects)
208 ifneq ($(strip $(c_objects)),)
209 $(c_objects): $(intermediates)/%.o: $(TOPDIR)$(LOCAL_PATH)/%.c $(yacc_cpps) $(PRIVATE_ADDITIONAL_DEPENDENCIES)
210 $(transform-$(PRIVATE_HOST)c-to-o)
211 -include $(c_objects:%.o=%.P)
214 ###########################################################
215 ## ObjC: Compile .m files to .o
216 ###########################################################
218 objc_sources := $(filter %.m,$(LOCAL_SRC_FILES))
219 objc_objects := $(addprefix $(intermediates)/,$(objc_sources:.m=.o))
221 ifneq ($(strip $(objc_objects)),)
222 $(objc_objects): $(intermediates)/%.o: $(TOPDIR)$(LOCAL_PATH)/%.m $(yacc_cpps) $(PRIVATE_ADDITIONAL_DEPENDENCIES)
223 $(transform-$(PRIVATE_HOST)m-to-o)
224 -include $(objc_objects:%.o=%.P)
227 ###########################################################
228 ## AS: Compile .S files to .o.
229 ###########################################################
231 asm_sources_S := $(filter %.S,$(LOCAL_SRC_FILES))
232 asm_objects_S := $(addprefix $(intermediates)/,$(asm_sources_S:.S=.o))
234 ifneq ($(strip $(asm_objects_S)),)
235 $(asm_objects_S): $(intermediates)/%.o: $(TOPDIR)$(LOCAL_PATH)/%.S $(PRIVATE_ADDITIONAL_DEPENDENCIES)
236 $(transform-$(PRIVATE_HOST)s-to-o)
237 -include $(asm_objects_S:%.o=%.P)
240 asm_sources_s := $(filter %.s,$(LOCAL_SRC_FILES))
241 asm_objects_s := $(addprefix $(intermediates)/,$(asm_sources_s:.s=.o))
243 ifneq ($(strip $(asm_objects_s)),)
244 $(asm_objects_s): $(intermediates)/%.o: $(TOPDIR)$(LOCAL_PATH)/%.s $(PRIVATE_ADDITIONAL_DEPENDENCIES)
245 $(transform-$(PRIVATE_HOST)s-to-o-no-deps)
246 -include $(asm_objects_s:%.o=%.P)
249 asm_objects := $(asm_objects_S) $(asm_objects_s)
252 ###########################################################
253 ## Common object handling.
254 ###########################################################
256 # some rules depend on asm_objects being first. If your code depends on
257 # being first, it's reasonable to require it to be assembly
266 $(addprefix $(TOPDIR)$(LOCAL_PATH)/,$(LOCAL_PREBUILT_OBJ_FILES))
268 LOCAL_C_INCLUDES += $(TOPDIR)$(LOCAL_PATH) $(intermediates) $(base_intermediates)
270 $(all_objects) : | $(LOCAL_GENERATED_SOURCES)
271 ALL_C_CPP_ETC_OBJECTS += $(all_objects)
273 ###########################################################
274 ## Copy headers to the install tree
275 ###########################################################
276 include $(BUILD_COPY_HEADERS)
278 ###########################################################
279 # Standard library handling.
281 # On the target, we compile with -nostdlib, so we must add in the
282 # default system shared libraries, unless they have requested not
283 # to by supplying a LOCAL_SYSTEM_SHARED_LIBRARIES value. One would
284 # supply that, for example, when building libc itself.
285 ###########################################################
286 ifndef LOCAL_IS_HOST_MODULE
287 ifeq ($(LOCAL_SYSTEM_SHARED_LIBRARIES),none)
288 LOCAL_SHARED_LIBRARIES += $($(my_prefix)DEFAULT_SYSTEM_SHARED_LIBRARIES)
290 LOCAL_SHARED_LIBRARIES += $(LOCAL_SYSTEM_SHARED_LIBRARIES)
294 # Logging used to be part of libcutils (target) and libutils (sim);
295 # hack modules that use those other libs to also include liblog.
296 # All of this complexity is to make sure that liblog only appears
297 # once, and appears just before libcutils or libutils on the link
299 # TODO: remove this hack and change all modules to use liblog
302 $(if $(filter liblog,$(1)),$(1), \
303 $(if $(filter libcutils,$(1)), \
304 $(patsubst libcutils,liblog libcutils,$(1)) \
306 $(patsubst libutils,liblog libutils,$(1)) \
310 ifneq (,$(filter libcutils libutils,$(LOCAL_SHARED_LIBRARIES)))
311 LOCAL_SHARED_LIBRARIES := $(call insert-liblog,$(LOCAL_SHARED_LIBRARIES))
313 ifneq (,$(filter libcutils libutils,$(LOCAL_STATIC_LIBRARIES)))
314 LOCAL_STATIC_LIBRARIES := $(call insert-liblog,$(LOCAL_STATIC_LIBRARIES))
316 ifneq (,$(filter libcutils libutils,$(LOCAL_WHOLE_STATIC_LIBRARIES)))
317 LOCAL_WHOLE_STATIC_LIBRARIES := $(call insert-liblog,$(LOCAL_WHOLE_STATIC_LIBRARIES))
320 ###########################################################
321 # The list of libraries that this module will link against are in
322 # these variables. Each is a list of bare module names like "libc libm".
324 # LOCAL_SHARED_LIBRARIES
325 # LOCAL_STATIC_LIBRARIES
326 # LOCAL_WHOLE_STATIC_LIBRARIES
328 # We need to convert the bare names into the dependencies that
329 # we'll use for LOCAL_BUILT_MODULE and LOCAL_INSTALLED_MODULE.
330 # LOCAL_BUILT_MODULE should depend on the BUILT versions of the
331 # libraries, so that simply building this module doesn't force
332 # an install of a library. Similarly, LOCAL_INSTALLED_MODULE
333 # should depend on the INSTALLED versions of the libraries so
334 # that they get installed when this module does.
335 ###########################################################
337 # WHOLE_STATIC_LIBRARIES are libraries that are pulled into the
338 # module without leaving anything out, which is useful for turning
339 # a collection of .a files into a .so file. Linking against a
340 # normal STATIC_LIBRARY will only pull in code/symbols that are
341 # referenced by the module. (see gcc/ld's --whole-archive option)
342 ###########################################################
344 # Get the list of BUILT libraries, which are under
345 # various intermediates directories.
346 so_suffix := $($(my_prefix)SHLIB_SUFFIX)
347 a_suffix := $($(my_prefix)STATIC_LIB_SUFFIX)
349 built_shared_libraries := \
350 $(addprefix $($(my_prefix)OUT_INTERMEDIATE_LIBRARIES)/, \
351 $(addsuffix $(so_suffix), \
352 $(LOCAL_SHARED_LIBRARIES)))
354 built_static_libraries := \
355 $(foreach lib,$(LOCAL_STATIC_LIBRARIES), \
356 $(call intermediates-dir-for, \
357 STATIC_LIBRARIES,$(lib),$(LOCAL_IS_HOST_MODULE))/$(lib)$(a_suffix))
359 built_whole_libraries := \
360 $(foreach lib,$(LOCAL_WHOLE_STATIC_LIBRARIES), \
361 $(call intermediates-dir-for, \
362 STATIC_LIBRARIES,$(lib),$(LOCAL_IS_HOST_MODULE))/$(lib)$(a_suffix))
364 # Get the list of INSTALLED libraries. Strip off the various
365 # intermediates directories and point to the common lib dirs.
366 installed_shared_libraries := \
367 $(addprefix $($(my_prefix)OUT_SHARED_LIBRARIES)/, \
368 $(notdir $(built_shared_libraries)))
370 # We don't care about installed static libraries, since the
371 # libraries have already been linked into the module at that point.
372 # We do, however, care about the NOTICE files for any static
373 # libraries that we use. (see notice_files.make)
375 installed_static_library_notice_file_targets := \
376 $(foreach lib,$(LOCAL_STATIC_LIBRARIES) $(LOCAL_WHOLE_STATIC_LIBRARIES), \
377 NOTICE-$(if $(LOCAL_IS_HOST_MODULE),HOST,TARGET)-STATIC_LIBRARIES-$(lib))
379 ###########################################################
380 # Rule-specific variable definitions
381 ###########################################################
382 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_YACCFLAGS := $(LOCAL_YACCFLAGS)
383 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_ASFLAGS := $(LOCAL_ASFLAGS)
384 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_CFLAGS := $(LOCAL_CFLAGS)
385 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_CPPFLAGS := $(LOCAL_CPPFLAGS)
386 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_DEBUG_CFLAGS := $(debug_cflags)
387 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_C_INCLUDES := $(LOCAL_C_INCLUDES)
388 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_LDFLAGS := $(LOCAL_LDFLAGS)
389 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_LDLIBS := $(LOCAL_LDLIBS)
391 # this is really the way to get the files onto the command line instead
392 # of using $^, because then LOCAL_ADDITIONAL_DEPENDENCIES doesn't work
393 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_ALL_SHARED_LIBRARIES := $(built_shared_libraries)
394 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_ALL_STATIC_LIBRARIES := $(built_static_libraries)
395 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_ALL_WHOLE_STATIC_LIBRARIES := $(built_whole_libraries)
396 $(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_ALL_OBJECTS := $(all_objects)
398 ###########################################################
399 # Define library dependencies.
400 ###########################################################
401 # all_libraries is used for the dependencies on LOCAL_BUILT_MODULE.
403 $(built_shared_libraries) \
404 $(built_static_libraries) \
405 $(built_whole_libraries)
407 # Make LOCAL_INSTALLED_MODULE depend on the installed versions of the
408 # libraries so they get installed along with it. We don't need to
409 # rebuild it when installing it, though, so this can be an order-only
411 $(LOCAL_INSTALLED_MODULE): | $(installed_shared_libraries)
413 # Also depend on the notice files for any static libraries that
414 # are linked into this module. This will force them to be installed
415 # when this module is.
416 $(LOCAL_INSTALLED_MODULE): | $(installed_static_library_notice_file_targets)