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 LOCAL_UNSTRIPPED_PATH := $(strip $(LOCAL_UNSTRIPPED_PATH))
  16 ifeq ($(LOCAL_UNSTRIPPED_PATH),)
  17   ifeq ($(LOCAL_MODULE_PATH),)
  18     LOCAL_UNSTRIPPED_PATH := $(TARGET_OUT_$(LOCAL_MODULE_CLASS)_UNSTRIPPED)
  19   else
  20     # We have to figure out the corresponding unstripped path if LOCAL_MODULE_PATH is customized.
  21     LOCAL_UNSTRIPPED_PATH := $(TARGET_OUT_UNSTRIPPED)/$(patsubst $(PRODUCT_OUT)/%,%,$(LOCAL_MODULE_PATH))
  22   endif
  23 endif
  24
  25 # The name of the target file, without any path prepended.
  26 # TODO: This duplicates logic from base_rules.mk because we need to
  27 #       know its results before base_rules.mk is included.
  28 #       Consolidate the duplicates.
  29 LOCAL_MODULE_STEM := $(strip $(LOCAL_MODULE_STEM))
  30 ifeq ($(LOCAL_MODULE_STEM),)
  31   LOCAL_MODULE_STEM := $(LOCAL_MODULE)
  32 endif
  33 LOCAL_INSTALLED_MODULE_STEM := $(LOCAL_MODULE_STEM)$(LOCAL_MODULE_SUFFIX)
  34 LOCAL_BUILT_MODULE_STEM := $(LOCAL_INSTALLED_MODULE_STEM)
  35
  36 # base_rules.make defines $(intermediates), but we need its value
  37 # before we include base_rules.  Make a guess, and verify that
  38 # it's correct once the real value is defined.
  39 guessed_intermediates := $(call local-intermediates-dir)
  40
  41 # Define the target that is the unmodified output of the linker.
  42 # The basename of this target must be the same as the final output
  43 # binary name, because it's used to set the "soname" in the binary.
  44 # The includer of this file will define a rule to build this target.
  45 linked_module := $(guessed_intermediates)/LINKED/$(LOCAL_BUILT_MODULE_STEM)
  46
  47 ALL_ORIGINAL_DYNAMIC_BINARIES += $(linked_module)
  48
  49 # Because TARGET_SYMBOL_FILTER_FILE depends on ALL_ORIGINAL_DYNAMIC_BINARIES,
  50 # the linked_module rules won't necessarily inherit the PRIVATE_
  51 # variables from LOCAL_BUILT_MODULE.  This tells binary.make to explicitly
  52 # define the PRIVATE_ variables for linked_module as well as for
  53 # LOCAL_BUILT_MODULE.
  54 LOCAL_INTERMEDIATE_TARGETS := $(linked_module)
  55
  56 ###################################
  57 include $(BUILD_SYSTEM)/binary.mk
  58 ###################################
  59
  60 # Make sure that our guess at the value of intermediates was correct.
  61 ifneq ($(intermediates),$(guessed_intermediates))
  62 $(error Internal error: guessed path '$(guessed_intermediates)' doesn't match '$(intermediates))
  63 endif
  64
  65 ###########################################################
  66 ## Compress
  67 ###########################################################
  68 compress_input := $(linked_module)
  69
  70 ifeq ($(strip $(LOCAL_COMPRESS_MODULE_SYMBOLS)),)
  71   LOCAL_COMPRESS_MODULE_SYMBOLS := $(strip $(TARGET_COMPRESS_MODULE_SYMBOLS))
  72 endif
  73
  74 ifeq ($(LOCAL_COMPRESS_MODULE_SYMBOLS),true)
  75 $(error Symbol compression not yet supported.)
  76 compress_output := $(intermediates)/COMPRESSED-$(LOCAL_BUILT_MODULE_STEM)
  77
  78 #TODO: write the real $(STRIPPER) rule.
  79 #TODO: define a rule to build TARGET_SYMBOL_FILTER_FILE, and
  80 #      make it depend on ALL_ORIGINAL_DYNAMIC_BINARIES.
  81 $(compress_output): $(compress_input) $(TARGET_SYMBOL_FILTER_FILE) | $(ACP)
  82         @echo "target Compress Symbols: $(PRIVATE_MODULE) ($@)"
  83         $(copy-file-to-target)
  84 else
  85 # Skip this step.
  86 compress_output := $(compress_input)
  87 endif
  88
  89 ###########################################################
  90 ## Store a copy with symbols for symbolic debugging
  91 ###########################################################
  92 symbolic_input := $(compress_output)
  93 symbolic_output := $(LOCAL_UNSTRIPPED_PATH)/$(LOCAL_BUILT_MODULE_STEM)
  94 $(symbolic_output) : $(symbolic_input) | $(ACP)
  95         @echo "target Symbolic: $(PRIVATE_MODULE) ($@)"
  96         $(copy-file-to-target)
  97
  98
  99 ###########################################################
 100 ## Strip
 101 ###########################################################
 102 strip_input := $(symbolic_output)
 103 strip_output := $(LOCAL_BUILT_MODULE)
 104
 105 ifeq ($(strip $(LOCAL_STRIP_MODULE)),)
 106   LOCAL_STRIP_MODULE := $(strip $(TARGET_STRIP_MODULE))
 107 endif
 108
 109 ifeq ($(LOCAL_STRIP_MODULE),true)
 110 # Strip the binary
 111 $(strip_output): $(strip_input) | $(TARGET_STRIP)
 112         $(transform-to-stripped)
 113 else
 114 # Don't strip the binary, just copy it.  We can't skip this step
 115 # because a copy of the binary must appear at LOCAL_BUILT_MODULE.
 116 #
 117 # If the binary we're copying is acp or a prerequisite,
 118 # use cp(1) instead.
 119 ifneq ($(LOCAL_ACP_UNAVAILABLE),true)
 120 $(strip_output): $(strip_input) | $(ACP)
 121         @echo "target Unstripped: $(PRIVATE_MODULE) ($@)"
 122         $(copy-file-to-target)
 123 else
 124 $(strip_output): $(strip_input)
 125         @echo "target Unstripped: $(PRIVATE_MODULE) ($@)"
 126         $(copy-file-to-target-with-cp)
 127 endif
 128 endif # LOCAL_STRIP_MODULE
 129
 130
 131 $(cleantarget): PRIVATE_CLEAN_FILES := \
 132                         $(PRIVATE_CLEAN_FILES) \
 133                         $(linked_module) \
 134                         $(symbolic_output) \
 135                         $(compress_output)