基于环境切换Gradle仓库配置求助（本地/云端）

Gradle可以通过环境变量或项目属性区分本地与云端构建环境，实现仓库的动态配置，以下是两种适合新手的简单方案：

方式一：利用CI平台自动环境变量（推荐） #

绝大多数CI/CD平台（如GitHub Actions、GitLab CI、Jenkins）会自动设置CI环境变量为true，我们可以通过这个变量判断构建环境：

repositories {
    // 云端构建：启用带凭证的远程仓库
    if (System.getenv("CI") != null) {
        maven {
            url 'remote-url'
            credentials {
                username "xyz"
                password = "xyz"
            }
        }
    }

    // 本地开发：启用本地仓库
    if (System.getenv("CI") == null) {
        mavenLocal()
    }

    // 所有环境保留mavenCentral
    mavenCentral()
}

说明 #

• 本地开发时无CI变量，自动启用mavenLocal()，优先从本地仓库拉取依赖；
• 云端构建时CI变量存在，启用指定远程仓库，同时跳过mavenLocal()（避免云端无本地依赖导致构建失败）。

方式二：手动指定项目属性（自定义场景） #

如果需要手动控制是否使用本地仓库，可通过Gradle项目属性切换：

repositories {
    // 未指定useLocalRepo或值为false时，启用远程仓库
    if (!project.hasProperty("useLocalRepo") || !project.property("useLocalRepo").toBoolean()) {
        maven {
            url 'remote-url'
            credentials {
                username "xyz"
                password = "xyz"
            }
        }
    }

    // 指定useLocalRepo=true时，启用本地仓库
    if (project.hasProperty("useLocalRepo") && project.property("useLocalRepo").toBoolean()) {
        mavenLocal()
    }

    mavenCentral()
}

使用方法 #

• 本地开发时，运行Gradle命令附加属性：

  ./gradlew build -PuseLocalRepo=true
  

• 云端构建时直接运行常规命令即可（无需附加属性，自动启用远程仓库）。

安全优化：避免硬编码凭证 #

不要把仓库用户名和密码硬编码在脚本里，推荐以下做法：

1. 云端构建：在CI平台的保密变量中设置REPO_USERNAME和REPO_PASSWORD；
2. 本地开发：在~/.gradle/gradle.properties文件中添加：

   repoUsername=xyz
   repoPassword=xyz
   

修改脚本的凭证部分：

credentials {
    username = System.getenv("REPO_USERNAME") ?: project.findProperty("repoUsername") ?: "xyz"
    password = System.getenv("REPO_PASSWORD") ?: project.findProperty("repoPassword") ?: "xyz"
}

既保证安全，又能在本地与云端无缝切换。

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