GitHub Actions发布多模块Android应用遇apksigner缺失AndroidManifest.xml错误

我在通过GitHub Actions Workflow发布多模块Android应用到Play商店时，遇到了AAB未签名的错误提示。为排查问题，我已经添加了以下Workflow步骤：

• 检查AAB文件是否存在（确认存在）
• 提取AAB内容（确认包含AndroidManifest.xml）
  但执行apksigner verify时，始终抛出Missing AndroidManifest.xml异常，即使本地Clean并Rebuild项目后问题依然存在。

可能的排查方向 #

1. 确认apksigner指向的AAB路径是否正确 #

GitHub Actions中路径容易出现相对路径错误：

• 核对Workflow中apksigner命令的目标AAB路径是否和Gradle生成路径完全匹配，比如是否为app/build/outputs/bundle/release/app-release.aab（根据你的模块结构调整）
• 在Workflow中添加ls -l <AAB路径>指令，打印文件详细信息，确认文件大小正常（不是空文件）

2. 检查release变体的签名配置是否生效 #

在app/build.gradle.kts中，确保release构建类型已正确关联签名配置：

android {
    signingConfigs {
        create("release") {
            storeFile = file(System.getenv("KEYSTORE_PATH"))
            storePassword = System.getenv("KEYSTORE_PASSWORD")
            keyAlias = System.getenv("KEY_ALIAS")
            keyPassword = System.getenv("KEY_PASSWORD")
        }
    }
    buildTypes {
        release {
            signingConfig = signingConfigs.getByName("release")
            // 其他release配置
        }
    }
}

同时确认GitHub Actions的环境变量已正确传入所有签名参数，无拼写错误或遗漏。

3. 检查多模块打包的完整性 #

多模块项目中，确保主模块的settings.gradle.kts已正确包含所有依赖模块，且release打包时所有模块都参与构建：

• 查看./gradlew bundleRelease的构建日志，确认所有模块都完成了release变体的构建
• 提取AAB内容后，除根目录的AndroidManifest.xml，还要检查各模块对应的子目录（如base/AndroidManifest.xml）是否存在，apksigner需要完整的模块清单才能正常验证

4. 规范GitHub Actions中的Gradle构建命令 #

确保执行完整的清理+构建命令，避免残留旧产物：

./gradlew clean bundleRelease

不要仅执行bundleRelease，否则可能导致构建产物不完整。

5. 本地验证AAB的签名状态 #

将GitHub Actions生成的AAB下载到本地，执行以下命令验证：

apksigner verify --verbose app-release.aab

如果本地也出现相同错误，说明问题出在构建流程；如果本地验证正常，则是GitHub Actions环境的问题（比如apksigner版本不兼容）。

6. 统一apksigner的版本 #

不同版本的Android Build Tools中，apksigner对AAB的处理可能存在差异，在GitHub Actions中指定与本地一致的Build Tools版本：

- name: Setup Android SDK
  uses: android-actions/setup-android@v3
  with:
    build-tools-version: "34.0.0" # 替换为你本地使用的版本

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