gradle库中模糊的接口参数名

Question

我做了一个带一些接口的库(github上的HybridMediaPlayer)。当我在新项目中从gradle导入它并使用这些接口时，我得到了更改的参数名，例如:

player.setOnPositionDiscontinuityListener(new ExoMediaPlayer.OnPositionDiscontinuityListener() {
     @Override
     public void onPositionDiscontinuity(int i, int i1) {

     }
});

其中“i”是“原因”，“i1”是“currentWindowIndex”。为什么在其他项目中更改了它以及如何修复它？Proguard 已禁用。

Answer 1

发生这种情况的原因有两个：

1.您没有将任何留档作为工件包含在您的AAR中

如果是这种情况，则需要在AAR的＜code＞构建中添加以下任务。gradle如下：

task javadoc(type: Javadoc) {

    description "Generates Javadoc for ${archivesBaseName}-${version} API"
    group JavaBasePlugin.DOCUMENTATION_GROUP

    title = "${archivesBaseName}-${version} API References"

    source android.sourceSets.main.java.srcDirs, configurations.doc.collect { zipTree(it) }
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))

    options {
        memberLevel = JavadocMemberLevel.PUBLIC
        linksOffline('http://developer.android.com/reference/', "${android.sdkDirectory}/docs/reference");
    }

    include '<path of your public api>/*.java'
    exclude '**/BuildConfig.java'
    exclude '**/R.java' 
    exclude '**/test/**/*.java'

    failOnError false
}

task androidJavadocsJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

artifacts {
    archives androidJavadocsJar
}

2.您已经完成了步骤1

如果是这种情况，您需要通知android studio下载< code>javaDoc。将以下代码放入目标应用程序的主< code>build.gradle中

apply plugin: 'idea'
...
idea {
    module {
        downloadJavadoc = true
        downloadSources = true
    }
}

或者，您可以按照此SO通过android Studio进行操作。

注意：您需要在AAR的用户指南中正确记录Javadoc下载，以便AAR的用户知道如何克服障碍

Answer 2

jitpack的解决方案是为接口添加javadoc，这在lib gradle构建文件中：

// build a jar with source files
task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}

task javadoc(type: Javadoc) {
    failOnError  false
    source = android.sourceSets.main.java.sourceFiles
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
    classpath += configurations.compile
}

// build a jar with javadoc
task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

artifacts {
    archives sourcesJar
    archives javadocJar
}

Answer 3

我认为这是因为在Maven repo上只存在一个Android归档库(AAR ),而没有源代码jar。AAR只包含编译过的类，在编译过的类中，完整的变量名不再为人所知。因此，当您的IDE实现该方法时，它不再知道名称，所以它默认为基于参数类型的标准命名(因此I代表整数)。

如果您想要正确的变量名，您应该将项目的源jar也发布到Jitpack repo。这个答案可能提供了一种在AAR旁边发布source jar的方法。当源jar也发布时，IDE将使用Gradle将源jar拉入项目，并在实现方法时使用它来获取参数名等。