# 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 ifeq ($(LOCAL_SDK_VERSION),current) LOCAL_JAVA_LIBRARIES := android_stubs_$(LOCAL_SDK_VERSION) $(LOCAL_JAVA_LIBRARIES) else LOCAL_JAVA_LIBRARIES := sdk_v$(LOCAL_SDK_VERSION) $(LOCAL_JAVA_LIBRARIES) endif endif endif else ifneq ($(LOCAL_NO_STANDARD_LIBRARIES),true) LOCAL_JAVA_LIBRARIES := core core-junit ext framework $(LOCAL_JAVA_LIBRARIES) endif endif proto_sources := $(filter %.proto,$(LOCAL_SRC_FILES)) ifneq ($(proto_sources),) ifeq ($(LOCAL_PROTOC_OPTIMIZE_TYPE),micro) LOCAL_STATIC_JAVA_LIBRARIES += libprotobuf-java-2.3.0-micro else LOCAL_STATIC_JAVA_LIBRARIES += libprotobuf-java-2.3.0-lite endif endif LOCAL_JAVA_LIBRARIES := $(sort $(LOCAL_JAVA_LIBRARIES)) 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 ############################################################################## # Define the intermediate targets before including base_rules so they get # the correct environment. ############################################################################## intermediates := $(call local-intermediates-dir) intermediates.COMMON := $(call local-intermediates-dir,COMMON) # 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 built_dex_intermediate_leaf := classes-no-local.dex else full_classes_compiled_jar_leaf := classes-full-debug.jar built_dex_intermediate_leaf := classes-with-local.dex endif LOCAL_PROGUARD_ENABLED:=$(strip $(LOCAL_PROGUARD_ENABLED)) ifeq ($(LOCAL_PROGUARD_ENABLED),disabled) LOCAL_PROGUARD_ENABLED := endif # By giving different file name, files can be updated correctly when switching # between builds with and without Proguard enabled. # Note that ANY intermediate targets between the proguard and # the final built_dex should be differently named! ifdef LOCAL_PROGUARD_ENABLED proguard_jar_leaf := proguard.classes.jar built_dex_intermediate_leaf := proguard.$(built_dex_intermediate_leaf) built_dex_leaf := proguard.classes.dex else proguard_jar_leaf := noproguard.classes.jar built_dex_intermediate_leaf := noproguard.$(built_dex_intermediate_leaf) built_dex_leaf := noproguard.classes.dex endif full_classes_compiled_jar := $(intermediates.COMMON)/$(full_classes_compiled_jar_leaf) jarjar_leaf := classes-jarjar.jar full_classes_jarjar_jar := $(intermediates.COMMON)/$(jarjar_leaf) emma_intermediates_dir := $(intermediates.COMMON)/emma_out # emma is hardcoded to use the leaf name of its input for the output file -- # only the output directory can be changed full_classes_emma_jar := $(emma_intermediates_dir)/lib/$(jarjar_leaf) full_classes_proguard_jar := $(intermediates.COMMON)/$(proguard_jar_leaf) built_dex_intermediate := $(intermediates.COMMON)/$(built_dex_intermediate_leaf) full_classes_stubs_jar := $(intermediates.COMMON)/stubs.jar # full_classes_jar and built_dex are cleared below, and re-set if we really need them. full_classes_jar := $(intermediates.COMMON)/classes.jar built_dex := $(intermediates.COMMON)/$(built_dex_leaf) LOCAL_INTERMEDIATE_TARGETS += \ $(full_classes_compiled_jar) \ $(full_classes_jarjar_jar) \ $(full_classes_emma_jar) \ $(full_classes_jar) \ $(full_classes_proguard_jar) \ $(built_dex_intermediate) \ $(built_dex) \ $(full_classes_stubs_jar) LOCAL_INTERMEDIATE_SOURCE_DIR := $(intermediates.COMMON)/src ############################################################### ## .rs files: RenderScript sources to .java files and .bc files ############################################################### renderscript_sources := $(filter %.rs,$(LOCAL_SRC_FILES)) # Because names of the java files from RenderScript are unknown until the # .rs file(s) are compiled, we have to depend on a timestamp file. RenderScript_file_stamp := ifneq ($(renderscript_sources),) renderscript_sources_fullpath := $(addprefix $(LOCAL_PATH)/, $(renderscript_sources)) RenderScript_file_stamp := $(LOCAL_INTERMEDIATE_SOURCE_DIR)/RenderScript.stamp renderscript_intermediate := $(LOCAL_INTERMEDIATE_SOURCE_DIR)/renderscript # prepend the RenderScript system include path ifneq ($(filter-out current,$(LOCAL_SDK_VERSION)),) LOCAL_RENDERSCRIPT_INCLUDES := \ $(HISTORICAL_SDK_VERSIONS_ROOT)/$(LOCAL_SDK_VERSION)/renderscript/clang-include \ $(HISTORICAL_SDK_VERSIONS_ROOT)/$(LOCAL_SDK_VERSION)/renderscript/include \ $(LOCAL_RENDERSCRIPT_INCLUDES) else LOCAL_RENDERSCRIPT_INCLUDES := \ $(TOPDIR)external/clang/lib/Headers \ $(TOPDIR)frameworks/base/libs/rs/scriptc \ $(LOCAL_RENDERSCRIPT_INCLUDES) endif ifeq ($(LOCAL_RENDERSCRIPT_CC),) LOCAL_RENDERSCRIPT_CC := $(LLVM_RS_CC) endif $(RenderScript_file_stamp): PRIVATE_RS_INCLUDES := $(LOCAL_RENDERSCRIPT_INCLUDES) $(RenderScript_file_stamp): PRIVATE_RS_CC := $(LOCAL_RENDERSCRIPT_CC) $(RenderScript_file_stamp): PRIVATE_RS_SOURCE_FILES := $(renderscript_sources_fullpath) # By putting the generated java files into $(LOCAL_INTERMEDIATE_SOURCE_DIR), they will be # automatically found by the java compiling function transform-java-to-classes.jar. $(RenderScript_file_stamp): PRIVATE_RS_OUTPUT_DIR := $(renderscript_intermediate) $(RenderScript_file_stamp): $(renderscript_sources_fullpath) $(LOCAL_RENDERSCRIPT_CC) $(transform-renderscripts-to-java-and-bc) # include the dependency files (.d) generated by llvm-rs-cc. renderscript_generated_dep_files := $(addprefix $(renderscript_intermediate)/, \ $(patsubst %.rs,%.d, $(notdir $(renderscript_sources)))) -include $(renderscript_generated_dep_files) LOCAL_INTERMEDIATE_TARGETS += $(RenderScript_file_stamp) # Make sure the generated resource will be added to the apk. LOCAL_RESOURCE_DIR := $(LOCAL_INTERMEDIATE_SOURCE_DIR)/renderscript/res $(LOCAL_RESOURCE_DIR) endif # TODO: It looks like the only thing we need from base_rules is # all_java_sources. See if we can get that by adding a # common_java.mk, and moving the include of base_rules.mk to # after all the declarations. ####################################### 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 := $(LOCAL_INTERMEDIATE_SOURCE_DIR) # 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 built_dex := $(intermediates.COMMON)/$(built_dex_leaf) # 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): 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) # 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): PRIVATE_JAVACFLAGS := $(LOCAL_JAVACFLAGS) $(full_classes_compiled_jar): $(java_sources) $(java_resource_sources) $(full_java_lib_deps) $(jar_manifest_file) \ $(RenderScript_file_stamp) $(proto_java_sources_file_stamp) $(transform-java-to-classes.jar) # All of the rules after full_classes_compiled_jar are very unlikely # to fail except for bugs in their respective tools. If you would # like to run these rules, add the "all" modifier goal to the make # command line. # This overwrites the value defined in base_rules.mk. That's a little # dirty. It's preferable to set LOCAL_CHECKED_MODULE, but this has to # be done after the inclusion of base_rules.mk. ALL_MODULES.$(LOCAL_MODULE).CHECKED := $(full_classes_compiled_jar) $(full_classes_compiled_jar): PRIVATE_JAVAC_DEBUG_FLAGS := -g # Run jarjar if necessary, otherwise just copy the file. ifneq ($(strip $(LOCAL_JARJAR_RULES)),) $(full_classes_jarjar_jar): PRIVATE_JARJAR_RULES := $(LOCAL_JARJAR_RULES) $(full_classes_jarjar_jar): $(full_classes_compiled_jar) | $(JARJAR) @echo JarJar: $@ $(hide) java -jar $(JARJAR) process $(PRIVATE_JARJAR_RULES) $< $@ else $(full_classes_jarjar_jar): $(full_classes_compiled_jar) | $(ACP) @echo Copying: $@ $(hide) $(ACP) -fp $< $@ endif 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) # module level coverage filter can be defined using LOCAL_EMMA_COVERAGE_FILTER # in Android.mk ifdef LOCAL_EMMA_COVERAGE_FILTER $(full_classes_emma_jar): PRIVATE_EMMA_COVERAGE_FILTER := $(LOCAL_EMMA_COVERAGE_FILTER) else # by default, avoid applying emma instrumentation onto emma classes itself, # otherwise there will be exceptions thrown $(full_classes_emma_jar): PRIVATE_EMMA_COVERAGE_FILTER := *,-emma,-emmarun,-com.vladium.* endif # this rule will generate both $(PRIVATE_EMMA_COVERAGE_FILE) and # $(full_classes_emma_jar) $(full_classes_emma_jar): $(full_classes_jarjar_jar) | $(EMMA_JAR) $(transform-classes.jar-to-emma) $(PRIVATE_EMMA_COVERAGE_FILE): $(full_classes_emma_jar) # tell proguard to load emma jar LOCAL_PROGUARD_FLAGS := $(LOCAL_PROGUARD_FLAGS) $(addprefix -libraryjars ,$(EMMA_JAR)) else $(full_classes_emma_jar): $(full_classes_jarjar_jar) | $(ACP) @echo Copying: $@ $(copy-file-to-target) endif # Keep a copy of the jar just before proguard processing. $(full_classes_jar): $(full_classes_emma_jar) | $(ACP) @echo Copying: $@ $(hide) $(ACP) -fp $< $@ # Run proguard if necessary, otherwise just copy the file. proguard_dictionary := $(intermediates.COMMON)/proguard_dictionary # Proguard doesn't like a class in both library and the jar to be processed. proguard_full_java_libs := $(filter-out $(full_static_java_libs),$(full_java_libs)) proguard_flags := $(addprefix -libraryjars ,$(proguard_full_java_libs)) \ -include $(BUILD_SYSTEM)/proguard.flags \ -forceprocessing \ -printmapping $(proguard_dictionary) # If this is a test package, add proguard keep flags for tests. ifneq ($(strip $(LOCAL_INSTRUMENTATION_FOR)$(filter tests,$(LOCAL_MODULE_TAGS))$(filter android.test.runner,$(LOCAL_JAVA_LIBRARIES))),) proguard_flags := $(proguard_flags) -include $(BUILD_SYSTEM)/proguard_tests.flags endif # test package ifneq ($(LOCAL_PROGUARD_ENABLED),) ifeq ($(LOCAL_PROGUARD_ENABLED),full) # full else ifeq ($(LOCAL_PROGUARD_ENABLED),optonly) # optonly proguard_flags += -dontobfuscate else ifeq ($(LOCAL_PROGUARD_ENABLED),custom) # custom else $(warning while processing: $(LOCAL_MODULE)) $(error invalid value for LOCAL_PROGUARD_ENABLED: $(LOCAL_PROGUARD_ENABLED)) endif # custom endif # optonly endif # full endif # LOCAL_PROGUARD_ENABLED proguard_flag_files := $(addprefix $(LOCAL_PATH)/, $(LOCAL_PROGUARD_FLAG_FILES)) LOCAL_PROGUARD_FLAGS += $(addprefix -include , $(proguard_flag_files)) $(full_classes_proguard_jar): PRIVATE_PROGUARD_ENABLED:=$(LOCAL_PROGUARD_ENABLED) $(full_classes_proguard_jar): PRIVATE_PROGUARD_FLAGS := $(proguard_flags) $(LOCAL_PROGUARD_FLAGS) $(full_classes_proguard_jar): PRIVATE_INSTRUMENTATION_FOR:=$(strip $(LOCAL_INSTRUMENTATION_FOR)) $(full_classes_proguard_jar) : $(full_classes_jar) $(proguard_flag_files) | $(ACP) $(PROGUARD) $(call transform-jar-to-proguard) ALL_MODULES.$(LOCAL_MODULE).PROGUARD_ENABLED:=$(LOCAL_PROGUARD_ENABLED) # Override PRIVATE_INTERMEDIATES_DIR so that install-dex-debug # will work even when intermediates != intermediates.COMMON. $(built_dex_intermediate): PRIVATE_INTERMEDIATES_DIR := $(intermediates.COMMON) ifeq (,$(filter --target-api=%, $(LOCAL_DX_FLAGS))) possible_dx_target_api := ifneq (,$(LOCAL_MANIFEST_FILE)) manifest_min_sdk_version := \ $(shell grep -o 'android:minSdkVersion="[0-9]\{1,\}"' $(LOCAL_PATH)/$(LOCAL_MANIFEST_FILE) 2>/dev/null) possible_dx_target_api := $(patsubst android:minSdkVersion="%",%,$(firstword $(manifest_min_sdk_version))) endif ifeq (,$(possible_dx_target_api)) # In case minSdkVersion is not available, eg shared library built against SDK, # LOCAL_SDK_VERSION may be a good guess ifneq (,$(filter-out current, $(LOCAL_SDK_VERSION))) possible_dx_target_api := $(LOCAL_SDK_VERSION) endif endif LOCAL_DX_FLAGS += $(addprefix --target-api=, $(possible_dx_target_api)) endif # --target-api not defined in LOCAL_DX_FLAGS $(built_dex_intermediate): PRIVATE_DX_FLAGS := $(LOCAL_DX_FLAGS) # 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 here is to build different dex file here based on emma switch # then later copy into classes.dex. When emma is on, dx is run with --no-locals # option to remove local variable information ifneq ($(LOCAL_NO_EMMA_COMPILE),true) $(built_dex_intermediate): PRIVATE_DX_FLAGS += --no-locals endif $(built_dex_intermediate): $(full_classes_proguard_jar) $(DX) $(transform-classes.jar-to-dex) $(built_dex): $(built_dex_intermediate) | $(ACP) @echo Copying: $@ $(hide) $(ACP) -fp $< $@ 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 ConvertXmlToText: $@ $(hide) prebuilt/common/findbugs/bin/convertXmlToText -html:fancy.xsl $(PRIVATE_XML_FILE) \ > $@ $(LOCAL_MODULE)-findbugs : $(findbugs_html) endif