core/dynamic_binary.mk

   1 ###########################################################
   2 ## Standard rules for building any target-side binaries
   3 ## with dynamic linkage (dynamic libraries or executables
   4 ## that link with dynamic libraries)
   5 ##
   6 ## Files including this file must define a rule to build
   7 ## the target $(linked_module).
   8 ###########################################################
   9
  10 # This constraint means that we can hard-code any $(TARGET_*) variables.
  11 ifdef LOCAL_IS_HOST_MODULE
  12 $(error This file should not be used to build host binaries.  Included by (or near) $(lastword $(filter-out config/%,$(MAKEFILE_LIST))))
  13 endif
  14
  15 # The name of the target file, without any path prepended.
  16 # This duplicates logic from base_rules.mk because we need to
  17 # know its results before base_rules.mk is included.
  18 include $(BUILD_SYSTEM)/configure_module_stem.mk
  19
  20 intermediates := $(call local-intermediates-dir,,$(LOCAL_2ND_ARCH_VAR_PREFIX))
  21
  22 # Define the target that is the unmodified output of the linker.
  23 # The basename of this target must be the same as the final output
  24 # binary name, because it's used to set the "soname" in the binary.
  25 # The includer of this file will define a rule to build this target.
  26 linked_module := $(intermediates)/LINKED/$(my_built_module_stem)
  27
  28 ALL_ORIGINAL_DYNAMIC_BINARIES += $(linked_module)
  29
  30 # Because TARGET_SYMBOL_FILTER_FILE depends on ALL_ORIGINAL_DYNAMIC_BINARIES,
  31 # the linked_module rules won't necessarily inherit the PRIVATE_
  32 # variables from LOCAL_BUILT_MODULE.  This tells binary.make to explicitly
  33 # define the PRIVATE_ variables for linked_module as well as for
  34 # LOCAL_BUILT_MODULE.
  35 LOCAL_INTERMEDIATE_TARGETS := $(linked_module)
  36
  37 ###################################
  38 include $(BUILD_SYSTEM)/binary.mk
  39 ###################################
  40
  41 ###########################################################
  42 ## Compress
  43 ###########################################################
  44 compress_input := $(linked_module)
  45
  46 ifeq ($(strip $(LOCAL_COMPRESS_MODULE_SYMBOLS)),)
  47   LOCAL_COMPRESS_MODULE_SYMBOLS := $(strip $(TARGET_COMPRESS_MODULE_SYMBOLS))
  48 endif
  49
  50 ifeq ($(LOCAL_COMPRESS_MODULE_SYMBOLS),true)
  51 $(error Symbol compression not yet supported.)
  52 compress_output := $(intermediates)/COMPRESSED-$(my_built_module_stem)
  53
  54 #TODO: write the real $(STRIPPER) rule.
  55 #TODO: define a rule to build TARGET_SYMBOL_FILTER_FILE, and
  56 #      make it depend on ALL_ORIGINAL_DYNAMIC_BINARIES.
  57 $(compress_output): $(compress_input) $(TARGET_SYMBOL_FILTER_FILE) | $(ACP)
  58         @echo "target Compress Symbols: $(PRIVATE_MODULE) ($@)"
  59         $(copy-file-to-target)
  60 else
  61 # Skip this step.
  62 compress_output := $(compress_input)
  63 endif
  64
  65 ###########################################################
  66 ## Store a copy with symbols for symbolic debugging
  67 ###########################################################
  68 ifeq ($(LOCAL_UNSTRIPPED_PATH),)
  69 my_unstripped_path := $(TARGET_OUT_UNSTRIPPED)/$(patsubst $(PRODUCT_OUT)/%,%,$(my_module_path))
  70 else
  71 my_unstripped_path := $(LOCAL_UNSTRIPPED_PATH)
  72 endif
  73 symbolic_input := $(compress_output)
  74 symbolic_output := $(my_unstripped_path)/$(my_installed_module_stem)
  75 $(symbolic_output) : $(symbolic_input) | $(ACP)
  76         @echo "target Symbolic: $(PRIVATE_MODULE) ($@)"
  77         $(copy-file-to-target)
  78
  79
  80 ###########################################################
  81 ## Strip
  82 ###########################################################
  83 strip_input := $(symbolic_output)
  84 strip_output := $(LOCAL_BUILT_MODULE)
  85
  86 my_strip_module := $(LOCAL_STRIP_MODULE)
  87 ifeq ($(my_strip_module),)
  88   my_strip_module := $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_STRIP_MODULE)
  89 endif
  90
  91 ifeq ($(my_strip_module),true)
  92 # Strip the binary
  93 $(strip_output): PRIVATE_STRIP := $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_STRIP)
  94 $(strip_output): PRIVATE_OBJCOPY := $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_OBJCOPY)
  95 $(strip_output): $(strip_input) | $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_STRIP)
  96         $(transform-to-stripped)
  97 else
  98 ifeq ($(my_strip_module),keep_symbols)
  99 # Strip only the debug frames, but leave the symbol table.
 100 $(strip_output): PRIVATE_STRIP := $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_STRIP)
 101 $(strip_output): PRIVATE_OBJCOPY := $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_OBJCOPY)
 102 $(strip_output): PRIVATE_READELF := $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_READELF)
 103 $(strip_output): $(strip_input) | $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_STRIP)
 104         $(transform-to-stripped-keep-symbols)
 105
 106 # A product may be configured to strip everything in some build variants.
 107 # We do the stripping as a post-install command so that LOCAL_BUILT_MODULE
 108 # is still with the symbols and we don't need to clean it (and relink) when
 109 # you switch build variant.
 110 ifneq ($(filter $(STRIP_EVERYTHING_BUILD_VARIANTS),$(TARGET_BUILD_VARIANT)),)
 111 $(LOCAL_INSTALLED_MODULE): PRIVATE_POST_INSTALL_CMD := \
 112   $($(LOCAL_2ND_ARCH_VAR_PREFIX)TARGET_STRIP) --strip-all $(LOCAL_INSTALLED_MODULE)
 113 endif
 114 else
 115 # Don't strip the binary, just copy it.  We can't skip this step
 116 # because a copy of the binary must appear at LOCAL_BUILT_MODULE.
 117 #
 118 # If the binary we're copying is acp or a prerequisite,
 119 # use cp(1) instead.
 120 ifneq ($(LOCAL_ACP_UNAVAILABLE),true)
 121 $(strip_output): $(strip_input) | $(ACP)
 122         @echo "target Unstripped: $(PRIVATE_MODULE) ($@)"
 123         $(copy-file-to-target)
 124 else
 125 $(strip_output): $(strip_input)
 126         @echo "target Unstripped: $(PRIVATE_MODULE) ($@)"
 127         $(copy-file-to-target-with-cp)
 128 endif
 129 endif
 130 endif # my_strip_module
 131
 132
 133 $(cleantarget): PRIVATE_CLEAN_FILES += \
 134     $(linked_module) \
 135     $(symbolic_output) \
 136     $(compress_output)