base_rules.mk revision 0ec188f1c197709cf61d0de647b5220539b97322
1# 2# Copyright (C) 2008 The Android Open Source Project 3# 4# Licensed under the Apache License, Version 2.0 (the "License"); 5# you may not use this file except in compliance with the License. 6# You may obtain a copy of the License at 7# 8# http://www.apache.org/licenses/LICENSE-2.0 9# 10# Unless required by applicable law or agreed to in writing, software 11# distributed under the License is distributed on an "AS IS" BASIS, 12# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13# See the License for the specific language governing permissions and 14# limitations under the License. 15# 16 17# Users can define base-rules-hook in their buildspec.mk to perform 18# arbitrary operations as each module is included. 19ifdef base-rules-hook 20$(if $(base-rules-hook),) 21endif 22 23########################################################### 24## Common instructions for a generic module. 25########################################################### 26 27LOCAL_MODULE := $(strip $(LOCAL_MODULE)) 28ifeq ($(LOCAL_MODULE),) 29 $(error $(LOCAL_PATH): LOCAL_MODULE is not defined) 30endif 31 32LOCAL_IS_HOST_MODULE := $(strip $(LOCAL_IS_HOST_MODULE)) 33ifdef LOCAL_IS_HOST_MODULE 34 ifneq ($(LOCAL_IS_HOST_MODULE),true) 35 $(error $(LOCAL_PATH): LOCAL_IS_HOST_MODULE must be "true" or empty, not "$(LOCAL_IS_HOST_MODULE)") 36 endif 37 my_prefix:=HOST_ 38 my_host:=host- 39else 40 my_prefix:=TARGET_ 41 my_host:= 42endif 43 44########################################################### 45## Validate and define fallbacks for input LOCAL_* variables. 46########################################################### 47 48## Dump a .csv file of all modules and their tags 49#ifneq ($(tag-list-first-time),false) 50#$(shell rm -f tag-list.csv) 51#tag-list-first-time := false 52#endif 53#comma := , 54#empty := 55#space := $(empty) $(empty) 56#$(shell echo $(lastword $(filter-out config/% out/%,$(MAKEFILE_LIST))),$(LOCAL_MODULE),$(strip $(LOCAL_MODULE_CLASS)),$(subst $(space),$(comma),$(sort $(LOCAL_MODULE_TAGS))) >> tag-list.csv) 57 58LOCAL_MODULE_TAGS := $(sort $(LOCAL_MODULE_TAGS)) 59ifeq (,$(LOCAL_MODULE_TAGS)) 60ifeq (true,$(LOCAL_UNINSTALLABLE_MODULE)) 61LOCAL_MODULE_TAGS := optional 62else 63# Installable modules without tags fall back to user (which is changed to user eng below) 64LOCAL_MODULE_TAGS := user 65endif 66#$(warning default tags: $(lastword $(filter-out config/% out/%,$(MAKEFILE_LIST)))) 67endif 68 69# Only the tags mentioned in this test are expected to be set by module 70# makefiles. Anything else is either a typo or a source of unexpected 71# behaviors. 72ifneq ($(filter-out user debug eng tests optional samples shell_ash shell_mksh,$(LOCAL_MODULE_TAGS)),) 73$(warning unusual tags $(LOCAL_MODULE_TAGS) on $(LOCAL_MODULE) at $(LOCAL_PATH)) 74endif 75 76ifneq ($(filter $(LOCAL_MODULE_TAGS),user),) 77 ifeq ($(filter $(GRANDFATHERED_USER_MODULES),$(LOCAL_MODULE)),) 78 $(warning *** Module name: $(LOCAL_MODULE)) 79 $(warning *** Makefile location: $(LOCAL_PATH)) 80 $(warning * ) 81 $(warning * Each module must use a LOCAL_MODULE_TAGS in its) 82 $(warning * Android.mk. Possible tags declared by a module:) 83 $(warning * ) 84 $(warning * optional, debug, eng, tests, samples) 85 $(warning * ) 86 $(warning * If the module is expected to be in all builds) 87 $(warning * of a product, then it should use the) 88 $(warning * "optional" tag: ) 89 $(warning * ) 90 $(warning * Add "LOCAL_MODULE_TAGS := optional" in the) 91 $(warning * Android.mk for the affected module, and add) 92 $(warning * the LOCAL_MODULE value for that component) 93 $(warning * into the PRODUCT_PACKAGES section of product) 94 $(warning * makefile(s) where it's necessary, if) 95 $(warning * appropriate.) 96 $(warning * ) 97 $(warning * If the component should be in EVERY build of ALL) 98 $(warning * products, then add its LOCAL_MODULE value to the) 99 $(warning * PRODUCT_PACKAGES section of) 100 $(warning * build/target/product/core.mk) 101 $(warning * ) 102 $(error user tag detected on new module - user tags are only supported on legacy modules) 103 endif 104endif 105 106# Add implicit tags. 107# 108# If the local directory or one of its parents contains a MODULE_LICENSE_GPL 109# file, tag the module as "gnu". Search for "*_GPL*" and "*_MPL*" so that we can also 110# find files like MODULE_LICENSE_GPL_AND_AFL but exclude files like 111# MODULE_LICENSE_LGPL. 112# 113gpl_license_file := $(call find-parent-file,$(LOCAL_PATH),MODULE_LICENSE*_GPL* MODULE_LICENSE*_MPL*) 114ifneq ($(gpl_license_file),) 115 LOCAL_MODULE_TAGS += gnu 116 ALL_GPL_MODULE_LICENSE_FILES := $(sort $(ALL_GPL_MODULE_LICENSE_FILES) $(gpl_license_file)) 117endif 118 119# 120# If this module is listed on CUSTOM_MODULES, promote it to "user" 121# so that it will be installed in $(TARGET_OUT). 122# 123ifneq (,$(filter $(LOCAL_MODULE),$(CUSTOM_MODULES))) 124 LOCAL_MODULE_TAGS := $(sort $(LOCAL_MODULE_TAGS) user) 125endif 126 127ifdef LOCAL_IS_HOST_MODULE 128 partition_tag := 129else 130ifeq (true,$(LOCAL_PROPRIETARY_MODULE)) 131 partition_tag := _VENDOR 132else 133 # The definition of should-install-to-system will be different depending 134 # on which goal (e.g., sdk or just droid) is being built. 135 partition_tag := $(if $(call should-install-to-system,$(LOCAL_MODULE_TAGS)),,_DATA) 136endif 137endif 138 139LOCAL_MODULE_CLASS := $(strip $(LOCAL_MODULE_CLASS)) 140ifneq ($(words $(LOCAL_MODULE_CLASS)),1) 141 $(error $(LOCAL_PATH): LOCAL_MODULE_CLASS must contain exactly one word, not "$(LOCAL_MODULE_CLASS)") 142endif 143 144# Those used to be implicitly ignored, but aren't any more. 145# As of 20100110 there are no apps with the user tag. 146ifeq ($(LOCAL_MODULE_CLASS),APPS) 147 ifneq ($(filter $(LOCAL_MODULE_TAGS),user),) 148 $(warning user tag on app $(LOCAL_MODULE) at $(LOCAL_PATH) - add your app to core.mk instead) 149 endif 150endif 151 152LOCAL_MODULE_PATH := $(strip $(LOCAL_MODULE_PATH)) 153ifeq ($(LOCAL_MODULE_PATH),) 154 LOCAL_MODULE_PATH := $($(my_prefix)OUT$(partition_tag)_$(LOCAL_MODULE_CLASS)) 155 ifeq ($(strip $(LOCAL_MODULE_PATH)),) 156 $(error $(LOCAL_PATH): unhandled LOCAL_MODULE_CLASS "$(LOCAL_MODULE_CLASS)") 157 endif 158endif 159 160ifneq ($(strip $(LOCAL_BUILT_MODULE)$(LOCAL_INSTALLED_MODULE)),) 161 $(error $(LOCAL_PATH): LOCAL_BUILT_MODULE and LOCAL_INSTALLED_MODULE must not be defined by component makefiles) 162endif 163 164# Make sure that this IS_HOST/CLASS/MODULE combination is unique. 165module_id := MODULE.$(if \ 166 $(LOCAL_IS_HOST_MODULE),HOST,TARGET).$(LOCAL_MODULE_CLASS).$(LOCAL_MODULE) 167ifdef $(module_id) 168$(error $(LOCAL_PATH): $(module_id) already defined by $($(module_id))) 169endif 170$(module_id) := $(LOCAL_PATH) 171 172intermediates := $(call local-intermediates-dir) 173intermediates.COMMON := $(call local-intermediates-dir,COMMON) 174 175########################################################### 176# Pick a name for the intermediate and final targets 177########################################################### 178LOCAL_MODULE_STEM := $(strip $(LOCAL_MODULE_STEM)) 179ifeq ($(LOCAL_MODULE_STEM),) 180 LOCAL_MODULE_STEM := $(LOCAL_MODULE) 181endif 182LOCAL_INSTALLED_MODULE_STEM := $(LOCAL_MODULE_STEM)$(LOCAL_MODULE_SUFFIX) 183 184LOCAL_BUILT_MODULE_STEM := $(strip $(LOCAL_BUILT_MODULE_STEM)) 185ifeq ($(LOCAL_BUILT_MODULE_STEM),) 186 LOCAL_BUILT_MODULE_STEM := $(LOCAL_INSTALLED_MODULE_STEM) 187endif 188 189# OVERRIDE_BUILT_MODULE_PATH is only allowed to be used by the 190# internal SHARED_LIBRARIES build files. 191OVERRIDE_BUILT_MODULE_PATH := $(strip $(OVERRIDE_BUILT_MODULE_PATH)) 192ifdef OVERRIDE_BUILT_MODULE_PATH 193 ifneq ($(LOCAL_MODULE_CLASS),SHARED_LIBRARIES) 194 $(error $(LOCAL_PATH): Illegal use of OVERRIDE_BUILT_MODULE_PATH) 195 endif 196 built_module_path := $(OVERRIDE_BUILT_MODULE_PATH) 197else 198 built_module_path := $(intermediates) 199endif 200LOCAL_BUILT_MODULE := $(built_module_path)/$(LOCAL_BUILT_MODULE_STEM) 201built_module_path := 202 203LOCAL_UNINSTALLABLE_MODULE := $(strip $(LOCAL_UNINSTALLABLE_MODULE)) 204ifneq (true,$(LOCAL_UNINSTALLABLE_MODULE)) 205 LOCAL_INSTALLED_MODULE := $(LOCAL_MODULE_PATH)/$(LOCAL_INSTALLED_MODULE_STEM) 206endif 207 208# Assemble the list of targets to create PRIVATE_ variables for. 209LOCAL_INTERMEDIATE_TARGETS += $(LOCAL_BUILT_MODULE) 210 211 212########################################################### 213## AIDL: Compile .aidl files to .java 214########################################################### 215 216aidl_sources := $(filter %.aidl,$(LOCAL_SRC_FILES)) 217 218ifneq ($(strip $(aidl_sources)),) 219 220aidl_java_sources := $(patsubst %.aidl,%.java,$(addprefix $(intermediates.COMMON)/src/, $(aidl_sources))) 221aidl_sources := $(addprefix $(TOP_DIR)$(LOCAL_PATH)/, $(aidl_sources)) 222 223ifeq (,$(TARGET_BUILD_APPS)) 224LOCAL_AIDL_INCLUDES += $(FRAMEWORKS_BASE_JAVA_SRC_DIRS) 225endif 226aidl_preprocess_import := 227LOCAL_SDK_VERSION:=$(strip $(LOCAL_SDK_VERSION)) 228ifdef LOCAL_SDK_VERSION 229ifeq ($(LOCAL_SDK_VERSION)$(TARGET_BUILD_APPS),current) 230 # LOCAL_SDK_VERSION is current and no TARGET_BUILD_APPS 231 aidl_preprocess_import := $(TARGET_OUT_COMMON_INTERMEDIATES)/framework.aidl 232else 233 aidl_preprocess_import := $(HISTORICAL_SDK_VERSIONS_ROOT)/$(LOCAL_SDK_VERSION)/framework.aidl 234endif # !current 235endif # LOCAL_SDK_VERSION 236$(aidl_java_sources): PRIVATE_AIDL_FLAGS := -b $(addprefix -p,$(aidl_preprocess_import)) -I$(LOCAL_PATH) -I$(LOCAL_PATH)/src $(addprefix -I,$(LOCAL_AIDL_INCLUDES)) 237 238$(aidl_java_sources): $(intermediates.COMMON)/src/%.java: $(TOPDIR)$(LOCAL_PATH)/%.aidl $(LOCAL_ADDITIONAL_DEPENDENCIES) $(AIDL) $(aidl_preprocess_import) 239 $(transform-aidl-to-java) 240-include $(aidl_java_sources:%.java=%.P) 241 242else 243aidl_java_sources := 244endif 245 246########################################################### 247## logtags: Add .logtags files to global list, emit java source 248########################################################### 249 250logtags_sources := $(filter %.logtags,$(LOCAL_SRC_FILES)) 251 252ifneq ($(strip $(logtags_sources)),) 253 254event_log_tags := $(addprefix $(LOCAL_PATH)/,$(logtags_sources)) 255 256# Emit a java source file with constants for the tags, if 257# LOCAL_MODULE_CLASS is "APPS" or "JAVA_LIBRARIES". 258ifneq ($(strip $(filter $(LOCAL_MODULE_CLASS),APPS JAVA_LIBRARIES)),) 259 260logtags_java_sources := $(patsubst %.logtags,%.java,$(addprefix $(intermediates.COMMON)/src/, $(logtags_sources))) 261logtags_sources := $(addprefix $(TOP_DIR)$(LOCAL_PATH)/, $(logtags_sources)) 262 263$(logtags_java_sources): $(intermediates.COMMON)/src/%.java: $(TOPDIR)$(LOCAL_PATH)/%.logtags $(TARGET_OUT_COMMON_INTERMEDIATES)/all-event-log-tags.txt 264 $(transform-logtags-to-java) 265 266endif 267 268else 269logtags_java_sources := 270event_log_tags := 271endif 272 273########################################################### 274## .proto files: Compile proto files to .java 275########################################################### 276proto_sources := $(filter %.proto,$(LOCAL_SRC_FILES)) 277# Because names of the .java files compiled from .proto files are unknown until the 278# .proto files are compiled, we use a timestamp file as depedency. 279proto_java_sources_file_stamp := 280ifneq ($(proto_sources),) 281proto_sources_fullpath := $(addprefix $(TOP_DIR)$(LOCAL_PATH)/, $(proto_sources)) 282# By putting the generated java files into $(LOCAL_INTERMEDIATE_SOURCE_DIR), they will be 283# automatically found by the java compiling function transform-java-to-classes.jar. 284ifneq ($(LOCAL_INTERMEDIATE_SOURCE_DIR),) 285proto_java_intemediate_dir := $(LOCAL_INTERMEDIATE_SOURCE_DIR)/proto 286else 287# LOCAL_INTERMEDIATE_SOURCE_DIR may be not defined in non-java modules. 288proto_java_intemediate_dir := $(intermediates)/proto 289endif 290proto_java_sources_file_stamp := $(proto_java_intemediate_dir)/Proto.stamp 291proto_java_sources_dir := $(proto_java_intemediate_dir)/src 292 293$(proto_java_sources_file_stamp): PRIVATE_PROTO_INCLUDES := $(TOP) 294$(proto_java_sources_file_stamp): PRIVATE_PROTO_SRC_FILES := $(proto_sources_fullpath) 295$(proto_java_sources_file_stamp): PRIVATE_PROTO_JAVA_OUTPUT_DIR := $(proto_java_sources_dir) 296ifeq ($(LOCAL_PROTOC_OPTIMIZE_TYPE),micro) 297$(proto_java_sources_file_stamp): PRIVATE_PROTO_JAVA_OUTPUT_OPTION := --javamicro_out 298else 299$(proto_java_sources_file_stamp): PRIVATE_PROTO_JAVA_OUTPUT_OPTION := --java_out 300endif 301$(proto_java_sources_file_stamp): PRIVATE_PROTOC_FLAGS := $(LOCAL_PROTOC_FLAGS) 302$(proto_java_sources_file_stamp) : $(proto_sources_fullpath) $(PROTOC) 303 $(call transform-proto-to-java) 304 305#TODO: protoc should output the dependencies introduced by imports. 306 307LOCAL_INTERMEDIATE_TARGETS += $(proto_java_sources_file_stamp) 308endif # proto_sources 309 310 311########################################################### 312## Java: Compile .java files to .class 313########################################################### 314#TODO: pull this into java.make once host and target are combined 315 316java_sources := $(addprefix $(TOP_DIR)$(LOCAL_PATH)/, $(filter %.java,$(LOCAL_SRC_FILES))) $(aidl_java_sources) $(logtags_java_sources) \ 317 $(filter %.java,$(LOCAL_GENERATED_SOURCES)) 318all_java_sources := $(java_sources) $(addprefix $($(my_prefix)OUT_COMMON_INTERMEDIATES)/, $(filter %.java,$(LOCAL_INTERMEDIATE_SOURCES))) 319 320## Java resources ######################################### 321 322# Look for resource files in any specified directories. 323# Non-java and non-doc files will be picked up as resources 324# and included in the output jar file. 325java_resource_file_groups := 326 327LOCAL_JAVA_RESOURCE_DIRS := $(strip $(LOCAL_JAVA_RESOURCE_DIRS)) 328ifneq ($(LOCAL_JAVA_RESOURCE_DIRS),) 329 # This makes a list of words like 330 # <dir1>::<file1>:<file2> <dir2>::<file1> <dir3>: 331 # where each of the files is relative to the directory it's grouped with. 332 # Directories that don't contain any resource files will result in groups 333 # that end with a colon, and they are stripped out in the next step. 334 java_resource_file_groups += \ 335 $(foreach dir,$(LOCAL_JAVA_RESOURCE_DIRS), \ 336 $(subst $(space),:,$(strip \ 337 $(TOP_DIR)$(LOCAL_PATH)/$(dir): \ 338 $(patsubst ./%,%,$(shell cd $(TOP_DIR)$(LOCAL_PATH)/$(dir) && \ 339 find . \ 340 -type d -a -name ".svn" -prune -o \ 341 -type f \ 342 -a \! -name "*.java" \ 343 -a \! -name "package.html" \ 344 -a \! -name "overview.html" \ 345 -a \! -name ".*.swp" \ 346 -a \! -name ".DS_Store" \ 347 -a \! -name "*~" \ 348 -print \ 349 )) \ 350 )) \ 351 ) 352 java_resource_file_groups := $(filter-out %:,$(java_resource_file_groups)) 353endif # LOCAL_JAVA_RESOURCE_DIRS 354 355LOCAL_JAVA_RESOURCE_FILES := $(strip $(LOCAL_JAVA_RESOURCE_FILES)) 356ifneq ($(LOCAL_JAVA_RESOURCE_FILES),) 357 java_resource_file_groups += \ 358 $(foreach f,$(LOCAL_JAVA_RESOURCE_FILES), \ 359 $(patsubst %/,%,$(dir $(f)))::$(notdir $(f)) \ 360 ) 361endif # LOCAL_JAVA_RESOURCE_FILES 362 363ifdef java_resource_file_groups 364 # The full paths to all resources, used for dependencies. 365 java_resource_sources := \ 366 $(foreach group,$(java_resource_file_groups), \ 367 $(addprefix $(word 1,$(subst :,$(space),$(group)))/, \ 368 $(wordlist 2,9999,$(subst :,$(space),$(group))) \ 369 ) \ 370 ) 371 # The arguments to jar that will include these files in a jar file. 372 # Quote the file name to handle special characters (such as #) correctly. 373 extra_jar_args := \ 374 $(foreach group,$(java_resource_file_groups), \ 375 $(addprefix -C "$(word 1,$(subst :,$(space),$(group)))" , \ 376 $(foreach w, $(wordlist 2,9999,$(subst :,$(space),$(group))), "$(w)" ) \ 377 ) \ 378 ) 379 java_resource_file_groups := 380else 381 java_resource_sources := 382 extra_jar_args := 383endif # java_resource_file_groups 384 385## PRIVATE java vars ###################################### 386 387ifneq ($(strip $(all_java_sources)$(all_res_assets))$(LOCAL_STATIC_JAVA_LIBRARIES),) 388 389full_static_java_libs := \ 390 $(foreach lib,$(LOCAL_STATIC_JAVA_LIBRARIES), \ 391 $(call intermediates-dir-for, \ 392 JAVA_LIBRARIES,$(lib),$(LOCAL_IS_HOST_MODULE),COMMON)/javalib.jar) 393 394$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_INSTALL_DIR := $(dir $(LOCAL_INSTALLED_MODULE)) 395$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_CLASS_INTERMEDIATES_DIR := $(intermediates)/classes 396$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_SOURCE_INTERMEDIATES_DIR := $(intermediates)/src 397$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_JAVA_SOURCES := $(all_java_sources) 398$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_JAVA_OBJECTS := $(patsubst %.java,%.class,$(LOCAL_SRC_FILES)) 399ifeq ($(my_prefix),TARGET_) 400ifeq ($(LOCAL_SDK_VERSION),) 401$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_BOOTCLASSPATH := -bootclasspath $(call java-lib-files,core) 402else 403ifeq ($(LOCAL_SDK_VERSION)$(TARGET_BUILD_APPS),current) 404# LOCAL_SDK_VERSION is current and no TARGET_BUILD_APPS. 405$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_BOOTCLASSPATH := -bootclasspath $(call java-lib-files,android_stubs_current) 406else 407$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_BOOTCLASSPATH := -bootclasspath $(call java-lib-files,sdk_v$(LOCAL_SDK_VERSION)) 408endif # current 409endif # LOCAL_SDK_VERSION 410endif # TARGET_ 411$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_RESOURCE_DIR := $(LOCAL_RESOURCE_DIR) 412$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_EXTRA_JAR_ARGS := $(extra_jar_args) 413$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_ASSET_DIR := $(LOCAL_ASSET_DIR) 414$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_STATIC_JAVA_LIBRARIES := $(full_static_java_libs) 415 416# full_java_libs: The list of files that should be used as the classpath. 417# Using this list as a dependency list WILL NOT WORK. 418# full_java_lib_deps: Should be specified as a prerequisite of this module 419# to guarantee that the files in full_java_libs will 420# be up-to-date. 421ifdef LOCAL_IS_HOST_MODULE 422ifeq ($(LOCAL_BUILD_HOST_DEX),true) 423$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_BOOTCLASSPATH := -bootclasspath $(call java-lib-files,core-hostdex,$(LOCAL_IS_HOST_MODULE)) 424 425full_java_libs := $(call java-lib-files,$(LOCAL_JAVA_LIBRARIES),$(LOCAL_IS_HOST_MODULE)) 426full_java_lib_deps := $(call java-lib-deps,$(LOCAL_JAVA_LIBRARIES),$(LOCAL_IS_HOST_MODULE)) 427else 428$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_BOOTCLASSPATH := 429 430full_java_libs := $(addprefix $(HOST_OUT_JAVA_LIBRARIES)/,$(addsuffix $(COMMON_JAVA_PACKAGE_SUFFIX),$(LOCAL_JAVA_LIBRARIES))) 431full_java_lib_deps := $(full_java_libs) 432endif # LOCAL_BUILD_HOST_DEX 433else 434full_java_libs := $(call java-lib-files,$(LOCAL_JAVA_LIBRARIES),$(LOCAL_IS_HOST_MODULE)) 435full_java_lib_deps := $(call java-lib-deps,$(LOCAL_JAVA_LIBRARIES),$(LOCAL_IS_HOST_MODULE)) 436endif # !LOCAL_IS_HOST_MODULE 437full_java_libs += $(full_static_java_libs) $(LOCAL_CLASSPATH) 438full_java_lib_deps += $(full_static_java_libs) $(LOCAL_CLASSPATH) 439 440# This is set by packages that contain instrumentation, allowing them to 441# link against the package they are instrumenting. Currently only one such 442# package is allowed. 443LOCAL_INSTRUMENTATION_FOR := $(strip $(LOCAL_INSTRUMENTATION_FOR)) 444ifdef LOCAL_INSTRUMENTATION_FOR 445 ifneq ($(words $(LOCAL_INSTRUMENTATION_FOR)),1) 446 $(error \ 447 $(LOCAL_PATH): Multiple LOCAL_INSTRUMENTATION_FOR members defined) 448 endif 449 450 link_instr_intermediates_dir := $(call intermediates-dir-for, \ 451 APPS,$(LOCAL_INSTRUMENTATION_FOR)) 452 link_instr_intermediates_dir.COMMON := $(call intermediates-dir-for, \ 453 APPS,$(LOCAL_INSTRUMENTATION_FOR),,COMMON) 454 455 # link against the jar with full original names (before proguard processing). 456 full_java_libs += $(link_instr_intermediates_dir.COMMON)/classes.jar 457 full_java_lib_deps += $(link_instr_intermediates_dir.COMMON)/classes.jar 458endif 459 460jar_manifest_file := 461ifneq ($(strip $(LOCAL_JAR_MANIFEST)),) 462jar_manifest_file := $(LOCAL_PATH)/$(LOCAL_JAR_MANIFEST) 463$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_JAR_MANIFEST := $(jar_manifest_file) 464else 465$(LOCAL_INTERMEDIATE_TARGETS): PRIVATE_JAR_MANIFEST := 466endif 467 468endif 469 470 471########################################################### 472## make clean- targets 473########################################################### 474cleantarget := clean-$(LOCAL_MODULE) 475$(cleantarget) : PRIVATE_MODULE := $(LOCAL_MODULE) 476$(cleantarget) : PRIVATE_CLEAN_FILES := \ 477 $(PRIVATE_CLEAN_FILES) \ 478 $(LOCAL_BUILT_MODULE) \ 479 $(LOCAL_INSTALLED_MODULE) \ 480 $(intermediates) 481$(cleantarget):: 482 @echo "Clean: $(PRIVATE_MODULE)" 483 $(hide) rm -rf $(PRIVATE_CLEAN_FILES) 484 485########################################################### 486## Common definitions for module. 487########################################################### 488 489# Propagate local configuration options to this target. 490$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_PATH:=$(LOCAL_PATH) 491$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_POST_PROCESS_COMMAND:= $(LOCAL_POST_PROCESS_COMMAND) 492$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_AAPT_FLAGS:= $(LOCAL_AAPT_FLAGS) 493$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_JAVA_LIBRARIES:= $(LOCAL_JAVA_LIBRARIES) 494$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_MANIFEST_PACKAGE_NAME:= $(LOCAL_MANIFEST_PACKAGE_NAME) 495$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_MANIFEST_INSTRUMENTATION_FOR:= $(LOCAL_MANIFEST_INSTRUMENTATION_FOR) 496 497$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_ALL_JAVA_LIBRARIES:= $(full_java_libs) 498$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_IS_HOST_MODULE := $(LOCAL_IS_HOST_MODULE) 499$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_HOST:= $(my_host) 500 501$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_INTERMEDIATES_DIR:= $(intermediates) 502 503# Tell the module and all of its sub-modules who it is. 504$(LOCAL_INTERMEDIATE_TARGETS) : PRIVATE_MODULE:= $(LOCAL_MODULE) 505 506# Provide a short-hand for building this module. 507# We name both BUILT and INSTALLED in case 508# LOCAL_UNINSTALLABLE_MODULE is set. 509.PHONY: $(LOCAL_MODULE) 510$(LOCAL_MODULE): $(LOCAL_BUILT_MODULE) $(LOCAL_INSTALLED_MODULE) 511 512########################################################### 513## Module installation rule 514########################################################### 515 516# Some hosts do not have ACP; override the LOCAL version if that's the case. 517ifneq ($(strip $(HOST_ACP_UNAVAILABLE)),) 518 LOCAL_ACP_UNAVAILABLE := $(strip $(HOST_ACP_UNAVAILABLE)) 519endif 520 521ifndef LOCAL_UNINSTALLABLE_MODULE 522 # Define a copy rule to install the module. 523 # acp and libraries that it uses can't use acp for 524 # installation; hence, LOCAL_ACP_UNAVAILABLE. 525ifneq ($(LOCAL_ACP_UNAVAILABLE),true) 526$(LOCAL_INSTALLED_MODULE): $(LOCAL_BUILT_MODULE) | $(ACP) 527 @echo "Install: $@" 528 $(copy-file-to-new-target) 529else 530$(LOCAL_INSTALLED_MODULE): $(LOCAL_BUILT_MODULE) 531 @echo "Install: $@" 532 $(copy-file-to-target-with-cp) 533endif 534 535ifdef LOCAL_DEX_PREOPT 536installed_odex := $(basename $(LOCAL_INSTALLED_MODULE)).odex 537built_odex := $(basename $(LOCAL_BUILT_MODULE)).odex 538$(installed_odex) : $(built_odex) | $(ACP) 539 @echo "Install: $@" 540 $(copy-file-to-target) 541 542$(LOCAL_INSTALLED_MODULE) : $(installed_odex) 543endif 544 545endif # !LOCAL_UNINSTALLABLE_MODULE 546 547 548########################################################### 549## CHECK_BUILD goals 550########################################################### 551 552# If nobody has defined a more specific module for the 553# checked modules, use LOCAL_BUILT_MODULE. This was old 554# behavior, so it should be a safe default. 555ifndef LOCAL_CHECKED_MODULE 556 ifndef LOCAL_SDK_VERSION 557 LOCAL_CHECKED_MODULE := $(LOCAL_BUILT_MODULE) 558 endif 559endif 560 561# If they request that this module not be checked, then don't. 562# PLEASE DON'T SET THIS. ANY PLACES THAT SET THIS WITHOUT 563# GOOD REASON WILL HAVE IT REMOVED. 564ifdef LOCAL_DONT_CHECK_MODULE 565 LOCAL_CHECKED_MODULE := 566endif 567 568########################################################### 569## Register with ALL_MODULES 570########################################################### 571 572ALL_MODULES += $(LOCAL_MODULE) 573 574# Don't use += on subvars, or else they'll end up being 575# recursively expanded. 576ALL_MODULES.$(LOCAL_MODULE).CLASS := \ 577 $(ALL_MODULES.$(LOCAL_MODULE).CLASS) $(LOCAL_MODULE_CLASS) 578ALL_MODULES.$(LOCAL_MODULE).PATH := \ 579 $(ALL_MODULES.$(LOCAL_MODULE).PATH) $(LOCAL_PATH) 580ALL_MODULES.$(LOCAL_MODULE).TAGS := \ 581 $(ALL_MODULES.$(LOCAL_MODULE).TAGS) $(LOCAL_MODULE_TAGS) 582ALL_MODULES.$(LOCAL_MODULE).CHECKED := \ 583 $(ALL_MODULES.$(LOCAL_MODULE).CHECKED) $(LOCAL_CHECKED_MODULE) 584ALL_MODULES.$(LOCAL_MODULE).BUILT := \ 585 $(ALL_MODULES.$(LOCAL_MODULE).BUILT) $(LOCAL_BUILT_MODULE) 586ALL_MODULES.$(LOCAL_MODULE).INSTALLED := \ 587 $(ALL_MODULES.$(LOCAL_MODULE).INSTALLED) $(LOCAL_INSTALLED_MODULE) 588ALL_MODULES.$(LOCAL_MODULE).REQUIRED := \ 589 $(ALL_MODULES.$(LOCAL_MODULE).REQUIRED) $(LOCAL_REQUIRED_MODULES) 590ALL_MODULES.$(LOCAL_MODULE).EVENT_LOG_TAGS := \ 591 $(ALL_MODULES.$(LOCAL_MODULE).EVENT_LOG_TAGS) $(event_log_tags) 592ALL_MODULES.$(LOCAL_MODULE).INTERMEDIATE_SOURCE_DIR := \ 593 $(ALL_MODULES.$(LOCAL_MODULE).INTERMEDIATE_SOURCE_DIR) $(LOCAL_INTERMEDIATE_SOURCE_DIR) 594ifdef LOCAL_MODULE_OWNER 595ALL_MODULES.$(LOCAL_MODULE).OWNER := \ 596 $(strip $(ALL_MODULES.$(LOCAL_MODULE).OWNER) $(LOCAL_MODULE_OWNER)) 597endif 598 599INSTALLABLE_FILES.$(LOCAL_INSTALLED_MODULE).MODULE := $(LOCAL_MODULE) 600 601########################################################### 602## Take care of LOCAL_MODULE_TAGS 603########################################################### 604 605# Keep track of all the tags we've seen. 606ALL_MODULE_TAGS := $(sort $(ALL_MODULE_TAGS) $(LOCAL_MODULE_TAGS)) 607 608# Add this module to the tag list of each specified tag. 609# Don't use "+=". If the variable hasn't been set with ":=", 610# it will default to recursive expansion. 611$(foreach tag,$(LOCAL_MODULE_TAGS),\ 612 $(eval ALL_MODULE_TAGS.$(tag) := \ 613 $(ALL_MODULE_TAGS.$(tag)) \ 614 $(LOCAL_INSTALLED_MODULE))) 615 616# Add this module name to the tag list of each specified tag. 617$(foreach tag,$(LOCAL_MODULE_TAGS),\ 618 $(eval ALL_MODULE_NAME_TAGS.$(tag) += $(LOCAL_MODULE))) 619 620########################################################### 621## NOTICE files 622########################################################### 623 624include $(BUILD_SYSTEM)/notice_files.mk 625 626#:vi noexpandtab 627