1 # Copyright (C) 2007 The Android Open Source Project
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
7 # http://www.apache.org/licenses/LICENSE-2.0
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.
16 # Don't bother with the cleanspecs if you are running mm/mmm
17 ifeq ($(ONE_SHOT_MAKEFILE)$(dont_bother),)
19 INTERNAL_CLEAN_STEPS :=
21 # Builds up a list of clean steps. Creates a unique
22 # id for each step by taking makefile path, INTERNAL_CLEAN_BUILD_VERSION
23 # and appending an increasing number of '@' characters.
25 # $(1): shell command to run
26 # $(2): indicate to not use makefile path as part of step id if not empty.
27 # $(2) should only be used in build/core/cleanspec.mk: just for compatibility.
28 define _add-clean-step
29 $(if $(strip $(INTERNAL_CLEAN_BUILD_VERSION)),, \
30 $(error INTERNAL_CLEAN_BUILD_VERSION not set))
31 $(eval _acs_makefile_prefix := $(lastword $(MAKEFILE_LIST)))
32 $(eval _acs_makefile_prefix := $(subst /,_,$(_acs_makefile_prefix)))
33 $(eval _acs_makefile_prefix := $(subst .,-,$(_acs_makefile_prefix)))
34 $(eval _acs_makefile_prefix := $(_acs_makefile_prefix)_acs)
35 $(if $($(_acs_makefile_prefix)),,\
36 $(eval $(_acs_makefile_prefix) := $(INTERNAL_CLEAN_BUILD_VERSION)))
37 $(eval $(_acs_makefile_prefix) := $($(_acs_makefile_prefix))@)
38 $(if $(strip $(2)),$(eval _acs_id := $($(_acs_makefile_prefix))),\
39 $(eval _acs_id := $(_acs_makefile_prefix)$($(_acs_makefile_prefix))))
40 $(eval INTERNAL_CLEAN_STEPS += $(_acs_id))
41 $(eval INTERNAL_CLEAN_STEP.$(_acs_id) := $(1))
43 $(eval _acs_makefile_prefix :=)
46 $(eval # for build/core/cleanspec.mk, dont use makefile path as part of step id) \
47 $(if $(filter %/cleanspec.mk,$(lastword $(MAKEFILE_LIST))),\
48 $(eval $(call _add-clean-step,$(1),true)),\
49 $(eval $(call _add-clean-step,$(1))))
52 # Defines INTERNAL_CLEAN_BUILD_VERSION and the individual clean steps.
53 # cleanspec.mk is outside of the core directory so that more people
54 # can have permission to touch it.
55 include $(BUILD_SYSTEM)/cleanspec.mk
56 INTERNAL_CLEAN_BUILD_VERSION := $(strip $(INTERNAL_CLEAN_BUILD_VERSION))
57 INTERNAL_CLEAN_STEPS := $(strip $(INTERNAL_CLEAN_STEPS))
59 # If the clean_steps.mk file is missing (usually after a clean build)
60 # then we won't do anything.
61 CURRENT_CLEAN_BUILD_VERSION := $(INTERNAL_CLEAN_BUILD_VERSION)
62 CURRENT_CLEAN_STEPS := $(INTERNAL_CLEAN_STEPS)
64 # Read the current state from the file, if present.
65 # Will set CURRENT_CLEAN_BUILD_VERSION and CURRENT_CLEAN_STEPS.
67 clean_steps_file := $(PRODUCT_OUT)/clean_steps.mk
68 -include $(clean_steps_file)
70 ifneq ($(CURRENT_CLEAN_BUILD_VERSION),$(INTERNAL_CLEAN_BUILD_VERSION))
71 # The major clean version is out-of-date. Do a full clean, and
72 # don't even bother with the clean steps.
73 $(info *** A clean build is required because of a recent change.)
74 $(shell rm -rf $(OUT_DIR))
75 $(info *** Done with the cleaning, now starting the real build.)
77 # The major clean version is correct. Find the list of clean steps
78 # that we need to execute to get up-to-date.
80 $(filter-out $(CURRENT_CLEAN_STEPS),$(INTERNAL_CLEAN_STEPS))
81 $(foreach step,$(steps), \
82 $(info Clean step: $(INTERNAL_CLEAN_STEP.$(step))) \
83 $(shell $(INTERNAL_CLEAN_STEP.$(step))) \
86 # Rewrite the clean step for the second arch.
88 # $(1): the clean step cmd
89 # $(2): the prefix to search for
90 # $(3): the prefix to replace with
91 define -cs-rewrite-cleanstep
92 $(if $(filter $(2)/%,$(1)),\
93 $(eval _crs_new_cmd := $(patsubst $(2)/%,$(3)/%,$(1)))\
94 $(info Clean step: $(_crs_new_cmd))\
95 $(shell $(_crs_new_cmd)))
97 $(foreach step,$(steps), \
98 $(call -cs-rewrite-cleanstep,$(INTERNAL_CLEAN_STEP.$(step)),$(TARGET_OUT_INTERMEDIATES),$($(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_OUT_INTERMEDIATES))\
99 $(call -cs-rewrite-cleanstep,$(INTERNAL_CLEAN_STEP.$(step)),$(TARGET_OUT_SHARED_LIBRARIES),$($(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_OUT_SHARED_LIBRARIES))\
100 $(call -cs-rewrite-cleanstep,$(INTERNAL_CLEAN_STEP.$(step)),$(TARGET_OUT_VENDOR_SHARED_LIBRARIES),$($(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_OUT_VENDOR_SHARED_LIBRARIES))\
101 $(call -cs-rewrite-cleanstep,$(INTERNAL_CLEAN_STEP.$(step)),$($(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_OUT_INTERMEDIATES),$(TARGET_OUT_INTERMEDIATES))\
102 $(call -cs-rewrite-cleanstep,$(INTERNAL_CLEAN_STEP.$(step)),$($(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_OUT_SHARED_LIBRARIES),$(TARGET_OUT_SHARED_LIBRARIES))\
103 $(call -cs-rewrite-cleanstep,$(INTERNAL_CLEAN_STEP.$(step)),$($(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_OUT_VENDOR_SHARED_LIBRARIES),$(TARGET_OUT_VENDOR_SHARED_LIBRARIES))\
110 # Write the new state to the file.
112 rewrite_clean_steps_file :=
113 ifneq ($(CURRENT_CLEAN_BUILD_VERSION)-$(CURRENT_CLEAN_STEPS),$(INTERNAL_CLEAN_BUILD_VERSION)-$(INTERNAL_CLEAN_STEPS))
114 rewrite_clean_steps_file := true
116 ifeq ($(wildcard $(clean_steps_file)),)
117 # This is the first build.
118 rewrite_clean_steps_file := true
120 ifeq ($(rewrite_clean_steps_file),true)
122 mkdir -p $(dir $(clean_steps_file)) && \
123 echo "CURRENT_CLEAN_BUILD_VERSION := $(INTERNAL_CLEAN_BUILD_VERSION)" > \
124 $(clean_steps_file) ;\
125 echo "CURRENT_CLEAN_STEPS := $(wordlist 1,500,$(INTERNAL_CLEAN_STEPS))" >> $(clean_steps_file) \
127 define -cs-write-clean-steps-if-arg1-not-empty
128 $(if $(1),$(shell echo "CURRENT_CLEAN_STEPS += $(1)" >> $(clean_steps_file)))
130 $(call -cs-write-clean-steps-if-arg1-not-empty,$(wordlist 501,1000,$(INTERNAL_CLEAN_STEPS)))
131 $(call -cs-write-clean-steps-if-arg1-not-empty,$(wordlist 1001,1500,$(INTERNAL_CLEAN_STEPS)))
132 $(call -cs-write-clean-steps-if-arg1-not-empty,$(wordlist 1501,2000,$(INTERNAL_CLEAN_STEPS)))
133 $(call -cs-write-clean-steps-if-arg1-not-empty,$(wordlist 2001,2500,$(INTERNAL_CLEAN_STEPS)))
134 $(call -cs-write-clean-steps-if-arg1-not-empty,$(wordlist 2501,3000,$(INTERNAL_CLEAN_STEPS)))
135 $(call -cs-write-clean-steps-if-arg1-not-empty,$(wordlist 3001,99999,$(INTERNAL_CLEAN_STEPS)))
138 CURRENT_CLEAN_BUILD_VERSION :=
139 CURRENT_CLEAN_STEPS :=
141 rewrite_clean_steps_file :=
142 INTERNAL_CLEAN_STEPS :=
143 INTERNAL_CLEAN_BUILD_VERSION :=
145 endif # if not ONE_SHOT_MAKEFILE dont_bother
147 # Since products and build variants (unfortunately) share the same
148 # PRODUCT_OUT staging directory, things can get out of sync if different
149 # build configurations are built in the same tree. The following logic
150 # will notice when the configuration has changed and remove the files
151 # necessary to keep things consistent.
153 previous_build_config_file := $(PRODUCT_OUT)/previous_build_config.mk
155 # A change in the list of aapt configs warrants an installclean, too.
156 aapt_config_list := $(strip $(PRODUCT_AAPT_CONFIG) $(PRODUCT_AAPT_PREF_CONFIG))
158 current_build_config := \
159 $(TARGET_PRODUCT)-$(TARGET_BUILD_VARIANT)-{$(aapt_config_list)}
160 current_sanitize_target := $(strip $(SANITIZE_TARGET))
161 ifeq (,$(current_sanitize_target))
162 current_sanitize_target := false
165 force_installclean := false
166 force_objclean := false
168 # Read the current state from the file, if present.
169 # Will set PREVIOUS_BUILD_CONFIG.
171 PREVIOUS_BUILD_CONFIG :=
172 PREVIOUS_SANITIZE_TARGET :=
173 -include $(previous_build_config_file)
174 PREVIOUS_BUILD_CONFIG := $(strip $(PREVIOUS_BUILD_CONFIG))
175 PREVIOUS_SANITIZE_TARGET := $(strip $(PREVIOUS_SANITIZE_TARGET))
177 ifdef PREVIOUS_BUILD_CONFIG
178 ifneq "$(current_build_config)" "$(PREVIOUS_BUILD_CONFIG)"
179 $(info *** Build configuration changed: "$(PREVIOUS_BUILD_CONFIG)" -> "$(current_build_config)")
180 ifneq ($(DISABLE_AUTO_INSTALLCLEAN),true)
181 force_installclean := true
183 $(info DISABLE_AUTO_INSTALLCLEAN is set; skipping auto-clean. Your tree may be in an inconsistent state.)
186 endif # else, this is the first build, so no need to clean.
188 ifdef PREVIOUS_SANITIZE_TARGET
189 ifneq "$(current_sanitize_target)" "$(PREVIOUS_SANITIZE_TARGET)"
190 $(info *** SANITIZE_TARGET changed: "$(PREVIOUS_SANITIZE_TARGET)" -> "$(current_sanitize_target)")
191 force_objclean := true
193 endif # else, this is the first build, so no need to clean.
195 # Write the new state to the file.
197 ifneq ($(PREVIOUS_BUILD_CONFIG)-$(PREVIOUS_SANITIZE_TARGET),$(current_build_config)-$(current_sanitize_target))
199 mkdir -p $(dir $(previous_build_config_file)) && \
200 echo "PREVIOUS_BUILD_CONFIG := $(current_build_config)" > \
201 $(previous_build_config_file) && \
202 echo "PREVIOUS_SANITIZE_TARGET := $(current_sanitize_target)" >> \
203 $(previous_build_config_file) \
206 PREVIOUS_BUILD_CONFIG :=
207 PREVIOUS_SANITIZE_TARGET :=
208 previous_build_config_file :=
209 current_build_config :=
215 # The files/dirs to delete during an installclean. This includes the
216 # non-common APPS directory, which may contain the wrong resources.
218 # Deletes all of the files that change between different build types,
219 # like "make user" vs. "make sdk". This lets you work with different
220 # build types without having to do a full clean each time. E.g.:
223 # $ make installclean
225 # $ make installclean
228 installclean_files := \
229 $(HOST_OUT)/obj/NOTICE_FILES \
231 $(PRODUCT_OUT)/*.img \
232 $(PRODUCT_OUT)/*.ini \
233 $(PRODUCT_OUT)/*.txt \
234 $(PRODUCT_OUT)/*.xlb \
235 $(PRODUCT_OUT)/*.zip \
236 $(PRODUCT_OUT)/kernel \
237 $(PRODUCT_OUT)/data \
238 $(PRODUCT_OUT)/skin \
239 $(PRODUCT_OUT)/obj/APPS \
240 $(PRODUCT_OUT)/obj/NOTICE_FILES \
241 $(PRODUCT_OUT)/obj/PACKAGING \
242 $(PRODUCT_OUT)/recovery \
243 $(PRODUCT_OUT)/root \
244 $(PRODUCT_OUT)/system \
245 $(PRODUCT_OUT)/system_other \
246 $(PRODUCT_OUT)/vendor \
248 $(PRODUCT_OUT)/dex_bootjars \
249 $(PRODUCT_OUT)/obj/JAVA_LIBRARIES \
250 $(PRODUCT_OUT)/obj/FAKE \
251 $(PRODUCT_OUT)/obj/EXECUTABLES/adbd_intermediates \
252 $(PRODUCT_OUT)/obj/EXECUTABLES/logd_intermediates \
253 $(PRODUCT_OUT)/obj/STATIC_LIBRARIES/libfs_mgr_intermediates \
254 $(PRODUCT_OUT)/obj/EXECUTABLES/init_intermediates \
255 $(PRODUCT_OUT)/obj/ETC/mac_permissions.xml_intermediates \
256 $(PRODUCT_OUT)/obj/ETC/sepolicy_intermediates \
257 $(PRODUCT_OUT)/obj/ETC/sepolicy.recovery_intermediates \
258 $(PRODUCT_OUT)/obj/ETC/init.environ.rc_intermediates
260 # The files/dirs to delete during a dataclean, which removes any files
261 # in the staging and emulator data partitions.
263 $(PRODUCT_OUT)/data/* \
264 $(PRODUCT_OUT)/data-qemu/* \
265 $(PRODUCT_OUT)/userdata-qemu.img
267 # The files/dirs to delete during an objclean, which removes any files
268 # in the staging and emulator data partitions.
270 $(TARGET_OUT_INTERMEDIATES) \
271 $($(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_OUT_INTERMEDIATES)
273 # make sure *_OUT is set so that we won't result in deleting random parts
275 ifneq (2,$(words $(HOST_OUT) $(PRODUCT_OUT)))
276 $(error both HOST_OUT and PRODUCT_OUT should be set at this point.)
279 # Define the rules for commandline invocation.
281 dataclean: FILES := $(dataclean_files)
283 $(hide) rm -rf $(FILES)
284 @echo "Deleted emulator userdata images."
287 installclean: FILES := $(installclean_files)
288 installclean: dataclean
289 $(hide) rm -rf $(FILES)
290 @echo "Deleted images and staging directories."
293 objclean: FILES := $(objclean_files)
295 $(hide) rm -rf $(FILES)
296 @echo "Deleted images and staging directories."
298 ifeq "$(force_installclean)" "true"
299 $(info *** Forcing "make installclean"...)
300 $(info *** rm -rf $(dataclean_files) $(installclean_files))
301 $(shell rm -rf $(dataclean_files) $(installclean_files))
302 $(info *** Done with the cleaning, now starting the real build.)
304 force_installclean :=
306 ifeq "$(force_objclean)" "true"
307 $(info *** Forcing cleanup of intermediate files...)
308 $(info *** rm -rf $(objclean_files))
309 $(shell rm -rf $(objclean_files))
310 $(info *** Done with the cleaning, now starting the real build.)
314 ###########################################################
316 .PHONY: clean-jack-files
317 clean-jack-files: clean-dex-files
318 $(hide) find $(OUT_DIR) -name "*.jack" | xargs rm -f
319 $(hide) find $(OUT_DIR) -type d -name "jack" | xargs rm -rf
320 @echo "All jack files have been removed."
322 .PHONY: clean-dex-files
324 $(hide) find $(OUT_DIR) -name "*.dex" ! -path "*/jack-incremental/*" | xargs rm -f
325 $(hide) for i in `find $(OUT_DIR) -name "*.jar" -o -name "*.apk"` ; do ((unzip -l $$i 2> /dev/null | \
326 grep -q "\.dex$$" && rm -f $$i) || continue ) ; done
327 @echo "All dex files and archives containing dex files have been removed."
329 .PHONY: clean-jack-incremental
330 clean-jack-incremental:
331 $(hide) find $(OUT_DIR) -name "jack-incremental" -type d | xargs rm -rf
332 @echo "All jack incremental dirs have been removed."