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