首个Lib模块无法生成AAR文件的排查方法咨询

一、先检查基础配置 #

• 确认首个Lib模块的build.gradle（或build.gradle.kts）是否正确声明为库模块：

  // Groovy 配置
  plugins {
      id 'com.android.library'
  }
  

  // Kotlin 配置
  plugins {
      id("com.android.library")
  }
  

  如果误写成com.android.application，模块会被当成应用打包APK，不会生成AAR。
• 检查项目的settings.gradle（或settings.gradle.kts），确保包含该模块的声明：include ':你的首个Lib模块名'，没有这条声明的话，构建系统根本不会处理该模块。

二、查看构建日志与生成细节 #

• 用Gradle命令行获取完整日志：
  在项目根目录执行以下命令，强制构建首个Lib模块并输出详细日志：

  # Mac/Linux
  ./gradlew :你的首个Lib模块名:assembleRelease --info
  
  # Windows
  gradlew.bat :你的首个Lib模块名:assembleRelease --info
  

  日志里能找到：
  • AAR的预期生成路径（默认是模块目录/build/outputs/aar/）
  • 构建过程中的错误（比如编译失败、资源冲突、依赖缺失）
  • 任务执行状态（比如assembleRelease是否被触发、是否被跳过）
• Android Studio Build窗口查看：
  切换到Build标签，勾选Show verbose output，重新构建模块。任何编译错误、资源警告都会在这里直接显示，比如XML资源语法错误、代码未解决引用等。

三、自定义AAR输出路径（可选） #

如果默认路径找不到AAR，可以手动指定输出目录，在首个Lib模块的构建脚本中添加：

Groovy版本： #

android {
    // 其他配置...
    libraryVariants.all { variant ->
        variant.outputs.all {
            outputFileName = "first-lib-${variant.name}.aar"
            // 自定义到项目根目录的custom-aar文件夹
            def outputDir = new File(project.rootDir, "custom-aar")
            outputDir.mkdirs()
            outputFile = new File(outputDir, outputFileName)
        }
    }
}

Kotlin版本： #

android {
    // 其他配置...
    libraryVariants.all {
        outputs.all {
            outputFileName = "first-lib-${name}.aar"
            val outputDir = File(project.rootDir, "custom-aar")
            outputDir.mkdirs()
            outputFile = File(outputDir, outputFileName)
        }
    }
}

构建完成后直接去自定义目录查看是否生成了AAR。

四、常见问题排查点 #

• 依赖冲突/缺失：检查首个Lib模块的依赖是否存在版本冲突，或者依赖的本地模块是否构建失败。比如依赖了一个未正确编译的模块，会导致当前模块构建中断。
• 资源/代码隐性错误：有些语法错误不会直接阻断构建，但会导致AAR生成失败，比如XML资源命名重复、Kotlin代码有未捕获的编译警告（开启了allWarningsAsErrors）。
• 构建任务被跳过：如果模块代码没有变化，Gradle可能会跳过构建。执行./gradlew :你的首个Lib模块名:clean assembleRelease强制清理后重新构建，确保任务被执行。
• 模块是否被禁用：在Android Studio的File > Project Structure > Modules中，检查首个Lib模块是否被勾选为参与构建。

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