将私有Android库发布至自建GitLab：Gradle任务不显示问题排查

我正在参照教程创建自用内部Android库，已创建模块并添加发布配置文件gradle-mvn-push.gradle，内容如下：

apply plugin: 'maven-publish'

publishing {
    publications {
        myPublish (MavenPublication) {
            groupId "id"
            artifactId "utilsmobile"
            version "1.0.0"
            artifact "$buildDir/outputs/aar/utilsmobile-release.aar"


            pom.withXml {
                def dependencies = asNode().appendNode('dependencies')
                configurations.named("releaseCompileClasspath").getResolvedConfiguration().getFirstLevelModuleDependencies().each {
                    def dependency = dependencies.appendNode('dependency')
                    dependency.appendNode('groupId', it.moduleGroup)
                    dependency.appendNode('artifactId', it.moduleName)
                    dependency.appendNode('version', it.moduleVersion)
                }
            }
        }
    }
    repositories {
        maven {
            url "https://gitlab.com/api/v4/projects//packages/maven"
            credentials(HttpHeaderCredentials) {
                name = "utils_pkg"
                value = "token"
            }
            authentication {
                header(HttpHeaderAuthentication)
            }
        }
    }
}

并在模块的build.gradle中添加了：

apply from: "$rootDir/Utils/gradle-mvn-push.gradle"

但Android Studio的Gradle面板中未看到任何新任务，也不清楚如何将库发布到私有仓库。请问是否需要单独声明任务？或是哪里操作出错了？

1. 先完成Gradle同步与任务刷新 #

• 点击Android Studio右上角的Sync Project with Gradle Files按钮，确保配置已同步到项目中。
• 同步完成后，展开Gradle面板对应模块下的Tasks > publishing目录，应该能看到命名为publishMyPublishPublicationToMavenRepository的任务（规则是publish[你的Publication名称]PublicationToMavenRepository）。
• 如果面板仍无显示，点击Gradle面板顶部的Refresh all Gradle projects按钮强制刷新任务列表。

2. 修正配置中的错误点 #

（1）修复GitLab仓库URL #

你的URL中projects//packages多了一个斜杠，正确格式需要替换为GitLab项目ID：

url "https://gitlab.com/api/v4/projects/[你的项目ID]/packages/maven"

项目ID可在GitLab项目主页的Settings > General页面找到。

（2）优化Artifact路径配置 #

硬编码AAR路径可能导致未构建时找不到文件，建议改用Gradle自动关联构建产物：

// 替换原来的artifact "$buildDir/outputs/aar/utilsmobile-release.aar"
from components.release

这样Gradle会自动处理AAR的构建流程，确保发布时产物存在。

（3）更新依赖收集的配置项 #

releaseCompileClasspath在新版Android Gradle插件中已被废弃，建议替换为：

configurations.named("releaseRuntimeClasspath").getResolvedConfiguration().getFirstLevelModuleDependencies().each {
    // 原有依赖写入逻辑不变
}

3. 手动执行发布任务 #

如果Gradle面板仍无法看到任务，可直接在Terminal中执行命令：

./gradlew :你的模块名:publishMyPublishPublicationToMavenRepository

将你的模块名替换为实际的模块名称（比如Utils）。

4. 确认插件版本兼容性 #

确保项目根目录build.gradle中的Android Gradle插件（AGP）与Gradle版本兼容，建议使用AGP 7.0+的稳定版本，maven-publish插件需要配合适配的AGP版本才能正常生成任务。

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