用JitPack发布开源库时附加文档和源码
Posted GcsSloop
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了用JitPack发布开源库时附加文档和源码相关的知识,希望对你有一定的参考价值。
首发地址: http://www.gcssloop.com/course/jitpack-sources-javadoc
很早之前写过一篇用JitPack发布Android开源库的文章,有小伙伴反馈说发布到JitPack上的开源库没有文档注释,使用起来很不方便,这是我的失误,上一篇文章只是讲解了如何使用JitPack发布开源库,最终发布的只有arr(即编译好的动态链接库),不仅没有文档注释(Javadoc),也没有源码(sources),本次就教大家如何在发布同时添加上注释和源码。
由于JitPack本身就是一个自定义Maven仓库,所以与上传Maven的配置方式基本一样。
配置项目的 build.gradle
项目的 build.gradle 配置和上一篇一样,没有变化。
buildscript
dependencies
// 重点就是下面这一行(上面两行是为了定位这一行的添加位置)
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
配置 Library 的 build.gradle
完整示例(重点内容已经用注释标出):
apply plugin: 'com.android.library'
apply plugin: 'com.github.dcendents.android-maven' // 添加这个
group='com.github.GcsSloop' // 指定group,com.github.<用户名>
android
compileSdkVersion 23
buildToolsVersion "23.0.3"
defaultConfig
minSdkVersion 7
targetSdkVersion 23
versionCode 1
versionName "1.0"
buildTypes
release
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
dependencies
compile fileTree(dir: 'libs', include: ['*.jar'])
testCompile 'junit:junit:4.12'
compile 'com.android.support:appcompat-v7:23.4.0'
//---------------------------------------------
// 指定编码
tasks.withType(JavaCompile)
options.encoding = "UTF-8"
// 打包源码
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
// 制作文档(Javadoc)
task javadocJar(type: Jar, dependsOn: javadoc)
classifier = 'javadoc'
from javadoc.destinationDir
artifacts
archives sourcesJar
archives javadocJar
发布参照上一篇文章: 使用JitPack发布开源库
查看在线文档
如果你在JitPack配置了文档和源码支持,在引用同时就包含了源码和文档,不仅如此,你也可以在线查看。
查看地址是: https://jitpack.io/com/github/USER/REPO/VERSION/javadoc/
例如我的一个开源库:https://jitpack.io/com/github/GcsSloop/ViewSupport/v1.2.2/javadoc/
在线API文档样式:
以上是关于用JitPack发布开源库时附加文档和源码的主要内容,如果未能解决你的问题,请参考以下文章
“Android Gradle 插件需要 Java 11 才能运行”在发布 jitpack 库时