6 # Make sure there's something to build.
7 # It's possible to build a package that doesn't contain any classes.
8 ifeq (,$(strip $(LOCAL_SRC_FILES)$(all_res_assets)))
9 $(error $(LOCAL_PATH): Target java module does not define any source or resource files)
12 LOCAL_NO_STANDARD_LIBRARIES:=$(strip $(LOCAL_NO_STANDARD_LIBRARIES))
13 LOCAL_SDK_VERSION:=$(strip $(LOCAL_SDK_VERSION))
15 ifneq ($(LOCAL_SDK_VERSION),)
16 ifeq ($(LOCAL_NO_STANDARD_LIBRARIES),true)
17 $(error $(LOCAL_PATH): Must not define both LOCAL_NO_STANDARD_LIBRARIES and LOCAL_SDK_VERSION)
19 ifeq ($(strip $(filter $(LOCAL_SDK_VERSION),$(TARGET_AVAILABLE_SDK_VERSIONS))),)
20 $(error $(LOCAL_PATH): Invalid LOCAL_SDK_VERSION '$(LOCAL_SDK_VERSION)' \
21 Choices are: $(TARGET_AVAILABLE_SDK_VERSIONS))
23 LOCAL_JAVA_LIBRARIES := android_stubs_$(LOCAL_SDK_VERSION) $(LOCAL_JAVA_LIBRARIES)
27 ifneq ($(LOCAL_NO_STANDARD_LIBRARIES),true)
28 LOCAL_JAVA_LIBRARIES := core ext framework $(LOCAL_JAVA_LIBRARIES)
32 LOCAL_BUILT_MODULE_STEM := $(strip $(LOCAL_BUILT_MODULE_STEM))
33 ifeq ($(LOCAL_BUILT_MODULE_STEM),)
34 $(error $(LOCAL_PATH): Target java template must define LOCAL_BUILT_MODULE_STEM)
36 ifneq ($(filter classes-compiled.jar classes.jar,$(LOCAL_BUILT_MODULE_STEM)),)
37 $(error LOCAL_BUILT_MODULE_STEM may not be "$(LOCAL_BUILT_MODULE_STEM)")
40 #######################################
41 include $(BUILD_SYSTEM)/base_rules.mk
42 #######################################
44 # We use intermediates.COMMON because the classes.jar/.dex files will be
45 # common even if LOCAL_BUILT_MODULE isn't.
47 # Override some target variables that base_rules set up for us.
48 $(LOCAL_INTERMEDIATE_TARGETS): \
49 PRIVATE_CLASS_INTERMEDIATES_DIR := $(intermediates.COMMON)/classes
50 $(LOCAL_INTERMEDIATE_TARGETS): \
51 PRIVATE_SOURCE_INTERMEDIATES_DIR := $(intermediates.COMMON)/src
53 # Since we're using intermediates.COMMON, make sure that it gets cleaned
55 $(cleantarget): PRIVATE_CLEAN_FILES += $(intermediates.COMMON)
57 # If the module includes java code (i.e., it's not framework-res), compile it.
60 ifneq (,$(strip $(all_java_sources)))
62 # If LOCAL_BUILT_MODULE_STEM wasn't overridden by our caller,
63 # full_classes_jar will be the same module as LOCAL_BUILT_MODULE.
64 # Otherwise, the caller will define it as a prerequisite of
65 # LOCAL_BUILT_MODULE, so it will inherit the necessary PRIVATE_*
66 # variable definitions.
67 full_classes_jar := $(intermediates.COMMON)/classes.jar
69 # Droiddoc isn't currently able to generate stubs for modules, so we're just
70 # allowing it to use the classes.jar as the "stubs" that would be use to link
71 # against, for the cases where someone needs the jar to link against.
72 # - Use the classes.jar instead of the handful of other intermediates that
73 # we have, because it's the most processed, but still hasn't had dex run on
74 # it, so it's closest to what's on the device.
75 # - This extra copy, with the dependency on LOCAL_BUILT_MODULE allows the
76 # PRIVATE_ vars to be preserved.
77 full_classes_stubs_jar := $(intermediates.COMMON)/stubs.jar
78 $(full_classes_stubs_jar): PRIVATE_SOURCE_FILE := $(full_classes_jar)
79 $(full_classes_stubs_jar) : $(LOCAL_BUILT_MODULE) | $(ACP)
80 @echo Copying $(PRIVATE_SOURCE_FILE)
81 $(hide) $(ACP) -fp $(PRIVATE_SOURCE_FILE) $@
82 ALL_MODULES.$(LOCAL_MODULE).STUBS := $(full_classes_stubs_jar)
84 # Emma source code coverage
85 ifneq ($(EMMA_INSTRUMENT),true)
86 LOCAL_NO_EMMA_INSTRUMENT := true
87 LOCAL_NO_EMMA_COMPILE := true
90 # Choose leaf name for the compiled jar file.
91 ifneq ($(LOCAL_NO_EMMA_COMPILE),true)
92 full_classes_compiled_jar_leaf := classes-no-debug-var.jar
94 full_classes_compiled_jar_leaf := classes-full-debug.jar
97 # Compile the java files to a .jar file.
98 # This intentionally depends on java_sources, not all_java_sources.
99 # Deps for generated source files must be handled separately,
100 # via deps on the target that generates the sources.
101 full_classes_compiled_jar := $(intermediates.COMMON)/$(full_classes_compiled_jar_leaf)
102 $(full_classes_compiled_jar): $(java_sources) $(full_java_lib_deps)
103 $(transform-java-to-classes.jar)
105 ifneq ($(LOCAL_NO_EMMA_COMPILE),true)
106 # If you instrument class files that have local variable debug information in
107 # them emma does not correctly maintain the local variable table.
108 # This will cause an error when you try to convert the class files for Android.
109 # The workaround for this to compile the java classes with only
110 # line and source debug information, not local information.
111 $(full_classes_compiled_jar): PRIVATE_JAVAC_DEBUG_FLAGS := -g:{lines,source}
113 # when emma is off, compile with the default flags, which contain full debug
115 $(full_classes_compiled_jar): PRIVATE_JAVAC_DEBUG_FLAGS := -g
118 emma_intermediates_dir := $(intermediates.COMMON)/emma_out
119 # the 'lib/$(full_classes_compiled_jar_leaf)' portion of this path is fixed in
121 full_classes_emma_jar := $(emma_intermediates_dir)/lib/$(full_classes_compiled_jar_leaf)
123 ifeq ($(LOCAL_IS_STATIC_JAVA_LIBRARY),true)
124 # Skip adding emma instrumentation to class files if this is a static library,
125 # since it will be instrumented by the package that includes it
126 LOCAL_NO_EMMA_INSTRUMENT:= true
129 ifneq ($(LOCAL_NO_EMMA_INSTRUMENT),true)
130 $(full_classes_emma_jar): PRIVATE_EMMA_COVERAGE_FILE := $(intermediates.COMMON)/coverage.em
131 $(full_classes_emma_jar): PRIVATE_EMMA_INTERMEDIATES_DIR := $(emma_intermediates_dir)
132 # this rule will generate both $(PRIVATE_EMMA_COVERAGE_FILE) and
133 # $(full_classes_emma_jar)
134 $(full_classes_emma_jar): $(full_classes_compiled_jar)
135 $(transform-classes.jar-to-emma)
136 $(PRIVATE_EMMA_COVERAGE_FILE): $(full_classes_emma_jar)
138 $(full_classes_emma_jar): $(full_classes_compiled_jar) | $(ACP)
140 $(copy-file-to-target)
143 # Run jarjar if necessary, otherwise just copy the file. This is the last
144 # part of this step, so the output of this command is full_classes_jar.
145 full_classes_jarjar_jar := $(full_classes_jar)
146 ifneq ($(strip $(LOCAL_JARJAR_RULES)),)
147 $(full_classes_jarjar_jar): PRIVATE_JARJAR_RULES := $(LOCAL_JARJAR_RULES)
148 $(full_classes_jarjar_jar): $(full_classes_emma_jar) | jarjar
150 $(hide) $(JARJAR) process $(PRIVATE_JARJAR_RULES) $< $@
152 $(full_classes_jarjar_jar): $(full_classes_emma_jar) | $(ACP)
158 built_dex := $(intermediates.COMMON)/classes.dex
160 # Override PRIVATE_INTERMEDIATES_DIR so that install-dex-debug
161 # will work even when intermediates != intermediates.COMMON.
162 $(built_dex): PRIVATE_INTERMEDIATES_DIR := $(intermediates.COMMON)
163 $(built_dex): PRIVATE_DX_FLAGS := $(LOCAL_DX_FLAGS)
164 $(built_dex): $(full_classes_jar) $(DX)
165 $(transform-classes.jar-to-dex)
166 ifneq ($(GENERATE_DEX_DEBUG),)
170 findbugs_xml := $(intermediates.COMMON)/findbugs.xml
171 $(findbugs_xml) : PRIVATE_JAR_FILE := $(full_classes_jar)
172 $(findbugs_xml) : PRIVATE_AUXCLASSPATH := $(addprefix -auxclasspath ,$(strip \
173 $(call normalize-path-list,$(filter %.jar,\
174 $(full_java_libs)))))
175 # We can't depend directly on full_classes_jar because the PRIVATE_
176 # vars won't be set up correctly.
177 $(findbugs_xml) : $(LOCAL_BUILT_MODULE)
179 $(hide) $(FINDBUGS) -textui -effort:min -xml:withMessages \
180 $(PRIVATE_AUXCLASSPATH) \
181 $(PRIVATE_JAR_FILE) \
184 ALL_FINDBUGS_FILES += $(findbugs_xml)
186 findbugs_html := $(PRODUCT_OUT)/findbugs/$(LOCAL_MODULE).html
187 $(findbugs_html) : PRIVATE_XML_FILE := $(findbugs_xml)
188 $(LOCAL_MODULE)-findbugs : $(findbugs_html)
189 $(findbugs_html) : $(findbugs_xml)
191 @echo ConvertXmlToText: $@
192 $(hide) prebuilt/common/findbugs/bin/convertXmlToText -html:fancy.xsl $(PRIVATE_XML_FILE) \
195 $(LOCAL_MODULE)-findbugs : $(findbugs_html)