# Copyright (C) 2008 The Android Open Source Project # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # # Rules for running apicheck to confirm that you haven't broken # api compatibility or added apis illegally. # # skip api check for PDK buid ifeq (,$(filter true, $(WITHOUT_CHECK_API) $(TARGET_BUILD_PDK))) .PHONY: checkapi # Run the checkapi rules by default. droidcore: checkapi last_released_sdk_version := $(lastword $(call numerically_sort, \ $(filter-out current, \ $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \ )\ )) .PHONY: check-public-api checkapi : check-public-api .PHONY: update-api # INTERNAL_PLATFORM_API_FILE is the one build by droiddoc. # Note that since INTERNAL_PLATFORM_API_FILE is the byproduct of api-stubs module, # (See frameworks/base/Android.mk) # we need to add api-stubs as additional dependency of the api check. # Check that the API we're building hasn't broken the last-released # SDK version. $(eval $(call check-api, \ checkpublicapi-last, \ $(SRC_API_DIR)/$(last_released_sdk_version).txt, \ $(INTERNAL_PLATFORM_API_FILE), \ frameworks/base/api/removed.txt, \ $(INTERNAL_PLATFORM_REMOVED_API_FILE), \ -hide 2 -hide 3 -hide 4 -hide 5 -hide 6 -hide 24 -hide 25 -hide 26 -hide 27 \ -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \ -error 16 -error 17 -error 18 , \ cat $(BUILD_SYSTEM)/apicheck_msg_last.txt, \ check-public-api, \ $(call doc-timestamp-for,api-stubs) \ )) # Check that the API we're building hasn't changed from the not-yet-released # SDK version. $(eval $(call check-api, \ checkpublicapi-current, \ frameworks/base/api/current.txt, \ $(INTERNAL_PLATFORM_API_FILE), \ frameworks/base/api/removed.txt, \ $(INTERNAL_PLATFORM_REMOVED_API_FILE), \ -error 2 -error 3 -error 4 -error 5 -error 6 \ -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \ -error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 \ -error 25 -error 26 -error 27, \ cat $(BUILD_SYSTEM)/apicheck_msg_current.txt, \ check-public-api, \ $(call doc-timestamp-for,api-stubs) \ )) .PHONY: update-public-api update-public-api: $(INTERNAL_PLATFORM_API_FILE) | $(ACP) @echo -e ${CL_GRN}"Copying current.txt"${CL_RST} $(hide) $(ACP) $(INTERNAL_PLATFORM_API_FILE) frameworks/base/api/current.txt @echo -e ${CL_GRN}"Copying removed.txt"${CL_RST} $(hide) $(ACP) $(INTERNAL_PLATFORM_REMOVED_API_FILE) frameworks/base/api/removed.txt update-api : update-public-api #####################Check System API##################### .PHONY: check-system-api checkapi : check-system-api # Check that the System API we're building hasn't broken the last-released # SDK version. $(eval $(call check-api, \ checksystemapi-last, \ $(SRC_SYSTEM_API_DIR)/$(last_released_sdk_version).txt, \ $(INTERNAL_PLATFORM_SYSTEM_API_FILE), \ frameworks/base/api/system-removed.txt, \ $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE), \ -hide 2 -hide 3 -hide 4 -hide 5 -hide 6 -hide 24 -hide 25 -hide 26 -hide 27 \ -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \ -error 16 -error 17 -error 18 , \ cat $(BUILD_SYSTEM)/apicheck_msg_last.txt, \ check-system-api, \ $(call doc-timestamp-for,system-api-stubs) \ )) # Check that the System API we're building hasn't changed from the not-yet-released # SDK version. $(eval $(call check-api, \ checksystemapi-current, \ frameworks/base/api/system-current.txt, \ $(INTERNAL_PLATFORM_SYSTEM_API_FILE), \ frameworks/base/api/system-removed.txt, \ $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE), \ -error 2 -error 3 -error 4 -error 5 -error 6 \ -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \ -error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 \ -error 25 -error 26 -error 27, \ cat $(BUILD_SYSTEM)/apicheck_msg_current.txt, \ check-system-api, \ $(call doc-timestamp-for,system-api-stubs) \ )) .PHONY: update-system-api update-api : update-system-api update-system-api: $(INTERNAL_PLATFORM_SYSTEM_API_FILE) | $(ACP) @echo Copying system-current.txt $(hide) $(ACP) $(INTERNAL_PLATFORM_SYSTEM_API_FILE) frameworks/base/api/system-current.txt @echo Copying system-removed.txt $(hide) $(ACP) $(INTERNAL_PLATFORM_SYSTEM_REMOVED_API_FILE) frameworks/base/api/system-removed.txt endif