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