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