AIDL实现Vendor HAL无法生成Java代码编译失败求助

问题背景 #

用AIDL实现Vendor HAL时，启用Java后端编译报错找不到markVintfStability()方法，禁用Java后端则编译正常，需解决Java后端启用后的编译问题。

相关文件与错误信息 #

原Android.bp配置 #

aidl_interface {
   name: "android.hardware.weather",
   vendor: true,
   srcs: ["android/hardware/weather/*.aidl"],
   stability: "vintf",
   owner: "jiangc",
   backend: {
       cpp: {
           enabled: false,
       },
   },
}

AIDL文件内容 #

@VintfStability
interface IWeather{

    String getWeather();

    void setCity(in String city);
}

编译错误日志 #

[ 45% 5/11] //vendor/jiangc/hardware/interfaces/automotive/vehicle/aidl/weather:android.hardware.weather-V1-java javac [common]
FAILED: out/soong/.intermediates/vendor/jiangc/hardware/interfaces/automotive/vehicle/aidl/weather/android.hardware.weather-V1-java/android_common/javac/android.hardware.weather-V1-java.jar
...
out/soong/.intermediates/vendor/jiangc/hardware/interfaces/automotive/vehicle/aidl/weather/android.hardware.weather-V1-java-source/gen/android/hardware/weather/IWeather.java:46: error: cannot find symbol
      this.markVintfStability();
          ^
  symbol: method markVintfStability()
1 error
16:18:59 ninja failed with: exit status 1

#### failed to build some targets (15 seconds) ####

禁用Java后端后的Android.bp（编译正常） #

aidl_interface {
   name: "android.hardware.weather",
   vendor: true,
   srcs: ["android/hardware/weather/*.aidl"],
   stability: "vintf",
   owner: "jiangc",
   backend: {
       cpp: {
           enabled: false,
       },
       java: {
           enabled: false,
       },
   },
}

解决方案 #

方案1：添加Java依赖库（推荐） #

问题根源是生成的Java代码依赖markVintfStability()方法，但默认未关联包含该方法的HIDL基础库。修改Android.bp，为Java后端添加依赖：

aidl_interface {
   name: "android.hardware.weather",
   vendor: true,
   srcs: ["android/hardware/weather/*.aidl"],
   stability: "vintf",
   owner: "jiangc",
   backend: {
       cpp: {
           enabled: false,
       },
       java: {
           enabled: true,
           // 添加HIDL基础Java库依赖
           java_libs: ["android.hidl.base-V1.0-java"],
       },
   },
}

方案2：移除@VintfStability注解（临时方案） #

如果编译环境的Android SDK版本低于API 30（该方法在API 30及以上引入），可临时移除AIDL中的@VintfStability注解，但这会丢失接口稳定性声明，不推荐长期使用：

interface IWeather{

    String getWeather();

    void setCity(in String city);
}

方案3：升级编译SDK版本 #

确保编译环境使用API级别30及以上的Android SDK，该版本开始原生支持markVintfStability()方法。

原理说明 #

markVintfStability()是HIDL基础库提供的方法，用于标记接口的VINTF稳定性。Vendor HAL启用Java后端时，生成的代码会调用该方法，但默认配置未自动引入依赖库，导致编译报错。添加android.hidl.base-V1.0-java依赖即可解决符号缺失问题。

内容的提问来源于stack exchange，提问作者Chao Jiang