如何在Android Studio中设计配置Gradle的正式发布流程

参考示意图 #

具体配置流程 #

1. 引入发布插件 #

首先在需要发布的模块级build.gradle（或build.gradle.kts）文件顶部引入maven-publish插件，这是Gradle官方提供的标准发布插件：

plugins {
    id 'com.android.library' // 若发布APK则替换为com.android.application
    id 'maven-publish'
}

2. 配置基础发布信息 #

指定发布产物的基础标识信息，建议将版本号等通用配置统一放在根项目的gradle.properties中管理：

// 模块级build.gradle
group = "com.your.organization" // 组织标识
version = "1.0.0-release" // 发布版本号

3. 配置目标发布仓库 #

支持配置本地测试仓库、企业私有Maven仓库、公开仓库等多类目标地址，敏感账号密码建议从local.properties读取，不要硬编码提交到代码仓库：

publishing {
    repositories {
        maven {
            // 本地测试仓库示例，发布到项目本地目录便于调试
            url = uri("${rootProject.rootDir}/maven-repo")
            // 私有远程仓库示例
            // url = uri("私有仓库地址")
            // credentials {
            //     def localProps = new Properties()
            //     localProps.load(rootProject.file('local.properties').newDataInputStream())
            //     username = localProps.getProperty("maven.username")
            //     password = localProps.getProperty("maven.password")
            // }
        }
    }
}

4. 配置发布产物规则 #

指定需要发布的构建变体、POM依赖信息等内容，确保下游依赖可以正常拉取关联依赖：

afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                // 选择发布release构建变体的产物，AAR库对应components.release，APK对应components.release_apk
                from components.release
                artifactId = "your-library-name" // 产物名称
                // 配置POM信息，公开仓库上传需完善该部分
                pom {
                    name.set("你的工具库名称")
                    description.set("工具库功能描述")
                }
            }
        }
    }
}

5. 执行发布任务 #

有两种执行方式可选：

• 可视化操作：打开Android Studio右侧的Gradle面板，找到对应模块下的publishing分组，双击publish任务即可执行全量发布
• 命令行操作：在项目根目录执行命令：./gradlew :your-module-name:publish（Windows系统替换为gradlew.bat）

注意事项 #

• 正式发布前可以先执行publishToMavenLocal任务发布到本地Maven仓库，在本地项目测试依赖正常后再推送至远程仓库
• 多模块项目可以将通用发布配置抽离为独立的publish.gradle脚本，通过apply from: "../publish.gradle"引入各模块，减少重复代码
• 上传到公开类Maven仓库需要额外配置signing插件对发布产物做GPG签名，满足平台校验要求

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