为何debuggable设为false时Android App版本与Gradle配置不符？

问题原因 #

你的项目里应该存在基于Git提交记录自动生成版本号的Gradle逻辑，且这个逻辑只在debuggable=false的Release构建中生效，Debug构建（debuggable=true）则跳过了该逻辑，所以版本号显示正常。

解决步骤 #

1. 定位自动版本生成的代码 #

检查以下位置的Gradle配置：

• 应用模块的build.gradle（或build.gradle.kts）中的buildTypes > release块，看是否有覆盖versionCode/versionName的代码，比如调用Git命令统计提交数、获取提交哈希的逻辑。
• 根目录的build.gradle或单独的版本管理脚本（比如version.gradle），看是否有全局的版本号生成task。

示例中需要删除的自动生成代码类似：

buildTypes {
    release {
        debuggable false
        // 这类自动生成代码就是问题根源
        versionCode getGitCommitCount()
        versionName "${project.ext.defaultVersionName}-${getGitCommitHash()}"
    }
}

2. 强制使用Gradle手动配置的版本号 #

删除Release构建中自动生成版本号的代码，手动指定versionCode和versionName，同时确保Release构建的签名配置正确（这是Google Play发布的必备条件）：

android {
    defaultConfig {
        // 全局基础版本配置（可选，也可以直接在release块中指定）
        versionCode 100
        versionName "1.0.0"
    }

    signingConfigs {
        release {
            // 配置你的发布密钥信息，建议用环境变量避免硬编码
            storeFile file("your-release-keystore.jks")
            storePassword System.getenv("KEYSTORE_PWD")
            keyAlias "your-key-alias"
            keyPassword System.getenv("KEY_PWD")
        }
    }

    buildTypes {
        release {
            debuggable false
            signingConfig signingConfigs.release // 必须指定Release签名
            // 如果defaultConfig里已经配置，这里可以不用重复写，否则直接指定
            // versionCode 100
            // versionName "1.0.0"
        }
        debug {
            debuggable true
        }
    }
}

3. 验证构建结果 #

执行Release构建命令：

# 生成AAB包（Google Play推荐）
./gradlew bundleRelease
# 或生成APK
./gradlew assembleRelease

用aapt工具验证版本信息（需确保Android SDK的build-tools在环境变量中）：

aapt dump badging app/build/outputs/bundle/release/app-release.aab

输出中会显示versionCode和versionName，确认是否与Gradle配置一致。

4. 检查CI/CD配置（如果使用） #

如果你的项目用了CI/CD工具（如GitHub Actions、GitLab CI），检查CI脚本中是否有自动修改版本号的步骤，确保Release构建时跳过该步骤，直接使用Gradle中的配置。

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