如何使用其文档导出AAR库？

Question

我想知道为什么我的库在AAR格式构建后总是丢失文档.此外,Android Studio缩小了代码,即构建之前的代码总是与内置到AAR格式后的代码不同,没有原始代码.我希望我的库有自己的文档,并有原始代码.你可以看到下面的不同:

建成之前

内置为AAR格式后

文档在哪里？!此外,您会注意到整个代码确实缩小了,并且不同.

那么,如何在不缩小代码的情况下将AAR库与其文档一起导出？

Answer 1

我同意@MarkusKauppinen.

构建源jar之后的主要问题是你不能使用这个jar作为你的依赖项.这只是一个不能用于编写代码的源代码,即你不能导入任何东西,因为jar包含*.java文件而不是*.class文件.这样做,请执行以下操作:

步骤#1为您的库构建AAR格式.通常,它位于[project]/[library-module]/build/outputs/aar/library-release.aar

步骤#2将AAR文件添加为模块.转到文件>新建>新模块...>导入.JAR/.AAR包>下一步.

然后,找到AAR文件并单击"完成".

步骤#3单击此图标转到项目结构,并将我们刚刚制作的模块添加到应用程序的依赖项中.

步骤#4将@ MarkusKauppinen的gradle任务添加到库模块,build.gradle并使用gradle同步项目.

步骤#5转到Android Studio右侧窗格>单击此图标,单击Gradle>刷新gradle任务.

第6步查找和运行(通过双击)sourcesJar在:library-module> Tasks> other.

步骤#7任务完成后,您将找到源jar

library-module\build\libs\..-sources.jar.

步骤#8将至少一个类导入应用程序的模块,例如在MainActivity.然后,按Ctrl+单击该课程.单击Choose sources并浏览步骤#7中提到的源jar.

最后,您可以查看源代码及其文档.

Answer 2

代码"缩小",因为一旦您创建AAR ,原始源代码就不会包含在AAR中.它只是Java字节码.

然后在应用程序中使用AAR库时.源代码是从字节码反向设计的.原始变量名称不可用,并且由于字节码编译器的优化和诸如此类的原因,可能存在一些编码样式差异.当然,这些注释不包含在字节代码中,因为它适用于计算机,注释适用于人员.

因此,当使用AAR库时,如果您在调试等时不想看到原始源代码,则需要将AAR作为单独的源JAR提供,并且可能告诉Android Studio如果不这样做则使用源JAR它自动.

我已经能够自动创建源JAR,作为将生成的AAR/JAR"上传"到本地Maven存储库的过程的一部分.我不知道你有什么样的构建系统,所以我不会深入研究这些细节.

无论如何,你可以将它添加到你的模块的build.gradle:

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

然后,只要您想要创建/更新源JAR,就需要单独运行它:

Gradle - >任务 - >其他 - > sourcesJar

并且可能有一些方法可以使任务自动化成为任务的一部分,assembleRelease但我对Gradle还不是很熟悉.

源JAR将出现在...\MyLibrary\app\build\libs\path中.