core/java.mk

   1 # Requires:
   2 # LOCAL_MODULE_SUFFIX
   3 # LOCAL_MODULE_CLASS
   4 # all_res_assets
   5
   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)
  10 endif
  11
  12 LOCAL_NO_STANDARD_LIBRARIES:=$(strip $(LOCAL_NO_STANDARD_LIBRARIES))
  13 LOCAL_SDK_VERSION:=$(strip $(LOCAL_SDK_VERSION))
  14
  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)
  18   else
  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))
  22     else
  23       LOCAL_JAVA_LIBRARIES := android_stubs_$(LOCAL_SDK_VERSION) $(LOCAL_JAVA_LIBRARIES)
  24     endif
  25   endif
  26 else
  27   ifneq ($(LOCAL_NO_STANDARD_LIBRARIES),true)
  28     LOCAL_JAVA_LIBRARIES := core ext framework $(LOCAL_JAVA_LIBRARIES)
  29   endif
  30 endif
  31
  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)
  35 endif
  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)")
  38 endif
  39
  40 #######################################
  41 include $(BUILD_SYSTEM)/base_rules.mk
  42 #######################################
  43
  44 # We use intermediates.COMMON because the classes.jar/.dex files will be
  45 # common even if LOCAL_BUILT_MODULE isn't.
  46 #
  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
  52
  53 # Since we're using intermediates.COMMON, make sure that it gets cleaned
  54 # properly.
  55 $(cleantarget): PRIVATE_CLEAN_FILES += $(intermediates.COMMON)
  56
  57 # If the module includes java code (i.e., it's not framework-res), compile it.
  58 full_classes_jar :=
  59 built_dex :=
  60 ifneq (,$(strip $(all_java_sources)))
  61
  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
  68
  69 # Emma source code coverage
  70 ifneq ($(EMMA_INSTRUMENT),true)
  71 LOCAL_NO_EMMA_INSTRUMENT := true
  72 LOCAL_NO_EMMA_COMPILE := true
  73 endif
  74
  75 ifneq ($(LOCAL_NO_EMMA_COMPILE),true)
  76 # If you instrument class files that have local variable debug information in
  77 # them emma does not correctly maintain the local variable table.
  78 # This will cause an error when you try to convert the class files for Android.
  79 # The workaround for this to compile the java classes with only
  80 # line and source debug information, not local information.
  81 full_classes_compiled_name_jar := classes-no-debug-var.jar
  82 $(full_classes_compiled_jar): PRIVATE_JAVAC_DEBUG_FLAGS := -g:{lines,source}
  83 else
  84 # when emma is off, compile with the default flags, which contain full debug
  85 # info
  86 full_classes_compiled_name_jar := classes-full-debug.jar
  87 $(full_classes_compiled_jar): PRIVATE_JAVAC_DEBUG_FLAGS := -g
  88 endif
  89
  90 # Compile the java files to a .jar file.
  91 # This intentionally depends on java_sources, not all_java_sources.
  92 # Deps for generated source files must be handled separately,
  93 # via deps on the target that generates the sources.
  94 full_classes_compiled_jar := $(intermediates.COMMON)/$(full_classes_compiled_name_jar)
  95 $(full_classes_compiled_jar): $(java_sources) $(full_java_lib_deps)
  96         $(transform-java-to-classes.jar)
  97
  98 emma_intermediates_dir := $(intermediates.COMMON)/emma_out
  99 # the 'lib/$(full_classes_compiled_name_jar)' portion of this path is fixed in
 100 # the emma tool
 101 full_classes_emma_jar := $(emma_intermediates_dir)/lib/$(full_classes_compiled_name_jar)
 102
 103 ifeq ($(LOCAL_IS_STATIC_JAVA_LIBRARY),true)
 104 # Skip adding emma instrumentation to class files if this is a static library,
 105 # since it will be instrumented by the package that includes it
 106 LOCAL_NO_EMMA_INSTRUMENT:= true
 107 endif
 108
 109 ifneq ($(LOCAL_NO_EMMA_INSTRUMENT),true)
 110 $(full_classes_emma_jar): PRIVATE_EMMA_COVERAGE_FILE := $(intermediates.COMMON)/coverage.em
 111 $(full_classes_emma_jar): PRIVATE_EMMA_INTERMEDIATES_DIR := $(emma_intermediates_dir)
 112 # this rule will generate both $(PRIVATE_EMMA_COVERAGE_FILE) and
 113 # $(full_classes_emma_jar)
 114 $(full_classes_emma_jar): $(full_classes_compiled_jar)
 115         $(transform-classes.jar-to-emma)
 116 $(PRIVATE_EMMA_COVERAGE_FILE): $(full_classes_emma_jar)
 117 else
 118 $(full_classes_emma_jar): $(full_classes_compiled_jar) | $(ACP)
 119         @echo Copying $<
 120         $(copy-file-to-target)
 121 endif
 122
 123 # Run jarjar if necessary, otherwise just copy the file.  This is the last
 124 # part of this step, so the output of this command is full_classes_jar.
 125 full_classes_jarjar_jar := $(full_classes_jar)
 126 ifneq ($(strip $(LOCAL_JARJAR_RULES)),)
 127 $(full_classes_jarjar_jar): PRIVATE_JARJAR_RULES := $(LOCAL_JARJAR_RULES)
 128 $(full_classes_jarjar_jar): $(full_classes_emma_jar) | jarjar
 129         @echo JarJar: $@
 130         $(hide) $(JARJAR) process $(PRIVATE_JARJAR_RULES) $< $@
 131 else
 132 $(full_classes_jarjar_jar): $(full_classes_emma_jar) | $(ACP)
 133         @echo Copying: $@
 134         $(hide) $(ACP) $< $@
 135 endif
 136
 137
 138 built_dex := $(intermediates.COMMON)/classes.dex
 139
 140 # Override PRIVATE_INTERMEDIATES_DIR so that install-dex-debug
 141 # will work even when intermediates != intermediates.COMMON.
 142 $(built_dex): PRIVATE_INTERMEDIATES_DIR := $(intermediates.COMMON)
 143 $(built_dex): PRIVATE_DX_FLAGS := $(LOCAL_DX_FLAGS)
 144 $(built_dex): $(full_classes_jar) $(DX)
 145         $(transform-classes.jar-to-dex)
 146 ifneq ($(GENERATE_DEX_DEBUG),)
 147         $(install-dex-debug)
 148 endif
 149
 150 findbugs_xml := $(intermediates.COMMON)/findbugs.xml
 151 $(findbugs_xml) : PRIVATE_JAR_FILE := $(full_classes_jar)
 152 $(findbugs_xml) : PRIVATE_AUXCLASSPATH := $(addprefix -auxclasspath ,$(strip \
 153                                                                 $(call normalize-path-list,$(filter %.jar,\
 154                                                                                 $(full_java_libs)))))
 155 # We can't depend directly on full_classes_jar because the PRIVATE_
 156 # vars won't be set up correctly.
 157 $(findbugs_xml) : $(LOCAL_BUILT_MODULE)
 158         @echo Findbugs: $@
 159         $(hide) $(FINDBUGS) -textui -effort:min -xml:withMessages \
 160                 $(PRIVATE_AUXCLASSPATH) \
 161                 $(PRIVATE_JAR_FILE) \
 162                 > $@
 163
 164 ALL_FINDBUGS_FILES += $(findbugs_xml)
 165
 166 findbugs_html := $(PRODUCT_OUT)/findbugs/$(LOCAL_MODULE).html
 167 $(findbugs_html) : PRIVATE_XML_FILE := $(findbugs_xml)
 168 $(LOCAL_MODULE)-findbugs : $(findbugs_html)
 169 $(findbugs_html) : $(findbugs_xml)
 170         @mkdir -p $(dir $@)
 171         @echo UnionBugs: $@
 172         $(hide) prebuilt/common/findbugs/bin/unionBugs $(PRIVATE_XML_FILE) \
 173         | prebuilt/common/findbugs/bin/convertXmlToText -html:fancy.xsl \
 174         > $@
 175
 176 $(LOCAL_MODULE)-findbugs : $(findbugs_html)
 177
 178 endif