Azure DevOps Server下多版本Gradle包管理与依赖存储方案

本地部署版Azure DevOps Server 2019及更新版本无需依赖仅云服务支持的Universal Package任务，使用内置原生能力即可完成多版本构建包的规范化管理，具体落地方案如下：

存储选型 #

直接使用Azure DevOps Server内置的Maven制品源作为统一存储载体，不需要额外部署第三方制品服务：

• Gradle原生兼容Maven仓库协议，支持Jar包发布、指定版本拉取、依赖校验全流程能力，本地Server环境全量支持，不存在功能兼容问题。
• 禁止使用两类非规范存储方式：不要把多版本Jar直接提交到Git代码仓库（Git对二进制文件的差分存储效率极低，会快速膨胀仓库体积，且没有配套的版本、权限管控能力）；不要用SMB共享文件夹等文件存储方式散放Jar包（无法做版本校验、依赖溯源，很容易出现包被覆盖、拉错版本的问题）。

命名与版本规范 #

所有上传到制品源的包统一遵循以下规则，从源头避免混乱：

• 包名规则：和Gradle坐标规则对齐，同组件所有版本共用固定坐标，格式为组织反向域名:组件名，比如示例中的abc组件固定坐标为com.yourorg.shared:abc。绝对不要把版本号写进包名，禁止出现abc-1.0.1、abc-1.02这类同组件不同包名的命名方式，版本差异完全通过制品源的版本字段管理。
• 版本号规则：严格遵循语义化版本（SemVer）规范，正式发布版格式为主版本号.次版本号.修订号（比如1.0.1、1.0.2）；开发迭代的临时构建版本统一加-SNAPSHOT后缀标识，和正式版做明确区分。版本号直接由Pipeline构建号统一生成，禁止人工手动修改版本号上传。
• 元数据规则：每个上传的Jar包必须绑定三个核心元数据：对应Git提交哈希、Pipeline构建号、构建时间，后续出现依赖问题时可直接追溯到对应的代码版本与构建记录。

Pipeline 配置方式 #

组件发布端（产出Jar的公共组件流水线） #

直接通过Gradle原生的publish任务把构建产出推送到内置Maven源，不需要使用专属的制品上传任务，核心配置示例：

publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
            // 从Pipeline构建参数读取版本号，禁止硬编码
            version = project.findProperty("artifactVersion") ?: "0.0.1-SNAPSHOT"
            groupId = "com.yourorg.shared"
            artifactId = "abc"
        }
    }
    repositories {
        maven {
            name = "AzDevLocalFeed"
            // 替换为本地Azure DevOps Server内Maven源的实际地址
            url = "http://your-devops-server/DefaultCollection/_packaging/shared-libs/maven/v1"
            credentials {
                username = System.getenv("AZDEVOPS_USER")
                password = System.getenv("AZDEVOPS_PAT")
            }
        }
    }
}

Pipeline中添加Gradle任务执行以下命令即可完成自动上传：
./gradlew clean build publish -PartifactVersion=$(Build.BuildNumber)

依赖消费端（调用组件的微服务流水线） #

在微服务的Gradle配置中，把上述同一个Maven源加入仓库列表，需要哪个版本的组件直接在依赖块中指定即可，示例：

repositories {
    maven {
        name = "AzDevLocalFeed"
        url = "http://your-devops-server/DefaultCollection/_packaging/shared-libs/maven/v1"
        credentials {
            username = System.getenv("AZDEVOPS_USER")
            password = System.getenv("AZDEVOPS_PAT")
        }
    }
}

dependencies {
    // 需要1.0.2版本就写对应版本号，需要1.0.1直接替换版本号即可
    implementation 'com.yourorg.shared:abc:1.0.2'
}

构建时Gradle会自动从Maven源拉取对应版本的Jar包，不需要人工维护文件路径。

配套管理规则 #

• 权限分离：Maven源配置分级权限，普通微服务的构建服务账号仅授予拉取权限，公共组件的对应维护团队账号才拥有正式版本的上传权限，禁止无关账号覆盖已发布的正式包。
• 视图隔离：利用Maven源内置的视图能力做版本隔离，未经过测试的快照版放在Prerelease视图，测试通过的正式版提升到Release视图，消费端默认只拉取Release视图的包，避免误依赖未验证的版本。
• 留存策略：快照版本仅保留最近30天的构建产物，正式发布的版本永久留存，不得随意删除，避免影响历史版本微服务的构建与回溯。
• 校验规则：在所有Pipeline中开启源校验，禁止从公网、非授权源拉取依赖包，所有内部组件必须从统一的内置Maven源拉取。

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