如何使用 maven-publish gradle 插件附加 AAR 文件的源？

Question

我将 AAR 发布给团队的另一部分，该部分仅检查此 AAR，而不检查源代码。

我想无缝地向他们提供源代码（使用 Ctrl + 单击类或 Ctrl + B 直接在 Android Studio 中获取源代码）。

据我了解，只能使用 .jar 档案，而不是 .aar。

这是maven-publish 配置文件。我可以将档案（调试、“发布”和源代码）发布到 Maven。我可以获得调试依赖项（“xxx-debug.aar”）。我可以手动下载源（“xxx-sources.jar”）并通过 Android Studio 中的“选择源...”链接它们。但链接并不像任何其他像样的库一样自动进行（想到的是 Retrofit 或 OkHttp）：

// MAVEN PUBLICATION

apply plugin: 'maven-publish'

task sourceJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier "sources"
}

publishing {

    group = 'foo.bar.rootpackage'
    version = "foobar1.0"

    publications {

        aar(MavenPublication) {

            println("Maven publish: package name is ${aarName}")

            groupId group
            artifactId sdkModuleName
            version version

            artifact(sourceJar)

            def debugAar = "$buildDir/outputs/aar/${aarName}-debug.aar"
            if (new File(debugAar).exists()) {
                artifact(debugAar) {
                    classifier 'debug'
                    extension 'aar'
                }
            }

            def releaseAar = "$buildDir/outputs/aar/${aarName}-release.aar"
            if (new File(releaseAar).exists()) {
                artifact(releaseAar) {
                    extension 'aar'
                }
            }

            //The publication doesn't know about our dependencies, so we have to manually add them to the pom
            pom.withXml {
                def dependenciesNode = asNode().appendNode('dependencies')

                def compileTimeDependencies = configurations.api.allDependencies +
                        configurations.implementation.allDependencies +
                        configurations.releaseImplementation.allDependencies

                appendDependencies(compileTimeDependencies, dependenciesNode)
            }
        }
    }

    repositories {
        maven {
            // PRIVATE MAVEN STUFF
        }
    }
}

ext {
    appendDependencies = { Set<Dependency> compileTimeDependencies, dependenciesNode ->

        compileTimeDependencies.each {
            def dependencyNode = dependenciesNode.appendNode('dependency')
            dependencyNode.appendNode('groupId', it.group)
            dependencyNode.appendNode('artifactId', it.name)
            dependencyNode.appendNode('version', it.version)

            if (!it.excludeRules.isEmpty()) {
                def exclusionsNode = dependencyNode.appendNode('exclusions')
                it.excludeRules.each { rule ->
                    def exclusionNode = exclusionsNode.appendNode('exclusion')
                    exclusionNode.appendNode('groupId', rule.group)
                    exclusionNode.appendNode('artifactId', rule.module ?: '*')
                }
            }
        }
    }
}

在需要此依赖项的其他项目的 build.gradle 中，我实现了这样的依赖项：

    debugApi("foo.bar.rootpackage:core:$foobar1.0:debug@aar") {
        transitive = true
    }
    releaseApi("foo.bar.rootpackage:core:$foobar1.0@aar") {
        transitive = true
    }

项目已构建，但没有与源的“自动链接”。

如何修复？

Answer 1

使用android-maven-publish。链接源包应该在生成的 POM 中进行。

Answer 2

在我使用 aar 的情况下，我还应该包含

javadocJar

工件，以便自动链接它。

你可以尝试类似的方法：

...
task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}
    
task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

publishing {

    ...

    publications {

        aar(MavenPublication) {
            artifact(sourceJar)
            artifact(javadocJar)
            ...

参考这里