64d85d0d82
Original change by joeo@abreu on 2009/04/06 19:54:13. Implement SDK add-ons in the build system. - Add an option to use the standard javadoc doclet instead of droiddoc, since droiddocs non-sdk templates aren't ready for prime time. - Add the notion of a stubs for a library. It's only implemented for java libraries, but when we do native libraries in the NDK or sdk-addons, it will work there too. Original author: joeo Merged from: //branches/cupcake/... Automated import of CL 145618
198 lines
7.7 KiB
Makefile
198 lines
7.7 KiB
Makefile
# Requires:
|
|
# LOCAL_MODULE_SUFFIX
|
|
# LOCAL_MODULE_CLASS
|
|
# all_res_assets
|
|
|
|
# Make sure there's something to build.
|
|
# It's possible to build a package that doesn't contain any classes.
|
|
ifeq (,$(strip $(LOCAL_SRC_FILES)$(all_res_assets)))
|
|
$(error $(LOCAL_PATH): Target java module does not define any source or resource files)
|
|
endif
|
|
|
|
LOCAL_NO_STANDARD_LIBRARIES:=$(strip $(LOCAL_NO_STANDARD_LIBRARIES))
|
|
LOCAL_SDK_VERSION:=$(strip $(LOCAL_SDK_VERSION))
|
|
|
|
ifneq ($(LOCAL_SDK_VERSION),)
|
|
ifeq ($(LOCAL_NO_STANDARD_LIBRARIES),true)
|
|
$(error $(LOCAL_PATH): Must not define both LOCAL_NO_STANDARD_LIBRARIES and LOCAL_SDK_VERSION)
|
|
else
|
|
ifeq ($(strip $(filter $(LOCAL_SDK_VERSION),$(TARGET_AVAILABLE_SDK_VERSIONS))),)
|
|
$(error $(LOCAL_PATH): Invalid LOCAL_SDK_VERSION '$(LOCAL_SDK_VERSION)' \
|
|
Choices are: $(TARGET_AVAILABLE_SDK_VERSIONS))
|
|
else
|
|
LOCAL_JAVA_LIBRARIES := android_stubs_$(LOCAL_SDK_VERSION) $(LOCAL_JAVA_LIBRARIES)
|
|
endif
|
|
endif
|
|
else
|
|
ifneq ($(LOCAL_NO_STANDARD_LIBRARIES),true)
|
|
LOCAL_JAVA_LIBRARIES := core ext framework $(LOCAL_JAVA_LIBRARIES)
|
|
endif
|
|
endif
|
|
|
|
LOCAL_BUILT_MODULE_STEM := $(strip $(LOCAL_BUILT_MODULE_STEM))
|
|
ifeq ($(LOCAL_BUILT_MODULE_STEM),)
|
|
$(error $(LOCAL_PATH): Target java template must define LOCAL_BUILT_MODULE_STEM)
|
|
endif
|
|
ifneq ($(filter classes-compiled.jar classes.jar,$(LOCAL_BUILT_MODULE_STEM)),)
|
|
$(error LOCAL_BUILT_MODULE_STEM may not be "$(LOCAL_BUILT_MODULE_STEM)")
|
|
endif
|
|
|
|
#######################################
|
|
include $(BUILD_SYSTEM)/base_rules.mk
|
|
#######################################
|
|
|
|
# We use intermediates.COMMON because the classes.jar/.dex files will be
|
|
# common even if LOCAL_BUILT_MODULE isn't.
|
|
#
|
|
# Override some target variables that base_rules set up for us.
|
|
$(LOCAL_INTERMEDIATE_TARGETS): \
|
|
PRIVATE_CLASS_INTERMEDIATES_DIR := $(intermediates.COMMON)/classes
|
|
$(LOCAL_INTERMEDIATE_TARGETS): \
|
|
PRIVATE_SOURCE_INTERMEDIATES_DIR := $(intermediates.COMMON)/src
|
|
|
|
# Since we're using intermediates.COMMON, make sure that it gets cleaned
|
|
# properly.
|
|
$(cleantarget): PRIVATE_CLEAN_FILES += $(intermediates.COMMON)
|
|
|
|
# If the module includes java code (i.e., it's not framework-res), compile it.
|
|
full_classes_jar :=
|
|
built_dex :=
|
|
ifneq (,$(strip $(all_java_sources)))
|
|
|
|
# If LOCAL_BUILT_MODULE_STEM wasn't overridden by our caller,
|
|
# full_classes_jar will be the same module as LOCAL_BUILT_MODULE.
|
|
# Otherwise, the caller will define it as a prerequisite of
|
|
# LOCAL_BUILT_MODULE, so it will inherit the necessary PRIVATE_*
|
|
# variable definitions.
|
|
full_classes_jar := $(intermediates.COMMON)/classes.jar
|
|
|
|
# Droiddoc isn't currently able to generate stubs for modules, so we're just
|
|
# allowing it to use the classes.jar as the "stubs" that would be use to link
|
|
# against, for the cases where someone needs the jar to link against.
|
|
# - Use the classes.jar instead of the handful of other intermediates that
|
|
# we have, because it's the most processed, but still hasn't had dex run on
|
|
# it, so it's closest to what's on the device.
|
|
# - This extra copy, with the dependency on LOCAL_BUILT_MODULE allows the
|
|
# PRIVATE_ vars to be preserved.
|
|
full_classes_stubs_jar := $(intermediates.COMMON)/stubs.jar
|
|
$(full_classes_stubs_jar): PRIVATE_SOURCE_FILE := $(full_classes_jar)
|
|
$(full_classes_stubs_jar) : $(LOCAL_BUILT_MODULE) | $(ACP)
|
|
@echo Copying $(PRIVATE_SOURCE_FILE)
|
|
$(hide) $(ACP) -fp $(PRIVATE_SOURCE_FILE) $@
|
|
ALL_MODULES.$(LOCAL_MODULE).STUBS := $(full_classes_stubs_jar)
|
|
|
|
# Emma source code coverage
|
|
ifneq ($(EMMA_INSTRUMENT),true)
|
|
LOCAL_NO_EMMA_INSTRUMENT := true
|
|
LOCAL_NO_EMMA_COMPILE := true
|
|
endif
|
|
|
|
# Choose leaf name for the compiled jar file.
|
|
ifneq ($(LOCAL_NO_EMMA_COMPILE),true)
|
|
full_classes_compiled_jar_leaf := classes-no-debug-var.jar
|
|
else
|
|
full_classes_compiled_jar_leaf := classes-full-debug.jar
|
|
endif
|
|
|
|
# Compile the java files to a .jar file.
|
|
# This intentionally depends on java_sources, not all_java_sources.
|
|
# Deps for generated source files must be handled separately,
|
|
# via deps on the target that generates the sources.
|
|
full_classes_compiled_jar := $(intermediates.COMMON)/$(full_classes_compiled_jar_leaf)
|
|
$(full_classes_compiled_jar): $(java_sources) $(full_java_lib_deps)
|
|
$(transform-java-to-classes.jar)
|
|
|
|
ifneq ($(LOCAL_NO_EMMA_COMPILE),true)
|
|
# If you instrument class files that have local variable debug information in
|
|
# them emma does not correctly maintain the local variable table.
|
|
# This will cause an error when you try to convert the class files for Android.
|
|
# The workaround for this to compile the java classes with only
|
|
# line and source debug information, not local information.
|
|
$(full_classes_compiled_jar): PRIVATE_JAVAC_DEBUG_FLAGS := -g:{lines,source}
|
|
else
|
|
# when emma is off, compile with the default flags, which contain full debug
|
|
# info
|
|
$(full_classes_compiled_jar): PRIVATE_JAVAC_DEBUG_FLAGS := -g
|
|
endif
|
|
|
|
emma_intermediates_dir := $(intermediates.COMMON)/emma_out
|
|
# the 'lib/$(full_classes_compiled_jar_leaf)' portion of this path is fixed in
|
|
# the emma tool
|
|
full_classes_emma_jar := $(emma_intermediates_dir)/lib/$(full_classes_compiled_jar_leaf)
|
|
|
|
ifeq ($(LOCAL_IS_STATIC_JAVA_LIBRARY),true)
|
|
# Skip adding emma instrumentation to class files if this is a static library,
|
|
# since it will be instrumented by the package that includes it
|
|
LOCAL_NO_EMMA_INSTRUMENT:= true
|
|
endif
|
|
|
|
ifneq ($(LOCAL_NO_EMMA_INSTRUMENT),true)
|
|
$(full_classes_emma_jar): PRIVATE_EMMA_COVERAGE_FILE := $(intermediates.COMMON)/coverage.em
|
|
$(full_classes_emma_jar): PRIVATE_EMMA_INTERMEDIATES_DIR := $(emma_intermediates_dir)
|
|
# this rule will generate both $(PRIVATE_EMMA_COVERAGE_FILE) and
|
|
# $(full_classes_emma_jar)
|
|
$(full_classes_emma_jar): $(full_classes_compiled_jar)
|
|
$(transform-classes.jar-to-emma)
|
|
$(PRIVATE_EMMA_COVERAGE_FILE): $(full_classes_emma_jar)
|
|
else
|
|
$(full_classes_emma_jar): $(full_classes_compiled_jar) | $(ACP)
|
|
@echo Copying $<
|
|
$(copy-file-to-target)
|
|
endif
|
|
|
|
# Run jarjar if necessary, otherwise just copy the file. This is the last
|
|
# part of this step, so the output of this command is full_classes_jar.
|
|
full_classes_jarjar_jar := $(full_classes_jar)
|
|
ifneq ($(strip $(LOCAL_JARJAR_RULES)),)
|
|
$(full_classes_jarjar_jar): PRIVATE_JARJAR_RULES := $(LOCAL_JARJAR_RULES)
|
|
$(full_classes_jarjar_jar): $(full_classes_emma_jar) | jarjar
|
|
@echo JarJar: $@
|
|
$(hide) $(JARJAR) process $(PRIVATE_JARJAR_RULES) $< $@
|
|
else
|
|
$(full_classes_jarjar_jar): $(full_classes_emma_jar) | $(ACP)
|
|
@echo Copying: $@
|
|
$(hide) $(ACP) $< $@
|
|
endif
|
|
|
|
|
|
built_dex := $(intermediates.COMMON)/classes.dex
|
|
|
|
# Override PRIVATE_INTERMEDIATES_DIR so that install-dex-debug
|
|
# will work even when intermediates != intermediates.COMMON.
|
|
$(built_dex): PRIVATE_INTERMEDIATES_DIR := $(intermediates.COMMON)
|
|
$(built_dex): PRIVATE_DX_FLAGS := $(LOCAL_DX_FLAGS)
|
|
$(built_dex): $(full_classes_jar) $(DX)
|
|
$(transform-classes.jar-to-dex)
|
|
ifneq ($(GENERATE_DEX_DEBUG),)
|
|
$(install-dex-debug)
|
|
endif
|
|
|
|
findbugs_xml := $(intermediates.COMMON)/findbugs.xml
|
|
$(findbugs_xml) : PRIVATE_JAR_FILE := $(full_classes_jar)
|
|
$(findbugs_xml) : PRIVATE_AUXCLASSPATH := $(addprefix -auxclasspath ,$(strip \
|
|
$(call normalize-path-list,$(filter %.jar,\
|
|
$(full_java_libs)))))
|
|
# We can't depend directly on full_classes_jar because the PRIVATE_
|
|
# vars won't be set up correctly.
|
|
$(findbugs_xml) : $(LOCAL_BUILT_MODULE)
|
|
@echo Findbugs: $@
|
|
$(hide) $(FINDBUGS) -textui -effort:min -xml:withMessages \
|
|
$(PRIVATE_AUXCLASSPATH) \
|
|
$(PRIVATE_JAR_FILE) \
|
|
> $@
|
|
|
|
ALL_FINDBUGS_FILES += $(findbugs_xml)
|
|
|
|
findbugs_html := $(PRODUCT_OUT)/findbugs/$(LOCAL_MODULE).html
|
|
$(findbugs_html) : PRIVATE_XML_FILE := $(findbugs_xml)
|
|
$(LOCAL_MODULE)-findbugs : $(findbugs_html)
|
|
$(findbugs_html) : $(findbugs_xml)
|
|
@mkdir -p $(dir $@)
|
|
@echo UnionBugs: $@
|
|
$(hide) prebuilt/common/findbugs/bin/unionBugs $(PRIVATE_XML_FILE) \
|
|
| prebuilt/common/findbugs/bin/convertXmlToText -html:fancy.xsl \
|
|
> $@
|
|
|
|
$(LOCAL_MODULE)-findbugs : $(findbugs_html)
|
|
|
|
endif
|