xref: /aosp_15_r20/prebuilts/sdk/current/placeholder-api.txt (revision 344a7f5ef16c479e7a7f54ee6567a9d112f9e72b)
1*344a7f5eSAndroid Build Coastguard WorkerPlaceholder API txt file that is used in the java_sdk_library_import modules
2*344a7f5eSAndroid Build Coastguard Workerin the Android.bp file for their current_api and removed_api properties.
3*344a7f5eSAndroid Build Coastguard Worker
4*344a7f5eSAndroid Build Coastguard WorkerThis is not a valid API txt file and is not intended to be used as such. Any
5*344a7f5eSAndroid Build Coastguard Workerattempt to parse its contents will fail. That is intentional.
6*344a7f5eSAndroid Build Coastguard Worker
7*344a7f5eSAndroid Build Coastguard WorkerIts purpose is simply to allow Soong to pass dependency checking when
8*344a7f5eSAndroid Build Coastguard WorkerTARGET_BUILD_APPS is set without UNBUNDLED_BUILD_SDKS_FROM_SOURCE being set to
9*344a7f5eSAndroid Build Coastguard Workertrue. Without this file being referenced from the java_sdk_library_import
10*344a7f5eSAndroid Build Coastguard Workerproperties any attempt to depend on say ":javax.obex{.public.api.txt}" would
11*344a7f5eSAndroid Build Coastguard Workerfail in Soong when building with TARGET_BUILD_APPS set and so prevent the
12*344a7f5eSAndroid Build Coastguard Workerbuilding of any module even those that do not depend on that missing API file.
13*344a7f5eSAndroid Build Coastguard Worker
14*344a7f5eSAndroid Build Coastguard WorkerWith this file being referenced from the java_sdk_library_import properties
15*344a7f5eSAndroid Build Coastguard WorkerSoong will pass its dependency checks and produce the ninja file and so allow
16*344a7f5eSAndroid Build Coastguard Workermodules that do not depend on this file to be built successfully. Building
17*344a7f5eSAndroid Build Coastguard Workermodules that depend on this file will fail when those modules attempt to parse
18*344a7f5eSAndroid Build Coastguard Workerthis file.
19