blob: 96e0f44db52f281b186016e5c6d9268eb086df0f [file] [log] [blame]
The Android Open Source Project88b60792009-03-03 19:28:42 -08001# 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
20ifneq ($(BUILD_TINY_ANDROID), true)
21
22.PHONY: checkapi
23
24# eval this to define a rule that runs apicheck.
25#
26# Args:
27# $(1) target
Joe Onorato15ee93b2011-04-08 15:03:48 -070028# $(2) stable api file
29# $(3) api file to be tested
The Android Open Source Project88b60792009-03-03 19:28:42 -080030# $(4) arguments for apicheck
31# $(5) command to run if apicheck failed
32define check-api
33$(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/$(strip $(1))-timestamp: $(2) $(3) $(APICHECK)
34 @echo "Checking API:" $(1)
Joe Onorato2a6e0522011-04-08 17:32:52 -070035 $(hide) ( $(APICHECK_COMMAND) $(4) $(2) $(3) || ( $(5) ; exit 38 ) )
The Android Open Source Project88b60792009-03-03 19:28:42 -080036 $(hide) mkdir -p $$(dir $$@)
37 $(hide) touch $$@
38checkapi: $(TARGET_OUT_COMMON_INTERMEDIATES)/PACKAGING/$(strip $(1))-timestamp
39endef
40
41# Run the checkapi rules by default.
42droidcore: checkapi
43
Joe Onorato15ee93b2011-04-08 15:03:48 -070044last_released_sdk_version := $(lastword $(call numerically_sort, \
45 $(filter-out $(SRC_API_DIR)/current, \
46 $(patsubst $(SRC_API_DIR)/%.txt,%, $(wildcard $(SRC_API_DIR)/*.txt)) \
47 )\
48 ))
Ying Wang0f6f4ca2010-06-09 10:26:26 -070049
The Android Open Source Project88b60792009-03-03 19:28:42 -080050# INTERNAL_PLATFORM_API_FILE is the one build by droiddoc.
51
52# Check that the API we're building hasn't broken the last-released
53# SDK version.
54$(eval $(call check-api, \
55 checkapi-last, \
Joe Onorato15ee93b2011-04-08 15:03:48 -070056 $(SRC_API_DIR)/$(last_released_sdk_version).txt, \
The Android Open Source Project88b60792009-03-03 19:28:42 -080057 $(INTERNAL_PLATFORM_API_FILE), \
58 -hide 2 -hide 3 -hide 4 -hide 5 -hide 6 -hide 24 -hide 25 \
59 -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \
60 -error 16 -error 17 -error 18 , \
61 cat $(BUILD_SYSTEM)/apicheck_msg_last.txt \
62 ))
63
64# Check that the API we're building hasn't changed from the not-yet-released
65# SDK version.
66$(eval $(call check-api, \
67 checkapi-current, \
Joe Onorato15ee93b2011-04-08 15:03:48 -070068 $(SRC_API_DIR)/current.txt, \
The Android Open Source Project88b60792009-03-03 19:28:42 -080069 $(INTERNAL_PLATFORM_API_FILE), \
70 -error 2 -error 3 -error 4 -error 5 -error 6 \
71 -error 7 -error 8 -error 9 -error 10 -error 11 -error 12 -error 13 -error 14 -error 15 \
72 -error 16 -error 17 -error 18 -error 19 -error 20 -error 21 -error 23 -error 24 \
73 -error 25 , \
74 cat $(BUILD_SYSTEM)/apicheck_msg_current.txt \
75 ))
76
77.PHONY: update-api
78update-api: $(INTERNAL_PLATFORM_API_FILE) | $(ACP)
Joe Onorato15ee93b2011-04-08 15:03:48 -070079 @echo Copying current.txt
80 $(hide) $(ACP) $(INTERNAL_PLATFORM_API_FILE) $(SRC_API_DIR)/current.txt
The Android Open Source Project88b60792009-03-03 19:28:42 -080081
82endif