如何让Doxygen正确解析无public修饰的AIDL接口与枚举？

针对你遇到的AIDL文件无法被Doxygen正常解析，且添加public关键字会导致Android编译报错的问题，可尝试以下几种方案：

方案1：利用Doxygen预定义宏（PREDEFINED） #

在Doxygen配置文件中添加预定义宏，让Doxygen在解析时自动为AIDL的interface和enum补全public关键字，原文件无需修改：

PREDEFINED = interface=public interface \
             enum=public enum

原理是Doxygen处理AIDL文件时（已映射为Java），会把interface替换成public interface，enum替换成public enum，这样就能正常识别并生成文档，而Android编译时读取的是原AIDL文件，不受影响。

方案2：使用输入过滤器（INPUT_FILTER） #

编写一个简单的文本替换脚本（比如用sed），让Doxygen读取AIDL文件时临时添加public关键字，处理完成后不修改原文件：

1. 创建一个名为aidl_filter.sh的脚本（确保有执行权限），内容如下：

#!/bin/bash
sed -e 's/^interface/public interface/' -e 's/^enum/public enum/' "$1"

2. 在Doxygen配置文件中配置INPUT_FILTER：

INPUT_FILTER = ./aidl_filter.sh

这样Doxygen会先通过脚本处理AIDL文件，再进行解析，既满足文档生成需求，又不影响Android编译。

方案3：升级Doxygen版本 #

你当前使用的是Doxygen 1.9.6，部分旧版本对AIDL语法的支持不完善。尝试升级到最新稳定版（比如1.10.x及以上），新版本可能已经优化了对无public修饰符的AIDL接口/枚举的识别逻辑，无需额外配置即可正常生成文档。

内容的提问来源于stack exchange，提问作者Dmitry Golubev