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