xref: /aosp_15_r20/build/soong/scripts/freeze-sysprop-api-files.sh (revision 333d2b3687b3a337dbcca9d65000bca186795e39)
1*333d2b36SAndroid Build Coastguard Worker#!/bin/bash -e
2*333d2b36SAndroid Build Coastguard Worker
3*333d2b36SAndroid Build Coastguard Worker# Copyright (C) 2019 The Android Open Source Project
4*333d2b36SAndroid Build Coastguard Worker#
5*333d2b36SAndroid Build Coastguard Worker# Licensed under the Apache License, Version 2.0 (the "License");
6*333d2b36SAndroid Build Coastguard Worker# you may not use this file except in compliance with the License.
7*333d2b36SAndroid Build Coastguard Worker# You may obtain a copy of the License at
8*333d2b36SAndroid Build Coastguard Worker#
9*333d2b36SAndroid Build Coastguard Worker#     http://www.apache.org/licenses/LICENSE-2.0
10*333d2b36SAndroid Build Coastguard Worker#
11*333d2b36SAndroid Build Coastguard Worker# Unless required by applicable law or agreed to in writing, software
12*333d2b36SAndroid Build Coastguard Worker# distributed under the License is distributed on an "AS IS" BASIS,
13*333d2b36SAndroid Build Coastguard Worker# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14*333d2b36SAndroid Build Coastguard Worker# See the License for the specific language governing permissions and
15*333d2b36SAndroid Build Coastguard Worker# limitations under the License.
16*333d2b36SAndroid Build Coastguard Worker
17*333d2b36SAndroid Build Coastguard Worker# This script freezes APIs of a sysprop_library after checking compatibility
18*333d2b36SAndroid Build Coastguard Worker# between latest API and current API.
19*333d2b36SAndroid Build Coastguard Worker#
20*333d2b36SAndroid Build Coastguard Worker# Usage: freeze-sysprop-api-files.sh <modulePath> <moduleName>
21*333d2b36SAndroid Build Coastguard Worker#
22*333d2b36SAndroid Build Coastguard Worker# <modulePath>: the directory, either relative or absolute, which holds the
23*333d2b36SAndroid Build Coastguard Worker# Android.bp file defining sysprop_library.
24*333d2b36SAndroid Build Coastguard Worker#
25*333d2b36SAndroid Build Coastguard Worker# <moduleName>: the name of sysprop_library to freeze API.
26*333d2b36SAndroid Build Coastguard Worker#
27*333d2b36SAndroid Build Coastguard Worker# Example:
28*333d2b36SAndroid Build Coastguard Worker# $ . build/envsetup.sh && lunch aosp_arm64-user
29*333d2b36SAndroid Build Coastguard Worker# $ . build/soong/scripts/freeze-sysprop-api-files.sh \
30*333d2b36SAndroid Build Coastguard Worker#       system/libsysprop/srcs PlatformProperties
31*333d2b36SAndroid Build Coastguard Worker
32*333d2b36SAndroid Build Coastguard Workerif [[ -z "$1" || -z "$2" ]]; then
33*333d2b36SAndroid Build Coastguard Worker  echo "usage: $0 <modulePath> <moduleName>" >&2
34*333d2b36SAndroid Build Coastguard Worker  exit 1
35*333d2b36SAndroid Build Coastguard Workerfi
36*333d2b36SAndroid Build Coastguard Worker
37*333d2b36SAndroid Build Coastguard Workerapi_dir=$1/api
38*333d2b36SAndroid Build Coastguard Worker
39*333d2b36SAndroid Build Coastguard Workerm "$2-check-api" && cp -f "${api_dir}/$2-current.txt" "${api_dir}/$2-latest.txt"
40