093f0eb133
sysprop_library now checks the API stability itself, cutting dependency
on java_sdk_library. Under the directory {module_dir}/api,
{module_name}-current.txt and {module_name}-latest.txt hold API
signatures.
When sysprop_library is built, or a user run "m {module_name}-check-api"
command, API check is performed. First, current.txt must have exactly
same signature with built sysprop_library module. Second, current.txt
must be compatible with latest.txt.
Build system emits a handy error message to generate/update those API
files, in case of missing or mismatching. Also, a script file for
freezing API files is introduced.
Bug: 131637873
Test: 1) m && boot blueline
Test: 2) m {sysprop_library} performs API check
Test: 3) manual test for check-api, freezing api
Change-Id: I9d25f5dc64299e666527ca8e23d7233966901c4e
39 lines
1.3 KiB
Bash
Executable file
39 lines
1.3 KiB
Bash
Executable file
#!/bin/bash -e
|
|
|
|
# Copyright (C) 2019 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.
|
|
|
|
# This script freezes APIs of a sysprop_library after checking compatibility
|
|
# between latest API and current API.
|
|
#
|
|
# Usage: freeze-sysprop-api-files.sh <modulePath> <moduleName>
|
|
#
|
|
# <modulePath>: the directory, either relative or absolute, which holds the
|
|
# Android.bp file defining sysprop_library.
|
|
#
|
|
# <moduleName>: the name of sysprop_library to freeze API.
|
|
#
|
|
# Example:
|
|
# $ . build/envsetup.sh && lunch aosp_arm64-user
|
|
# $ . build/soong/scripts/freeze-sysprop-api-files.sh \
|
|
# system/libsysprop/srcs PlatformProperties
|
|
|
|
if [[ -z "$1" || -z "$2" ]]; then
|
|
echo "usage: $0 <modulePath> <moduleName>" >&2
|
|
exit 1
|
|
fi
|
|
|
|
api_dir=$1/api
|
|
|
|
m "$2-check-api" && cp -f "${api_dir}/$2-current.txt" "${api_dir}/$2-latest.txt"
|