上传到bintray.com的文件有什么区别？

Question

我根据教程将我的库上传到bintray.com，现在在标签“文件”中存在文件列表。

1）哪一个可以直接添加到app/libs文件夹

2）上传到bintray.com的文件有什么不同？

*-javadoc.jar 
*-javadoc.jar.asc 
*-sources.jar 
*-sources.jar.asc 
*.aar 
*.aar.asc 
*.pom 
*.pom.asc

Answer 1

让我们一次回答一个问题：

1）哪一个可以直接添加到app/libs文件夹

这就是*.aar文件。.aar文件包含编译后的代码和在库中定义的其他资源（例如XML文件）。

这是一个XML文件，存储关于库的元数据。

通常，它存储以下内容：

• 工件的名称（例如MyLibrary)
• 发布工件的组（即组织）（例如com.myname.mycompany)
• 库的版本（即0.0.4)
• 打包-定义二进制文件的文件类型（对于Android库是AAR，对于某些Java库是WAR)，等等）
• 库的一个或多个依赖项

这只是一个归档文件，而不是可执行文件。你可以用Total Commander或WinRar打开它，检查它的内容。

包含库的源。这也只是一个归档文件，而不是可执行文件。

它包含实际的*.java或*.kotlin文件，并附有注释。有了这个文件，库的客户端就可以正确地查看代码，逐行查看代码，并更好地理解代码的功能。

我假设您使用的是Bintray Gradle插件，因为您提到了bintrayupload任务。

在gradle文件的某个地方，应该有这样的内容：

publishing {
    publications {
        MyPublicationName(MavenPublication) {
        ...
        }
    }
}

这定义了一个名为MyPublicationName的发布对象。

./gradle generatePomFileForMyPublicationNamePublication

./gradle :moduleName:assembleRelease

task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}

./gradle :moduleName:sourcesJar

和前面一样，用库模块的名称替换moduleName。

您通常需要为此定义2个任务：

1. 一个在类上调用Javadoc工具的任务，从代码中的文档生成HTML文档文件。
2. 第二个任务获取HTML文件并将它们绑定到.jar文件中（就像我们对sources.jar文件所做的那样）

//generates HTML files from the documentation present in your source files
task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    failOnError false
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

//takes the generated html documentation files, and archives them in a jar
task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

./gradle :moduleName:javadocJar

希望这能有所帮助！