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