xref: /aosp_15_r20/system/chre/std_overrides/README.md (revision 84e339476a462649f82315436d70fd732297a399)
1*84e33947SAndroid Build Coastguard Worker### CHRE Overrides
2*84e33947SAndroid Build Coastguard Worker
3*84e33947SAndroid Build Coastguard WorkerCHRE provides nanoapps with a minimal list of overrides to standard library
4*84e33947SAndroid Build Coastguard Workerfunctions that are not supported by CHRE, but can be redirected to a supported
5*84e33947SAndroid Build Coastguard Workerfunction, or when failing silently should be of minimal consequences to the
6*84e33947SAndroid Build Coastguard Workernanoapp. Two possible scenarios where the developers might need to use these
7*84e33947SAndroid Build Coastguard Workeroverrides are:
8*84e33947SAndroid Build Coastguard Worker
9*84e33947SAndroid Build Coastguard Worker* Generated code
10*84e33947SAndroid Build Coastguard Worker* Third-party code/libraries
11*84e33947SAndroid Build Coastguard Worker
12*84e33947SAndroid Build Coastguard WorkerThe overrides makefile is included in the nanoapp build by and enabled by
13*84e33947SAndroid Build Coastguard Workerdefault, but the developers can disable it by setting a flag in the nanoapp Makefile:
14*84e33947SAndroid Build Coastguard Worker`CHRE_STD_OVERRIDES_ALLOWED = false`
15*84e33947SAndroid Build Coastguard Worker
16*84e33947SAndroid Build Coastguard WorkerIt is expected that the nanoapp developers only leverage these overrides while
17*84e33947SAndroid Build Coastguard Workerworking towards zero overrides usage.
18*84e33947SAndroid Build Coastguard Worker
19