Home | History | Annotate | Download | only in core 
      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       ifeq ($(LOCAL_SDK_VERSION),current)
     24         LOCAL_JAVA_LIBRARIES := android_stubs_$(LOCAL_SDK_VERSION) $(LOCAL_JAVA_LIBRARIES)
     25       else
     26         LOCAL_JAVA_LIBRARIES := sdk_v$(LOCAL_SDK_VERSION) $(LOCAL_JAVA_LIBRARIES)
     27       endif
     28     endif
     29   endif
     30 else
     31   ifneq ($(LOCAL_NO_STANDARD_LIBRARIES),true)
     32     LOCAL_JAVA_LIBRARIES := core core-junit ext framework filterfw $(LOCAL_JAVA_LIBRARIES)
     33   endif
     34 endif
     35 
     36 proto_sources := $(filter %.proto,$(LOCAL_SRC_FILES))
     37 ifneq ($(proto_sources),)
     38 ifeq ($(LOCAL_PROTOC_OPTIMIZE_TYPE),micro)
     39     LOCAL_STATIC_JAVA_LIBRARIES += libprotobuf-java-2.3.0-micro
     40 else
     41     LOCAL_STATIC_JAVA_LIBRARIES += libprotobuf-java-2.3.0-lite
     42 endif
     43 endif
     44 
     45 LOCAL_JAVA_LIBRARIES := $(sort $(LOCAL_JAVA_LIBRARIES))
     46 
     47 LOCAL_BUILT_MODULE_STEM := $(strip $(LOCAL_BUILT_MODULE_STEM))
     48 ifeq ($(LOCAL_BUILT_MODULE_STEM),)
     49 $(error $(LOCAL_PATH): Target java template must define LOCAL_BUILT_MODULE_STEM)
     50 endif
     51 ifneq ($(filter classes-compiled.jar classes.jar,$(LOCAL_BUILT_MODULE_STEM)),)
     52 $(error LOCAL_BUILT_MODULE_STEM may not be "$(LOCAL_BUILT_MODULE_STEM)")
     53 endif
     54 
     55 
     56 ##############################################################################
     57 # Define the intermediate targets before including base_rules so they get
     58 # the correct environment.
     59 ##############################################################################
     60 
     61 intermediates := $(call local-intermediates-dir)
     62 intermediates.COMMON := $(call local-intermediates-dir,COMMON)
     63 
     64 # Emma source code coverage
     65 ifneq ($(EMMA_INSTRUMENT),true)
     66 LOCAL_NO_EMMA_INSTRUMENT := true
     67 LOCAL_NO_EMMA_COMPILE := true
     68 endif
     69 
     70 # Choose leaf name for the compiled jar file.
     71 ifneq ($(LOCAL_NO_EMMA_COMPILE),true)
     72 full_classes_compiled_jar_leaf := classes-no-debug-var.jar
     73 built_dex_intermediate_leaf := classes-no-local.dex
     74 else
     75 full_classes_compiled_jar_leaf := classes-full-debug.jar
     76 built_dex_intermediate_leaf := classes-with-local.dex
     77 endif
     78 
     79 LOCAL_PROGUARD_ENABLED:=$(strip $(LOCAL_PROGUARD_ENABLED))
     80 ifeq ($(LOCAL_PROGUARD_ENABLED),disabled)
     81 LOCAL_PROGUARD_ENABLED :=
     82 endif
     83 
     84 # By giving different file name, files can be updated correctly when switching
     85 # between builds with and without Proguard enabled.
     86 # Note that ANY intermediate targets between the proguard and
     87 # the final built_dex should be differently named!
     88 ifdef LOCAL_PROGUARD_ENABLED
     89 proguard_jar_leaf := proguard.classes.jar
     90 built_dex_intermediate_leaf := proguard.$(built_dex_intermediate_leaf)
     91 built_dex_leaf := proguard.classes.dex
     92 else
     93 proguard_jar_leaf := noproguard.classes.jar
     94 built_dex_intermediate_leaf := noproguard.$(built_dex_intermediate_leaf)
     95 built_dex_leaf := noproguard.classes.dex
     96 endif
     97 
     98 full_classes_compiled_jar := $(intermediates.COMMON)/$(full_classes_compiled_jar_leaf)
     99 jarjar_leaf := classes-jarjar.jar
    100 full_classes_jarjar_jar := $(intermediates.COMMON)/$(jarjar_leaf)
    101 emma_intermediates_dir := $(intermediates.COMMON)/emma_out
    102 # emma is hardcoded to use the leaf name of its input for the output file --
    103 # only the output directory can be changed
    104 full_classes_emma_jar := $(emma_intermediates_dir)/lib/$(jarjar_leaf)
    105 full_classes_proguard_jar := $(intermediates.COMMON)/$(proguard_jar_leaf)
    106 built_dex_intermediate := $(intermediates.COMMON)/$(built_dex_intermediate_leaf)
    107 full_classes_stubs_jar := $(intermediates.COMMON)/stubs.jar
    108 
    109 # full_classes_jar and built_dex are cleared below, and re-set if we really need them.
    110 full_classes_jar := $(intermediates.COMMON)/classes.jar
    111 built_dex := $(intermediates.COMMON)/$(built_dex_leaf)
    112 
    113 LOCAL_INTERMEDIATE_TARGETS += \
    114     $(full_classes_compiled_jar) \
    115     $(full_classes_jarjar_jar) \
    116     $(full_classes_emma_jar) \
    117     $(full_classes_jar) \
    118     $(full_classes_proguard_jar) \
    119     $(built_dex_intermediate) \
    120     $(built_dex) \
    121     $(full_classes_stubs_jar)
    122 
    123 
    124 LOCAL_INTERMEDIATE_SOURCE_DIR := $(intermediates.COMMON)/src
    125 
    126 ###############################################################
    127 ## .rs files: RenderScript sources to .java files and .bc files
    128 ###############################################################
    129 renderscript_sources := $(filter %.rs,$(LOCAL_SRC_FILES))
    130 # Because names of the java files from RenderScript are unknown until the
    131 # .rs file(s) are compiled, we have to depend on a timestamp file.
    132 RenderScript_file_stamp :=
    133 ifneq ($(renderscript_sources),)
    134 renderscript_sources_fullpath := $(addprefix $(LOCAL_PATH)/, $(renderscript_sources))
    135 RenderScript_file_stamp := $(LOCAL_INTERMEDIATE_SOURCE_DIR)/RenderScript.stamp
    136 renderscript_intermediate := $(LOCAL_INTERMEDIATE_SOURCE_DIR)/renderscript
    137 
    138 renderscript_target_api :=
    139 
    140 ifneq (,$(LOCAL_RENDERSCRIPT_TARGET_API))
    141 renderscript_target_api := $(LOCAL_RENDERSCRIPT_TARGET_API)
    142 else
    143 ifneq (,$(LOCAL_SDK_VERSION))
    144 # Set target-api for LOCAL_SDK_VERSIONs other than current.
    145 ifneq (,$(filter-out current, $(LOCAL_SDK_VERSION)))
    146 renderscript_target_api := $(LOCAL_SDK_VERSION)
    147 endif
    148 endif  # LOCAL_SDK_VERSION is set
    149 endif  # LOCAL_RENDERSCRIPT_TARGET_API is set
    150 
    151 ifeq ($(LOCAL_RENDERSCRIPT_CC),)
    152 LOCAL_RENDERSCRIPT_CC := $(LLVM_RS_CC)
    153 endif
    154 
    155 # prepend the RenderScript system include path
    156 ifneq ($(filter-out current,$(LOCAL_SDK_VERSION)),)
    157 LOCAL_RENDERSCRIPT_INCLUDES := \
    158     $(HISTORICAL_SDK_VERSIONS_ROOT)/$(LOCAL_SDK_VERSION)/renderscript/clang-include \
    159     $(HISTORICAL_SDK_VERSIONS_ROOT)/$(LOCAL_SDK_VERSION)/renderscript/include \
    160     $(LOCAL_RENDERSCRIPT_INCLUDES)
    161 else
    162 LOCAL_RENDERSCRIPT_INCLUDES := \
    163     $(TOPDIR)external/clang/lib/Headers \
    164     $(TOPDIR)frameworks/base/libs/rs/scriptc \
    165     $(LOCAL_RENDERSCRIPT_INCLUDES)
    166 endif
    167 
    168 ifneq ($(LOCAL_RENDERSCRIPT_INCLUDES_OVERRIDE),)
    169 LOCAL_RENDERSCRIPT_INCLUDES := $(LOCAL_RENDERSCRIPT_INCLUDES_OVERRIDE)
    170 endif
    171 
    172 $(RenderScript_file_stamp): PRIVATE_RS_INCLUDES := $(LOCAL_RENDERSCRIPT_INCLUDES)
    173 $(RenderScript_file_stamp): PRIVATE_RS_CC := $(LOCAL_RENDERSCRIPT_CC)
    174 $(RenderScript_file_stamp): PRIVATE_RS_SOURCE_FILES := $(renderscript_sources_fullpath)
    175 # By putting the generated java files into $(LOCAL_INTERMEDIATE_SOURCE_DIR), they will be
    176 # automatically found by the java compiling function transform-java-to-classes.jar.
    177 $(RenderScript_file_stamp): PRIVATE_RS_OUTPUT_DIR := $(renderscript_intermediate)
    178 $(RenderScript_file_stamp): PRIVATE_RS_TARGET_API := $(renderscript_target_api)
    179 $(RenderScript_file_stamp): $(renderscript_sources_fullpath) $(LOCAL_RENDERSCRIPT_CC)
    180 	$(transform-renderscripts-to-java-and-bc)
    181 
    182 # include the dependency files (.d) generated by llvm-rs-cc.
    183 renderscript_generated_dep_files := $(addprefix $(renderscript_intermediate)/, \
    184     $(patsubst %.rs,%.d, $(notdir $(renderscript_sources))))
    185 -include $(renderscript_generated_dep_files)
    186 
    187 LOCAL_INTERMEDIATE_TARGETS += $(RenderScript_file_stamp)
    188 # Make sure the generated resource will be added to the apk.
    189 LOCAL_RESOURCE_DIR := $(LOCAL_INTERMEDIATE_SOURCE_DIR)/renderscript/res $(LOCAL_RESOURCE_DIR)
    190 endif
    191 
    192 # TODO: It looks like the only thing we need from base_rules is
    193 # all_java_sources.  See if we can get that by adding a
    194 # common_java.mk, and moving the include of base_rules.mk to
    195 # after all the declarations.
    196 
    197 #######################################
    198 include $(BUILD_SYSTEM)/base_rules.mk
    199 #######################################
    200 
    201 # We use intermediates.COMMON because the classes.jar/.dex files will be
    202 # common even if LOCAL_BUILT_MODULE isn't.
    203 #
    204 # Override some target variables that base_rules set up for us.
    205 $(LOCAL_INTERMEDIATE_TARGETS): \
    206 	PRIVATE_CLASS_INTERMEDIATES_DIR := $(intermediates.COMMON)/classes
    207 $(LOCAL_INTERMEDIATE_TARGETS): \
    208 	PRIVATE_SOURCE_INTERMEDIATES_DIR := $(LOCAL_INTERMEDIATE_SOURCE_DIR)
    209 
    210 # Since we're using intermediates.COMMON, make sure that it gets cleaned
    211 # properly.
    212 $(cleantarget): PRIVATE_CLEAN_FILES += $(intermediates.COMMON)
    213 
    214 # If the module includes java code (i.e., it's not framework-res), compile it.
    215 full_classes_jar :=
    216 built_dex :=
    217 ifneq (,$(strip $(all_java_sources)))
    218 
    219 # If LOCAL_BUILT_MODULE_STEM wasn't overridden by our caller,
    220 # full_classes_jar will be the same module as LOCAL_BUILT_MODULE.
    221 # Otherwise, the caller will define it as a prerequisite of
    222 # LOCAL_BUILT_MODULE, so it will inherit the necessary PRIVATE_*
    223 # variable definitions.
    224 full_classes_jar := $(intermediates.COMMON)/classes.jar
    225 built_dex := $(intermediates.COMMON)/$(built_dex_leaf)
    226 
    227 # Droiddoc isn't currently able to generate stubs for modules, so we're just
    228 # allowing it to use the classes.jar as the "stubs" that would be use to link
    229 # against, for the cases where someone needs the jar to link against.
    230 # - Use the classes.jar instead of the handful of other intermediates that
    231 #   we have, because it's the most processed, but still hasn't had dex run on
    232 #   it, so it's closest to what's on the device.
    233 # - This extra copy, with the dependency on LOCAL_BUILT_MODULE allows the
    234 #   PRIVATE_ vars to be preserved.
    235 $(full_classes_stubs_jar): PRIVATE_SOURCE_FILE := $(full_classes_jar)
    236 $(full_classes_stubs_jar) : $(LOCAL_BUILT_MODULE) | $(ACP)
    237 	@echo Copying $(PRIVATE_SOURCE_FILE)
    238 	$(hide) $(ACP) -fp $(PRIVATE_SOURCE_FILE) $@
    239 ALL_MODULES.$(LOCAL_MODULE).STUBS := $(full_classes_stubs_jar)
    240 
    241 # Compile the java files to a .jar file.
    242 # This intentionally depends on java_sources, not all_java_sources.
    243 # Deps for generated source files must be handled separately,
    244 # via deps on the target that generates the sources.
    245 $(full_classes_compiled_jar): PRIVATE_JAVACFLAGS := $(LOCAL_JAVACFLAGS)
    246 $(full_classes_compiled_jar): $(java_sources) $(java_resource_sources) $(full_java_lib_deps) $(jar_manifest_file) \
    247 	$(RenderScript_file_stamp) $(proto_java_sources_file_stamp)
    248 	$(transform-java-to-classes.jar)
    249 
    250 # All of the rules after full_classes_compiled_jar are very unlikely
    251 # to fail except for bugs in their respective tools.  If you would
    252 # like to run these rules, add the "all" modifier goal to the make
    253 # command line.
    254 # This overwrites the value defined in base_rules.mk.  That's a little
    255 # dirty.  It's preferable to set LOCAL_CHECKED_MODULE, but this has to
    256 # be done after the inclusion of base_rules.mk.
    257 ALL_MODULES.$(LOCAL_MODULE).CHECKED := $(full_classes_compiled_jar)
    258 
    259 $(full_classes_compiled_jar): PRIVATE_JAVAC_DEBUG_FLAGS := -g
    260 
    261 # Run jarjar if necessary, otherwise just copy the file.
    262 ifneq ($(strip $(LOCAL_JARJAR_RULES)),)
    263 $(full_classes_jarjar_jar): PRIVATE_JARJAR_RULES := $(LOCAL_JARJAR_RULES)
    264 $(full_classes_jarjar_jar): $(full_classes_compiled_jar) | $(JARJAR)
    265 	@echo JarJar: $@
    266 	$(hide) java -jar $(JARJAR) process $(PRIVATE_JARJAR_RULES) $< $@
    267 else
    268 $(full_classes_jarjar_jar): $(full_classes_compiled_jar) | $(ACP)
    269 	@echo Copying: $@
    270 	$(hide) $(ACP) -fp $< $@
    271 endif
    272 
    273 ifeq ($(LOCAL_IS_STATIC_JAVA_LIBRARY),true)
    274 # Skip adding emma instrumentation to class files if this is a static library,
    275 # since it will be instrumented by the package that includes it
    276 LOCAL_NO_EMMA_INSTRUMENT:= true
    277 endif
    278 
    279 ifneq ($(LOCAL_NO_EMMA_INSTRUMENT),true)
    280 $(full_classes_emma_jar): PRIVATE_EMMA_COVERAGE_FILE := $(intermediates.COMMON)/coverage.em
    281 $(full_classes_emma_jar): PRIVATE_EMMA_INTERMEDIATES_DIR := $(emma_intermediates_dir)
    282 # module level coverage filter can be defined using LOCAL_EMMA_COVERAGE_FILTER
    283 # in Android.mk
    284 ifdef LOCAL_EMMA_COVERAGE_FILTER
    285 $(full_classes_emma_jar): PRIVATE_EMMA_COVERAGE_FILTER := $(LOCAL_EMMA_COVERAGE_FILTER)
    286 else
    287 # by default, avoid applying emma instrumentation onto emma classes itself,
    288 # otherwise there will be exceptions thrown
    289 $(full_classes_emma_jar): PRIVATE_EMMA_COVERAGE_FILTER := *,-emma,-emmarun,-com.vladium.*
    290 endif
    291 # this rule will generate both $(PRIVATE_EMMA_COVERAGE_FILE) and
    292 # $(full_classes_emma_jar)
    293 $(full_classes_emma_jar): $(full_classes_jarjar_jar) | $(EMMA_JAR)
    294 	$(transform-classes.jar-to-emma)
    295 $(PRIVATE_EMMA_COVERAGE_FILE): $(full_classes_emma_jar)
    296 
    297 # tell proguard to load emma jar
    298 LOCAL_PROGUARD_FLAGS := $(LOCAL_PROGUARD_FLAGS) $(addprefix -libraryjars ,$(EMMA_JAR))
    299 else
    300 $(full_classes_emma_jar): $(full_classes_jarjar_jar) | $(ACP)
    301 	@echo Copying: $@
    302 	$(copy-file-to-target)
    303 endif
    304 
    305 # Keep a copy of the jar just before proguard processing.
    306 $(full_classes_jar): $(full_classes_emma_jar) | $(ACP)
    307 	@echo Copying: $@
    308 	$(hide) $(ACP) -fp $< $@
    309 
    310 # Run proguard if necessary, otherwise just copy the file.
    311 proguard_dictionary := $(intermediates.COMMON)/proguard_dictionary
    312 # Proguard doesn't like a class in both library and the jar to be processed.
    313 proguard_full_java_libs := $(filter-out $(full_static_java_libs),$(full_java_libs))
    314 proguard_flags := $(addprefix -libraryjars ,$(proguard_full_java_libs)) \
    315                   -include $(BUILD_SYSTEM)/proguard.flags \
    316                   -forceprocessing \
    317                   -printmapping $(proguard_dictionary)
    318 # If this is a test package, add proguard keep flags for tests.
    319 ifneq ($(strip $(LOCAL_INSTRUMENTATION_FOR)$(filter tests,$(LOCAL_MODULE_TAGS))$(filter android.test.runner,$(LOCAL_JAVA_LIBRARIES))),)
    320 proguard_flags := $(proguard_flags) -include $(BUILD_SYSTEM)/proguard_tests.flags
    321 endif # test package
    322 
    323 ifneq ($(LOCAL_PROGUARD_ENABLED),)
    324 ifeq ($(LOCAL_PROGUARD_ENABLED),full)
    325     # full
    326 else
    327 ifeq ($(LOCAL_PROGUARD_ENABLED),optonly)
    328     # optonly
    329     proguard_flags += -dontobfuscate
    330 else
    331 ifeq ($(LOCAL_PROGUARD_ENABLED),custom)
    332     # custom
    333 else
    334     $(warning while processing: $(LOCAL_MODULE))
    335     $(error invalid value for LOCAL_PROGUARD_ENABLED: $(LOCAL_PROGUARD_ENABLED))
    336 endif # custom
    337 endif # optonly
    338 endif # full
    339 endif # LOCAL_PROGUARD_ENABLED
    340 
    341 proguard_flag_files := $(addprefix $(LOCAL_PATH)/, $(LOCAL_PROGUARD_FLAG_FILES))
    342 LOCAL_PROGUARD_FLAGS += $(addprefix -include , $(proguard_flag_files))
    343 
    344 $(full_classes_proguard_jar): PRIVATE_PROGUARD_ENABLED:=$(LOCAL_PROGUARD_ENABLED)
    345 $(full_classes_proguard_jar): PRIVATE_PROGUARD_FLAGS := $(proguard_flags) $(LOCAL_PROGUARD_FLAGS)
    346 $(full_classes_proguard_jar): PRIVATE_INSTRUMENTATION_FOR:=$(strip $(LOCAL_INSTRUMENTATION_FOR))
    347 $(full_classes_proguard_jar) : $(full_classes_jar) $(proguard_flag_files) | $(ACP) $(PROGUARD)
    348 	$(call transform-jar-to-proguard)
    349 
    350 ALL_MODULES.$(LOCAL_MODULE).PROGUARD_ENABLED:=$(LOCAL_PROGUARD_ENABLED)
    351 
    352 # Override PRIVATE_INTERMEDIATES_DIR so that install-dex-debug
    353 # will work even when intermediates != intermediates.COMMON.
    354 $(built_dex_intermediate): PRIVATE_INTERMEDIATES_DIR := $(intermediates.COMMON)
    355 $(built_dex_intermediate): PRIVATE_DX_FLAGS := $(LOCAL_DX_FLAGS)
    356 # If you instrument class files that have local variable debug information in
    357 # them emma does not correctly maintain the local variable table.
    358 # This will cause an error when you try to convert the class files for Android.
    359 # The workaround here is to build different dex file here based on emma switch
    360 # then later copy into classes.dex. When emma is on, dx is run with --no-locals
    361 # option to remove local variable information
    362 ifneq ($(LOCAL_NO_EMMA_COMPILE),true)
    363 $(built_dex_intermediate): PRIVATE_DX_FLAGS += --no-locals
    364 endif
    365 $(built_dex_intermediate): $(full_classes_proguard_jar) $(DX)
    366 	$(transform-classes.jar-to-dex)
    367 $(built_dex): $(built_dex_intermediate) | $(ACP)
    368 	@echo Copying: $@
    369 	$(hide) $(ACP) -fp $< $@
    370 ifneq ($(GENERATE_DEX_DEBUG),)
    371 	$(install-dex-debug)
    372 endif
    373 
    374 findbugs_xml := $(intermediates.COMMON)/findbugs.xml
    375 $(findbugs_xml) : PRIVATE_JAR_FILE := $(full_classes_jar)
    376 $(findbugs_xml) : PRIVATE_AUXCLASSPATH := $(addprefix -auxclasspath ,$(strip \
    377 								$(call normalize-path-list,$(filter %.jar,\
    378 										$(full_java_libs)))))
    379 # We can't depend directly on full_classes_jar because the PRIVATE_
    380 # vars won't be set up correctly.
    381 $(findbugs_xml) : $(LOCAL_BUILT_MODULE)
    382 	@echo Findbugs: $@
    383 	$(hide) $(FINDBUGS) -textui -effort:min -xml:withMessages \
    384 		$(PRIVATE_AUXCLASSPATH) \
    385 		$(PRIVATE_JAR_FILE) \
    386 		> $@
    387 
    388 ALL_FINDBUGS_FILES += $(findbugs_xml)
    389 
    390 findbugs_html := $(PRODUCT_OUT)/findbugs/$(LOCAL_MODULE).html
    391 $(findbugs_html) : PRIVATE_XML_FILE := $(findbugs_xml)
    392 $(LOCAL_MODULE)-findbugs : $(findbugs_html)
    393 $(findbugs_html) : $(findbugs_xml)
    394 	@mkdir -p $(dir $@)
    395 	@echo ConvertXmlToText: $@
    396 	$(hide) prebuilt/common/findbugs/bin/convertXmlToText -html:fancy.xsl $(PRIVATE_XML_FILE) \
    397 	> $@
    398 
    399 $(LOCAL_MODULE)-findbugs : $(findbugs_html)
    400 
    401 endif
    402