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