Home | History | Annotate | Download | only in tasks
      1 # Copyright (C) 2008 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 # Rules for running apicheck to confirm that you haven't broken
     17 # api compatibility or added apis illegally.
     18 #
     19 
     20 # skip api check for TINY_ANDROID and PDK buid
     21 ifeq (,$(filter true, $(BUILD_TINY_ANDROID) $(TARGET_BUILD_PDK)))
     22 
     23 .PHONY: checkapi
     24 
     25 # eval this to define a rule that runs apicheck.
     26 #
     27 # Args:
     28 #    $(1)  target
     29 #    $(2)  stable api file
     30 #    $(3)  api file to be tested
     31 #    $(4)  arguments for apicheck
     32 #    $(5)  command to run if apicheck failed
     33 define check-api
     34 $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/$(strip $(1))-timestamp: $(2) $(3) $(APICHECK)
     35 	@echo "Checking API:" $(1)
     36 	$(hide) ( $(APICHECK_COMMAND) $(4) $(2) $(3) || ( $(5) ; exit 38 ) )
     37 	$(hide) mkdir -p $$(dir $$@)
     38 	$(hide) touch $$@
     39 checkapi: $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/$(strip $(1))-timestamp
     40 endef
     41 
     42 # Run the checkapi rules by default.
     43 droidcore: checkapi
     44 
     45 last_released_sdk_version := $(lastword $(call numerically_sort, \
     46             $(filter-out $(SRC_API_DIR)/current, \
     47                 $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \
     48              )\
     49         ))
     50 
     51 # INTERNAL_PLATFORM_API_FILE is the one build by droiddoc.
     52 
     53 # Check that the API we're building hasn't broken the last-released
     54 # SDK version.
     55 $(eval $(call check-api, \
     56 	checkapi-last, \
     57 	$(SRC_API_DIR)/$(last_released_sdk_version).txt, \
     58 	$(INTERNAL_PLATFORM_API_FILE), \
     59 	-hide 2 -hide 3 -hide 4 -hide 5 -hide 6 -hide 24 -hide 25 \
     60 	-error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \
     61 	-error 16 -error 17 -error 18 , \
     62 	cat $(BUILD_SYSTEM)/apicheck_msg_last.txt \
     63 	))
     64 
     65 # Check that the API we're building hasn't changed from the not-yet-released
     66 # SDK version.
     67 $(eval $(call check-api, \
     68 	checkapi-current, \
     69 	$(SRC_API_DIR)/current.txt, \
     70 	$(INTERNAL_PLATFORM_API_FILE), \
     71 	-error 2 -error 3 -error 4 -error 5 -error 6 \
     72 	-error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \
     73 	-error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 \
     74 	-error 25 , \
     75 	cat $(BUILD_SYSTEM)/apicheck_msg_current.txt \
     76 	))
     77 
     78 .PHONY: update-api
     79 update-api: $(INTERNAL_PLATFORM_API_FILE) | $(ACP)
     80 	@echo Copying current.txt
     81 	$(hide) $(ACP) $(INTERNAL_PLATFORM_API_FILE) $(SRC_API_DIR)/current.txt
     82 
     83 endif
     84