core/cleanbuild.mk

   1 # Copyright (C) 2007 The Android Open Source Project
   2 #
   3 # Licensed under the Apache License, Version 2.0 (the "License");
   4 # you may not use this file except in compliance with the License.
   5 # You may obtain a copy of the License at
   6 #
   7 #      http://www.apache.org/licenses/LICENSE-2.0
   8 #
   9 # Unless required by applicable law or agreed to in writing, software
  10 # distributed under the License is distributed on an "AS IS" BASIS,
  11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 # See the License for the specific language governing permissions and
  13 # limitations under the License.
  14 #
  15
  16 INTERNAL_CLEAN_STEPS :=
  17
  18 # Builds up a list of clean steps.  Creates a unique
  19 # id for each step by taking INTERNAL_CLEAN_BUILD_VERSION
  20 # and appending an increasing number of '@' characters.
  21 #
  22 # $(1): shell command to run
  23 define _add-clean-step
  24   $(if $(strip $(INTERNAL_CLEAN_BUILD_VERSION)),, \
  25       $(error INTERNAL_CLEAN_BUILD_VERSION not set))
  26   $(eval _acs_id := $(strip $(lastword $(INTERNAL_CLEAN_STEPS))))
  27   $(if $(_acs_id),,$(eval _acs_id := $(INTERNAL_CLEAN_BUILD_VERSION)))
  28   $(eval _acs_id := $(_acs_id)@)
  29   $(eval INTERNAL_CLEAN_STEPS += $(_acs_id))
  30   $(eval INTERNAL_CLEAN_STEP.$(_acs_id) := $(1))
  31   $(eval _acs_id :=)
  32 endef
  33 define add-clean-step
  34 $(if $(call _add-clean-step,$(1)),)
  35 endef
  36
  37 # Defines INTERNAL_CLEAN_BUILD_VERSION and the individual clean steps.
  38 # cleanspec.mk is outside of the core directory so that more people
  39 # can have permission to touch it.
  40 include build/cleanspec.mk
  41 INTERNAL_CLEAN_BUILD_VERSION := $(strip $(INTERNAL_CLEAN_BUILD_VERSION))
  42
  43 # If the clean_steps.mk file is missing (usually after a clean build)
  44 # then we won't do anything.
  45 CURRENT_CLEAN_BUILD_VERSION := $(INTERNAL_CLEAN_BUILD_VERSION)
  46 CURRENT_CLEAN_STEPS := $(INTERNAL_CLEAN_STEPS)
  47
  48 # Read the current state from the file, if present.
  49 # Will set CURRENT_CLEAN_BUILD_VERSION and CURRENT_CLEAN_STEPS.
  50 #
  51 clean_steps_file := $(PRODUCT_OUT)/clean_steps.mk
  52 -include $(clean_steps_file)
  53
  54 ifneq ($(CURRENT_CLEAN_BUILD_VERSION),$(INTERNAL_CLEAN_BUILD_VERSION))
  55   # The major clean version is out-of-date.  Do a full clean, and
  56   # don't even bother with the clean steps.
  57   $(info *** A clean build is required because of a recent change.)
  58   $(shell rm -rf $(OUT_DIR))
  59   $(info *** Done with the cleaning, now starting the real build.)
  60 else
  61   # The major clean version is correct.  Find the list of clean steps
  62   # that we need to execute to get up-to-date.
  63   steps := \
  64       $(filter-out $(CURRENT_CLEAN_STEPS),$(INTERNAL_CLEAN_STEPS))
  65   $(foreach step,$(steps), \
  66     $(info Clean step: $(INTERNAL_CLEAN_STEP.$(step))) \
  67     $(shell $(INTERNAL_CLEAN_STEP.$(step))) \
  68    )
  69   steps :=
  70 endif
  71 CURRENT_CLEAN_BUILD_VERSION :=
  72 CURRENT_CLEAN_STEPS :=
  73
  74 # Write the new state to the file.
  75 #
  76 $(shell \
  77   mkdir -p $(dir $(clean_steps_file)) && \
  78   echo "CURRENT_CLEAN_BUILD_VERSION := $(INTERNAL_CLEAN_BUILD_VERSION)" > \
  79       $(clean_steps_file) ;\
  80   echo "CURRENT_CLEAN_STEPS := $(INTERNAL_CLEAN_STEPS)" >> \
  81       $(clean_steps_file) \
  82  )
  83
  84 clean_steps_file :=
  85 INTERNAL_CLEAN_STEPS :=
  86 INTERNAL_CLEAN_BUILD_VERSION :=
  87
  88
  89 # Since products and build variants (unfortunately) share the same
  90 # PRODUCT_OUT staging directory, things can get out of sync if different
  91 # build configurations are built in the same tree.  The following logic
  92 # will notice when the configuration has changed and remove the files
  93 # necessary to keep things consistent.
  94
  95 previous_build_config_file := $(PRODUCT_OUT)/previous_build_config.mk
  96
  97 # TODO: this special case for the sdk is only necessary while "sdk"
  98 # is a valid make target.  Eventually, it will just be a product, at
  99 # which point TARGET_PRODUCT will handle it and we can avoid this check
 100 # of MAKECMDGOALS.  The "addprefix" is just to keep things pretty.
 101 ifneq ($(TARGET_PRODUCT),sdk)
 102   building_sdk := $(addprefix -,$(filter sdk,$(MAKECMDGOALS)))
 103 else
 104   # Don't bother with this extra part when explicitly building the sdk product.
 105   building_sdk :=
 106 endif
 107
 108 # A change in the list of locales warrants an installclean, too.
 109 locale_list := $(subst $(space),$(comma),$(strip $(PRODUCT_LOCALES)))
 110
 111 current_build_config := \
 112     $(TARGET_PRODUCT)-$(TARGET_BUILD_VARIANT)$(building_sdk)-{$(locale_list)}
 113 building_sdk :=
 114 locale_list :=
 115 force_installclean := false
 116
 117 # Read the current state from the file, if present.
 118 # Will set PREVIOUS_BUILD_CONFIG.
 119 #
 120 PREVIOUS_BUILD_CONFIG :=
 121 -include $(previous_build_config_file)
 122 PREVIOUS_BUILD_CONFIG := $(strip $(PREVIOUS_BUILD_CONFIG))
 123 ifdef PREVIOUS_BUILD_CONFIG
 124   ifneq "$(current_build_config)" "$(PREVIOUS_BUILD_CONFIG)"
 125     $(info *** Build configuration changed: "$(PREVIOUS_BUILD_CONFIG)" -> "$(current_build_config)")
 126     force_installclean := true
 127   endif
 128 endif  # else, this is the first build, so no need to clean.
 129 PREVIOUS_BUILD_CONFIG :=
 130
 131 # Write the new state to the file.
 132 #
 133 $(shell \
 134   mkdir -p $(dir $(previous_build_config_file)) && \
 135   echo "PREVIOUS_BUILD_CONFIG := $(current_build_config)" > \
 136       $(previous_build_config_file) \
 137  )
 138 previous_build_config_file :=
 139 current_build_config :=
 140
 141 #
 142 # installclean logic
 143 #
 144
 145 # The files/dirs to delete during an installclean.  This includes the
 146 # non-common APPS directory, which may contain the wrong resources.
 147 # Use "./" in front of the paths to avoid accidentally deleting random
 148 # parts of the filesystem if any of the *_OUT vars resolve to blank.
 149 #
 150 # Deletes all of the files that change between different build types,
 151 # like "make user" vs. "make sdk".  This lets you work with different
 152 # build types without having to do a full clean each time.  E.g.:
 153 #
 154 #     $ make -j8 all
 155 #     $ make installclean
 156 #     $ make -j8 user
 157 #     $ make installclean
 158 #     $ make -j8 sdk
 159 #
 160 installclean_files := \
 161         ./$(HOST_OUT)/obj/NOTICE_FILES \
 162         ./$(HOST_OUT)/sdk \
 163         ./$(PRODUCT_OUT)/*.img \
 164         ./$(PRODUCT_OUT)/*.txt \
 165         ./$(PRODUCT_OUT)/*.xlb \
 166         ./$(PRODUCT_OUT)/*.zip \
 167         ./$(PRODUCT_OUT)/data \
 168         ./$(PRODUCT_OUT)/obj/APPS \
 169         ./$(PRODUCT_OUT)/obj/NOTICE_FILES \
 170         ./$(PRODUCT_OUT)/obj/PACKAGING \
 171         ./$(PRODUCT_OUT)/recovery \
 172         ./$(PRODUCT_OUT)/root \
 173         ./$(PRODUCT_OUT)/system
 174
 175 # The files/dirs to delete during a dataclean, which removes any files
 176 # in the staging and emulator data partitions.
 177 dataclean_files := \
 178         ./$(PRODUCT_OUT)/data/* \
 179         ./$(PRODUCT_OUT)/data-qemu/* \
 180         ./$(PRODUCT_OUT)/userdata-qemu.img
 181
 182 # Define the rules for commandline invocation.
 183 .PHONY: dataclean
 184 dataclean: FILES := $(dataclean_files)
 185 dataclean:
 186         $(hide) rm -rf $(FILES)
 187         @echo "Deleted emulator userdata images."
 188
 189 .PHONY: installclean
 190 installclean: FILES := $(installclean_files)
 191 installclean: dataclean
 192         $(hide) rm -rf $(FILES)
 193         @echo "Deleted images and staging directories."
 194
 195 ifeq "$(force_installclean)" "true"
 196   $(info *** Forcing "make installclean"...)
 197   $(shell rm -rf $(dataclean_files) $(installclean_files))
 198   $(info *** Done with the cleaning, now starting the real build.)
 199 endif
 200 force_installclean :=