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 PDK buid 21ifeq (,$(filter true, $(WITHOUT_CHECK_API) $(TARGET_BUILD_PDK))) 22 23.PHONY: checkapi 24 25# Run the checkapi rules by default. 26droidcore: checkapi 27 28last_released_sdk_version := $(lastword $(call numerically_sort, \ 29 $(filter-out current, \ 30 $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \ 31 )\ 32 )) 33 34# INTERNAL_PLATFORM_API_FILE is the one build by droiddoc. 35# Note that since INTERNAL_PLATFORM_API_FILE is the byproduct of api-stubs module, 36# (See frameworks/base/Android.mk) 37# we need to add api-stubs as additional dependency of the api check. 38 39# Check that the API we're building hasn't broken the last-released 40# SDK version. 41$(eval $(call check-api, \ 42 checkapi-last, \ 43 $(SRC_API_DIR)/$(last_released_sdk_version).txt, \ 44 $(INTERNAL_PLATFORM_API_FILE), \ 45 frameworks/base/api/removed.txt, \ 46 $(INTERNAL_PLATFORM_REMOVED_API_FILE), \ 47 -hide 2 -hide 3 -hide 4 -hide 5 -hide 6 -hide 24 -hide 25 -hide 26 -hide 27 \ 48 -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \ 49 -error 16 -error 17 -error 18 , \ 50 cat $(BUILD_SYSTEM)/apicheck_msg_last.txt, \ 51 checkapi, \ 52 $(call doc-timestamp-for,api-stubs) \ 53 )) 54 55# Check that the API we're building hasn't changed from the not-yet-released 56# SDK version. 57$(eval $(call check-api, \ 58 checkapi-current, \ 59 frameworks/base/api/current.txt, \ 60 $(INTERNAL_PLATFORM_API_FILE), \ 61 frameworks/base/api/removed.txt, \ 62 $(INTERNAL_PLATFORM_REMOVED_API_FILE), \ 63 -error 2 -error 3 -error 4 -error 5 -error 6 \ 64 -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \ 65 -error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 \ 66 -error 25 -error 26 -error 27, \ 67 sed -e 's/%UPDATE_API%/update-api/g' $(BUILD_SYSTEM)/apicheck_msg_current.txt, \ 68 checkapi, \ 69 $(call doc-timestamp-for,api-stubs) \ 70 )) 71 72.PHONY: update-api 73update-api: $(INTERNAL_PLATFORM_API_FILE) | $(ACP) 74 @echo Copying current.txt 75 $(hide) $(ACP) $(INTERNAL_PLATFORM_API_FILE) frameworks/base/api/current.txt 76 @echo Copying removed.txt 77 $(hide) $(ACP) $(INTERNAL_PLATFORM_REMOVED_API_FILE) frameworks/base/api/removed.txt 78 79 80#####################Check System API##################### 81.PHONY: checksystemapi 82 83# Check that the System API we're building hasn't broken the last-released 84# SDK version. 85$(eval $(call check-api, \ 86 checksystemapi-last, \ 87 $(SRC_SYSTEM_API_DIR)/$(last_released_sdk_version).txt, \ 88 $(INTERNAL_PLATFORM_SYSTEM_API_FILE), \ 89 frameworks/base/api/system-removed.txt, \ 90 $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE), \ 91 -hide 2 -hide 3 -hide 4 -hide 5 -hide 6 -hide 24 -hide 25 -hide 26 -hide 27 \ 92 -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \ 93 -error 16 -error 17 -error 18 , \ 94 cat $(BUILD_SYSTEM)/apicheck_msg_last.txt, \ 95 checksystemapi, \ 96 $(call doc-timestamp-for,system-api-stubs) \ 97 )) 98 99# Check that the System API we're building hasn't changed from the not-yet-released 100# SDK version. 101$(eval $(call check-api, \ 102 checksystemapi-current, \ 103 frameworks/base/api/system-current.txt, \ 104 $(INTERNAL_PLATFORM_SYSTEM_API_FILE), \ 105 frameworks/base/api/system-removed.txt, \ 106 $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE), \ 107 -error 2 -error 3 -error 4 -error 5 -error 6 \ 108 -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \ 109 -error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 \ 110 -error 25 -error 26 -error 27, \ 111 sed -e 's/%UPDATE_API%/update-system-api/g' $(BUILD_SYSTEM)/apicheck_msg_current.txt, \ 112 checksystemapi, \ 113 $(call doc-timestamp-for,system-api-stubs) \ 114 )) 115 116.PHONY: update-system-api 117update-system-api: $(INTERNAL_PLATFORM_SYSTEM_API_FILE) | $(ACP) 118 @echo Copying system-current.txt 119 $(hide) $(ACP) $(INTERNAL_PLATFORM_SYSTEM_API_FILE) frameworks/base/api/system-current.txt 120 @echo Copying system-removed.txt 121 $(hide) $(ACP) $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) frameworks/base/api/system-removed.txt 122 123endif 124