如何允许本地调试时覆盖buildConfigField且避免提交修改？

安全阿岳

2026-8-13

避免Android服务器地址误提交的解决方案

步骤1：创建本地配置模板并提交到Git

在项目根目录创建local.properties.template文件，写入默认服务器地址作为示例：

# 本地服务器配置模板，复制为local.properties后修改
server_url=https://app.example.com

将这个模板文件提交到Git仓库，让所有开发者都能获取到。

步骤2：配置.gitignore忽略本地配置文件

在项目根目录的.gitignore中添加一行，确保本地配置文件不会被提交：

local.properties

步骤3：修改app/build.gradle读取本地配置

在app/build.gradle的android块中，先加载本地配置文件，再动态设置buildConfigField：

android {
    // 其他原有配置...

    // 加载本地配置文件
    def localProperties = new Properties()
    def localPropertiesFile = rootProject.file('local.properties')
    if (localPropertiesFile.exists()) {
        localProperties.load(new FileInputStream(localPropertiesFile))
    }

    // 在productFlavors或buildTypes中使用动态值
    productFlavors {
        production {
            def serverUrl = localProperties.getProperty('server_url', 'https://app.example.com')
            buildConfigField "android.net.Uri", "server", """android.net.Uri.parse("${serverUrl}")"""
        }
        // 其他flavor可同理配置
    }
}