You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows下编译AIDL文件失败:Android Studio执行AidlCompile任务报错

解决Windows下AIDL编译任务失败问题

针对你遇到的cert4android:compileDebugAidl任务失败、手动执行aidl.exe正常但Gradle调用异常的问题,以下是经过验证的解决方案:

  • 修正Gradle任务工作目录
    Gradle执行AIDL编译任务的工作目录可能与你手动执行命令时不一致,导致路径解析错误。在模块的build.gradle中添加配置,强制指定工作目录:

    android {
        tasks.withType(com.android.build.gradle.tasks.AidlCompile) {
            workingDir = project.rootDir
        }
    }
    

    同步Gradle后重新构建项目。

  • 彻底清理Gradle缓存与构建产物
    缓存损坏是这类问题的常见诱因:

    1. 点击Android Studio顶部菜单File > Invalidate Caches...,勾选"Clear file system cache and local history",确认后重启IDE。
    2. 删除项目根目录下的.gradle文件夹,以及cert4android/build目录。
    3. 打开终端执行gradlew.bat clean build(Windows环境),从头构建项目。
  • 排查系统权限与环境变量

    • 确认Android SDK的build-tools/<对应版本>/目录已加入系统PATH环境变量,避免Gradle找不到aidl.exe。
    • 右键选择“以管理员身份运行”Android Studio,防止权限不足导致进程调用失败。
  • 调整AGP与Gradle版本兼容性
    你当前使用的是Beta版Android Studio和AGP 7.3.0,存在版本兼容性风险:

    • 尝试降级AGP到7.2.2(稳定版),对应Gradle版本改为7.3.3,同步后重新构建。
    • 或升级AGP至7.4.0及以上版本,同时匹配对应的Gradle版本(可参考官方兼容映射)。
  • 统一AIDL文件的换行符与编码
    Windows与Linux的换行符差异可能导致Gradle解析AIDL文件时出错:

    1. 在Android Studio中打开所有AIDL文件,通过File > Line Separators选择Windows (CRLF),保存文件。
    2. 全局设置换行符:File > Settings > Editor > Code Style > Line Separators,设置为Windows,确保后续新建文件统一格式。
  • 手动指定aidl.exe路径
    强制Gradle使用指定版本的aidl.exe,避免版本混淆:

    android {
        buildToolsVersion "33.0.2" // 替换为你当前使用的build-tools版本
        aidl {
            executable = file("${android.sdkDirectory}/build-tools/${buildToolsVersion}/aidl.exe")
        }
    }
    

内容的提问来源于stack exchange,提问作者Arnyminer Z

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.14 02:15:50